Auditoria de prompts no Claude Code: tutorial do /doctor prompt-audit
Como auditar sua configuração do Claude Code em busca de prompts escritos para modelos antigos: atualize para a 2.1.283, rode /doctor prompt-audit num projeto real, leia o relatório de nove verificações e aprove só as correções que você quiser.
A auditoria de prompts em quatro linhas
- A auditoria de prompts é um subcomando do check-up de configuração /doctor: rode /doctor prompt-audit (ou /checkup prompt-audit) dentro de uma sessão do Claude Code.
- Ela escaneia seus arquivos CLAUDE.md, skills, agentes e comandos em busca de padrões de prompting escritos para modelos antigos, e coloca na frente caminhos obsoletos, comandos obsoletos e arquivos de instruções que se contradizem.
- Ela chegou no Claude Code 2.1.283, então atualize primeiro: uma build antiga responde ao /doctor com um erro de subcomando desconhecido em vez de um relatório.
- O check-up relata primeiro e pergunta antes de mudar qualquer coisa; se você só quer uma passada somente leitura, rode claude doctor no terminal.
Anthropic just dropped the new Checkup command (/doctor)
Canal:Software Engineer Meets AI2:18
Claude Code 2.1.283 — Prompt Audits & Windows Fix
Canal:Claude Code Updates1:02
Claude Code v2.1.283 — Advanced Model Control and Auditing
Canal:Claude Code Changelog2:10
Claude Code changelog — 2.1.283 adds /doctor prompt-audit
Docs:github.com/anthropics/claude-codeChangelog
Claude Code commands reference — /doctor, /checkup and /claude-api
Docs:code.claude.comDocs
As capturas vêm de três gravações. O Software Engineer Meets AI gravou um check-up /doctor completo na v2.1.205; o subcomando prompt-audit e seu escopo foram anunciados na v2.1.283 e usam essa mesma interface de check-up. O Claude Code Updates e o Claude Code Changelog forneceram os quadros do lançamento 2.1.283. Cada quadro foi conferido à mão; os dois quadros de slide foram recortados para remover as marcas d'água dos canais.
As capturas continuam sendo propriedade dos canais acima e são usadas para ilustrar nossas próprias instruções escritas, com cada passo linkado ao seu timestamp.
Rodar a auditoria de prompts do Claude Code, passo a passo
Antes de rodar
- 1
Atualize o Claude Code para a 2.1.283 ou mais recente
Só rode /doctor prompt-audit numa build que tenha o recurso. Confira a versão no terminal com claude --version e atualize com claude update se for anterior à 2.1.283 — a versão que adicionou a auditoria. Dentro de uma sessão, a checagem de versão do próprio /doctor (verificação 6) compara a versão instalada com o seu canal de lançamento.
O Prompt Audit é o primeiro item do lançamento 2.1.283, então uma build sem ele não consegue responder ao comando.Assistir em 0:08 - 2
Entenda por que prompts antigos precisam de auditoria
Instruções escritas para um modelo anterior se acumulam em arquivos de memória, skills, agentes e comandos, e continuam moldando cada sessão muito depois de o modelo para o qual foram ajustadas sumir. A auditoria existe para trazer esses padrões obsoletos à tona e você saber exatamente o que reescrever em vez de chutar.
O card mostra como essas instruções se acumulam: arquivos de memória, skills, agentes e comandos.Assistir em 0:12 - 3
Aprenda o comando exato e o escopo do escaneamento
O comando é /doctor prompt-audit, e /checkup prompt-audit é a mesma coisa, porque /checkup é um alias do /doctor. O escopo é a sua configuração do Claude Code: arquivos CLAUDE.md, skills, agentes e comandos. É um subcomando do check-up de configuração, não um plugin separado nem uma instalação de marketplace.
O slide do lançamento mostra um único argumento num comando que já existe: não há nada para instalar.Assistir em 1:02
Rodar a auditoria numa sessão ativa
- 4
Abra o Claude Code no projeto que você quer auditar
Inicie a sessão na raiz do projeto. A auditoria lê a configuração que aquele projeto realmente carrega, então uma sessão aberta numa pasta acima vai auditar os arquivos CLAUDE.md errados. A linha de cabeçalho confirma o diretório e o modelo antes de você digitar qualquer coisa.
O diretório de trabalho no cabeçalho da sessão é o escopo da auditoria.Assistir em 1:00 - 5
Digite o comando e deixe ele trabalhar em somente leitura
Digite /doctor prompt-audit no prompt. O check-up declara o método antes de começar: ele roda a checagem de saúde em somente leitura primeiro e apresenta um relatório antes de mudar qualquer coisa. Espere vários turnos de leitura de arquivos e comandos de shell enquanto ele reúne evidências — isso é normal, não é travamento.
A promessa de somente leitura vem antes de qualquer proposta: nada é escrito enquanto ele investiga.Assistir em 0:30 - 6
Veja ele reunir fatos para cada verificação
A transcrição mostra a qual verificação cada comando serve: a versão mais recente para a verificação 6, diretórios de skills e configuração de hooks para as verificações de extensões, arquivos CLAUDE.md pequenos para as verificações 2 e 3, e transcrições de sessões recentes para as verificações 1, 4 e 8. Se um hook bloquear um comando, o check-up reformula os fatos de que precisa e tenta de novo em vez de falhar.
Todo comando executado está associado a uma verificação numerada.Assistir em 0:36
Ler o relatório
- 7
Conheça as nove verificações que o relatório pode cobrir
A verificação 0 é a saúde da instalação, a 1 extensões não usadas, a 2 a limpeza de duplicatas na memória LOCAL, a 3 a migração do conteúdo sempre carregado, a 4 hooks lentos, a 5 extensões que pesam no contexto, a 6 a versão, a 7 o modo auto como modo de permissão padrão e a 8 comandos somente leitura negados com frequência. Numa auditoria de prompts, as verificações de arquivos de instruções são as que mais importam: a 2 encontra anotações pessoais que duplicam ou contradizem as diretrizes do time versionadas no repositório, e a 3 tira do contexto sempre ativo as diretrizes raramente necessárias.
As verificações 2, 3 e 5 são as que mexem no CLAUDE.md e em outros arquivos de instruções.Assistir em 1:16 - 8
Leia primeiro a seção "Proposed actions"
"Proposed actions" é a parte do relatório que mudaria arquivos, e cada item nomeia o arquivo editado e se a mudança é reversível. Uma verificação saudável é marcada e encerrada com "No action", então você vê de relance quais das nove encontraram algo e quais não encontraram nada.
Leia o caminho do arquivo em cada proposta antes de decidir — é ali que a edição acontece.Assistir em 0:40 - 9
Leia os avisos e as duas perguntas de confirmação
Abaixo das propostas fica um bloco "Warnings (no action)" para o que a auditoria mediu mas não vai mudar — hooks lentos e extensões que pesam no contexto, com os números medidos para você julgar sozinho. O relatório termina fazendo as perguntas de confirmação em vez de presumir uma resposta.
Avisos são medições, não edições: eles trazem números, não propostas.Assistir em 0:56
Aprovar e repetir
- 10
Aprove, escolha ou recuse antes de qualquer escrita
O check-up termina num menu: "Clean up everything" (recomendado), "Let me pick", "No, keep everything", "Type something" e "Chat about this". A opção recomendada aplica todas as propostas, "Let me pick" percorre a lista item por item, e "No, keep everything" deixa cada arquivo intacto. Nada é aplicado só pelo relatório.
O padrão é uma pergunta, não uma edição — é todo o modelo de segurança.Assistir em 0:52 - 11
Coloque a auditoria num lembrete mensal
A auditoria é barata o bastante para repetir, mas nada no Claude Code vai rodá-la para você num cronograma: /schedule cria uma tarefa na nuvem e /loop só roda enquanto a sessão está viva. A resposta prática é um evento recorrente no calendário lembrando você de rodar de novo — mensalmente, ou depois de um upgrade de modelo que deixe seus padrões antigos obsoletos.
Um lembrete mensal é o único agendador que sobrevive a reinicializações.Assistir em 2:08
As cinco falhas que você realmente vai encontrar
A maioria dos relatos de auditoria de prompts quebrada é um destes casos. Confira na ordem antes de concluir que o comando não existe.
- 1Comando desconhecido ou nenhum item prompt-audit — sua build é anterior à 2.1.283. Rode claude --version, atualize com claude update e depois abra uma sessão nova para a build nova carregar.
- 2/checkup prompt-audit ou /doctor prompt-audit — são o mesmo comando. O /checkup é documentado como alias do /doctor, então qualquer um dos prefixos chega à mesma skill de check-up.
- 3/claude-api prompt-audit é outro subcomando, com outro alvo. Ele audita os prompts, skills e descrições de ferramentas no código da sua própria aplicação com a Claude API e propõe correções como diff; exige Claude Code 2.1.221 ou mais recente, não 2.1.283, e não vai olhar seus arquivos CLAUDE.md.
- 4A auditoria não diz nada sobre seus arquivos de instruções — ou eles são realmente enxutos, ou nunca foram carregados. Rode /context para ver quais arquivos de memória e skills estão de fato no contexto, e confirme que você iniciou a sessão na raiz do projeto.
- 5Você quer uma passada somente leitura sem sessão nenhuma — rode claude doctor no terminal. Ele imprime diagnósticos de instalação e configurações sem iniciar uma sessão, enquanto o /doctor dentro da sessão é a versão que pode propor e aplicar correções.