CLAUDE.md (Claude Code): onde fica e como as ferramentas o leem

CLAUDE.md é o arquivo de memória que o Claude Code carrega ao iniciar, a partir do diretório pessoal, do projeto e de cada diretório pai. As regras associadas a caminhos em .claude/rules/ adicionam orientações carregadas apenas quando arquivos correspondentes são lidos.

Onde fica

• Projeto: ./CLAUDE.md ou ./.claude/CLAUDE.md, incluído no commit e compartilhado com a equipe.
• Local: ./CLAUDE.local.md, para anotações pessoais que não devem ser incluídas no git.
• Usuário: ~/.claude/CLAUDE.md, aplicado a todos os projetos.
• Regras: ./.claude/rules/**/*.md e ~/.claude/rules/**/*.md, com escopo opcional definido pelo frontmatter paths.
• Política gerenciada: /Library/Application Support/ClaudeCode/CLAUDE.md no macOS, C:\Program Files\ClaudeCode\CLAUDE.md no Windows ou a chave claudeMd em managed-settings.json.

Formato

Markdown. Os arquivos em .claude/rules/ podem começar com frontmatter YAML cuja chave paths lista globs. Inclua outros arquivos com @path/to/file, até 4 níveis de profundidade; não há limite rígido de tamanho documentado, mas a Anthropic recomenda manter cada arquivo abaixo de 200 linhas.

Chaves do frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

Precedência e combinação

Nada é sobrescrito: todos os arquivos encontrados são concatenados. A política gerenciada é carregada primeiro, seguida pelos arquivos da raiz do sistema de arquivos até o diretório de inicialização; assim, os arquivos mais próximos são lidos por último. No mesmo diretório, CLAUDE.local.md vem depois de CLAUDE.md. Os arquivos em subdiretórios são carregados sob demanda, quando Claude lê arquivos nesses diretórios, e não é possível excluir a política gerenciada com claudeMdExcludes.

Ferramentas que o leem

Dicas

• Se você mantiver um CLAUDE.md, comece o arquivo com @AGENTS.md; caso contrário, Claude Code ignorará AGENTS.md na configuração padrão.
• Mova as orientações específicas de cada área para .claude/rules/ com frontmatter paths, para que sejam carregadas somente para esses arquivos.
• As importações organizam o arquivo, mas ainda consomem contexto, porque o texto importado também é carregado.
• Execute /doctor para verificar CLAUDE.md, CLAUDE.local.md, AGENTS.md, regras e skills de uma só vez.

Outros arquivos de instruções