Nova Ferramenta Injeta Instruções no Código do Claude Baseado no Uso de Contexto

Um desenvolvedor frustrado com o Claude Code atingindo limites de contexto durante tarefas criou uma ferramenta que monitora o uso de contexto e injeta instruções personalizadas quando os limites são ultrapassados — permitindo que o Claude aja sobre os avisos antes que seja tarde demais.

O Problema

A compactação automática do Claude Code frequentemente acontece nos piores momentos. O aviso padrão de 20% geralmente chega tarde demais para fazer algo útil, resultando em contexto perdido e fluxos de trabalho interrompidos.

A Solução

A ferramenta cc-context-awareness usa a linha de status e hooks para definir limites de aviso personalizados. A inovação principal: as mensagens são injetadas durante a tarefa (dentro do loop agentico), então o Claude pode realmente agir sobre elas.

Casos de Uso

• Transferências determinísticas — Aos 75% do contexto, o Claude escreve um resumo da sessão em um arquivo de memória, depois sugere /compact. Após a compactação, ele lê o arquivo e continua.
• Avisos graduais — Um leve lembrete aos 60%, um aviso sério aos 80%, e uma parada total aos 95%. Bom para sessões longas com lembretes progressivos.
• Loops de agentes autônomos — Escrever o estado e encerrar aos 50-60% de uso, mantendo-se bem abaixo da "zona burra" onde a qualidade se degrada.
• Tarefas de longo horizonte — Refatorações de múltiplos arquivos, depuração estendida. Fazer checkpoints e concluir antes que a qualidade caia.

Instalação

Instalação em uma linha:

curl -fsSL https://raw.githubusercontent.com/sdi2200262/cc-context-awareness/main/install.sh | bash

A ferramenta é instalada como uma habilidade, então você pode pedir ao Claude para ajudar a configurar limites, alterar estilos da barra e personalizar comportamentos.