Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md é um arquivo de configuração em markdown colocado na raiz do seu projeto que fornece ao Claude Code instruções persistentes e específicas do projeto. Ele informa o agente sobre suas convenções de codificação, arquitetura, comandos comuns e regras—funcionando como uma forma de memória de longo prazo que se aplica a cada sessão naquele projeto.

Como o CLAUDE.md funciona

Quando o Claude Code inicia uma sessão, ele automaticamente lê o arquivo CLAUDE.md na raiz do seu projeto (e quaisquer arquivos CLAUDE.md em diretórios pais ou subdiretórios). O conteúdo se torna parte do contexto de sistema do agente, então ele segue suas instruções sem precisar ser lembrado a cada sessão. Isso faz o agente se comportar de forma consistente com as convenções da sua equipe.

O que incluir no CLAUDE.md

  • +Visão geral da arquitetura do projeto e localização de arquivos-chave
  • +Convenções de codificação (nomenclatura, formatação, padrões para usar ou evitar)
  • +Comandos comuns para testes, build e deploy
  • +Regras como "sempre escreva testes para novas funções" ou "nunca modifique o módulo de autenticação diretamente"
  • +Detalhes da stack tecnológica que o agente deve conhecer
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

Mantenha o CLAUDE.md conciso. O agente o lê a cada sessão, então inclua apenas informações relevantes para múltiplas tarefas. Mova detalhes específicos de tarefas para seus prompts.

Onde devo colocar o arquivo CLAUDE.md?+
Coloque-o na raiz do diretório do seu projeto. O Claude Code também suporta arquivos CLAUDE.md em subdiretórios para instruções específicas de módulos, e em diretórios pais para regras da organização. Todos os arquivos aplicáveis são mesclados.
O CLAUDE.md funciona com outras ferramentas de IA?+
CLAUDE.md é específico do Claude Code. No entanto, algumas outras ferramentas adotaram conceitos similares. O Cursor usa .cursorrules, e outros agentes podem ler arquivos de configuração personalizados. O conceito de instruções de IA em nível de projeto está se tornando um padrão comum.
Qual deve ser o tamanho do CLAUDE.md?+
Mantenha-o com menos de 500 linhas. Foque nas convenções e regras mais importantes. O agente sempre pode ler arquivos individuais para detalhes—o CLAUDE.md deve fornecer o contexto de alto nível que se aplica a todas as tarefas.

Related terms

Codificação AgênticaClaude CodeEngenharia de Prompt para Código

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS