Configuração e Uso
CLAUDE.md
Aprenda a criar o arquivo CLAUDE.md que guia o Claude Code no seu projeto. Configuração essencial para respostas precisas.
Não é uma instalação, mas é a primeira coisa a configurar em qualquer projeto. O CLAUDE.md é a memória persistente — o Claude lê automaticamente para entender seu projeto.
Onde colocar
| Arquivo | Escopo | Uso típico |
|---|---|---|
./CLAUDE.md | Projeto (raiz) | Arquitetura, stack, convenções |
./.claude/CLAUDE.md | Projeto (oculto) | Mesmo, mas organizado dentro de .claude/ |
./CLAUDE.local.md | Pessoal | Preferências do dev, não commitado |
~/.claude/CLAUDE.md | Global | Padrões pessoais para todos projetos |
A pasta .claude/ deve ser commitada — ela contém configurações compartilhadas do time (settings, commands, CLAUDE.md). A convenção para separar o que é pessoal é o sufixo .local: arquivos como CLAUDE.local.md e settings.local.json ficam fora do versionamento.
Mesmo conceito, nomes diferentes: todo assistente de IA para código usa um arquivo de memória de projeto.
| Assistente | Arquivo |
|---|---|
| Claude Code | CLAUDE.md |
| OpenAI Codex | AGENTS.md |
| Google Antigravity | GEMINI.md |
| Cursor | .cursorrules / .cursor/rules/ |
| Windsurf | .windsurfrules |
| GitHub Copilot | .github/copilot-instructions.md |
Se você usa mais de um assistente, pode manter ambos os arquivos no repositório — cada agente lê apenas o seu.
O que colocar
- Descrição do projeto e stack
- Convenções de código (nomenclatura, imports, patterns)
- Comandos para rodar, buildar e testar
- Estrutura de diretórios
- Regras que o Claude deve sempre seguir
Conteúdo Premium
Desbloqueie todas as 20 seções do Claude Code Guide com acesso vitalício.
Incluído no Guide:
- 20 seções detalhadas, do setup à automação
- Acesso vitalício com atualizações
- Exemplos práticos e configurações prontas
- Suporte bilíngue (PT-BR e EN)