LeanCTX per Claude Code

Claude Code è brillante.
Il suo conto dei token no.

LeanCTX riduce i costi dei token di Claude Code del 60–90% con strumenti MCP e hook shell: letture compresse consapevoli AST, riletture in cache di ~13 token e output dei comandi più piccoli dell'88–99%. Le sessioni rimangono nitide più a lungo perché la finestra si riempie di segnale anziché di rumore. L'installazione è con un comando: lean-ctx setup.

Il problema

Dove spende Claude Code i tuoi token.

I limiti del piano arrivano nel mezzo del compito

Le lunghe sessioni agentiche consumano i limiti di utilizzo perché ogni lettura di file e chiamata bash vengono inserite grezze nella finestra.

La compattazione perde il filo

Quando la finestra si riempie, la compattazione riassume dettagli che hai ancora bisogno. Poi l'agente rilegge ciò che ha appena dimenticato.

L'output bash domina lo storico

Un singolo test o installazione può costare più token del cambiamento di codice stesso.

L'integrazione

Come LeanCTX si collega a Claude Code.

01

Server MCP nella configurazione Claude

lean-ctx registra il server MCP per Claude Code. Ottieni di default ~13 strumenti lean-core (ctx_read, ctx_search, ctx_shell, …), con l'intero catalogo di 81 strumenti disponibile su richiesta tramite ctx_call / ctx_expand.

02

Guida CLAUDE.md installata

Setup scrive regole di preferenza per gli strumenti in modo che Claude Code cerchi prima letture compresse. Automaticamente, in ogni sessione.

03

Memoria della sessione tra riavvii

Le scoperte, le decisioni e i progressi persistono in uno store di conoscenza locale e vengono ripristinati nelle nuove sessioni: meno spiegazioni da ripetere, meno letture da rifare.

Setup

Un comando. Rilevato automaticamente.

# installa LeanCTX
$ curl -fsSL https://leanctx.com/install.sh | sh
# rilevamento automatico di Claude Code e configurazione MCP + CLAUDE.md
$ lean-ctx setup
# verifica il collegamento
$ lean-ctx doctor
# vedi una sessione salvata
$ lean-ctx gain
Cosa cambia

Tre momenti lo noterai.

La sessione che non si compatta

I dati arrivano 60–90% più piccoli, quindi la finestra si riempie 5–10× più lentamente. I compiti lunghi terminano prima che venga attivata qualsiasi compressione.

La memoria che sopravvive

Domani inizia la sessione sapendo ciò che è stato appreso ieri, ripristinato dallo store di conoscenza locale anziché rileso dal disco.

La ricevuta verificabile

Ogni salvataggio viene registrato in un registro firmato Ed25519. Il guadagno con lean-ctx è un numero che puoi auditare.

FAQ

Claude Code + LeanCTX, risposte.

Come posso ridurre l'utilizzo e i costi dei token di Claude Code?

Esegui lean-ctx setup dopo aver installato LeanCTX. Claude Code ottiene strumenti MCP che comprimono i dati del 60–90%, memorizzano i rilesi a ~13 token e riducono l'output bash dell'88–99%, estendendo tipicamente i limiti di pianificazione di diversi fattori.

LeanCTX interferisce con la gestione del contesto di Claude Code?

No. LeanCTX opera a monte: riduce ciò che entra nella finestra fin dall'inizio, in modo che la compressione venga attivata più tardi o non affatto. I meccanismi interni di Claude Code continuano a funzionare invariati.

Funziona sia con CLI che con l'estensione VS Code?

Sì. Qualsiasi interfaccia di Claude Code che legge la stessa configurazione utilizza lo stesso server MCP, cache e registro.

Posso adattare il contesto a diversi tipi di compiti?

Sì. I Context Personas integrati (coding, research, support, data-analysis, lead-gen) rimodellano l'intera superficie del contesto per dominio: set di strumenti, modalità di lettura, compressione e tassonomia dell'intento. Una sessione di ricerca e una sessione di coding ricevono contesti diversi e ottimizzati dalla stessa installazione. Passa con un'unica impostazione (LEAN_CTX_PERSONA), senza ri-prompting.

Usarlo al lavoro?

Team fornisce a tutta l'organizzazione un piano di contesto condiviso e verificato, e il registro dimostra i risparmi per la finanza. L'uso locale rimane gratuito per sempre, garantito da CI.