O Context Mode é um plugin de terceiros do Claude Code que encaminha alguns resultados grandes por suas próprias ferramentas e mantém um índice local dos eventos da sessão. Um desenvolvedor pode examinar o que chegou à conversa durante uma tarefa. As estatísticas descrevem o tratamento das saídas pelo plugin; os ficheiros alterados e as verificações de aceitação continuam determinando se o trabalho está correto. Este guia segue os ficheiros da versão 1.0.169 do mantenedor e as instruções atuais de plugins do Claude Code, consultados em 20 de outubro de 2026. A BIG CHANGE não instalou o plugin nem executou uma sessão de programação para este artigo.

A grande mudança

  • O que mudou: Um plugin do Claude Code pode interceptar chamadas selecionadas, manter resultados grandes fora da conversa e indexar eventos para recuperação posterior. Confira a versão instalada pelo catálogo e os hooks ativos na sua própria sessão.
  • Por que importa: Em uma tarefa longa, o desenvolvedor pode comparar o registo de saídas encaminhadas com os ficheiros e resultados de testes reais. Isso permite avaliar se a filtragem preservou as evidências necessárias, em vez de aceitar um número de compressão como prova de trabalho útil.
  • O que observar: O decisivo é confirmar o encaminhamento das chamadas previstas no ambiente instalado e o acesso às evidências originais após compactar ou retomar a sessão. O relatório local não comprova cobranças do provedor nem a correção do código.

Antes de instalar

Use uma sessão autorizada de terminal do Claude Code e um repositório que possa alterar. Escolha uma tarefa delimitada com verificação de conclusão conhecida: ficheiros pertinentes, comando existente de teste ou compilação e comportamento a preservar. Para comparar com os controles nativos, nosso guia para examinar o contexto e continuar uma sessão aborda /context e /compact sem este plugin.

No terminal, registe as versões instaladas do Claude Code e do Node.js:

Terminal
claude --version
node --version

O pacote do plugin na revisão fixada exige Node.js 22.5.0 ou posterior. Seu manifesto do Claude Code inicia o servidor MCP com node. Confira se o processo do plugin consegue acessar o Node, abra uma sessão interativa e confirme que /plugin está disponível. Se não estiver, siga as instruções de configuração da sua distribuição do Claude Code; a versão mínima antiga no README não é um teste confiável de compatibilidade com os controles atuais.

Use uma plataforma capaz de executar o hook Bash: macOS, Linux, WSL ou Windows com Git Bash configurado para o Claude Code. O Claude Code funciona no Windows nativo com PowerShell, mas os padrões de hooks na revisão fixada nomeiam Bash, não PowerShell. Esses ficheiros não demonstram encaminhamento automático por uma ferramenta exclusivamente PowerShell.

Obtenha autorização para instalar um plugin de terceiros no ambiente de trabalho. Examine a Elastic License 2.0, os comandos dos hooks e o manifesto do servidor conforme as regras da organização. Segundo o Claude Code, hooks e servidores MCP de plugins executam com os privilégios do utilizador fora da sandbox das ferramentas; aprovar uma chamada do modelo não isola esses processos. O plugin pode processar o repositório e herda acesso aos ficheiros e credenciais do utilizador. O índice local também não significa que prompts e resultados selecionados não cheguem ao provedor do modelo. Consulte os termos de uso de dados da conta antes de usar material sensível.

1. Escolha deliberadamente o âmbito de instalação

Na sessão interativa do Claude Code, digite estes comandos:

Text
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

O segundo comando abre o painel de detalhes do plugin conforme o fluxo atual de instalação do Claude Code. Confira as skills, hooks e servidor MCP listados. Escolha o âmbito local para uma experiência limitada a si neste repositório, salvo autorização mais ampla. O âmbito de utilizador ativa o plugin nos seus projetos; o de projeto, para colaboradores que o instalem. Leia o resumo e o separador Errors de /plugin . Siga a instrução de recarga ou reinicie o Claude Code. Forçar /reload-plugins --force pode invalidar o cache do prompt e gerar um pedido sem cache; use apenas para ativá-lo na sessão atual.

Confirme que o Context Mode aparece no separador Installed de /plugincom o escopo pretendido. Em outro terminal, registe a versão realmente instalada e o estado:

Terminal
claude plugin list

O retrato pesquisado é a versão 1.0.169 no commit do repositório b31c7ee853cb9ea76121e24d368599390972a997; o comando do catálogo não fixa esse commit. Julgue mudanças de comando ou comportamento pela versão efetivamente instalada. A alternativa separada npx do mantenedor fornece somente ferramentas MCP, sem os hooks automáticos do plugin; não equivale a esta instalação.

2. Diagnostique o plugin instalado

Na sessão ativa do Claude Code, execute:

Text
/context-mode:ctx-doctor

Guarde o relatório completo. A skill de diagnóstico na revisão fixada rotula resultados como [OK], [FAIL] e [WARN]. Confira o ambiente de execução, registo de hooks, busca SQLite FTS5, registo do plugin e linhas de versão. Resolva as falhas pela causa indicada. Uma skill ou servidor ausente exige examinar o separador Errors de /plugin e o guia de solução de problemas de plugins do Claude Code. Um diagnóstico aprovado estabelece a configuração; a próxima etapa verifica o encaminhamento real durante o trabalho.

3. Observe o encaminhamento em uma tarefa real

Antes da tarefa, salve objetivo, verificação de aceitação e estado do repositório. Estes comandos ajudam a identificar alterações existentes sem atribuí-las ao plugin:

Terminal
git status --short
git diff --stat

Na sessão do Claude Code, execute /context-mode:ctx-stats e guarde o relatório inicial completo. Faça a tarefa autorizada. Observe os nomes das ferramentas e resultados: leituras, buscas, comandos shell ou chamadas MCP pertinentes usaram ferramentas do Context Mode? É possível recuperar detalhes originais omitidos pelo filtro? Execute o mesmo comando de estatísticas depois:

Text
/context-mode:ctx-stats

A skill de estatísticas relata as saídas da sessão atual por ferramenta. Sem chamadas pertinentes, um relatório vazio não mostra efeito observado do plugin. Guarde os dois relatórios com o registo da tarefa e compare com as chamadas vistas. Números de compressão e duração do mantenedor são exemplos dele, não medições da sua tarefa. Estimativas de tokens ou contexto não são fatura do provedor nem prova de edições corretas. O uso do Claude Code e do modelo segue os termos da conta ou do provedor.

Se a conversa for compactada ou retomada, examine o estado recuperado antes de permitir outra edição. Confira ficheiros, diferenças e comando original de aceitação; recupere os resultados completos necessários para julgar um trecho filtrado. O índice local pode localizar decisões anteriores, mas o estado lembrado não verifica o repositório. Termine executando a verificação real e examinando pessoalmente as diferenças. Registe comando, resultado de saída, ficheiros e falhas não resolvidas. Um relatório pode ser útil quando a tarefa falha; não pode transformar a falha em aprovação.

4. Recupere sem descartar evidências

Se o encaminhamento bloquear uma ferramenta necessária, guarde o erro exato e o diagnóstico e examine o separador Errors de /plugin. Se o problema for o plugin, desative o Context Mode no separador Installed de /plugin, no âmbito que o ativa. Configurações locais, de projeto e de utilizador têm alcances e precedências diferentes. Abra uma nova sessão do Claude Code, confirme a desativação e confira as ferramentas comuns e o estado real da tarefa. Preserve relatórios e saídas originais que expliquem o ocorrido.

Desativar não exclui o índice local. A skill de limpeza do plugin descreve uma operação deliberada e irreversível /context-mode:ctx-purge . O escopo de sessão exige seu ID exato e remove linhas e trechos de busca dessa sessão, preservando outras sessões e estatísticas do projeto. O escopo de projeto remove o conteúdo indexado, todos os eventos de sessões do projeto, ficheiros de eventos e estatísticas. Decida e confirme o escopo somente após preservar as evidências necessárias; nenhuma limpeza é procedimento rotineiro de diagnóstico. /clear e /compact não apagam os dados armazenados pelo Context Mode.

Fontes e leituras adicionais