Il libro gratuito · versione 6.2.2

Guida Claude Code in italiano

Una guida pratica e gratuita per chi vuole iniziare a usare Claude Code in modo professionale: dall’installazione al primo progetto, fino a skill, MCP, subagent e hook.

Nessuna email da lasciare: il PDF si scarica direttamente.

Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code
Copertina della guida Claude Code in italiano di Maurizio Pelizzone
Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code
Una persona con la copia stampata della guida a Claude Code

Otto delle ventuno facce da libro: chi ha ricevuto la copia stampata si è fatto fotografare.

  • 323

    pagine in 17 capitoli e quattro allegati

  • 300+

    volte scaricata dal sito

  • 6.2.2

    versione del 30 ottobre 2026

  • 0

    email da lasciare per averla

A un certo punto mi sono fermato e ho pensato: sto usando uno strumento che serve a fare cose complesse in poco tempo, perché non lo uso per scrivere la guida che nessuno ha scritto bene?

Com’è nata

Negli ultimi mesi ho visto passare parecchi contenuti su Claude Code, quasi tutti di due tipi: video su YouTube che ti spiegano cos’è lo strumento e si fermano lì, utili per i primi dieci minuti finché non capisci di aver guardato un trailer, e post social del tipo «ho preparato una guida completa, lasciami un commento e te la mando», con il solito percorso fatto di commento, messaggio privato, landing page, modulo per l’email e newsletter.

Così, un prompt dopo l’altro, è nato un testo tecnico che aspira a essere la guida Claude Code che avrei voluto leggere io: verificata sulla documentazione ufficiale, senza flag inventati né skill fantasiose raccolte nei thread di Reddit, e senza nulla da lasciare in cambio. La scarichi, la leggi, la stampi e la giri ai colleghi se ti è utile.

Il contenuto

Cosa trovi nei 17 capitoli

La guida segue il percorso di chi parte da zero e arriva a usare Claude Code ogni giorno, ma i capitoli si leggono anche da soli, quando ti serve ritrovare al volo dove si parla di hook o di gestione del contesto.

Capitoli 1-4

Le basi

Cos’è Claude Code e quando conviene, installazione su macOS, Linux e Windows con WSL2, un primo progetto completo su un plugin WordPress e i comandi essenziali.

Capitoli 5-8

Il metodo

Plan Mode, prompt engineering, memoria con CLAUDE.md e Auto Memory, gestione della finestra di contesto.

Capitolo 9

La sicurezza

Permessi, guardrail, sandbox e difesa in profondità per un agente che esegue comandi sul tuo computer.

Capitoli 10-14

Le estensioni

Skill, server MCP, subagent, hook, plugin e mod, con esempi da copiare.

Capitoli 15-17

Pratica e confronto

Workflow per onboarding, bug hunting, refactoring e audit, il confronto con Codex e OpenCode e perché usare la riga di comando e non solo la chat.

Allegati A-D

Gli allegati

Glossario, fonti ufficiali per le verifiche e la linea temporale dei modelli.

Pagina 239 della guida: la sezione 14.8 sui mod
Pagina 240 della guida: che cosa si può modificare con un mod

Le pagine 239 e 240: la sezione sui mod.

Dentro il libro

Le novità della versione 6.2

  • 6.2.2

    30 ottobre 2026

    La più recente

    La revisione critica

    Ho ricontrollato online, una per una, 58 affermazioni tecniche su changelog, documentazione, prezzi e specifica MCP, correggendo quelle superate. Nella stessa passata ho reso più leggibili i passaggi più densi.

  • 6.2

    Fine ottobre 2026

    I mod, /code-review e le parti di un harness

    La guida arriva a 322 pagine e segue Claude Code fino alla v2.1.311.

    • Mod (sezione 14.8): plugin che cambiano Claude Code dall’interno
    • /code-review e /security-review (sezione 4.5)
    • Le parti di un harness (sezione 1.6 e capitolo 16)
  • 6.1

    Inizio ottobre 2026

    Da 206 a oltre 300 pagine

    Allineata ai modelli della generazione 5, con la linea temporale dei modelli, il nuovo capitolo 16 sugli altri agenti di coding, sandbox e managed settings, subagent annidati e sessioni parallele.

#faccedalibro

Facce da libro

A maggio 2026 le prime copie stampate sono uscite dalla legatoria e sono finite in mano a colleghi e amici (e a mia mamma). Ognuno si è fatto fotografare con il libro: le foto sono su Instagram con l’hashtag #faccedalibro.

  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro
  • Una persona con la copia stampata della guida a Claude Code
    #faccedalibro

Come averla

Sullo schermo, su carta, e la prossima versione

PDF · gratuito

0 €

Il PDF, subito

323 pagine in 2,1 MB, formato 17×24. Niente email e niente newsletter: clicchi e lo leggi.

Le copie stampate della guida appena uscite dalla legatoria

Su carta · a prezzo di costo

15 €

La copia stampata

Se preferisci la carta te ne spedisco una copia a 15 euro, che è quello che spendo io tra stampa e spedizione. Stesso contenuto del PDF, formato 17×24, 323 pagine.

Nuove versioni · facoltativo

6.3

Avvisami quando esce la prossima

Claude Code cambia quasi ogni settimana e la guida lo segue: tre versioni solo a ottobre. Scrivimi una mail e ti avviso quando esce la prossima, una mail per versione e basta. Il PDF si scarica comunque, con o senza.

Facoltativo. Nessuna newsletter: mi scrivi tu, e quando vuoi ti tolgo.

I primi trenta minuti

Tutorial: da dove iniziare con Claude Code

Trecento pagine possono spaventare: per questo, prima ancora di scaricare il PDF, ecco il percorso minimo che consiglio a chi apre Claude Code per la prima volta, lo stesso che seguo quando lo presento in azienda.

  1. Installa Claude Code

    Su macOS, Linux e WSL basta curl -fsSL https://claude.ai/install.sh | bash, su Windows, in PowerShell, irm https://claude.ai/install.ps1 | iex; al primo avvio di claude fai il login con il tuo account.

    Alternative ed errori comuni nel capitolo 2 →

    $ curl -fsSL https://claude.ai/install.sh | bash
    PS> irm https://claude.ai/install.ps1 | iex
    $ claude
  2. Apri il progetto giusto

    Entra nella cartella del progetto prima di lanciare claude, perché la directory corrente è il perimetro di lavoro dell’agente: avviarlo dalla home vuol dire mettergli in mano tutto il disco senza dargli alcun contesto utile.

    $ cd il-mio-progetto
    $ claude
  3. Genera il CLAUDE.md con /init

    Il comando analizza il codice e scrive una prima versione del file che Claude rilegge a ogni sessione; poi tocca a te togliere il superfluo e aggiungere le regole che dal codice non si vedono.

    La memoria nel capitolo 7 →

    > /init
  4. Fai esplorare prima di far modificare

    La prima richiesta conviene che sia una domanda, del tipo «analizza la struttura del progetto e spiegami come è organizzato». Per i lavori più corposi c’è /plan, che fa proporre un piano da approvare prima di toccare qualunque file.

    Il primo progetto completo nel capitolo 3 →

    > analizza la struttura del progetto e spiegami come è organizzato
    > /plan
  5. Impara una manciata di comandi

    /clear tra un compito e l’altro, /context per vedere che cosa occupa la finestra di contesto, /model e /effort per scegliere modello e profondità di ragionamento, /rewind per tornare a un punto precedente e claude --continue per riprendere l’ultima sessione.

    Tutti i comandi nel capitolo 4 →

    > /clear
    > /context
    > /model   > /effort
    > /rewind
    $ claude --continue

I lettori

A chi serve

Non serve essere esperti di intelligenza artificiale, serve saper aprire un terminale.

Sviluppatori

Per chi vuole passare dal copia e incolla nella chat a un agente che legge il progetto, esegue comandi e propone modifiche.

Chi guida un team

Per chi deve decidere regole, permessi e convenzioni prima che ognuno si inventi le sue.

Chi fa formazione

Per chi cerca un materiale da distribuire in aula senza problemi di licenza.

La lingua

Perché una guida Claude Code in italiano

Claude Code è uno strumento potente, ma la documentazione, i changelog e la maggior parte dei contenuti seri sono in inglese, e chi legge un concetto nuovo in una lingua che non è la sua spende metà dell’attenzione sulla lingua. Scrivere in italiano mi ha costretto a spiegare ogni concetto invece di ripeterlo, ed è la stessa ragione per cui chi fa formazione nelle aziende italiane preferisce materiale nella lingua del team.

I termini tecnici restano in inglese, perché sono quelli che ritrovi nel terminale e nella documentazione (skill, hook, subagent, Plan Mode), ma ognuno è spiegato la prima volta che compare e raccolto nel glossario in fondo al libro.

Perché è gratis

Vivo di consulenza e formazione, non di libri.

Nella guida c’è quello che spiego nei corsi in azienda e nei percorsi individuali. Scriverla mi è costata parecchie serate, regalarla non mi costa niente: chi la legge impara a usare Claude Code da solo, e chi vuole fare prima con il proprio team sa già come lavoro.

Formazione sull’intelligenza artificiale

Corsi per team e aziende, in presenza o da remoto

Prenota una call conoscitiva

Trenta minuti per capire da dove partire

Scritta con Claude Code, verificata a mano

Ho scritto la guida con l’aiuto di Claude Code, usando lo stesso metodo che racconta: piano prima del codice, istruzioni scritte in un CLAUDE.md, verifiche a ogni passaggio. Ogni affermazione tecnica è controllata sulla documentazione ufficiale e sul CHANGELOG, e a ogni versione la revisione riparte dal primo capitolo.

C’è anche un piccolo esperimento editoriale: la prefazione è una valutazione scritta da Claude Opus 4.7 durante la lavorazione, e la postfazione è firmata da Claude Fable 5, il modello che ha riletto e revisionato il libro.

Licenza, sostegno e segnalazioni

La guida è rilasciata con licenza Creative Commons BY-SA 4.0: puoi stamparla, distribuirla ai colleghi e perfino adattarla, a patto di citare l’autore e di condividere le versioni modificate con la stessa licenza.

Prima di scaricare

Domande frequenti sulla guida

La guida è davvero gratuita?

Sì: il PDF si scarica direttamente da questa pagina, senza lasciare indirizzi email e senza iscriversi a nessuna newsletter. Chi vuole sostenere il progetto può farlo, liberamente, su Leanpub.

Perché è gratuita?

Perché vivo di consulenza e formazione, non di libri. Nella guida c’è quello che spiego nei corsi in azienda e nei percorsi individuali: chi la legge impara a usare Claude Code da solo, e chi vuole fare prima con il proprio team può partire dalla formazione sull’intelligenza artificiale.

Posso avere una copia stampata?

Sì: te ne spedisco una copia a 15 euro, che è quello che spendo io tra stampa e spedizione. Il contenuto è lo stesso del PDF, nel formato 17×24. Per chiederla basta scrivermi dalla pagina Contatti.

Posso stamparla e condividerla con i colleghi?

Certo: la guida è rilasciata con licenza Creative Commons BY-SA 4.0, quindi puoi stamparla, distribuirla e perfino adattarla, a patto di citare l’autore e di condividere eventuali versioni modificate con la stessa licenza.

Che cosa serve per usare Claude Code?

Un computer con macOS, Linux o Windows, un terminale e un account Claude con un abbonamento a pagamento oppure l’accesso alle API di Anthropic: la guida spiega installazione, autenticazione e differenze tra le opzioni nei primi capitoli.

Che cosa contiene e da dove comincio?

Diciassette capitoli che vanno dall’installazione al primo progetto, passando per Plan Mode, prompt engineering, memoria, contesto, sicurezza, skill, MCP, subagent, hook, plugin e confronto tra harness, più quattro allegati; trovi l’elenco completo con una breve sinossi di ogni capitolo nella pagina capitoli e sinossi.

Ogni quanto viene aggiornata?

Claude Code cambia quasi ogni settimana, quindi la guida segue le novità con aggiornamenti periodici: la versione 6.2 di fine ottobre 2026 arriva poche settimane dopo la 6.1, che a sua volta era arrivata quattro mesi dopo la 5.1 di giugno, e le novità di ogni versione sono raccontate sul blog, come nel post sulla versione 6.1.

Ho trovato un errore: come lo segnalo?

Puoi aprire una segnalazione sul repository GitHub oppure scrivermi dalla pagina Contatti: ogni correzione finisce nella versione successiva.

Versione 6.2.2 · ottobre 2026

Scarica la guida Claude Code in italiano

323 pagine, PDF gratuito, nessuna email da lasciare. Se poi vuoi portare Claude Code nel tuo team, ne parliamo in una call di trenta minuti.