Context Inspector: encontre o desperdício de contexto no Claude Code

O Context Inspector é um mod da comunidade de YeonwooSung (my-claude-code-mods) que procura o desperdício de contexto no Claude Code. Ele mantém um registro de tudo o que entra na conversa (prompts, respostas, resultados de ferramentas, anexos) e responde a três perguntas: o que está preenchendo a janela agora, por que a mesma informação volta várias vezes e o que uma compactação manteve ou perdeu.

Ele adiciona uma linha de status como ctx 62% · waste≈8.1k, em que a porcentagem é medida e o desperdício é estimado. Também adiciona três comandos. /context-inspect imprime um relatório de texto com as seções overview, occupants, rereads, similar, compactions, efficiency e advice. /context-pane abre um painel ao vivo. /context-export salva o registro como JSONL, somente metadados.

As análises são específicas. As releituras de um arquivo são classificadas, por exemplo como sem alteração enquanto a cópia anterior ainda está na janela (desperdício puro), após uma edição ou após uma compactação. Saídas de ferramentas quase duplicadas são agrupadas por um SimHash lexical, não por significado. Depois de uma compactação, ele verifica se arquivos editados e lidos, erros e identificadores de usuário ainda aparecem no resumo. O README do autor exige o Claude Code 2.1.287 ou posterior.

A gravação inicia o Claude Code com o mod carregado no pequeno projeto de demonstração e pede ao Claude que leia README.md e diga em uma frase o que é o projeto. Quando o turno termina, o rodapé mostra context-inspector: ctx 4% · waste≈0. Em seguida, executamos /context-inspect. O relatório lista os tokens ativos (cerca de 6,2k em 17 itens), os principais ocupantes por categoria (os anexos de lista de skills, instruções de MCP e ferramentas adiadas), releituras, saídas semelhantes, compactações, eficiência e conselhos. Nesta sessão curta nada foi lido duas vezes, então o desperdício é zero e os conselhos dizem que nada se destaca.

Use qualquer um dos métodos do bloco de instalação; todos instalam diretamente do marketplace do próprio autor. A linha de status aparece depois do próximo início de sessão, quando o primeiro turno é concluído.

O módulo é uma única função register em hooks/register.tsx que envolve os eventos e os repassa sem alteração. Cada passo de registro passa por um auxiliar que engole os próprios erros, então o inspetor não consegue quebrar uma sessão. Uma chamada de ferramenta é registrada antes e depois de executar, e a resposta volta exatamente como chegou:

on('tool.call', async ($, e, next) => {
  const id = e.tool_use_id
  if (id !== undefined) safe(() => ingestToolCall(ledger, id, String(e.tool), e.agentId, e as unknown as Record<string, unknown>))
  const answer = await next(e)
  if (id !== undefined) safe(() => ingestToolResult(ledger, id, answer))
  return answer
}).catch(($, e, next) => next(e))

O trecho é de hooks/register.tsx. As linhas chegam por session.append, os tamanhos medidos das requisições por turn.step e as compactações por session.compact. Depois de cada turno, turn.complete enfileira uma repintura que lê $.session.usage() e escreve a linha de status. O código de análise em hooks/core/ é TypeScript simples com apenas importações locais, e o registro é limitado a 20.000 itens.

/config tem duas opções. outputDir define onde o /context-export grava; vazio significa ~/.claude/context-inspector. toastAdvice (ativada por padrão) mostra um aviso por sessão na primeira vez que aparece uma recomendação de severidade alta. Os comandos aceitam argumentos: /context-inspect advice mostra uma única seção e --agents inclui os subagentes.

Lemos todos os arquivos que o plugin pode executar antes de rodá-lo: o manifesto, hooks/hooks.json, hooks/register.tsx e tudo em hooks/core/, incluindo as regras de mascaramento. Não há package.json, script de instalação, binário nem código empacotado, e as únicas importações são arquivos locais.

• Rede, processos, daemons, telemetria: nenhum. Nada de fetch, nada de comandos de shell, nada que continue rodando depois que o Claude Code fecha.
• Altera a interface: a linha de status, um aviso e o painel. Adiciona comandos: os três acima.
• Observa cada chamada de ferramenta e cada linha por tool.call, session.append, turn.step e session.compact. São hooks de controle, mas cada um devolve sem alteração o resultado do próximo manipulador e tem um .catch de reserva; nada é bloqueado ou reescrito. O validate também observa que hooks de session.compact não rodam em um plugin instalado por uma pessoa quando uma organização gerencia o Claude Code, a menos que a organização o liste nas configurações gerenciadas.
• Gravação de arquivos: somente em /context-export, por $.fs.write, em <outputDir>/<id da sessão>/context-<load>-<n>.jsonl. O padrão fica dentro de ~/.claude, na subpasta do próprio plugin. Ele lê HOME para expandir ~. Os caminhos de arquivo são exportados como estão e os demais alvos são mascarados da melhor forma possível; o autor recomenda revisar as exportações antes de compartilhá-las.
• Influência nos prompts: nenhuma encontrada. Ele não injeta texto em prompts nem em resultados de ferramentas; os conselhos vão só para você.
• Requisitos externos: nenhum. Licença: Apache-2.0, com arquivo LICENSE na raiz do repositório.

O claude plugin validate não relatou erros nem avisos, apenas as observações acima. Os 102 testes do autor passaram no Claude Code 2.1.303.

Verificado com o Claude Code 2.1.303 no macOS (validate e testes). Se a linha de status não aparecer:

• claude --version é 2.1.287 ou posterior.
• Um turno foi concluído; a linha é pintada depois de turn.complete.
• /context-inspect imprime o relatório mesmo sem a linha de status, então serve para conferir se o mod está carregado.
• No painel de chat do VS Code só funcionam os hooks e o texto dos comandos; use /context-inspect.

Limites conhecidos do README: depois de recarregar, retomar ou usar /clear, o registro recomeça, e a sobrevivência à compactação é julgada por correspondência de substring, então o que o resumo parafraseia conta como perdido.