# .claude Directory

> A folder in a repo that holds its Claude Code files.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** .claude folder, project .claude directory

## Think of it like

It is like a drawer in a desk. It keeps the project's Claude things together.

## Definition

The .claude directory is a folder in a repo that holds Claude Code's files for that repo. It can hold settings.json and settings.local.json. It can also hold folders for skills, agents, rules, commands and output styles. Most of it is meant to be committed, so the team shares it. The repo's .mcp.json sits next to it, in the root.

## Example

Jack's new teammate clones the repo. The .claude folder comes with it, so her Claude gets the same skills and rules on day one.

## Example code

```console
.claude/
  settings.json
  settings.local.json
  skills/
  agents/
  rules/
```

A typical project .claude folder.

## Why it matters

It is where a project's whole Claude Code setup lives, in one place.

## Common mistake

Committing settings.local.json with the rest. That file is yours alone, and it should stay out of git.

## Three principles

- **In the project.** Next to the code.
- **Settings and more.** Skills, agents, rules.
- **Mostly committed.** The team shares it.

## Related terms

- [~/.claude Directory](https://learn.benibix.com/term/ai/home-claude-directory)
- [Project Settings File](https://learn.benibix.com/term/ai/project-settings-file)
- [CLAUDE.md](https://learn.benibix.com/term/ai/claude-md)

## Told apart from

- [.claude vs ~/.claude](https://learn.benibix.com/compare/claude-directory-vs-home-claude-directory): People think there is one .claude folder. There are two with the same name. The one in a project holds that project's setup and is shared through git. The one in your home folder holds your own setup for every project, plus the data Claude Code writes as you work. A project file beats the same key in your home one.

![Where Claude Code's files sit: in the project root, in the project's .claude folder, and in your home folder.](https://learn.benibix.com/diagrams/claude-directory-map.svg)

---

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