TLDR;

O Context Mode é uma camada de virtualização que intercepta dados volumosos antes de entrarem no chat, evitando que ocupem a janela de contexto do agente e reduzindo em até 98% o consumo de tokens. É necessário ter Node.js versão 22.5 ou superior, pois essa versão inclui fallback SQLite que elimina a necessidade de compilar dependências C++ nativas. Após a instalação, execute o comando {slash}context mode:ctx.doctor para verificar se os runtimes, hooks e o banco de busca full‑text estão ativos.

Resumo

Os agentes de IA modernos que manipulam logs de servidor ou arquivos volumosos tendem a inserir esses dados brutos diretamente no histórico da conversa, saturando rapidamente a janela de contexto e provocando “amnésia de contexto”, onde arquivos rastreados, detalhes da tarefa e a intenção do prompt são esquecidos. A solução proposta é o Context Mode, um protocolo de virtualização local (MCP server) que intercepta a carga pesada antes que ela alcance o chat, evitando o inchaço do contexto. Para utilizá‑lo, o ambiente deve rodar Node.js ≥ 22.5, que inclui um fallback SQLite embutido, eliminando a necessidade de compilar dependências C++ e prevenindo incompatibilidades de ABI. A instalação ocorre via marketplace do Claude Code, seguida de reinício do agente e verificação com {slash} context mode:ctx.doctor, que checa runtime, hooks de ciclo de vida e bindings de busca em texto completo. O modo fragmenta dados em diretórios temporários; pode‑se definir uma variável de ambiente para centralizar o banco SQLite, estatísticas e índices, garantindo continuidade entre reinicializações e suportando múltiplos agentes. Em testes, ao contar linhas de código TypeScript, o agente devolve apenas um pequeno payload (< 4 KB) em vez de megabytes de texto, economizando até 98 % dos tokens e preservando o foco no código gerado. É necessário excluir os scripts temporários do watcher do VS Code (files.watcherExclude). Atenção: a ferramenta de diagnóstico pode expor credenciais e o sandbox opera com privilégios totais do host, exigindo higiene operacional e sanitização manual de logs antes de compartilhá‑los. Por fim, o comando {colon} ctx stats mostra tokens economizados e a eficiência do índice local, confirmando que o agente agora pode ingerir bases de código extensas sem perder a memória de contexto.