---
title: "CLAUDE.md (Claude Code): caminhos e formato · DotsAgent"
description: "Onde CLAUDE.md fica, seu formato e frontmatter, como cópias globais e aninhadas são combinadas e quais ferramentas o leem. Verificado em 2026-10-01."
url: https://dotsagent.io/pt/instructions/files/claude-md
---

CLAUDE.md

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

`CLAUDE.md`

```
@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

| Ferramenta | Suporte |
| --- | --- |
| [GitHub Copilot](https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions) | Lê um CLAUDE.md na raiz como instruções para o agente, como alternativa a AGENTS.md. |

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

Gere um AGENTS.md e arquivos de regras correspondentes para cinco ferramentas a partir de um único formulário. [Abrir o gerador de AGENTS.md →](https://dotsagent.io/pt/instructions)

## Outros arquivos de instruções

[AGENTS.md](https://dotsagent.io/pt/instructions/files/agents-md)

[GEMINI.md](https://dotsagent.io/pt/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/pt/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/pt/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/pt/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/pt/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/pt/instructions/files/openclaw-workspace)

## Fontes

1. [code.claude.com](https://code.claude.com/docs/en/memory)/docs/en/memory

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026