# Local Settings File

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

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

## Think of it like

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

## 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

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.

## Example code

```json
{
  "permissions": {
    "allow": ["Bash(npm run dev)"]
  }
}
```

A rule saved from a prompt lands here.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

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

## Told apart from

- [settings.json vs settings.local.json](https://learn.benibix.com/compare/project-settings-file-vs-local-settings-file): People think settings.local.json is a backup of settings.json. It is a second file with a different owner. The project file is shared in git, so it sets the rules for the whole team. The local file is yours alone, stays out of git, and wins when both set a key. Rules you approve from a prompt are saved in the local one.

---

Source: https://learn.benibix.com/term/ai/local-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.
