# User Settings File

> Your own file of settings. It works in each repo you open.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** ~/.claude/settings.json, user settings

## Think of it like

It is like your own backpack. It goes with you to every class.

## Definition

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.

## Example code

```json
{
  "permissions": {
    "allow": ["Bash(git status)", "Bash(git diff *)"]
  }
}
```

Let Claude run git status and git diff in every project.

## Why it matters

It saves you from setting the same thing in every project.

## Common mistake

Putting a team rule here. Your teammates never get it, because the file is only on your machine.

## Three principles

- **In your home folder.** ~/.claude.
- **Every project.** On this machine.
- **Lowest level.** Projects override.

## Related terms

- [Project Settings File](https://learn.benibix.com/term/ai/project-settings-file)
- [Local Settings File](https://learn.benibix.com/term/ai/local-settings-file)
- [Claude Code Settings Precedence](https://learn.benibix.com/term/ai/settings-precedence)

## Told apart from

- [~/.claude/settings.json vs ~/.claude.json](https://learn.benibix.com/compare/user-settings-file-vs-claude-json-file): 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.

---

Source: https://learn.benibix.com/term/ai/user-settings-file
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
