Claude Code · Fable 5.2 · só leitura

Audite seu Claude para o Fable 5.2

O prompt que funcionava no modelo anterior pode atrapalhar agora. Ache as linhas antigas em 5 segundos, com relatório e gráficos.

Banner: Audite seu Claude, pronto para o Fable 5.2
Em resumo

O audite-seu-claude é um programa pequeno em Python que lê a configuração do seu Claude Code (o arquivo CLAUDE.md, as skills, as memórias, os plugins e os scripts) e aponta as instruções escritas para modelos anteriores que agora atrapalham o Claude Fable 5.2. Serve para quem usa o Claude Code no dia a dia e vai trocar de modelo. Ele entrega um relatório com gráficos e uma lista de sugestões; você marca o que aprova e o seu próprio Claude faz só essas correções. Precisa apenas de Python 3: não usa internet e não altera a sua configuração (só grava o relatório onde você mandar).

Vídeo

Os 10 pontos em pouco mais de 2 minutos

O Nei explica o que a Anthropic publicou sobre o Fable 5.2, por que o prompt antigo pode atrapalhar agora e como o kit acha essas linhas.

▶ Assista também a versão vertical (9:16)

O que é

A herança invisível, achada linha por linha

A Anthropic publicou 10 pontos de atenção para o Fable 5.2. Ele segue instruções ao pé da letra, então regras antigas mudam de efeito. O kit transforma esses 10 pontos em verificações automáticas.

Os pontos auditados: recusas, esforço, subagentes, cautela acumulada, relatório com gráficos, correções aprovadas

🔍 Acha o que trava

Pedido de raciocínio no texto (pode dar recusa), "pense menos", orçamento de tokens, ordem de sempre delegar, "nunca" sem motivo, estilo rígido, esforço antigo.

📊 Mostra o peso

Gráficos por ponto, por arquivo e o peso do texto que entra em toda sessão: CLAUDE.md, índice de memória e descrições de skills. Também aponta skills repetidas e memórias velhas.

✅ Você aprova, o Claude corrige

Marque as sugestões e gere o correcoes.md. Ele vira o pedido de correção: um item por vez, com cópia do original. Regra de segurança nunca é apagada.

Como funciona

Três passos, você no meio

O programa só lê. Quem decide o que muda é você; quem edita é o seu Claude, e só o que você aprovou.

varrer.py lê tudo→ relatorio.html com gráficos→ você marca o que aprova→ correcoes.md→ "aplique o correcoes.md"→ roda de novo e compara
Os 10 pontos da Anthropic

O que a página oficial diz, e o que o kit confere

Fonte: Prompting Claude Fable 5.2 (lida em 11/11/2026). Os números são dos testes da própria Anthropic.

1 Esforço

O padrão da API é high. Medium para o dia a dia; xhigh e max só onde você mediu ganho. "Responda sem pensar" não reduz o pensamento: baixe o esforço. Confere: max fixo, xhigh padrão, ajuste copiado de modelo antigo, Fable 5.2 em low/medium.

2 Parada antecipada

Em tarefa longa ele às vezes para antes do fim, mais em low e medium. O texto oficial cortou pela metade as sessões largadas no meio, com +~30% de tokens. Confere: se o seu CLAUDE.md tem esse texto (está em blocos/terminar-tarefa.md). No Claude Code com o Fable 5.2, esse texto já vem ligado de fábrica.

3 Aprovações

Diga a ação ("sim, rode a migração no banco de teste") em vez de "continue". Regra de aprovação deve nomear as ações. Confere: aprovação para "qualquer ação" e claude -p "continue" em script.

4 Dono do código

"Este código é seu" faz ele reorganizar o código: ~1,5x mais tokens e mudanças que ninguém pediu. Use só quando quer isso, e revise o diff. Confere: a frase, como aviso.

5 Silêncio

Ele trabalha calado em sequências longas. O texto oficial faz falar antes da primeira ferramenta, com +~20% de tokens. Confere: se você tem esse texto (blocos/avisar-progresso.md). No Claude Code com o Fable 5.2, o lembrete de silêncio já vem de fábrica.

6 Subagentes

Se o prompt manda delegar, ele delega muito. Revise essas linhas primeiro. Confere: "sempre use subagentes", "agent army", "delegue tudo".

7 Cautela acumulada

Notas e memórias juntam "nunca" e ele obedece tudo. Apague as que perderam o motivo; dê alcance e motivo às outras; liste o que NÃO precisa de aprovação. Confere: "nunca" sem motivo, "nunca tente de novo", ordem absoluta em caixa alta, memórias velhas.

8 Instruções antigas

Tirar: orçamento de tokens no prompt, "pense menos", "trate a resposta anterior como encerrada" (ele para de apontar os próprios erros) e regra rígida de estilo. Confere: os quatro.

9 Relatório final

Peça que escreva para quem não viu o trabalho: o principal primeiro, sem termo inventado. Confere: se você tem esse texto (blocos/relatorio-claro.md).

10 Recusas

Pedir o raciocínio escrito na resposta pode cair no filtro reasoning_extraction e a skill para. Confere: "mostre seu raciocínio passo a passo", "chain of thought" — severidade alta.

O que muda nos prompts

Ele faz o que está escrito, ao pé da letra

Tirando skills e volume, estas são as trocas de prompt que mais mudam o resultado, da maior para a menor. Prompt escrito para o modelo que "interpretava" passa a dar resultado diferente.

Para empresas (sistemas, automações, API)

1 "Mostre seu raciocínio" pode virar recusa

Prompt antigo com "explique passo a passo como pensou" pode voltar como recusa (refusal) em vez de resposta. É o único ponto que quebra produção. Troca: tire a frase; para ver o raciocínio, use o resumo do pensamento da API.

2 O esforço vale mais que o prompt

O padrão é high, que custa mais. "Responda direto, sem pensar muito" não diminui o esforço. Troca: escolha o nível por tarefa (low simples, medium dia a dia, high tarefa longa) e meça. Não copie o ajuste do modelo anterior.

3 Ele para no meio

Mais em low e medium. Em automação é tarefa largada sem erro nenhum. Troca: cole o texto de "termine o trabalho": resolver obstáculo comum sozinho, parar só no bloqueio de verdade e dizer o que falta.

4 Regras velhas viram freio

Anos de "nunca faça X" e "sempre peça aprovação": ele obedece tudo e fica tímido. Troca: dê motivo e alcance a cada regra e escreva o que não precisa de aprovação.

5 "Use subagentes sempre" multiplica o custo

Ele espalha o trabalho em vários agentes. Troca: "quando a tarefa for independente e puder rodar em paralelo".

Para quem conversa com ele

1 Diga a ação, não "continue"

"Sim, rode a migração no banco de teste" funciona melhor que "pode seguir".

2 "Esse código é seu" tem custo

Ele junta código repetido e mexe no que você não pediu, com ~50% a mais de tokens. Use quando quiser reestruturar e revise o diff.

3 Ele trabalha calado

Para acompanhar, peça: "antes de começar, diga em uma linha o que vai fazer".

4 Peça o formato do resumo

"Escreva para quem não acompanhou, o principal primeiro."

E o Opus 5.5? Mudar as regras piora ele?

Não. As trocas acima seguem as boas práticas da Anthropic para os modelos Claude em geral: regra com motivo, ação dita com clareza e pedido de terminar o trabalho também ajudam o Opus. Ele adivinha melhor a intenção, então nele o ganho é menor. O esforço é ajustado por modelo no settings.json (modelSettings), então subir o Fable 5.2 não mexe no Opus. Único efeito: o texto de "termine o trabalho" pode fazer o Opus trabalhar e gastar um pouco mais em tarefa longa. Regra de segurança (API, crédito, apagar, publicar) fica como está nos dois.

Pré-requisitos

Só Python 3 e git

Sem instalar pacote, sem internet, sem chave de API. Funciona em Linux, macOS e WSL.

Python 3.8 ou mais novo

Só a biblioteca padrão.

python3 --version

Claude Code (para aplicar)

O auditor roda sem ele; para aplicar as correções você usa o seu Claude.

claude --version
Guia de uso · passo a passo

Do clone ao Claude corrigido

É a ordem que a Anthropic recomenda: esforço primeiro, depois limpar as instruções, depois medir.

1

Baixe o kit

Uma pasta, um arquivo principal.

git clone https://github.com/inematds/audite-seu-claude.git ~/audite-seu-claude
2

Ponha o Fable 5.2 em high nas tarefas longas

O comando /effort do Claude Code muda o nível de esforço (quanto o modelo pensa). Use antes de uma tarefa grande. Nos robôs com claude -p, passe --effort high.

/effort high
3

Rode a auditoria

Dentro da pasta do projeto. --home também lê o seu ~/.claude (CLAUDE.md global, skills, memórias, plugins).

cd ~/meu-projeto
python3 ~/audite-seu-claude/varrer.py . --home --html relatorio.html --saida-json relatorio.json
# no terminal: total de achados, por ponto e por severidade
4

Abra o relatório e marque o que aprova

Cada sugestão tem um ID (A001, A002…). Filtre por camada — Fable 5.2 (as linhas que mudam o comportamento do modelo) ou volume (peso do contexto, skills repetidas ou sem uso, memórias velhas) — ou por severidade. Clique em gerar correcoes.md: o navegador baixa o arquivo e o texto aparece na tela. Mova o arquivo para a pasta do projeto. Ou gere direto lá pelo terminal, com os IDs:

python3 ~/audite-seu-claude/varrer.py --correcoes A001,A004,A007 --de relatorio.json --saida correcoes.md
5

Peça ao seu Claude para aplicar

Com o correcoes.md na pasta do projeto (o caminho também serve: "aplique o ~/Downloads/correcoes.md"). O cabeçalho do arquivo já diz como: um item por vez, cópia do original em .audite-backup/, regra protegida nunca é apagada, arquivo de plugin não é editado. Vale como aprovação só para essas edições.

# no Claude Code, na pasta do projeto
aplique o correcoes.md
6

Rode de novo e compare

Os achados aplicados somem. Depois rode a sua tarefa mais longa e veja onde ele para, cala ou delega demais. Para cada sintoma, cole o bloco certo de blocos/, um de cada vez.

python3 ~/audite-seu-claude/varrer.py . --home
cat ~/audite-seu-claude/blocos/terminar-tarefa.md # se ele para no meio

Rode também o auditor oficial do Claude Code (versão 2.1.283 ou mais nova). Ele acha o que este kit não procura: arquivo ou comando citado que não existe mais e regras que se contradizem entre arquivos. Este kit cobre o que ele não lê: memórias, textos de plugins, prompts dentro de scripts e bots, o nível de esforço no settings.json e o peso das skills. Use os dois.

# no Claude Code
/doctor prompt-audit
7

Opcional: a skill e o CI

A skill faz os passos 3 a 6 pelo Claude Code. --uso 30 lê os registros das suas sessões (~/.claude/projects/*.jsonl, local) e marca skills que você não usou em 30 dias. --estrito falha o CI se houver achado de severidade alta.

cp -r ~/audite-seu-claude/skill/audite-seu-claude ~/.claude/skills/
python3 ~/audite-seu-claude/varrer.py . --home --uso 30
python3 ~/audite-seu-claude/varrer.py . --estrito  # sai com 1 se houver "alta"
Exemplos

O relatório de um projeto de teste

Gerado a partir de tests/fixtures/sujo, um projeto feito de propósito com uma linha de cada tipo (24 achados). Abra o relatório interativo e teste o botão de gerar o correcoes.md.

Topo do relatório: totais, gráfico por ponto da Anthropic, por severidade e por arquivo
Totais e gráficos: por ponto da Anthropic, por severidade, por arquivo e peso do contexto fixo.
Lista de sugestões com caixas para aprovar, trecho, motivo e o que fazer
Cada sugestão: onde está, o trecho, o motivo (com o número da Anthropic) e o que fazer. Marque e gere o correcoes.md.

Numa máquina de produção com 148 skills carregadas, a primeira auditoria levou 4 segundos e achou: um hook de plugin que manda escrever "telegráfico, em fragmentos" (ponto 8), uma skill de plugin com "se houver 1% de chance, você é obrigado" (ponto 7), nove ordens de delegar sempre (ponto 6) e o Fable 5.2 configurado em medium (ponto 1).

Cuidados e próximos passos

O auditor sinaliza; quem decide é você

A própria Anthropic diz que nem toda instrução antiga precisa sair. Teste cada mudança na sua tarefa real.

Protegida
Regra de segurança fica"Nunca" que fala de API, crédito, apagar, publicar ou senha aparece como protegida: a sugestão é dar alcance e motivo, nunca apagar.
Plugin
Não edite arquivo de pluginA atualização desfaz. Escreva no CLAUDE.md global que aquela regra não vale, ou desligue o plugin.
Dica
Biblioteca de skills: guarde, não apagueSkill que você usa pouco vai para uma pasta fora de ~/.claude/skills, com um INDICE.md (nome, para quê, palavras de busca). Uma linha no CLAUDE.md global manda o Claude procurar lá quando você pedir uma skill que não está carregada. Confira antes se outra skill, script ou timer chama a skill. Na máquina do autor: 148 → 107 skills carregadas e 13,7 mil → 9,6 mil tokens de descrição por sessão. Passo a passo: blocos/biblioteca-skills.md.
Oficial
Dois blocos já vêm no Claude CodeTestes publicados na versão 2.1.322 mostram que, com o Fable 5.2, o Claude Code já liga sozinho o texto de terminar a tarefa e o lembrete quando ele fica calado. Nesse caso, não cole terminar-tarefa.md nem avisar-progresso.md: eles servem para quem chama o modelo pela API ou por programa próprio.
Custo
Os blocos custam tokensTerminar a tarefa: +~30% de saída. Avisar progresso: +~20%. Cole só se você vê o sintoma.
v1.0
Hoje19 regras na camada Fable 5.2, 8 na camada de volume, relatório HTML, correcoes.md, 4 blocos, skill, 19 testes.
Depois
Medir os sintomas nos logsContar nas sessões gravadas quantas vezes o modelo parou no meio, ficou calado ou abriu subagentes, antes e depois das correções.