Claude Code per principianti: Il mio resoconto di esperienze

Dopo mesi di scatoloni, JB è finalmente riuscito a rimettersi davanti al suo grande schermo e a ricominciare a programmare. Era così preso da Claude Code che gli ho chiesto di farmi una demo (creare e pubblicare un sito web in meno di 3 minuti) e mi ci sono messa anch’io.

Non sono una sviluppatrice, ma so programmare alla svelta. So cos’è un algoritmo, ho già scritto parecchi script automatici e uso API (= delle “porte d’ingresso” che permettono a un programma di parlare con un altro programma) come quelle di Google o Bing.

Il mio progetto principale: tradurre vecchi libri

Da anni traduco volontariamente libri antichi. Per questo, usavo l’API di Claude (= pagavo Claude a consumo perché traducesse). Costa caro, quindi i miei script non erano molto esigenti e non avanzavo molto velocemente. Sono comunque arrivata a 1 800 pagine tradotte, che rileggevo e correggevo tutte da sola. Quando ho capito cosa poteva veramente fare Claude Code, mi sono rimessa al lavoro.

Claude Code vs ChatGPT: qual è la differenza?

Quando usi ChatGPT o Claude.ai nel tuo browser, ti trovi in un’interfaccia di chat : fai una domanda, l’IA risponde, tutto qui. Non vede nulla di ciò che c’è sul tuo computer. Non può aprire i tuoi file, avviare un programma, modificare un documento. Risponde in una casella di testo, e devi fare tutto da solo dopo. Ha anche una memoria e un contesto limitati su ciò che hai fatto in precedenza.

Claude Code, è completamente diverso. Gira direttamente sul tuo computer, nel terminale (= la finestra nera con del testo che gli sviluppatori usano). E lì, ha le mani in pasta: può leggere e modificare i tuoi file (in una cartella autorizzata), eseguire codice, lanciare comandi, creare cartelle, chiamare API, fare test, … Agisce davvero sulla tua macchina, non solo in una finestra di dialogo.

È la differenza tra qualcuno che ti consiglia dal suo divano per telefono, e qualcuno che è lì in carne e ossa, seduto accanto a te, che può aprire i tuoi cassetti, leggere i tuoi documenti e fare le cose al posto tuo.

Ecco perché lo chiamano un agente : non si limita a rispondere, agisce.

I consigli che mi hanno aiutata

Un amico, Kevin (ti consiglio vivamente di leggere la sua presentazione), mi ha detto che bisognava

1. sfidare l’IA
2. e fargli verificare il suo lavoro a ogni passo.

JB mi ha detto di ricordare regolarmente all’IA di documentare il processo in un file chiamato CLAUDE.md, chiedere se l’IA ha domande, e chiedere all’IA di darmi sempre il suo piano dettagliato prima di eseguire qualsiasi cosa (su Claude si chiama “plan mode“).

Il CLAUDE.md, cos’è?
Sai cos’è un nuovo collega che arriva in un’azienda? Il primo giorno non sa nulla: come lavora il team, le abitudini, le regole non scritte, i progetti in corso. Bisogna spiegargli tutto da capo.
Claude Code è uguale. Di default, a ogni nuova sessione, non ricorda nulla. Tutto ciò che hai fatto insieme, tutte le decisioni prese, tutte le preferenze che gli hai spiegato… scomparso.
Il CLAUDE.md è il file che risolve questo problema. È un semplice file di testo che vive nel tuo progetto, e che Claude rilegge automaticamente ogni volta che si avvia. È la sua memoria permanente. Il suo libretto di benvenuto. Il suo giornale di bordo.

Invece, in ~/.claude/settings.json, bisogna disattivare memory perché memory contiene di tutto e di più e appesantisce inutilmente il contesto.

"autoMemoryEnabled":false

Perché Claude Code cambia tutto per le mie traduzioni

Prima usavo solo l’API, con strumenti limitati. Ora con Claude Code, posso dargli accesso a molti file contemporaneamente: un glossario, esempi di traduzioni, libri .epub sullo stesso argomento. È molto più comodo di prima e la traduzione è molto più qualitativa. Ho letto dei passaggi tradotti a caso e con Claude Code non ho trovato errori.

Il problema: i token

I token sono l’unità che misura ciò che l’IA legge e scrive. È come se si affittasse tempo di cervello. Più testo gli si dà, più se ne consuma, e quindi più costa. E io li esaurisco molto velocemente.

Per i compiti meno complessi, Kevin e JB mi hanno consigliato di usare Deepseek (un modello cinese) con Claude Code (l’interfaccia che parla con il modello, la chiamano una harness, cfr spiegazione sotto). Il modello Deepseek è leggermente meno buono di quelli di Claude, ma è infinitamente più economico (divisione per circa 25). Il rapporto qualità/prezzo è eccezionale. JB e io condividiamo un account a 25/30$ al mese che ci permette di consumare miliardi di token, cosa che sarebbe inaccessibile con i modelli di Claude.

E proprio non avere carenza di token ci rende perfettamente irresponsabili ! Su Deepseek, non si fa mai pulizia nelle conversazioni (/clear, /compact), non si ottimizza nulla. Su Claude, invece, dato che abbiamo solo un abbonamento a 20$/mese ciascuno e che vola via, stiamo molto attenti: ottimizziamo regolarmente, controlliamo i nostri processi per risparmiare token. Le persone come noi stanno inquinando il pianeta, non bene!!!

Claude Code è ciò che si chiama una “harness” (= un’interfaccia, un guscio). Immaginate un robot con le braccia. Le braccia, le pinze, il fatto che afferri oggetti, li sposti, apra cassetti, prema pulsanti… è la harness. È lui che fa le cose concretamente nel mondo reale. Ma la testa, quella che pensa e decide cosa fare con quelle braccia, si può cambiare. Si mette una testa molto intelligente per i compiti complessi, una testa più basilare per quelli semplici. Il corpo del robot rimane esattamente lo stesso, si cambia solo ciò che c’è sulle spalle.

Claude Code è lo stesso. La harness sono le braccia: legge i vostri file, lancia comandi, modifica documenti, gestisce i passaggi uno dopo l’altro. Questo è fisso, non cambia. Ma la testa all’interno, quella che pensa e scrive, si può cambiare! Con un po’ di configurazione tecnica, si può mettere Claude Opus, Sonnet o Haiku ovviamente, ma anche Deepseek, GPT Sol o Gemini. Le braccia rimangono le stesse, si cambia solo la testa. È molto pratico: si mette una testa potente per i compiti complessi (Claude Fable 5), una testa meno costosa per quelli semplici (Deepseek).

Leggere la documentazione tecnica cambia tutto

JB dice sempre che chi legge la documentazione tecnica ha più vantaggi degli altri. E dato che adoro leggere le documentazioni tecniche, le leggo per tutti e due! È così che ho scoperto funzionalità che Claude non offre di default (/skill, sub agents, agent teams) : bisogna chiedergli di fare un audit del processo, e lì ottimizza tutto.

Cosa sono le skills e i sub-agent?

Per impostazione predefinita, quando lavorate con Claude Code, fa tutto da solo, passo dopo passo. È buono, ma non è ottimale.
Le skills (= competenze), sono come delle schede di lavoro che preparate in anticipo. Ad esempio: “quando traduci, ecco esattamente come devi comportarti, ecco il glossario da rispettare, ecco lo stile atteso”. Invece di spiegargli ogni volta, attinge dalla sua scheda e parte direttamente su buone basi. Evita di ripetere le stesse istruzioni e migliora la qualità del risultato.

I sub-agenti (= sotto-agenti), è ancora più potente. Invece di avere un solo Claude che fa tutto, ne hai diversi che lavorano in parallelo, ciascuno su un compito specifico. Un po’ come una squadra. Nel mio caso per le traduzioni è enorme: invece che un solo agente traduca, poi verifichi e poi corregga, ho un agente “traduttore” che traduce e un altro “editor” che rilegge e mette in discussione il lavoro del primo. Il risultato è molto migliore, ed è più veloce.

I diversi modelli

Per le traduzioni, ho sempre amato la qualità di Claude Sonnet 4.6.

Per le grandi verifiche, ho scoperto Claude Fable 5 recentemente e sono super contenta. È veloce, di una precisione chirurgica, e vede oltre ciò che viene richiesto. Consuma enormemente di token per sessione (ogni sessione mi prende l’equivalente di 25$ se si passasse per l’API), ma alla fine risolve i compiti complessi in meno sessioni rispetto agli altri modelli (gli ho lanciato un libro intero e si è accorto delle incoerenze di traduzione ed è in grado di citare 3 punti diversi del libro per giustificare la scelta di una parola al 4° punto). Sono contenta di averlo nel mio abbonamento Claude Pro fino al 22 giugno.

Deepseek V4 Pro riflette troppo velocemente e scrive script di qualità dubbia. Bisogna obbligarlo a riflettere e proporre soluzioni prima di codificare, altrimenti si lancia a capofitto, rompe tutto, e il debug diventa un incubo. Lo uso per i compiti di base (creazione di siti web semplici, script per creare epub).

I miei insegnamenti

Lavorare con l’IA richiede di passare in modalità manager e non in modalità esecutiva. Invece di pensare “come faremo”, devo passare e pensare “quale risultato voglio, non importa come ci arriva” Per esempio per una traduzione: me ne frego che suddivida il mio testo in 2 o in 4, è un problema suo. Il mio problema è avere la migliore traduzione possibile, con uno stile omogeneo dall’inizio alla fine. A lui di arrangiarsi per arrivarci. Le rare volte in cui gli dico cosa fare (“fai uno script Python”, “invialo in batch”), è da micro-management, e si traduce direttamente in inefficienza. Invece di trovare la soluzione tecnica migliore, segue LA MIA soluzione tecnica, che non è necessariamente quella giusta. È come se assumeste un esperto e gli dettaste ogni gesto invece di spiegargli cosa volete ottenere. Sarà sicuramente meno bravo che se gli aveste semplicemente dato l’obiettivo. Si può anche ragionare in modalità processo e team: voglio un traduttore, un secondo che verifichi la qualità della traduzione, un web designer, …

Mi capita ancora di limitarmi da sola dicendomi “oh là là sembra complesso, non glielo chiederò” Grande errore. Devo ricordarmi che non c’è assolutamente nessun limite. Un esempio concreto: voglio proporre dei .epub (= libri digitali) accessibili a tutti. Ma per il mio lettore reMarkable 2 (= un tablet speciale per leggere e prendere appunti), servono epub in un formato un po’ specifico. Se fosse un essere umano a fare questo lavoro, mi sarei sentita in colpa a chiedergli uno sforzo extra solo per lo 0,5% dei lettori. Quindi mi sarei autocensurata. Ma qui è un’IA. Non si stanca, non sospira, non guarda l’orologio. Chiedergli di generare due versioni invece di una non gli costa nulla. Il mio immenso piacere di leggere un ebook perfettamente adattato al mio lettore non è assolutamente un capriccio, è solo un risultato aggiuntivo che avrei avuto torto a non chiedere. La regola che devo applicarmi: se esito a chiedere qualcosa perché “è tanto”, lo chiedo comunque. Con l’IA, si può chiedere la perfezione, a differenza di un umano.

Aggiornamento: mi sono reso conto che mi limito meno quando ho un numero quasi illimitato di token. Quindi se pensi di poter andare oltre, prendi il pacchetto ++ a 200$ solo per un mese per non limitarti e imparare al massimo, poi torna al pacchetto da 20$.

Ho scoperto che si può prendere il controllo dei software già installati sul mio computer tramite riga di comando. Così, invece di fare l’OCR (riconoscimento dei caratteri) tramite IA (e bruciare i token), ho potuto avviare OCR via riga di comando per controllare il software ABBYY. E aggiornare le flashcard con il mio software ANKI. Quindi non è perché uno strumento non ha API/MCP che non si può interagire con esso. Non esitate a dirgli di scansionare i software che avete già, per risparmiare token.

Un’ultima cosa, e la consiglio davvero a tutti: trovate un buddy con cui parlare di Claude Code. Si diventa assolutamente pazzi di fronte a questo strumento, nel senso positivo del termine. Si ha un’irrefrenabile voglia di parlarne con qualcuno. Se quel qualcuno ha già esperienza, è ancora meglio: puoi fargli domande sulle buone pratiche, mostrargli cosa ti ha risposto Claude, chiedergli se è normale. Sono convinta che un’ora di discussione con qualcuno che ha un anno di Claude Code alle spalle ti faccia risparmiare facilmente 3 mesi di test & learn da solo. E poi permette anche di condividere la frustrazione per la mancanza di token. Tra addicts, è molto importante uscire con altri addicts! ahahah

Seriamente, è anche molto utile per seguire le novità. Ci sono così tante cose che escono ogni giorno che è impossibile testare tutto da soli. Se ognuno testa una cosa per conto suo e ne parla agli altri, coprite molto più terreno insieme.

E infine, c’è il FOMO (= Fear Of Missing Out, la paura di perdersi qualcosa, di restare indietro). Questo FOMO è molto reale. Quando si vede a che velocità l’IA permette di avanzare, si ha una sola paura: che il proprio competitore avanzi più velocemente. E questa angoscia può essere davvero compresa solo da chi usa questi strumenti quotidianamente. Quindi sì, trovate il vostro buddy.

Se avete bisogno di demo e casi concreti e più complessi, ecco una presentazione generosamente condivisa da Kevin Richard (nostro amico, che vi consiglio vivamente di seguire su YouTube e X). Questa presentazione è importante perché sveglierà molte persone (almeno ha svegliato me!).