~/.claude/settings.json vs ~/.claude.json
People think ~/.claude.json is the user settings file. It is not. The user settings file is settings.json, inside the .claude folder in your home. Claude Code writes the other file itself. It keeps your account, your MCP servers and the folders you trust there. You edit the settings file by hand, and you rarely need to touch the other one.
User Settings File
Your own file of settings. It works in each repo you open.
The user settings file is ~/.claude/settings.json. It sits in the .claude folder in your home folder. It applies to you in each repo on this machine. It is the place for your own choices, such as your default model and your own rules. It is at the bottom of the order, so any repo file can win over it.
~/.claude.json
A file Claude Code writes for itself. It holds your account and MCP servers.
~/.claude.json is a file in your home folder that Claude Code writes for itself. It holds your account details and the MCP servers you added for yourself. It also holds state, such as which folders you trust, and global config keys that /config sets. It sits next to the ~/.claude folder, not inside it. If it breaks, Claude Code saves a copy in ~/.claude/backups.
In one line
- User Settings File
- Your own file of settings. It works in each repo you open.
- ~/.claude.json
- A file Claude Code writes for itself. It holds your account and MCP servers.