Use CLAUDE.md para Manter Convenções de Projeto nas Sessões da IA Claude

Um usuário do Reddit relata que adicionar um arquivo CLAUDE.md à raiz do projeto foi a mudança de maior alavancagem que ele fez com o Claude Code. O Claude lê este arquivo no início de cada sessão, então você nunca precisa reexplicar convenções como uso de TypeScript, Tailwind vs. CSS modules, estrutura de pastas de teste ou relacionamentos de modelo de dados.

Detalhes Principais

• Localização: Crie um arquivo chamado CLAUDE.md na raiz do diretório do seu projeto.
• O que incluir: Convenções de codificação (ex.: "Usamos TypeScript, sempre. Sem exports padrão. Tailwind, não CSS modules. Testes vão em pastas tests."), além do contexto de arquitetura do projeto — como os módulos se conectam, modelos de dados e quais arquivos são críticos vs. scaffolding.
• Comportamento: O arquivo é lido automaticamente no início de cada sessão do Claude. Nenhuma invocação manual é necessária. As convenções são aplicadas sem serem solicitadas.
• Resultado: O usuário notou que "as edições do Claude melhoraram visivelmente depois que ele tinha esse contexto incorporado desde o início da sessão."

Exemplo Prático

# CLAUDE.md

Conventions

Language: TypeScript
Exports: named exports only (no default exports)
Styling: Tailwind CSS (no CSS modules)
Testing: tests go in dedicated tests/ folders

Architecture

Frontend: React with React Router
API layer: Express routes in /api
Data models: Prisma schema in /prisma
Critical files: /src/app.ts, /src/config.ts

Após adicionar este arquivo, o usuário relata nunca mais ter que redigitar essas regras por sessão.

Para Quem é

Desenvolvedores que usam Claude Code ou qualquer agente de codificação baseado em Claude que desejam comportamento consistente entre sessões de chat sem repetir instruções.