Inside the .claude/ Folder: How Claude Code Organizes Your AI Workspace

Claude Code creates a .claude/ folder in your project root. Most developers ignore it. Some delete it. Few understand what it actually does. This folder is Claude's memory palace. It stores conversation threads, context snapshots, and project awareness that persists across sessions. Understanding its structure helps you work with Claude more effectively and avoid common pitfalls. Subscribe to the newsletter for deep dives on AI developer tooling. What Claude Code Stores in .claude/ The folder structure reveals how Claude maintains project awareness: .claude/ ├── conversations/ # Thread history and message logs ├── context/ # Project snapshots and file indexes ├── cache/ # Embeddings and computed context ├── settings.json # Project-specific preferences └── state.db # Session persistence and bookmarks conversations/ Each conversation thread gets a JSON file with: Message history (prompts and responses) File references and code snippets Tool invocations and their results Timestamps and se