Quase todo mundo monta a configuração do Claude Code do mesmo jeito: ele faz alguma coisa irritante, você abre o CLAUDE.md e acrescenta uma regra. Repete isso por seis meses.
O resultado é previsível. Regra escrita para um modelo que já foi aposentado, instrução que aponta para arquivo que não existe mais, duas linhas que mandam fazer o contrário uma da outra. Tudo isso carregando no início de cada sessão e disputando espaço com o seu problema de verdade.
Configuração de assistente é a única parte do seu setup que só cresce. Ninguém nunca apaga uma regra.
A boa notícia é que existe manutenção para isso, e ela cabe em vinte minutos a cada duas semanas.
O comando que resolve exatamente esse problema
Comece por aqui, porque é o menos conhecido dos três e o que ataca a raiz:
/doctor prompt-audit
Ele faz o Claude auditar os seus próprios arquivos de instrução procurando três coisas: instrução escrita para modelo antigo, referência a arquivo ou comando que não existe e arquivos que se contradizem.
Por padrão ele varre CLAUDE.md, CLAUDE.local.md e AGENTS.md, mais as regras, skills, comandos, subagentes e estilos de saída dentro de .claude/ e ~/.claude/. Para auditar só um pedaço, passe o caminho:
/doctor prompt-audit .claude/skills/deploy
Você recebe um relatório com as edições propostas, e nada muda até você mandar aplicar.
Precisa da versão 2.1.283 ou mais nova. Rode claude update antes se fizer tempo que você não atualiza.
A rotina das duas semanas
1. /doctor
Sem argumento nenhum ele roda o checkup completo, e faz bem mais do que a maioria imagina:
- Saúde da instalação, incluindo instalação duplicada, problema de
PATHe arquivo de configuração ilegível - Skills, servidores MCP e plugins que você carrega mas não usa, com o custo de contexto de cada um
- Hooks lentos
CLAUDE.mdlocal duplicando o que já está versionado- Proposta de enxugar o
CLAUDE.mdversionado
A lógica do enxugamento é a melhor parte, e vale adotar como critério seu: ele corta o que o Claude consegue descobrir lendo o código, como estrutura de pastas, lista de dependências e visão geral de arquitetura. E mantém armadilha, justificativa e convenção que difere do padrão da ferramenta.
Essa é a régua. Se a instrução descreve algo que está escrito no repositório, ela está ocupando espaço à toa.
Ele reporta tudo antes e pede confirmação antes de mexer em qualquer coisa.
2. /skill-doctor
Mostra quanto cada skill custa em contexto e com que frequência ela é de fato usada.
É um relatório desconfortável de ler na primeira vez. Quase todo mundo descobre que instalou cinco skills, usa uma, e paga contexto pelas cinco em toda sessão.
Precisa da versão 2.1.252 ou mais nova.
3. /memory
Abre os CLAUDE.md e também as anotações que o Claude escreveu sozinho sobre o seu jeito de trabalhar.
Minha régua aqui é uma pergunta só, feita linha por linha: o Claude ainda precisa disso, e o que acontece se eu apagar?
Os quatro que completam a varredura
Os três acima são o essencial. Estes fecham a conta:
| Comando | O que mostra |
|---|---|
/context | Grade colorida do que está ocupando a janela, com sugestão de otimização |
/mcp | Servidores conectados. Desligue o que não usa, sem perder a configuração |
/permissions | As regras de "não perguntar de novo" que você foi acumulando no piloto automático |
/hooks | Os hooks configurados, para conferir se cada um ainda faz sentido |
Um truque para o /context: rode ele numa sessão recém-aberta, antes de digitar qualquer coisa. O número que aparecer ali é o seu custo fixo, o que você paga em toda conversa antes de começar a trabalhar.
Depois de todo modelo novo
Essa parte quase ninguém faz, e é onde mora o ganho menos óbvio.
Boa parte do que está escrito no seu CLAUDE.md foi escrito para contornar limitação de um modelo que não existe mais. Duas varreduras rápidas:
- Procure maiúscula gritada. "CRITICAL", "YOU MUST", "NEVER EVER", "SEMPRE", "JAMAIS". Modelo novo responde melhor a instrução calma, e a linguagem agressiva herdada costuma produzir excesso de zelo
- Apague os pedidos de autoconferência. Coisas como "confira seu trabalho duas vezes" hoje fazem o modelo gastar turno repetindo verificação que ele já faz sozinho
O teste da deleção
Quando bater a dúvida se uma regra ainda serve, existe um jeito barato de descobrir:
- Escolha a regra suspeita Comece pelas mais antigas e pelas escritas em maiúscula.
- Comente ela Envolva em
<!-- comentário -->em vez de apagar. - Rode
/cleare refaça a tarefa Sessão limpa, mesmo pedido de sempre. - Compare Resultado igual, apague de vez. Resultado pior, você acabou de descobrir que a regra valia e pode até melhorá-la.
A regra dos 200
Um número oficial que vale decorar: arquivo de instrução acima de 200 linhas consome mais contexto e pode reduzir a aderência. Acima de 4 MiB o Claude Code ignora o arquivo inteiro.
A memória automática segue a mesma lógica: só as primeiras 200 linhas, ou 25 KB, entram em cada sessão. O que passa disso você escreveu e não é lido.
Se algum arquivo seu passou do recomendado, aparece aviso na abertura da sessão e no /status.
E quando o arquivo crescer demais, a saída melhor que apagar é mudar de lugar:
Regra que vale sempre
Fica no CLAUDE.md, que carrega em toda sessão.
Regra que vale às vezes
Vira skill, e carrega só quando o assunto aparece.
Regra que vale para certos arquivos
Vai para .claude/rules/ com paths: no cabeçalho, e carrega sob demanda.
Minha conclusão
Monte como calendário, que é mais fácil de cumprir que boa intenção:
- A cada duas semanas
/doctor,/skill-doctore/memory. Vinte minutos. - Quando sair modelo novo Caçar maiúscula gritada e pedido de autoconferência. Quinze minutos.
- A cada trimestre
/doctor prompt-auditpara achar contradição, e/insightspara ver onde as sessões vêm falhando.
O jeito de pensar nisso que me ajudou: cada linha de instrução é um custo fixo que você paga em toda conversa pelo resto do ano. Vale cobrar dela que justifique o lugar.
Fontes. Os comandos e os números vêm da documentação do Claude Code. A estrutura de calendário e o teste da deleção vêm da lista de manutenção da Mariah, que vale ler inteira. O Claude Code muda rápido: confira a versão com claude update antes de concluir que um comando não existe.
Conteúdos relacionados
5 comandos do Claude Code
Os atalhos que resolvem o que você faz na mão.
Ler artigo →
Sites com cara de IA
Dê um sistema de design para a IA seguir.
Ler artigo →Segurança antes de colocar no ar
Dez pontos para a IA revisar antes do deploy.
Ler artigo →Claude Academy: por onde começar
289 recursos, e o caminho curto para o que interessa.
Ler artigo →