A maioria das pessoas que usam o Claude Code está negligenciando o único arquivo que a IA sempre lê antes de iniciar qualquer tarefa.
Esse arquivo se chama "CLAUDE.md".
A documentação oficial da Anthropic afirma claramente: se um arquivo CLAUDE.md existir na pasta, o Claude Code sempre o carregará antes de começar a trabalhar — mesmo que você não peça.
Em outras palavras, o que você escreve aqui muda o comportamento inicial da IA em 100%. Enquanto você precisa redigitar os prompts toda vez, o CLAUDE.md funciona em todas as conversas depois de escrito.
A alavancagem está em outro nível.
Por outro lado, a menos que você organize este arquivo, não importa o quanto você refine seus prompts, os benefícios serão quase nulos. A IA vai se desviar toda vez. Você terá que reexplicar premissas toda vez. Mesmo para a mesma tarefa, a qualidade variará a cada dia. A causa não é o modelo ou sua habilidade em criar prompts — é este arquivo.
Hoje, vou revelar exatamente "o que e como escrever" no CLAUDE.md, incluindo exemplos prontos para copiar e colar.
Para quem tem baixo desempenho, o CLAUDE.md é apenas um "memorando"
Para ser honesto, eu também tive dificuldades no começo.
Por um tempo no X, havia muitos artigos dizendo "o conteúdo das pastas é importante" ou "o CLAUDE.md é importante." Eu os via e abria minhas pastas.
O conteúdo era uma bagunça.
Eu não sabia o que estava onde. Dados semelhantes estavam espalhados por toda parte. A IA não conseguia encontrar o conhecimento necessário, e toda vez que gerava uma saída, não era a resposta que eu queria.
O CLAUDE.md era a mesma coisa. As regras sobre onde salvar o quê não estavam definidas. Eu nem entendia o que era o CLAUDE.md em primeiro lugar. Então, eu ficava adicionando instruções do início, conforme pensava nelas.
Como resultado, ele cresceu para 300 ou 400 linhas. Facilmente ultrapassou 200 linhas.
Recomenda-se manter o CLAUDE.md com no máximo 200 linhas.
Um CLAUDE.md muito longo se torna um "texto longo onde a IA não sabe o que é importante."
Nesse estado, a IA relê o arquivo inteiro toda vez e tenta adivinhar: "Então, qual parte se aplica a esta tarefa?" Quando há adivinhação envolvida, a inconsistência aparece. Naturalmente.
CLAUDE.md não é um "bloco de notas." É um "mapa para julgamento" ao qual a IA se refere toda vez. Mudar sua percepção sobre isso já é metade da batalha.
Escreva apenas estas 5 coisas no CLAUDE.md
Você não precisa complicar. Um centro de comando forte invariavelmente contém estes cinco elementos:
- ① Regras Prioritárias: A declaração principal a ser seguida antes de qualquer saída
- ② Tabela de Roteamento: Palavra-chave → Local: Quais tarefas vão para onde
- ③ Árvore de Decisão para Locais: Como julgar itens que não estão na tabela
- ④ Gerenciamento de Tarefas: Como e onde registrar o que precisa ser feito
- ⑤ Tratamento de Informações Confidenciais: Definindo o limite do que não deve ser compartilhado
Quando esses cinco estão no lugar, a IA para de "adivinhar" e começa a "consultar". A raiz da inconsistência desaparece.
Agora, vamos ver como escrever cada um com exemplos reais.
Configuração ① Declare as "Regras Prioritárias" no topo
A primeira coisa a escrever é uma declaração para fixar o movimento inicial da IA. É um aviso: "Antes de pensar, siga as regras abaixo primeiro."
▼ Exemplo de Escrita
Prioridade: Antes de gerar ou salvar qualquer coisa, sempre verifique as regras abaixo antes de agir. Os locais devem ser decididos usando a "Tabela de Palavras-chave" e a "Árvore de Decisão" abaixo. Se não conseguir decidir, não prossiga por conta própria; faça uma pergunta.
Apenas colocando isso no topo, a IA para de "apenas mexer as mãos." Ela começa a verificar as regras toda vez antes de agir. Isso fixa o ponto de partida.
Configuração ② Inclua uma tabela de mapeamento "Palavra-chave → Local"
A próxima coisa mais eficaz é uma tabela de distribuição de trabalho. Vincule "se essa solicitação chegar, coloque aqui/olhe aqui" usando palavras-chave.
▼ Exemplo de Escrita
Palavra-chave → Local ・Blog/Artigos → Publicação/Blog/ ・Despesas/Recibos → Contabilidade/Vouchers/ ・Atas/Notas de Reunião → Registros/Atas/
O truque é escrever exatamente nas palavras que você usa normalmente. A IA olha as palavras na tabela e consegue escolher o local sem hesitação.
A dica para o eixo de distribuição é cortar por "função (tarefa)" em vez de "negócio." Dessa forma, mesmo que negócios ou produtos aumentem, a tabela não quebrará.
Configuração ③ Inclua uma "Árvore de Decisão" para quando estiver perdida ← Esta é a mais eficaz
Dos cinco, este tem o maior impacto. Como lidar com coisas que não estão na tabela ou coisas ambíguas.
Tanto humanos quanto IAs param quando estão perdidos. Eles se desviam porque estão perdidos. Então, apenas elimine o espaço para hesitação. Deixe-os seguir um caminho de SIM/NÃO a partir do topo.
▼ Exemplo de Escrita
Antes de salvar, siga estas etapas em ordem: P1. É informação confidencial (chaves de API/senhas)? → SIM: Vá para .env. Fim. P2. São dados brutos baixados recentemente de fora? → SIM: Vá para Assets/. P3. De qual tarefa se trata? → Vá para uma de: Publicação / Vendas / Contabilidade / Registros. → Se um único local não puder ser determinado ao final, não prossiga; faça exatamente 2 perguntas.
Então, como o comportamento muda antes e depois de adicionar uma árvore de decisão? Especificamente, de duas maneiras.
Mudança 1: Ela executa a mesma ação para a mesma solicitação toda vez.
O Claude Code opera com base em probabilidade. Ele não se lembra da conversa anterior quando o chat muda. Então, sem uma árvore de decisão, mesmo para a mesma solicitação de "salvar a ata", ele oscila.
Sem uma Árvore de Decisão:
- 1ª vez → Salvo em Reunião/
- 2ª vez → Memorando/Atas/
- 3ª vez → Por algum motivo, na pasta Assets
Com uma Árvore de Decisão:
- Toda vez segue o mesmo caminho: P1→P2→P3 → Sempre o mesmo lugar
O comportamento muda de "flutuação probabilística" para um "procedimento fixo". Reprodutibilidade significa que você pode construir em cima dela.
Mudança 2: Ela para de cometer erros com excesso de confiança quando está perdida.
O comportamento mais assustador da IA é "estar errada com confiança". Como jogar uma gravação de vídeo e a ata feita a partir dela no mesmo lugar.
- Forçar a passagem adivinhando → ❌
- Parar e verificar com 2 perguntas → ✓
A última linha é sutilmente eficaz. Apenas escrevendo "Se não conseguir decidir, não se apresse, pergunte", você reduz estruturalmente a produção em massa de entregas fora do alvo.
Quanto mais inteligente a IA, melhor ela se sai quando recebe um "modelo" em vez de liberdade total.
Configuração ④ e ⑤ Gerenciamento de Tarefas e Confidencialidade
Os dois restantes podem ser curtos. Mas você deve escrevê-los.
④ Fixe "onde e como deixar" as tarefas. Sem isso, as coisas a fazer se espalham a cada conversa.
▼ Exemplo de Escrita
Gerenciamento de Tarefas ・Consolide todas as tarefas pendentes em um único arquivo "tasks.md". ・Quando concluído, não exclua; mova para "Concluído" e deixe um resultado de 1 linha.
⑤ Escreva claramente os limites para informações confidenciais. Esta é a tábua de salvação para prevenção de acidentes.
▼ Exemplo de Escrita
Informações Confidenciais ・Escreva chaves de API/senhas apenas no .env. ・Nunca as cole em chats, código ou registros.
Com esses dois, as tarefas não se espalham e as coisas que não deveriam sair permanecem. Eles funcionam como seus dois escudos defensivos.
Mantenha o CLAUDE.md "com menos de 200 linhas." Se estourar, mova para outro arquivo.
Alguns de vocês podem ter percebido que, se escrever tudo no CLAUDE.md, ele ficará cada vez mais longo.
Isso está correto. Isto é importante. Se você deixar o CLAUDE.md muito longo, ele se torna menos eficaz. Como a IA lê isso do início ao fim toda vez, se for muito longo, a sensação do "que é importante" se dilui.
A diretriz é ter menos de 200 linhas.
Se não couber, mova as regras detalhadas para um arquivo separado (por exemplo, "rules_detail.md"). Então, no topo do CLAUDE.md, dê instruções sobre "quando lê-lo."
▼ Exemplo de Escrita (Apenas adicione uma linha à declaração do topo)
Prioridade: Antes de gerar/salvar, sempre siga as regras abaixo. Leia "rules_detail.md" apenas ao escrever uma postagem de blog.
O truque aqui é adicionar uma condição como "apenas quando..." em vez de "sempre ler." Dessa forma, a IA não abrirá esse arquivo para tarefas não relacionadas, mas para tarefas necessárias, ela irá "CLAUDE.md → rules_detail.md."
Isso mantém o corpo principal enxuto, ao mesmo tempo que permite adicionar quantas regras detalhadas você quiser. O ponto é torná-lo um sistema de chamada sob demanda.
CLAUDE.md é a "Entrada e Comandante", e os detalhes são "Arquivos separados chamados sob demanda." Se você se lembrar dessa divisão de papéis, suas regras não entrarão em colapso, não importa o quanto aumentem.
Para ser honesto, não vai se transformar em uma fera diferente de uma só vez
Vou ser honesto aqui.
Eu reorganizei uma bagunça de 300-400 linhas em 5 blocos. Depois disso, a primeira coisa que senti não foi uma "mudança dramática."
Primeiro, ela apenas parou de se perder. Só isso.
O mundo não muda de uma só vez. Ela entra em ação gradualmente. Ela retorna o mesmo movimento para a mesma solicitação, resultados fora do alvo diminuem e o conhecimento se acumula. Antes que você perceba, ela está se movendo como uma fera diferente. É assim que funciona.
Se você espera uma mágica chamativa, ficará desapontado. Mas a reprodutibilidade certamente se acumulará.
Resumo: Para quem acha que fazer tudo é um trabalho chato
Não complique. O que você precisa fazer hoje é abrir seu CLAUDE.md (ou criar um, se não tiver um). Só isso.
Para aqueles que acham que fazer tudo é um trabalho chato, aqui está a lista de prioridades com estimativas de tempo:
- Primeiros 5 min: Escreva 3 perguntas para a ③ Árvore de Decisão (Maior impacto)
- +7 min: Adicione a ① Regra Prioritária e a ② Tabela de Roteamento
- +3 min: Adicione os limites da ④ Tarefa e ⑤ Confidencialidade
Total de 15 minutos. Isso os alinhará na ordem ①→②→③→④→⑤. Se parecer que vai exceder 200 linhas, mova os detalhes para um arquivo separado e faça com que seja lido a partir do topo. Só isso.
Você não precisa sobrecarregar. Apenas organize. Com apenas isso, o mesmo Claude Code que você estava usando ontem começará a se mover como algo completamente diferente.
Pessoas que querem melhorar o desempenho do Claude Code sempre procuram técnicas de prompt. Mas a verdadeira alavancagem está mais acima. É o único arquivo que a IA lê primeiro toda vez.
A diferença entre os 5% melhores e os 95% restantes não é talento ou habilidade em criar prompts. É apenas se eles organizaram um arquivo CLAUDE.md ou o deixaram como estava.
Comece copiando e colando as 3 perguntas da árvore de decisão deste artigo.
Finalmente
Finalmente, deixe-me confessar uma coisa.
Os slides que costumo publicar são todos feitos por IA. Não tenho mais um único slide feito à mão.
E hoje, estou distribuindo a IA que pode fazê-los com exatamente a mesma qualidade.
Se você leu até aqui, provavelmente já percebeu. Tudo o que falei neste artigo se resume a uma coisa:
"Não deixe a IA se perder."
A IA não falha porque sua capacidade é baixa. Ela falha porque está perdida.
Dê a ela contexto. Projete as instruções. Não deixe espaço para a IA duvidar. Em outras palavras, treine-a como uma secretária. Neste artigo, fizemos isso com o Claude Code.
O que estou prestes a distribuir é um ChatGPT GPTs. Só para deixar claro: o texto principal era sobre Claude Code, e isso é um ChatGPT GPTs. As ferramentas são diferentes.
Mas a raiz é a mesma. O que é necessário não é tecnologia. É apenas um design que não deixa a IA se perder.
Este GPTs é um produto finalizado que leva essa filosofia ao limite na única área de "criação de slides." Já terminei todo o trabalho de projetar o contexto.
Eu garanto. Tudo o que você faz é digitar o tema. Depois disso, o GPTs meticulosamente projetado cuspirá slides sem hesitação.
O artigo que primeiro apresentou este GPTs registrou 400.000 impressões. É quantas pessoas reagiram, dizendo "isso é diferente."
https://x.com/masaki_aihack/status/2068646555524223366
E, por tempo limitado, estou distribuindo um pacote de "20 bônus" incluindo este GPTs.
A maneira de recebê-lo é simples. Comece entrando no LINE Open Chat abaixo.
Vou ser honesto: este GPTs não foi concluído de uma só vez. Eu falhei mais de 50 vezes. Levou uma semana para finalmente chegar a um ponto em que "qualquer um pode usá-lo." Estou distribuindo esse manual como está.
Deixe-me dizer mais uma vez. O que é necessário não é tecnologia. É apenas a engenhosidade para não deixar a IA se perder.
Por que não acabar com o cansaço de criar slides hoje?
