Claude Code e Codex: compact, fork e handoff

La scelta in una frase

Usa /compact quando vuoi continuare lo stesso lavoro con meno rumore. Usa /clear o /new quando il lavoro cambia. Usa /resume quando devi tornare a una sessione salvata. Usa /branch, /fork, /side o /btw quando vuoi una deviazione isolata. Se hai installato la skill, usa /handoff quando una deviazione deve diventare una nuova sessione con abbastanza contesto per partire bene.

• Stesso task, contesto pieno: /compact.
• Nuovo task: /clear o /new.
• Sessione da recuperare: /resume.
• Esperimento laterale: /branch, /fork, /side o /btw.
• Ramo portabile verso un'altra sessione o un altro agente: /handoff.

Compattare non vuol dire cancellare

La compaction non riparte da zero. Riduce la cronologia in una sintesi che l'agente può usare per continuare. È utile quando la conversazione contiene ancora decisioni valide, ma è diventata troppo lunga, costosa o rumorosa. Il rischio è affidare troppo a un riassunto automatico: se una decisione è critica, salvala anche in un file, una issue o una spec.

• Buon uso: dopo ore di debug, prima di una nuova fase dello stesso fix.
• Uso rischioso: prima di cambiare obiettivo senza separare il vecchio lavoro dal nuovo.
• Dettaglio pratico: in Claude Code puoi passare istruzioni a /compact, per esempio il focus da mantenere.
• Dettaglio pratico: in Codex CLI /compact sostituisce i turni precedenti con una sintesi concisa.

Quando usare /compact

Usa /compact quando la sessione è ancora utile ma ingombrante. Il segnale tipico è una conversazione piena di log, letture file, tentativi e correzioni, mentre l'obiettivo non è cambiato. In quel momento non vuoi perdere la direzione: vuoi tenere bug, decisioni, file rilevanti e comando di verifica, lasciando indietro il resto.

• Prima di chiedere una patch finale dopo molta esplorazione.
• Prima di passare da diagnosi a implementazione.
• Prima di far proseguire un goal o un task lungo con meno rumore.
• Con una frase di focus: cosa mantenere, cosa ignorare, quale test conta.

/compact tieni solo: bug riprodotto, file coinvolti, decisioni prese, patch già applicate, test che falliscono e prossimo comando di verifica

Quando usare /clear o /new

Usa /clear o /new quando il lavoro cambia davvero. Se stavi correggendo un bug di login e ora vuoi scrivere una guida, la vecchia cronologia non aiuta: occupa contesto e può portare l'agente verso vincoli non pertinenti. In Claude Code /clear apre una conversazione vuota mantenendo memoria di progetto. In Codex CLI /new avvia una conversazione fresca nella stessa CLI.

• Nuovo task, stessi file di progetto: nuova conversazione.
• Stessa sessione, vecchia ipotesi sbagliata: valuta /clear o un brief pulito.
• Prima di cancellare mentalmente tutto, salva decisioni importanti in un file stabile.

Quando biforcare

Biforcare serve quando vuoi provare una strada senza contaminare quella principale. È diverso da compattare: non riduci il passato, crei uno spazio separato. Claude Code distingue /branch, che ti sposta in una copia della conversazione, e /fork, che affida una direttiva a un subagent in background. Codex CLI usa /fork per clonare la conversazione corrente in un nuovo thread.

• Usa /branch quando vuoi esplorare personalmente una variante e magari tornare indietro.
• Usa /fork quando vuoi delegare una verifica o un approccio alternativo senza fermare la linea principale.
• Usa /side o /btw per domande brevi che non devono entrare nella cronologia principale.
• Non usare una biforcazione per nascondere confusione: se il task è vago, prima chiarisci obiettivo e criteri.

Quando riprendere o riavvolgere

/resume serve a tornare a una sessione salvata. È la scelta giusta quando il lavoro precedente è ancora il punto di partenza e vuoi continuare dalla sua cronologia. /rewind, in Claude Code, entra invece nei casi in cui qualcosa è andato storto: puoi tornare a un checkpoint della conversazione o del codice, oppure riassumere da un punto selezionato.

• Riprendi quando vuoi continuità con una sessione valida.
• Riavvolgi quando una scelta recente ha portato fuori strada.
• Apri una nuova sessione quando la continuità è più dannosa che utile.

Dove entra /handoff

/handoff non è un comando integrato come /compact: è una skill da installare. In Claude Code, dopo l'installazione, puoi invocarla come /handoff. In Codex lo stesso formato SKILL.md è supportato come Agent Skill: la richiami dal selettore /skills o con una mention tramite $. La skill chiede all'agente di scrivere un documento temporaneo che riassume solo il contesto utile, rimanda agli artefatti già esistenti e non include segreti o dati personali.

• Installazione della raccolta: npx skills@latest add mattpocock/skills.
• Obiettivo attuale e definizione di done.
• Stato del lavoro: cosa è già stato fatto e cosa no.
• File, branch, comandi e test rilevanti.
• Decisioni prese e alternative scartate.
• Rischi, permessi, segreti da non includere e prossimi passi.
• Suggested skills: il documento può indicare quali skill usare nella sessione successiva.

npx skills@latest add mattpocock/skills

Workflow consigliato

Il flusso più robusto è semplice: lavora nella sessione finché il contesto resta utile, compatta quando il task è lo stesso ma la cronologia pesa, biforca quando devi esplorare, riparti pulito quando cambi obiettivo, e usa /handoff quando una deviazione merita una sessione propria. Così il contesto resta uno strumento, non un archivio infinito.

• Prima del task: chiarisci obiettivo, file e verifica.
• Durante il task: usa /btw o /side per dubbi laterali.
• Dopo molta esplorazione: usa /compact con focus.
• Per alternative: usa /branch o /fork.
• Prima di chiudere: usa /handoff se il lavoro non è finito.

Domande frequenti