CLAUDE.md no Claude Code: pare de repetir as mesmas regras
Por Mauro Mequelussi · Curso gratuito Claude Code sem mistério: do zero ao plugin · Português (PT-BR)
Resposta direta · O que esta aula resolve
A Aula 6 de 15 ("CLAUDE.md no Claude Code: pare de repetir as mesmas regras"), parte do módulo "Ensinar o Claude" do curso gratuito "Claude Code sem mistério: do zero ao plugin" na Escola de Aplicativos (ministrado por Mauro Mequelussi), ensina na prática: o aluno aprende a configurar o arquivo CLAUDE.md, entendendo sua hierarquia de pastas e a importância de criar instruções curtas e conferíveis. O conteúdo também aborda regras modulares, suporte ao AGENTS.md, a memória automática do Claude Code e os limites recomendados de tamanho de contexto.
Crie sua conta grátis para assistir a esta videoaula em HD
O resumo técnico e os capítulos abaixo são abertos para consulta. Crie sua conta 100% gratuita em segundos para liberar todas as 15 videoaulas em HD, controle automático de progresso, Tutor IA e certificado gratuito verificável.
- R$ 0 · Sem cartão de crédito
- Tutor IA tira-dúvidas da aula
- Certificado gratuito incluso
O que você vai aprender
- O que é o arquivo CLAUDE.md e onde ele deve ficar (projeto, usuário ou empresa)
- Como gerar um rascunho automático com comandos de build e testes do projeto
- A fórmula para escrever regras claras, curtas e fáceis de conferir
- Como modularizar regras para carregar apenas nos arquivos relevantes
- Como funciona a memória automática que anota decisões sem você escrever nada
- O que não deve entrar no arquivo e o limite de duzentas linhas recomendado
Pontos-chave da aula
- O CLAUDE.md é carregado no início de toda sessão para dar contexto imediato ao Claude Code.
- Instruções específicas e verificáveis funcionam muito melhor do que orientações genéricas.
- O Claude Code é compatível com AGENTS.md caso você já use outros assistentes.
- Tudo no arquivo ocupa janela de contexto contínua; mantenha-o com menos de 200 linhas.
- O arquivo serve como contexto e orientação, não como uma garantia absoluta e inviolável.
Capítulos e roteiro técnico da aula
8 capítulos minutados- 00:00
O problema de repetir regras a cada sessão
Entenda por que você não precisa reensinar os comandos e regras do projeto toda vez que abre o Claude Code.
- 00:24
O que é o arquivo CLAUDE.md
Descubra a analogia do quadro de avisos na parede e como esse arquivo Markdown define as regras da casa lidas no início de cada sessão.
- 00:52
Onde o arquivo mora e como gerar o rascunho
Conheça a hierarquia de locais (projeto, pasta pessoal e empresa) e o comando que cria automaticamente a primeira versão das regras.
- 01:22
Como escrever regras claras e conferíveis
Veja o exemplo do app Atende e entenda por que instruções curtas e específicas funcionam muito melhor do que pedidos vagos.
- 01:55
Regras modulares e escopo por arquivo
Aprenda a organizar regras em múltiplos arquivos para que instruções específicas só entrem no contexto quando arquivos específicos forem editados.
- 02:21
Suporte a AGENTS.md e memória automática
Entenda a compatibilidade com outros agentes e como o Claude Code anota sozinho decisões e preferências sem você escrever nada.
- 02:52
O que não colocar no CLAUDE.md e limites de contexto
Descubra por que manuais longos não devem entrar no arquivo de regras e conheça o limite recomendado de 200 linhas.
- 03:51
Regras versus procedimentos: o que vem a seguir
Recapitulação sobre o papel das regras da casa e a ponte para transformar procedimentos complexos em skills na próxima aula.
Momentos de destaque na prática
O quadro de avisos do seu projeto: CLAUDE.md
Pare de repetir comandos todo dia e veja como o Claude Code lê suas regras automaticamente no início de cada sessão.
O segredo de regras que o Claude realmente segue
Entenda por que instruções vagas falham e como escrever regras curtas e conferíveis para o seu projeto.
O que nunca colocar no CLAUDE.md e o limite de linhas
Cuidado com o tamanho do arquivo: descubra por que manuais longos atrapalham e qual é o limite oficial recomendado.
Notas de aula e guia de estudo
Chega de abrir o terminal toda manhã e digitar os mesmos comandos de teste e restrições de código. O arquivo CLAUDE.md funciona como o quadro de avisos da sua equipe, lido automaticamente pelo Claude Code no início de cada sessão.
Nesta aula, você verá como gerar o primeiro rascunho das suas regras, como organizá-las para gastar menos contexto e qual é a diferença entre o que você define manualmente e o que a ferramenta aprende sozinha.
O que você vai aprender
- O que é o arquivo CLAUDE.md e onde ele deve ficar (projeto, usuário ou empresa)
- Como gerar um rascunho automático com comandos de build e testes do projeto
- A fórmula para escrever regras claras, curtas e fáceis de conferir
- Como modularizar regras para carregar apenas nos arquivos relevantes
- Como funciona a memória automática que anota decisões sem você escrever nada
- O que não deve entrar no arquivo e o limite de duzentas linhas recomendado
Pontos-chave
- O CLAUDE.md é carregado no início de toda sessão para dar contexto imediato ao Claude Code.
- Instruções específicas e verificáveis funcionam muito melhor do que orientações genéricas.
- O Claude Code é compatível com AGENTS.md caso você já use outros assistentes.
- Tudo no arquivo ocupa janela de contexto contínua; mantenha-o com menos de 200 linhas.
- O arquivo serve como contexto e orientação, não como uma garantia absoluta e inviolável.