Come evitare il Context Window Bloat con Claude Code

Perché il context window è un limite critico

Claude Code conserva nella context window tutta la conversazione, i file letti e i log dei comandi. Quando la quantità di token supera la capacità del modello, le prestazioni calano, le istruzioni iniziali vengono dimenticate e compaiono allucinazioni logiche.

Antipattern più comuni

1. Prompt “kitchen‑sink”

Chiedere all’agente di analizzare l’intero progetto (es. “Esplora tutto il progetto Express e spiegami i JWT”) riempie rapidamente la finestra con testo superfluo.

2. Correzioni successive nello stesso thread

Ripetere richieste di bug‑fix senza azzerare la sessione (es. “l’app crasha, ripara il DB” → “la variabile è indefinita” → “rimuovi il try‑catch”) accumula codice errato e peggiora la memoria attiva.

Strategie operative

Scoping esplicito con l’operatore @

Limita la lettura ai file realmente necessari:

Analizza l’implementazione dei JWT basandoti esclusivamente su @src/auth/jwt.ts e @src/middlewares/auth.middleware.ts

In questo modo la finestra contiene solo i token relativi a quei file.

Reset della sessione

Se l’agente non risolve il problema entro due tentativi, interrompi la conversazione (Esc), esegui /clear e riparti con un prompt preciso che includa solo l’errore corrente.

Sub‑agent per compiti pesanti

Delegare l’esplorazione di dipendenze obsolete a un sub‑agent con contesto isolato mantiene pulito il canale principale:

Usa un sub‑agent per analizzare le dipendenze obsolete in modalità sola lettura e restituisci un report sintetico.

Loop non interattivo con flag -p

Per operazioni su larga scala (migrazioni, refactoring) è più efficace eseguire comandi non interattivi, specificando gli strumenti consentiti:

for file in $(cat legacy_files.txt); do
  claude -p "Migra $file a ES6. Commit e conferma OK." \
    --allowedTools "Edit,Bash(git commit *)"
done

Questo evita di inondare la chat con output di terminale.

Monitoraggio dei token

Usa il comando /context periodicamente per verificare quanti token sono stati consumati e intervenire prima che la finestra si saturi.

Conseguenze pratiche

Applicare queste buone pratiche riduce i tempi di risposta, diminuisce il rischio di allucinazioni e limita i costi legati al consumo di token. Inoltre, una sessione più leggera è più facile da debug‑gare e da mantenere nel tempo.

In sintesi, per mantenere Claude Code efficace è fondamentale controllare la dimensione della context window: prompt mirati, reset puntuali, sub‑agent e comandi batch sono gli strumenti chiave.

Fonti

• HTML.it - sviluppo e AI