Skip to content
BENIBIX Learn

~/.claude.json

AI⌨️ Claude CodeConfiguration

Also known as .claude.json, Claude Code global config

A file Claude Code writes for itself. It holds your account and MCP servers.

Think of it like

It is like a notebook the app keeps for itself. You do not need to open it.

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.

Definition

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

bash
claude mcp add --transport http docs https://mcp.example.com/mcp
This writes the server into ~/.claude.json.

Common mistake

Looking for it inside the ~/.claude folder. It sits beside that folder, in your home folder.

Key takeaways

  1. 1
    Written by Claude Code. Not by you.
  2. 2
    Account and MCP. And trust.
  3. 3
    Beside ~/.claude. Not inside.

Compare