A maioria das pessoas que usa o Claude Code está ignorando 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ê aprimore seus prompts, os benefícios serão quase zero. A IA vai se desviar toda vez. Você terá que reexplicar premissas toda vez. Mesmo para a mesma tarefa, a qualidade variará de um dia para o outro. A causa não é o modelo ou sua habilidade com 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 desempenho ruim, CLAUDE.md é apenas um "memorando"
Para ser sincero, eu também sofri no começo.
Por um tempo no X, havia muitos artigos dizendo "o conteúdo da pasta é importante" ou "CLAUDE.md é importante." Eu os vi e abri 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.
CLAUDE.md era a mesma coisa. As regras sobre onde salvar o quê não estavam definidas. Eu nem entendia o que era CLAUDE.md. Então, eu ficava adicionando instruções de cima para baixo à medida que pensava nelas.
Como resultado, cresceu para 300 ou 400 linhas. Facilmente ultrapassou 200 linhas.
É recomendado 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, a inconsistência surge. 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 esses cinco elementos:
- ① Regras de Prioridade: A declaração principal a ser seguida antes de qualquer saída
- ② Tabela de Roteamento Palavra-chave → Local: Qual trabalho vai para onde
- ③ Árvore de Decisão para Locais: Como julgar itens que não estão na tabela
- ④ Tratamento 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 "referenciar." A raiz da inconsistência desaparece.
Agora, vamos ver como escrever cada um com exemplos reais.
Configuração ① Declare as "Regras de Prioridade" 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 mover 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 esta 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ê normalmente usa. A IA olha as palavras na tabela e pode 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 ela se perder ← Isso é o mais eficaz
Dos cinco, este tem o maior impacto. Como lidar com coisas que não estão na tabela ou que são ambíguas.
Tanto humanos quanto IAs param quando estão perdidos. Eles se desviam porque estão perdidos. Então, basta eliminar o espaço para hesitação. Deixe-os seguir um caminho SIM/NÃO a partir do topo.
▼ Exemplo de Escrita
Antes de salvar, siga estes passos em ordem: P1. É informação confidencial (chaves de API/senhas)? → SIM: Vá para .env. Fim. P2. São dados brutos baixados de fora? → SIM: Vá para Assets/. P3. Qual é o trabalho? → Vá para um de: Publicação / Vendas / Contabilidade / Registros. → Se um único local não puder ser determinado no 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 Meeting/
- 2ª vez → Memo/Minutes/
- 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 sobre ela.
Mudança 2: Ela para de cometer erros com excesso de confiança quando está perdida.
O comportamento mais assustador da IA é "estar confiantemente errada." 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 entregáveis fora do alvo.
Quanto mais inteligente a IA, melhor ela se sai quando recebe um "modelo" em vez de liberdade total.
Configuração ④ e ⑤ Tratamento 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
Tratamento 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 em .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 devem sair permanecem dentro. Eles funcionam como seus dois escudos defensivos.
Mantenha o CLAUDE.md "com menos de 200 linhas." Se ultrapassar, mova para outro arquivo.
Alguns de vocês podem ter percebido que, se você escrever tudo no CLAUDE.md, ele ficará cada vez mais longo.
Isso está correto. Isso é 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 é menos de 200 linhas.
Se não couber, mova as regras detalhadas para um arquivo separado (por exemplo, "regras_detalhadas.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 "regras_detalhadas.md" apenas ao escrever uma postagem de blog.
O truque aqui é adicionar uma condição como "apenas quando..." em vez de "sempre leia." Dessa forma, a IA não abrirá esse arquivo para tarefas não relacionadas, mas para tarefas necessárias, ela irá "CLAUDE.md → regras_detalhadas.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 para chamar." Se você se lembrar dessa divisão de funções, suas regras não entrarão em colapso, não importa o quanto aumentem.
Para ser sincero, não se tornará uma fera diferente de uma só vez
Vou ser honesto aqui.
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. Isso entra em vigor 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 mágica chamativa, ficará desapontado. Mas a reprodutibilidade definitivamente se acumulará.
Resumo: Para quem acha que fazer tudo é um trabalho árduo
Não pense demais. O que você precisa fazer hoje é abrir seu CLAUDE.md (ou criar um, se não tiver). Só isso.
Para quem acha que fazer tudo é um trabalho árduo, 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 ① Regras de Prioridade e ② Tabela de Roteamento
- +3 min: Adicione ④ Tarefa e ⑤ Limites de 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 totalmente diferente.
Pessoas que querem melhorar o desempenho do Claude Code sempre procuram técnicas de prompt. Mas a verdadeira alavancagem está mais upstream. É 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 com prompts. É apenas se eles organizaram um arquivo CLAUDE.md ou o deixaram de lado.
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 introduziu este GPTs registrou 400.000 impressões. Isso é 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.
Serei honesto: este GPTs não foi concluído de uma 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 o engenho de não deixar a IA se perder.
Por que não acabar com o cansaço de fazer slides hoje?
