Skip to content
BENIBIX Learn

Local Settings File

AI⌨️ Claude CodeConfiguration

Also known as .claude/settings.local.json, project local settings

Your own settings for one project, kept out of git.

Think of it like

It is like a sticky note on your own desk. Only you see it.

Example

Jack's team file sets one model, but he wants to try another in this repo. He sets it in his local file, and no one else is affected.

Why it matters

It lets you bend the team setup for yourself without a commit.

Definition

The local settings file is .claude/settings.local.json inside a project. It holds your own changes for that one project and sits above the shared project file, so it wins when both set a key. When you choose Yes, and don't ask again on a prompt, Claude Code saves the rule here. When Claude Code makes the file, it keeps it out of git for you.

Example code

json
{
  "permissions": {
    "allow": ["Bash(npm run dev)"]
  }
}
A rule saved from a prompt lands here.

Common mistake

Making the file by hand and forgetting git. Only a file Claude Code makes is kept out of git for you.

Key takeaways

  1. 1
    One project, just you. Not shared.
  2. 2
    Beats the team file. Higher level.
  3. 3
    Saved answers land here. Allow rules.

Compare