# Project Settings File

> A settings file in the repo. The whole team shares it in git.

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

## Think of it like

It is like the rules on a class wall. All in that room follow them.

## Definition

The project settings file is .claude/settings.json inside a repo. It is meant to be committed, so all who clone the repo get the same permissions, hooks and plugins. Claude Code reads it from the folder the session starts in. Some of what it sets waits until each person trusts the folder.

## Example

Lucy commits a project settings file with a lint hook. Everyone who pulls the repo now gets the same hook.

## Example code

```json
{
  "permissions": {
    "deny": ["Read(./.env)", "Read(./.env.*)"]
  }
}
```

Keep every teammate's Claude out of .env files.

## Why it matters

It is how a team agrees on one setup. No one has to copy it by hand.

## Common mistake

Starting Claude in a subfolder and wondering why the rules are missing. It reads the file from where the session starts.

## Three principles

- **In the project.** The .claude folder.
- **Commit it.** The team shares it.
- **Waits for trust.** Some keys.

## Related terms

- [Local Settings File](https://learn.benibix.com/term/ai/local-settings-file)
- [User Settings File](https://learn.benibix.com/term/ai/user-settings-file)
- [Project Trust](https://learn.benibix.com/term/ai/project-trust)

## 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/project-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.
