Vai al contenuto
Giallo

Claude Opus 5.5 in Claude Code: run lunghe, regole di stop, subagenti

Claude Opus 5.5 in Claude Code: regole in CLAUDE.md, checklist in TASKS.md, subagenti per audit e migrazioni e struttura del resoconto finale.

Redazione: Giallo Studio

Pubblicato il

Aggiornato il

Tempo di lettura: 12 min

Claude Opus 5.5 in Claude Code: run lunghe, CLAUDE.md e subagenti

Con Claude Opus 5.5 il lavoro in Claude Code cambia di natura: il modello porta avanti compiti lunghi, in più passaggi, con poca supervisione — Anthropic parla di run di ore con supervisione minima nei test dei primi utilizzatori. Il tuo lavoro non è più guidarlo un passo alla volta: è scrivere le regole dentro cui può andare avanti da solo, e leggere bene il risultato quando torna.

Questa guida traduce i consigli della guida ufficiale del lancio in tre cose concrete: cosa scrivere in CLAUDE.md, come usare una checklist su file, come dividere il lavoro fra subagenti. Dati verificati il 23 settembre 2026.

In sintesi

  • Dai il compito intero con la linea di arrivo, non il primo passo.
  • In CLAUDE.md metti la regola "continua, fermati solo se…".
  • Tieni una checklist in TASKS.md: sopravvive al riassunto del contesto.
  • Sui lavori grandi usa subagenti, uno per parte, e verifica le loro prove.
  • Chiudi ogni run con tre titoli: Bloccato su di me · Cambiato · Trovato.
  • I permessi sulle azioni distruttive restano attivi: non è autonomia cieca.

Che regola di stop mettere in CLAUDE.md per le run lunghe?

È il pezzo che decide tutto. Senza, il modello si ferma a chiederti conferma a ogni passo e il vantaggio delle run lunghe sparisce. Con una regola troppo larga, fa cose che non vuoi. La formulazione consigliata da Anthropic, tradotta:

"Quando un passo non richiede il mio intervento, continua. Metti le note di stato nello stesso messaggio della prossima azione. Fermati e chiedi solo quando non puoi continuare senza di me, o prima di qualcosa di distruttivo: cancellare dati, forzare un push, o modificare qualcosa fuori da questo repository."

Tre dettagli che contano:

  1. "Note di stato nello stesso messaggio della prossima azione": così il modello non si ferma per raccontarti cosa ha fatto. Racconta e prosegue.
  2. L'elenco esplicito delle azioni distruttive: cancellare, forzare, uscire dal repository. Non "fai attenzione", ma i casi precisi.
  3. I permessi restano attivi. La guida è chiara: tieni le richieste di permesso sulle azioni distruttive. La regola dice al modello quando chiedere, non gli dà carta bianca.

Se invece stai facendo pair programming — lavori insieme, passo per passo — la regola è l'opposto: chiedi un piano di una riga prima di iniziare e un riepilogo breve alla fine. Le due modalità non convivono nello stesso file: scegli in base a come lavori quel giorno.

Come si assegna a Claude Code il compito intero con la linea di arrivo?

Vale quanto in chat, ma in Claude Code pesa di più perché il modello agisce su file veri. L'esempio ufficiale:

"Migra gli endpoint dei pagamenti dal vecchio client al nuovo. Finito vuol dire: ogni endpoint usa il nuovo client, il vecchio client è cancellato, e la suite di test passa. Fermati e chiedimi qualcosa solo se un test fallisce per un motivo che non riesci a spiegare."

Puoi aggiungere istruzioni in corsa — "tieni anche i vecchi nomi come alias" — senza far ripartire la run. E vanno tolte dai prompt tutte le righe sul ragionamento: Opus 5.5 pensa sempre prima di agire. Il dettaglio è in prompt per Claude Opus 5.5.

Perché tenere una checklist in TASKS.md nelle run lunghe?

Nelle run lunghe il contesto viene riassunto, e quello che stava solo in memoria si perde. La soluzione della guida è una checklist su file:

"Tieni una checklist in TASKS.md. Spunta ogni voce quando è fatta, e aggiungi tutto quello che trovi di nuovo."

Il file sopravvive al riassunto, e a fine run è anche il resoconto: cosa era previsto, cosa è stato fatto, cosa è emerso. Per i lavori che attraversano più sessioni è l'unica memoria affidabile.

Come usare i subagenti per i lavori grandi in Claude Code?

Per audit, migrazioni e revisioni su codebase grandi, un modello solo non basta: il contesto si riempie. La guida propone di dividere il lavoro fra subagenti, ciascuno con la sua parte, e di far verificare le prove al modello principale. L'esempio ufficiale, tradotto:

"Controlla ogni servizio in services/ per il bug sui retry descritto nell'issue collegata. Assegna ogni servizio a un suo subagente. Quando un subagente riporta, verifica le sue prove prima di accettarle. Chiudi con una sola tabella: servizio, affetto sì o no, e la prova."

Elemento Perché è lì
Un subagente per servizio Ogni parte ha il suo contesto pulito
"Verifica le sue prove prima di accettarle" I subagenti sbagliano; il principale fa da revisore
"Chiudi con una sola tabella" Il risultato è leggibile in un colpo, non in venti messaggi
Colonna "prova" Un "sì" senza prova non vale niente

Il costo di una run con subagenti è più alto di una run semplice: usali quando il lavoro è davvero grande, non per abitudine. E ricorda che Opus 5.5 costa il 40% in meno di Opus 5 in esercizio, come spiegato in Claude Opus 5.5: cos'è: i conti di sei mesi fa vanno rifatti.

Come leggere il risultato di una run lunga, partendo dai blocchi?

Quando una run lunga finisce, la tentazione è leggere dall'inizio. La guida dice l'opposto: cerca prima le cose per cui Claude ti sta aspettando — decisioni aperte, approvazioni richieste. Per renderlo sistematico, in CLAUDE.md:

"Chiudi ogni run con tre titoli: Bloccato su di me, Cambiato, Trovato."

Il primo titolo è quello che sblocca il lavoro. Il secondo è il diff spiegato. Il terzo è quello che il modello ha notato strada facendo e che non era nel compito: spesso è la parte più preziosa.

Per la revisione del codice prima del merge — con il prompt esatto e il dato sorprendente sul livello di sforzo — vedi revisione del codice con Opus 5.5.

Cosa sono la Fast mode e i messaggi segnalati in Claude Code?

Due cose specifiche di Claude Code da conoscere.

Fast mode (/fast): stesso modello, testo che arriva prima, costo per token più alto, richiede l'utilizzo extra abilitato, in anteprima. Serve per il lavoro a botta e risposta, non per le run lunghe dove nessuno aspetta davanti allo schermo. Quando conviene davvero è in Fast mode di Opus 5.5.

Messaggi segnalati: Opus 5.5 ha filtri più severi, e quando un messaggio viene segnalato Claude Code passa a un modello precedente con un avviso. /model riporta indietro, Esc due volte modifica il messaggio, /config gestisce il cambio automatico, /feedback segnala i falsi positivi. La guida completa è in Claude è passato a un modello precedente.

Come funziona Opus in Claude Code in casi concreti?

Software house, 12 sviluppatori, Padova. Migrazione di un servizio da una libreria HTTP a un'altra, 40 endpoint. Prima: una sessione per endpoint, con conferma a ogni file. Con Opus 5.5 e la regola di stop in CLAUDE.md: un compito solo, "finito vuol dire: ogni endpoint usa il nuovo client, il vecchio è rimosso, i test passano", TASKS.md per la checklist. Il modello si è fermato due volte: entrambe su test che fallivano per motivi che non sapeva spiegare — esattamente la regola.

Team di due persone, agenzia web, Firenze. Audit di sicurezza su 9 siti con lo stesso plugin. Un subagente per sito, tabella finale con sito, vulnerabile sì/no, prova. Tre siti risultati vulnerabili; le prove erano i file e le righe, verificabili a mano in dieci minuti. Senza la colonna "prova" sarebbe stato un elenco di opinioni.

Come scegliere una personalizzazione per il lavoro sul repository?

Il modello e l’ambiente di lavoro risolvono problemi diversi. Un Mod può aggiungere una vista o un controllo alla sessione; non cambia automaticamente la qualità del modello. Per scegliere, separa il momento di installazione, il comportamento della UI e la policy del team.

Esigenza Percorso di approfondimento
Interfaccia, eventi e strumenti Mods di Claude
Dal marketplace alla sessione Installare un Mod
Tre file, una funzione precisa Il primo Mod
Leggere il contesto disponibile Token Weather
Valutare prima di eseguire Blast Radius
Rivedere le modifiche del turno Replay Theater
Due ingressi alla Mods API Comandi e tool
Fixture, tempo e interfaccia Mettere alla prova un Mod
Diagnosi dal sintomo alla causa Il Mod non funziona
Distribuzione e confini di fiducia Mods per il team

Collegare i controlli agli eventi con i Hooks

Un hook interviene su un evento preciso della sessione. Prima di costruirlo, decidi quale prova deve raccogliere e come gestire timeout, errori e reinvocazioni. Questi approfondimenti coprono esigenze distinte:

Esigenza Percorso di approfondimento
Il controllo nel momento giusto Claude Code Hooks
Proteggere file e comandi Prima del tool
Formatter e test, in ordine Dopo la modifica
Notifiche sul tuo computer Quando serve attenzione
SessionStart e compaction Contesto alla ripartenza
Stop hook senza loop Fermarsi con una prova
Un contratto di controllo Hooks via HTTP
Intercettare tool e usare handler Hooks e MCP
Controlli nella delega Hooks e subagent
Matcher, input e log L’hook non parte

Quali errori evitare con le run lunghe di Claude Code?

  • Togliere i permessi sulle azioni distruttive per "andare più veloce". La regola di stop serve a chiedere, non a saltare.
  • Dare il primo passo invece del compito intero. Il modello si ferma a ogni bivio.
  • Definire "finito" in modo non verificabile. "Quando funziona" non è una linea di arrivo; "i test passano" sì.
  • Tenere la checklist solo in chat. Il riassunto del contesto la cancella.
  • Accettare i risultati dei subagenti senza prove. Il principale deve verificare.
  • Usare Fast mode sulle run lunghe. Costa di più e nessuno sta guardando.

Come introdurre Opus in Claude Code nel team aziendale?

Per un team che adotta Opus 5.5 in Claude Code, quattro file e regole condivise:

  1. CLAUDE.md con la regola di stop e l'elenco esplicito delle azioni distruttive del vostro contesto: quali cartelle, quali comandi, quali branch.
  2. I tre titoli di fine run, così ogni sviluppatore legge i risultati nello stesso modo.
  3. TASKS.md per ogni lavoro che dura più di una sessione.
  4. Un prompt condiviso per la revisione pre-merge, da usare prima di ogni pull request.

Se il team lavora anche con altri strumenti, il confronto è in Claude per il codice.

Conclusione

Opus 5.5 in Claude Code non è "più veloce a scrivere codice": è capace di andare avanti da solo dentro regole che scrivi tu. La differenza fra una run che finisce il lavoro e una che ti interrompe venti volte sta in tre file: la regola di stop, la checklist, il formato del resoconto. Il modello fa la sua parte se tu hai fatto la tua.

Se vuoi passare dai test con ChatGPT a un sistema AI integrato nei processi aziendali, Giallo Studio progetta agenti e automazioni su misura.

Metodo e fonti delle guide di Giallo Studio

Vuoi applicarlo alla tua azienda?In 30 minuti, gratis: il processo da automatizzare per primo e il ritorno stimato, per iscritto.

Prenota l’audit gratuito

Come lo applichiamo in azienda

Risorse correlate

Servizi di consulenza AI e automazione dei processi

FAQ

Cosa cambia in Claude Code con Opus 5.5?

Il modello porta avanti compiti lunghi in più passaggi con poca supervisione, e spiega le modifiche in linguaggio piano, per cui le descrizioni delle pull request sono più facili da rivedere. Il lavoro tuo si sposta da guidarlo passo passo a definire regole di stop e linea di arrivo.

Cosa mettere in CLAUDE.md per le run lunghe?

La regola consigliata da Anthropic: quando un passo non richiede il mio intervento, continua; metti le note di stato nello stesso messaggio della prossima azione; fermati solo se non puoi proseguire senza di me o prima di qualcosa di distruttivo, come cancellare dati, forzare un push o toccare qualcosa fuori da questo repository.

A cosa serve TASKS.md?

A tenere una checklist che sopravvive al riassunto del contesto nelle run lunghe. Si chiede al modello di spuntare ogni voce fatta e aggiungere quello che trova strada facendo.

Quando usare i subagenti?

Per lavori grandi su codebase estese: audit, migrazioni, revisioni. Si assegna a ogni subagente una parte, si chiede al modello principale di verificare le prove di ciascuno prima di accettarle, e si chiude con una tabella riassuntiva.

Come si legge il risultato di una run lunga?

Cercando prima le cose per cui Claude ti sta aspettando: decisioni aperte, approvazioni. Per renderlo sistematico si aggiunge a CLAUDE.md: chiudi ogni run con tre titoli, Bloccato su di me, Cambiato, Trovato.

Cos'è Fast mode in Claude Code?

Una modalità che fa arrivare il testo prima, stesso modello, a un costo per token più alto. Si attiva con /fast, richiede l'utilizzo extra abilitato, ed è in anteprima. Serve per il lavoro a botta e risposta, non per le run lunghe.

Applichiamolo

Trasformiamo la guida in un primo flusso live.

Raccontaci quale processo vuoi alleggerire: valutiamo fattibilità, ritorno e primo step operativo.