Chi scrive di tecnologia sa che dopo aver premuto il pulsante «pubblica», si scopre che il mondo nel frattempo è andato avanti senza aspettarti; con la guida pratica a Claude Code quella sensazione non si è presentata una volta sola, ma con la regolarità di un abbonamento mensile, perché ogni volta che pensavo di aver fissato lo stato dell’arte Anthropic rilasciava un modello nuovo, la CLI cambiava versione e qualche comando che avevo descritto con tanta cura decideva, senza avvisare nessuno, di cambiare nome.
A quattro mesi dalla versione 5.1 di giugno è quindi arrivato il momento di presentare la versione 6.1, che non è un ritocco di facciata ma una revisione profonda: il libro è passato da 206 a oltre 300 pagine nel formato 17×24, è stato riletto capitolo per capitolo sulla documentazione ufficiale, è stato allineato a Claude Code v2.1.286 e si è arricchito di sezioni nuove che raccontano come è cambiato, in pochissimo tempo, il modo di lavorare con gli agenti di coding. Resta, come sempre, gratuito e scaricabile senza lasciare indirizzi email, senza scrivere commenti in cambio di un link e senza ritrovarsi iscritti a newsletter mai richieste.
Le nuove sezioni
Quando ho iniziato a pianificare questo aggiornamento pensavo di limitarmi a sistemare qualche tabella e a inserire i modelli usciti durante l’estate, ma è bastato rileggere la versione di giugno con un po’ di distacco per capire che alcuni argomenti, nel frattempo, erano diventati troppo importanti per restare confinati in una nota a margine. Ne sono nate alcune sezioni completamente nuove, che provo a raccontarti in breve senza rovinarti il piacere della lettura.
Modello e harness: che cosa c’è sotto il cofano
La novità a cui tengo di più riguarda una domanda che molti si pongono senza formularla in modo esplicito, cioè che cosa trasformi un modello linguistico in un agente capace di leggere un repository, lanciare i test e correggere i propri errori. La nuova sezione 1.6 risponde distinguendo con chiarezza il modello, che ragiona e scrive, dall’harness, cioè l’impalcatura di tool, permessi, memoria e ciclo agentico che gli permette di agire sul mondo reale; una volta compresa questa distinzione diventa molto più semplice capire perché lo stesso modello possa comportarsi in modo così diverso dentro strumenti diversi.
Su questa base è nato anche il nuovo capitolo 16, che mette Claude Code a confronto con OpenAI Codex, OpenCode e con il resto di un panorama ormai affollatissimo, da Gemini CLI a GitHub Copilot CLI, da Cursor CLI fino ad Aider, usando uno schema di valutazione comune e chiudendo con alcuni criteri pratici per scegliere lo strumento giusto senza lasciarsi guidare soltanto dall’entusiasmo del momento o dall’ultimo thread virale.
Dal prompt engineering al graph engineering
La sezione 1.7 prova a mettere ordine in un vocabolario che negli ultimi mesi si è gonfiato a dismisura, leggendo le cinque «ingegnerie» di cui si parla nei talk e nei post, ovvero prompt, context, harness, loop e graph engineering, non come mode passeggere che si sostituiscono l’una all’altra, ma come strati che si sommano e che aggiungono, ciascuno, un livello di controllo sopra quello precedente. Non mancano i contrappunti, dal vibe coding all’agentic engineering fino allo spec driven development, perché l’obiettivo non è collezionare etichette ma capire quale leva conviene usare in quale momento del lavoro.
I modelli della generazione 5
La sezione 1.5 è stata riscritta come una vera linea temporale dei modelli Claude, con una tabella che va da Opus 4.5 a Sonnet 5.5 e con i default attuali di Claude Code, mentre le schede dettagliate dei singoli rilasci sono state raccolte nel nuovo Allegato D, così chi vuole approfondire trova novità, prezzi e casi d’uso senza appesantire il capitolo introduttivo.
A questa parte si collega la nuova sezione 6.5, dedicata a che cosa togliere e che cosa aggiungere ai prompt quando si lavora con i modelli della generazione 5: alcune abitudini che erano utilissime con i modelli precedenti, come le insistenti richieste di ricontrollare il lavoro, oggi rischiano di produrre un eccesso di verifiche e costi inutili, mentre diventano molto più importanti la definizione del perimetro, i criteri di successo verificabili e la calibrazione dell’effort.
Sicurezza, subagent e sessioni
Il capitolo sulla sicurezza si è arricchito della sezione 9.8 su sandbox e managed settings, che spiega come isolare i comandi eseguiti dall’agente e come un’organizzazione possa imporre regole comuni a tutto il team; il capitolo sui subagent ha guadagnato tre sezioni nuove (12.7, 12.8 e 12.9) su subagent annidati, limiti di concorrenza, scelta del modello e su quella curiosa tendenza di Opus 5 a delegare più del necessario, mentre la sezione 15.13 accompagna il lettore oltre il terminale, tra worktree, sessioni programmate con /loop e routine, Remote Control e sessioni cloud.
Completano il quadro le tabelle dei comandi del capitolo 4, riallineate alla reference ufficiale con una ventina di comandi che mancavano, e un glossario cresciuto di una ventina di voci, utile soprattutto a chi si avvicina per la prima volta a termini come auto mode, agent view o tool search.
Le correzioni
Sarebbe bello poter dire che la versione di giugno era perfetta, ma un libro che descrive uno strumento in continua evoluzione non può esserlo per definizione, e chi sostiene il contrario probabilmente non ha mai riaperto un proprio testo a distanza di qualche mese. Rileggendo la guida con attenzione ho trovato dettagli che nel frattempo erano diventati imprecisi, comandi che erano stati rinominati o rimossi, numeri di versione citati in modo approssimativo e qualche ripetizione di troppo tra capitoli che trattavano argomenti vicini.
Un manuale su uno strumento che cambia ogni settimana non è mai davvero finito: è soltanto aggiornato all’ultima volta in cui qualcuno ha avuto la pazienza di rileggerlo con occhio critico.
Per questo la versione 6 è nata da una revisione integrale, condotta capitolo per capitolo sulla documentazione ufficiale e sul changelog di Claude Code, con una regola editoriale semplice ma rigorosa: l’unica fonte valida per i numeri di versione è il CHANGELOG ufficiale, e quando una funzione non vi compare il libro la descrive senza attribuirle un numero inventato. Due piccoli script controllano ora in automatico i link interni e le versioni citate, così una parte delle sviste che un occhio stanco lascia passare viene intercettata prima della pubblicazione.
C’è poi un aspetto che trovo divertente e, allo stesso tempo, piuttosto istruttivo: buona parte di questa revisione è stata fatta proprio con Claude Code, affidando la rilettura dei singoli capitoli a subagent che lavoravano in parallelo su file distinti e usando un knowledge graph dei capitoli per individuare le sezioni simili, i concetti ripetuti e i fatti che comparivano in più punti con informazioni non coerenti. In altre parole il libro è diventato anche un caso d’uso concreto delle tecniche che descrive, il che mi sembra il modo più onesto di dimostrare che funzionano davvero.
Non entrerò nel dettaglio di ogni correzione, che trovi comunque elencata nel changelog del repository GitHub, ma ci tengo a sottolineare un punto: se nella versione precedente avevi preso per buona un’indicazione che oggi è cambiata, la colpa non è tua e non è nemmeno, del tutto, mia, perché è semplicemente il prezzo da pagare quando si scrive di una tecnologia che corre più veloce della carta.
Da Fable 5 a Opus 5.5
Se c’è un capitolo che racconta meglio di qualunque altro quanto rapidamente stiano cambiando le cose, è proprio quello dedicato ai modelli. Quando a metà giugno ho pubblicato la versione 5.1, Opus 4.8 era uscito da poco più di due settimane e Fable 5 era appena arrivato come nuova classe di modelli sopra Opus, con un listino di 10 dollari per milione di token in ingresso e 50 in uscita che lo collocava chiaramente in una fascia riservata ai compiti più impegnativi.
Nel giro di un’estate la scena è cambiata più volte: a fine giugno è arrivato Sonnet 5, più agentico e meno costoso del predecessore; a luglio Opus 5 si è avvicinato sensibilmente a Fable 5 a metà del prezzo; a settembre è uscito Fable 5.1 e, a pochi giorni di distanza l’uno dall’altro, sono arrivati Opus 5.5, che è diventato il nuovo default di Claude Code lavorando quasi a livello di Fable con un listino ridotto a 4 e 20 dollari, e Sonnet 5.5, più veloce e più parsimonioso nell’uso dei token.
In meno di quattro mesi il modello di default è passato da una generazione all’altra e la distanza tra Opus e la classe superiore si è ridotta al punto che, su molti compiti quotidiani, salire di gradino conviene solo quando le tue verifiche, e non i benchmark degli annunci, dimostrano che il gradino inferiore non basta.
Questa compressione della scala ha conseguenze molto concrete per chi usa Claude Code tutti i giorni, perché cambia il modo in cui si sceglie il modello con /model, il livello di sforzo con /effort e persino il modo in cui conviene scrivere i prompt; a questo si aggiunge il fatto che il prezzo di listino non è più l’unico numero da guardare, dato che tokenizer, sconti sulla cache ed effort di default incidono sul costo reale di una sessione molto più di quanto suggerisca la semplice tariffa per milione di token.
Ecco perché considero l’aggiornamento di un testo come questo non un vezzo da perfezionista, ma una vera responsabilità verso chi lo legge: una guida che continua a indicare i default di giugno, oggi, non è semplicemente un po’ datata, è attivamente fuorviante, perché porta a scegliere modelli più costosi del necessario, a scrivere prompt pensati per comportamenti che i modelli non hanno più e a cercare comandi che nel frattempo hanno cambiato nome. Ho quindi scelto di presentare la cronologia dei modelli come una fotografia datata al 30 settembre 2026, dichiarando apertamente che è destinata a invecchiare e invitando il lettore a riverificare sul sito di Anthropic tutti i dettagli più volatili, dai prezzi ai livelli di effort.
La lezione che ne ricavo, e che attraversa tutto il libro, è che non esiste il modello migliore in assoluto, ma esiste il modello giusto per il compito che hai davanti: oggi questo significa, nella maggior parte dei casi, Opus 5.5 come punto di partenza, Sonnet 5.5 per l’esecuzione e per i subagent di media complessità, Haiku 4.5 per i lavori massivi e meccanici e Fable 5.1 per quei pochi task in cui serve davvero la classe superiore. Fra quattro mesi, con ogni probabilità, questa frase andrà riscritta, e la guida sarà lì per farlo.
Un grazie a chi sostiene il progetto
Quando a maggio ho pubblicato la prima versione della guida non avevo grandi aspettative, se non quella di mettere a disposizione degli sviluppatori italiani un testo pratico, verificato e privo di trappole commerciali; quello che è successo dopo, invece, mi ha sorpreso molto più di qualsiasi rilascio di Anthropic, perché intorno al libro si è formata una piccola comunità di lettori che lo ha scaricato, letto, condiviso, corretto con segnalazioni puntuali e, cosa per nulla scontata, sostenuto anche economicamente attraverso Leanpub.
A tutte queste persone va un grazie sincero, perché ogni segnalazione ha reso il libro un po’ più preciso, ogni condivisione lo ha fatto arrivare a qualcuno che altrimenti non lo avrebbe mai scoperto e ogni contributo su Leanpub ha trasformato in qualcosa di concreto il tempo dedicato a questo aggiornamento, che tra revisioni, verifiche e build ha richiesto molte più serate di quante avessi messo in conto.
La guida resta e resterà gratuita, rilasciata con licenza Creative Commons BY-SA 4.0, quindi puoi scaricarla, stamparla e distribuirla ai tuoi colleghi senza chiedere permesso a nessuno; se però ti è stata utile e vuoi contribuire al prossimo aggiornamento, la pagina Leanpub è il modo più semplice per farlo, e ogni contributo, anche piccolo, si trasforma direttamente in tempo dedicato alla prossima revisione.
Scarica, leggi e condividi
La versione 6.1 della guida pratica a Claude Code è più ampia, più precisa e, soprattutto, più vicina a come si lavora oggi con gli agenti di coding: racconta la differenza tra modello e harness, mette a confronto gli strumenti disponibili, accompagna il lettore nel passaggio ai modelli della generazione 5 e corregge quello che, nel frattempo, era diventato impreciso. Se hai scaricato la versione di giugno vale la pena aggiornarla, e se non l’hai mai letta questo è probabilmente il momento migliore per iniziare.
Puoi scaricare direttamente il PDF, oppure passare da Leanpub se vuoi sostenere il progetto; trovi tutti i dettagli e l’elenco sintetico delle novità anche nella pagina dedicata alla guida, mentre chi vuole approfondire questi temi può proseguire con gli altri articoli delle categorie intelligenza artificiale e formazione.
Se il libro ti è utile, il modo migliore per ringraziarmi è condividerlo con un collega, nel gruppo del tuo team o sul tuo profilo LinkedIn, e se trovi un errore, un comando che nel frattempo è cambiato o un argomento che meriterebbe più spazio, scrivimelo nei commenti oppure apri una segnalazione sul repository GitHub: la prossima versione, che arriverà prima di quanto entrambi immaginiamo, la costruiremo anche così.
