Skip to content
BENIBIX Learn

~/.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.

AI⌨️ Claude Code

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.

Example
Emma wants Claude to run git status without asking, in all her repos. She puts the rule in her user settings file once.
Why it matters
It saves you from setting the same thing in every project.
Full entry
AI⌨️ Claude Code

~/.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.

Example
Emma added a server with claude mcp add, then looked for it in settings.json. It was in ~/.claude.json, where her own servers live.
Why it matters
It explains where your MCP servers and trust choices are kept.
Full entry

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.