![Imagem de capa de [Claude Code #10] Guia de diagnóstico de /doctor, /context e /usage](/assets/images/posts/bbb99cc0-928a-48b8-a92b-cab5e3177e7b/claude-code-diagnostics-commands.jpg)
Depois de usar um agente de IA por algum tempo, algumas perguntas acabam surgindo: quanto do contexto já foi preenchido, quanto usei hoje e se alguma configuração não ficou desajustada.
O Claude Code tem comandos de diagnóstico que respondem a essas perguntas uma por uma. Nesta edição, vamos reunir os seis.
Se Claude Code — Parte 9 ensinou como colocá-lo para trabalhar, desta vez vamos aprender a consultar o painel.
/context: quanto do contexto foi preenchido?
/context visualiza o uso atual do contexto em uma grade colorida.
Com base em Documentação oficial de comandos, ele mostra quais ferramentas consomem mais contexto. Também indica se a memória cresceu demais e se apareceu um alerta de capacidade. Adicione all para expandir os detalhes por item.
Também serve para verificar se o CLAUDE.md foi carregado corretamente. Se ele não aparecer na lista Memory files, o Claude não consegue ler o arquivo.
/usage: quanto usei hoje?
/usage mostra o uso de tokens, os custos e o estado do limite do plano com base em Documentação oficial de custos. Digitar /cost abre a mesma tela.
Em um plano de assinatura, use-o para estimar quanto do limite já foi consumido; na cobrança por API, para saber o custo da sessão. Ele também mostra a participação de uso por skill e servidor MCP, facilitando descobrir o que está consumindo o limite.
/status: confirme a identidade da sessão atual
Ao digitar /status, a aba Status da tela de configurações é aberta. Você pode conferir versão, modelo, conta de login e status da conexão em um único lugar.
É a resposta mais rápida quando você se pergunta: “Com qual conta e qual modelo estou trabalhando agora?”. Ele é executado imediatamente, sem interromper uma resposta em andamento.
/doctor: check-up da configuração
/doctor é um check-up completo da instalação e da configuração (apelido: /checkup). Ele pode até corrigir os problemas encontrados.
O escopo da verificação é bastante amplo.
- Instalações duplicadas, problemas no PATH e arquivos de configuração corrompidos
- Skills, servidores MCP e plugins não utilizados, além do custo de contexto de cada um
- Hooks lentos e disponibilidade de uma nova versão
- Sugestões para reduzir um CLAUDE.md longo demais (v2.1.206 ou posterior)
Ele relata primeiro o que encontrou e pede confirmação antes de fazer correções. Fora de uma sessão, digitar claude doctor exibe apenas diagnósticos somente leitura. Vale a pena executá-lo aproximadamente uma vez por mês.
/debug: quando algo dá errado
Se algo estiver funcionando de forma estranha, digite /debug. A partir desse momento, ele ativa os logs de depuração e os lê para rastrear o problema.
Adicionar uma descrição como “A conexão MCP cai o tempo todo” ajuda a direcionar a análise.
/insights: reveja seus padrões de uso
/insights cria um relatório HTML que analisa as sessões recentes deste computador.
Ele aponta como você usa a ferramenta em cada projeto, onde costuma travar e quais recursos vale a pena experimentar. É útil abri-lo de vez em quando para revisar seus próprios hábitos de uso das ferramentas.
Resumo
Agrupando os seis por situação, temos o seguinte.
- Se a dúvida é sobre espaço, use
/context; se é sobre dinheiro,/usage - Se é sobre identidade,
/status; se é sobre saúde,/doctor - Se surgiu um problema,
/debug; para rever seus hábitos,/insights
Na próxima edição, vamos abordar hooks que conectam scripts automaticamente antes e depois da execução de comandos. É o primeiro passo do diagnóstico rumo à automação.
Fontes e critérios de verificação
- Documentação oficial do Claude Code — Commands (Anthropic, verificado em 2026-08-14)
- Documentação oficial do Claude Code — Manage costs effectively (Anthropic, verificado em 2026-08-14)
Continue lendo
Série Claude Code
- Edição anterior: [Claude Code #2] /plan, modo de planejamento: alinhe o design antes de fazer alterações
- Edição anterior: [Claude Code #1] /init: comece gerando o CLAUDE.md automaticamente