.claude vs ~/.claude
People think there is one .claude folder. There are two with the same name. The one in a project holds that project's setup and is shared through git. The one in your home folder holds your own setup for every project, plus the data Claude Code writes as you work. A project file beats the same key in your home one.
.claude Directory
A folder in a repo that holds its Claude Code files.
The .claude directory is a folder in a repo that holds Claude Code's files for that repo. It can hold settings.json and settings.local.json. It can also hold folders for skills, agents, rules, commands and output styles. Most of it is meant to be committed, so the team shares it. The repo's .mcp.json sits next to it, in the root.
~/.claude Directory
The .claude folder in your home folder, for your own setup.
The ~/.claude directory is the .claude folder in your home folder. It holds your own Claude Code setup for each repo you work in. That means settings.json, CLAUDE.md, skills, agents and keybindings.json. Claude Code also writes data there as you work, such as chat logs, history and auto memory. CLAUDE_CONFIG_DIR can move it.
In one line
- .claude Directory
- A folder in a repo that holds its Claude Code files.
- ~/.claude Directory
- The .claude folder in your home folder, for your own setup.