lcc 1.2.0 · código aberto · MIT
Compacte o contexto do agente de código sem trocá-lo por um resumo
O lcc corta o que o modelo não precisa, mantém todo o resto byte a byte e gera um recibo. Roda na sua máquina, sem chave de API e sem rede.
/compact vs lcc
O /compact do Claude Code troca a sua sessão por um resumo escrito por um modelo. O resumo perde o erro, o caminho ou a linha exata que o agente vai precisar dois turnos depois. O lcc mantém todas as mensagens e move saídas antigas de ferramentas para um stash local, a um recall de distância.
| /compact | lcc (rules, stashed) | |
|---|---|---|
| Suas mensagens | Reescritas em um resumo | Toda mensagem do usuário e do assistente mantida byte a byte |
| Saídas antigas de ferramentas | Somem | Vão para um stash local, a um recall de distância, com hash conferido |
| Erros, caminhos e valores exatos | Muitas vezes perdidos | Recuperáveis na íntegra |
| Como decide | Um modelo escreve o resumo | Regras determinísticas na sua CPU |
| Rastro de auditoria | Nenhum | Um relatório JSON por passada; lcc explain dá o motivo de cada corte |
Medido, não prometido
São as sessões do próprio mantenedor, medidas offline com contagem exata de tokens o200k_base.
- 22,7%
- de corte mediano de tokens em todas as 266 sessões longas de Claude Code (100+ mensagens cada); metade central de 15% a 32%, melhor caso 65%
- 0
- mensagens perdidas em qualquer dessas sessões
- 172
- pedidos em um teste pré-registrado: contexto stashed com recall empatou com o contexto completo na recuperação de arquivos
- 73% vs 98%
- de valores exatos corretos: resumo estilo /compact vs contexto completo e literal
Instalação
pip install "local-context-compiler[tiktoken]"export CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1claude plugin marketplace add lucasmartins-ai/lccclaude plugin install lcc@lcc --config provider=rules --config rulesMode=stashed
Function hooks estão em acesso antecipado, então o plugin precisa do Claude Code 2.1.274+ e da flag acima. Libere mcp__plugin_lcc_lcc__recall para o agente recuperar saídas removidas. Se uma passada falhar ou remover pouco, o plugin devolve para o resumo nativo e avisa.
Rode em uma das suas sessões
O measure-session roda todos os modos offline e imprime só contagens: mensagens, chamadas de ferramenta, tokens antes e depois, mensagens mantidas. Nenhum texto, caminho ou saída de ferramenta sai da sua máquina.
lcc measure-session <session>.jsonl --markdown