Hai questi problemi quando usi Claude Code?
・Quando la sessione di Claude Code si allunga, la qualità delle risposte cala per qualche motivo.
・Quali sono i comandi? Non capisco bene le differenze.
・Non riesco a decidere quando usare i subagenti.
・Il contesto è un totale caos.
Proprio ora, un post di Thariq (@trq212), un dipendente di Anthropic, sulla "gestione delle sessioni di Claude Code e il contesto da 1 milione di token" sta diventando virale con 540.000 visualizzazioni 😳
Quindi, per tutti quelli che hanno questi problemi, analizzerò e spiegherò il contenuto in modo semplice 👇
Post originale qui: https://x.com/trq212/status/2044548257058328723?s=20
■ Nozioni di base sulla 𝗳𝗶𝗻𝗲𝘀𝘁𝗿𝗮 𝗱𝗶 𝗰𝗼𝗻𝘁𝗲𝘀𝘁𝗼
Prima di tutto, come prerequisito, la finestra di contesto di Claude Code è di 1 milione di token.
Il contesto include tutto quanto segue:
・Prompt di sistema
・Cronologia delle conversazioni passate
・Tutte le chiamate agli strumenti e i loro output
・Contenuti dei file caricati
In altre parole, più lunga è la sessione, più informazioni si accumulano in questo contesto.
■ Cos'è il 𝗱𝗲𝗰𝗮𝗶𝗺𝗲𝗻𝘁𝗼 𝗱𝗲𝗹 𝗰𝗼𝗻𝘁𝗲𝘀𝘁𝗼?
Un concetto importante qui è il "decadimento del contesto" (context rot).
Man mano che il contesto cresce, l'attenzione del modello viene dispersa su molti token, e le informazioni vecchie o irrilevanti diventano rumore che inizia a interferire con il compito corrente.
Secondo Thariq, il decadimento del contesto si osserva a partire da circa 300.000 a 400.000 token nel modello da 1 milione di token. Tuttavia, non è una regola rigida poiché dipende molto dal compito.
Poiché la finestra di contesto ha un limite massimo, quando ti avvicini al limite, devi riassumere il lavoro precedente e continuare in un nuovo contesto. Questo processo si chiama "compattazione".
■ Ogni turno è un "Punto di Svolta"
Cosa dovrebbe fare Claude Code dopo aver completato un compito? Questo è in realtà il punto decisionale più importante.
Thariq elenca cinque opzioni:
𝟭. 𝗖𝗼𝗻𝘁𝗶𝗻𝘂𝗮
Invia il messaggio successivo nella stessa sessione. La scelta più naturale.
𝟮. /𝗶𝗻𝗱𝗶𝗲𝘁𝗿𝗼 (Doppio tap Esc Esc)
Torna a un messaggio passato e riparti da lì. I messaggi successivi vengono eliminati dal contesto.
𝟯. /𝗰𝗮𝗻𝗰𝗲𝗹𝗹𝗮 (Nuova Sessione)
Riassumi tu stesso le informazioni importanti e avvia una nuova sessione.
𝟰. /𝗰𝗼𝗺𝗽𝗮𝘁𝘁𝗮
Fai riassumere al modello la conversazione finora e continua sulla base di quel riassunto.
𝟱. 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗶
Delega il prossimo blocco di lavoro a un agente con il suo contesto pulito, restituendo solo il risultato alla sessione principale.
■ Quando avviare una nuova sessione
Grazie alla finestra di contesto da 1 milione di token, compiti lunghi come costruire un'app full-stack da zero possono ora essere eseguiti in modo più stabile.
Tuttavia, solo perché c'è spazio nel contesto non significa che dovresti continuare la stessa sessione.
La regola pratica di Thariq è semplice:
🔥 "Se stai iniziando un nuovo compito, dovresti iniziare una nuova sessione."
Ci sono eccezioni. Ad esempio, scrivere la documentazione subito dopo aver implementato una funzionalità. Se inizi una nuova sessione, Claude Code deve rileggere i file che ha appena implementato, il che è lento e costoso. Per compiti come la documentazione che non richiedono "alta intelligenza", è più efficiente accettare un po' di inquinamento del contesto e semplicemente continuare.
■ /𝗶𝗻𝗱𝗶𝗲𝘁𝗿𝗼 è la funzionalità più sottovalutata
Thariq cita "indietro" come la migliore abitudine per una buona gestione del contesto.
In Claude Code, puoi tornare a qualsiasi messaggio passato e ripartire premendo due volte il tasto Esc (o usando il comando /rewind). I messaggi dopo quel punto vengono completamente rimossi dal contesto.
Considera uno scenario specifico:
Claude ha letto cinque file e ha provato un approccio che è fallito.
❌ Reazione normale: "Non ha funzionato. Prova X invece."
→ L'intero registro dell'approccio fallito rimane nel contesto.
✅ Modo migliore: Torna indietro a subito dopo la lettura dei file e dai nuove istruzioni con ciò che hai imparato.
→ "Non usare l'approccio A. Il modulo foo non espone quello. Vai direttamente con B."
In questo modo, i token del tentativo fallito e dell'errore scompaiono, permettendo un nuovo tentativo in uno stato pulito.
Inoltre, usando una funzionalità "riassumi da qui", Claude può riassumere il proprio apprendimento e creare un "promemoria dal sé passato al sé futuro".
■ La differenza critica tra /𝗰𝗼𝗺𝗽𝗮𝘁𝘁𝗮 e /𝗰𝗮𝗻𝗰𝗲𝗹𝗹𝗮
Quando una sessione si allunga, ci sono due modi per ridurre il peso. Sembrano simili ma sono completamente diversi.
【/compact】
・Il modello riassume la conversazione e sostituisce la cronologia con quel riassunto.
・Con perdita — ciò che è importante è lasciato al giudizio di Claude.
・Non devi scrivere nulla, ma Claude potrebbe perdere qualcosa.
・Puoi fornire istruzioni per guidarlo (es., /compact focus on auth refactor, remove test debugging).
【/clear】
・Scrivi tu stesso le informazioni importanti e avvii una nuova sessione.
・Tipo: "L'obiettivo è il middleware di autenticazione, i vincoli sono X, i file correlati sono A e B, l'approccio Y è escluso."
・Richiede impegno, ma il contesto risultante consiste solo di informazioni che hai scelto.
Scegliere tra loro è un compromesso tra controllo e comodità.
■ Perché la 𝗰𝗼𝗺𝗽𝗮𝘁𝘁𝗮𝘇𝗶𝗼𝗻𝗲 fallisce
Quando si usano sessioni lunghe, la qualità della compattazione può diventare estremamente scarsa.
Secondo Thariq, la causa principale di una cattiva compattazione è "quando il modello non riesce a prevedere la direzione del lavoro."
Esempio:
Dopo una lunga sessione di debug, la compattazione automatica viene attivata e riassume l'indagine.
→ Se poi dici "Sistema anche quell'avviso in bar.ts," le informazioni su quell'avviso potrebbero essere state omesse dal riassunto incentrato sul debug.
Ancora più problematico è il dilemma che, a causa del decadimento del contesto, il modello è nel suo "stato di intelligenza più basso" quando esegue la compattazione. In altre parole, il riassunto di qualità più bassa viene generato nel momento in cui è necessario il riassunto più accurato.
Ora che abbiamo un contesto da 1 milione di token, la strategia migliore è eseguire /compact da solo mentre hai ancora spazio, aggiungendo una spiegazione di cosa fare dopo.
■ Quando usare i 𝗦𝘂𝗯𝗮𝗴𝗲𝗻𝘁𝗶
I subagenti sono anche una forma di gestione del contesto.
Quando Claude Code crea un subagente con lo strumento Agent, quel subagente ha la propria finestra di contesto pulita. Fa tutto il lavoro necessario, riassume il risultato e lo restituisce alla sessione principale.
Il criterio è semplice:
👀 "Avrò bisogno di questo output dello strumento più tardi? O basta solo la conclusione?"
Se basta solo la conclusione, dovresti lasciarlo a un subagente.
Claude Code chiama i subagenti automaticamente, ma dare istruzioni esplicite è anche efficace:
・"Avvia un subagente e verifica i risultati del lavoro basandoti su questo file di specifiche."
・"Usa un subagente per leggere e riassumere come il flusso di autenticazione è implementato in un'altra codebase. Usalo come riferimento per implementarlo qui."
・"Usa un subagente per scrivere la documentazione per questa funzionalità dal git diff."
Non portando l'output intermedio nel contesto principale, mantieni il contesto pulito.
■ Riepilogo: 5 Tecniche di Gestione del Contesto
Cose che dovresti sempre decidere prima di inviare il messaggio successivo dopo che Claude ha completato un turno:
- Il compito è cambiato? → /clear per una nuova sessione
- L'approccio è fallito? → /indietro per tornare subito dopo il caricamento del file
- La sessione si sta allungando? → /compact mentre hai spazio (con indicazioni)
- È un compito con molti output intermedi? → Delega a un subagente
- Il contesto può essere usato per compiti correlati? → Continua così
In futuro, Claude stesso aiuterà con queste decisioni, ma per ora, gli utenti che fanno queste valutazioni possono migliorare significativamente la qualità dell'output di Claude Code.
La gestione delle sessioni è sottile, ma è un'abilità che cambia fondamentalmente l'esperienza di Claude Code 🔥
Per chi ha trovato utile questo articolo:
𝗖𝗹𝗮𝘂𝗱𝗲 𝗖𝗼𝗻𝗱𝗲 𝗦𝘁𝘂𝗱𝗶𝗼 @ 𝗝𝗮𝗽𝗮𝗻 (@ClaudeCode_love) è un account gestito da tre appassionati di Claude Code.
Pubblichiamo quotidianamente consigli pratici sull'uso della CLI e sull'automazione.
Attualmente stiamo co-sviluppando un agente AI con un'azienda quotata in borsa.
I nostri contenuti abituali 👇
・Casi reali di sviluppo prodotto usando Claude Code e Claude
・Utilizzo di Claude Code / Vibe Coding / organizzazione delle tendenze di sviluppo
・Ultime informazioni su Claude Code dall'estero
Dalla filosofia di sviluppo al design, all'implementazione e al miglioramento, riassumiamo informazioni dall'estero e primarie per aiutarti a rilasciare prodotti funzionanti, non solo a "finire di crearli".
Se sei interessato, seguici e dai un'occhiata! Ne varrà la pena!
