Claude Code

Una guida pratica per chi vuole iniziare ad usare Claude Code in modo professionale

Una guida pratica a Claude Code, scritta con Claude Code.

Su Claude Code circolano due tipi di contenuti: video YouTube che si fermano ai primi dieci minuti e thread social che promettono "guide complete" in cambio di un'email. Questo libro nasce dall'esigenza opposta: avere finalmente un manuale che spieghi lo strumento per intero, senza hype e senza muri di lead generation.

140 pagine costruite a partire dalla documentazione ufficiale Anthropic, verificate su Claude Code v2.1.123, con esempi reali invece che screenshot da marketing. Si parte dall'installazione su macOS, Linux e Windows, si passa per Plan Mode, CLAUDE.md, gestione del contesto, sicurezza dei permessi, Skill personalizzate, subagent custom, integrazione MCP, e si arriva al prompt engineering aggiornato al 2026 — quello vero, dopo che le formule magiche del 2023 si sono sgonfiate.

Il libro è pensato per due lettori in parallelo: lo sviluppatore senior che vuole integrare Claude Code nel proprio workflow di produzione, e chi si avvicina per la prima volta agli strumenti AI agentici e ha bisogno di una mappa. I capitoli iniziali costruiscono le basi senza dare nulla per scontato; quelli avanzati entrano nei meccanismi che fanno la differenza tra un uso superficiale e uno strategico.

Tre cose che troverai e che altrove fatico a trovare:

Il prompt engineering riletto al 2026. Niente ruoli posticci, niente "agisci come un esperto di...". Le tre leve che contano davvero — istruzioni esplicite, contesto adeguato, esempi curati — applicate al contesto specifico della CLI.
Workflow reali, non demo da slide. Esempi concreti su WordPress e Node.js presi da progetti veri, non da repository giocattolo.

In apertura c'è una prefazione scritta da Claude Opus, a cui ho dato il manoscritto completo chiedendogli un commento onesto, anche dove il libro non funzionava. È rimasta lì come l'ha scritta: è il modo più trasparente che mi sia venuto in mente per inquadrare il libro.

Il libro è gratis — pay-what-you-want con minimo zero. Se ti torna utile e vuoi contribuire, decidi tu quanto. Se non puoi o non vuoi, scarichi e leggi senza pensieri: la licenza Creative Commons BY-SA 4.0 ti permette anche di redistribuirlo e modificarlo, basta citare la fonte e mantenere la stessa licenza.

Maurizio Pelizzone

Una guida pratica a Claude Code, scritta con Claude Code.

Tre cose che troverai e che altrove fatico a trovare:

Il prompt engineering riletto al 2026. Niente ruoli posticci, niente "agisci come un esperto di...". Le tre leve che contano davvero — istruzioni esplicite, contesto adeguato, esempi curati — applicate al contesto specifico della CLI.
Workflow reali, non demo da slide. Esempi concreti su WordPress e Node.js presi da progetti veri, non da repository giocattolo.

This is a book in Italian!

Minimum price

Free!

$6.00

You pay

$6.00

Author earns

$4.30

PDF

About

About the Book

Claude Code è la CLI agentica di Anthropic che vive nel terminale dello sviluppatore:

legge il codice, esegue i comandi, rispetta le convenzioni del progetto.

Questa guida pratica — pensata per chi vuole iniziare a usarla in modo professionale

— copre installazione e setup, comandi quotidiani, Plan Mode, prompt engineering,

gestione del contesto e dei permessi, hook, server MCP, subagent e Skill

personalizzate.

Tutti i contenuti sono verificati sulla documentazione ufficiale Anthropic.

Esempi concreti su PHP, JavaScript e WordPress. Niente hype: ogni capitolo dichiara

dove lo strumento conviene davvero e dove no.

Rivolto a sviluppatori web con familiarità con terminale e Git, professionisti che

vogliono integrare l'AI nel proprio workflow in modo consapevole, e team tecnici

che stanno valutando l'adozione di strumenti AI agentici nei processi di sviluppo.

Share this book

Feedback

Email the Author

Author

About the Author

Maurizio Pelizzone

Mi chiamo **Maurizio Pelizzone**, sono Senior Software Architect, Co-titolare di **Mavida snc** (Torino) dal 2001 e formatore tecnico specializzato nell'ecosistema WordPress. In oltre vent'anni ho progettato e portato in produzione più di 200 progetti web per clienti nazionali, specializzandomi in architetture WordPress enterprise, sviluppo plugin e temi custom, migrazioni di piattaforme legacy e ottimizzazione performance/security. Dal 2010 sono **Speaker ricorrente ai WordCamp italiani** (Milano, Bologna, Torino, WordCamp Italia), con talk su Custom Post Types, Hardening & Security, Solutions Architecture e Full Site Editing. **Dal 2023 ho aggiunto un "superpotere" al mio workflow: l'Intelligenza Artificiale**, usandola come leva strategica per scrivere codice più pulito, scalabile e intelligente. Non come sostituto del mestiere, ma come amplificatore: vent'anni di PHP, WordPress e architetture software mi permettono di distinguere un suggerimento brillante da una scorciatoia rischiosa, e di dirigere l'AI verso soluzioni che reggono il peso della produzione. Oggi affianco alla consulenza tecnica per PMI e aziende nazionali un'attività di **formazione su AI tools, prompt engineering, vibe coding e automazione con N8N**, convinto che la combinazione tra esperienza artigianale del codice e utilizzo consapevole dell'AI sia la direzione in cui il nostro mestiere sta evolvendo. Questa guida nasce da quella convinzione: uno strumento come Claude Code non sostituisce lo sviluppatore, ma cambia il modo in cui lavora. Per usarlo bene servono le stesse virtù di sempre — rigore, curiosità, capacità di verificare — più un po' di disciplina nuova.

Table of Contents

Prefazione
Premessa
- Perché questa guida
- A chi si rivolge
- Cosa troverai
- Cosa non troverai
- Come leggerla
- Come è stata scritta questa guida
- Feedback ed errata corrige

Cos'è Claude Code
1. Una breve storia
2. Claude Code rispetto a Lovable, Replit e altri ambienti AI
3. Quando conviene usarlo
4. La curva di apprendimento
Installazione e setup
1. Piani compatibili
2. Requisiti di sistema
3. Installazione su macOS e Linux
4. Installazione su Windows
5. Installazione via WSL2 (consigliata per Windows)
6. Installazione alternativa via npm (deprecata ma supportata)
7. Verifica dell'installazione
8. Autenticazione
Il primo progetto end-to-end
1. Step 1: Posizionati nella directory del progetto
2. Step 2: Inizializza il progetto
3. Step 3: Rivedi e personalizza CLAUDE.md
4. Step 4: Prima richiesta
5. Step 5: Esci dalla sessione
6. Step 6: Riprendi dove hai lasciato
Comandi e scorciatoie essenziali
1. La sintassi a comandi: perché funziona così
2. Flag CLI essenziali
3. Flag CLI avanzati
4. Slash command: il cuore della sessione interattiva
5. Slash command essenziali
6. Slash command per workflow specifici
7. Scorciatoie da tastiera
8. La sintassi @, !, / — i tre prefissi che cambiano tutto
Plan Mode: pensare prima di scrivere
1. Perché è importante
2. Come attivarlo
3. Strumenti disponibili in Plan Mode
4. Esempio di workflow con Plan Mode
5. opusplan: il modello giusto per la cosa giusta
Prompt engineering: scrivere prompt efficaci
1. Cos'è il prompt engineering e perché conta in CLI
2. Anatomia di un prompt ben fatto
3. Dai ruoli ai vincoli strutturali (la rivoluzione 2026)
4. Le tecniche fondamentali
5. Specificità di Claude Code rispetto alla chat
6. Esempi before/after
7. Anti-pattern comuni
8. Promuovere un prompt: quando va in CLAUDE.md o in custom command
9. Prompt library: archiviare e versionare
Memoria persistente: CLAUDE.md e Auto Memory
1. Generare CLAUDE.md con /init
2. Cosa mettere in CLAUDE.md
3. Esempio 1: Plugin WordPress
4. Esempio 2: Progetto Node/TypeScript generico
5. CLAUDE.md gerarchici
6. Auto Memory: cos'è e cosa cambia
7. Requisiti e abilitazione
8. Dove vivono le memorie
9. Anatomia della cartella memory
10. Auto Memory e subagent
11. Quando disabilitarla
12. CLAUDE.md vs Auto Memory: quando usare cosa
Gestione del contesto
1. Cos'è il contesto e perché conta
2. Cosa pesa nel contesto
3. Segnali di contesto saturo
4. Il comando /context: leggere ed agire
5. Compressione: /compact e /clear
6. Subagent: la strategia strutturale
7. Modelli con finestra 1M token: quando passarci
8. Regola pratica e mentalità
9. Scegliere l'architettura giusta: tabella decisionale
Sicurezza e gestione dei permessi
1. Il sistema dei permessi
2. Configurare i permessi in settings.json
3. Proteggere i segreti
4. Modalità pericolose
5. Prompt injection
Skill: il meccanismo di estensione
1. Come funziona una Skill
2. Skill native incluse — approfondimento
3. Skill della community: una selezione curata
4. Installare e gestire le skill
5. Creare una Skill personalizzata
6. Sicurezza delle skill di terzi
MCP: integrare servizi esterni
1. Cos'è MCP e perché esiste
2. Architettura del protocollo
3. Configurare un server MCP esistente
4. Server MCP utili: una selezione curata
5. Creare un server MCP da zero: pubblicare su WordPress
6. Sicurezza e considerazioni operative
Subagent: orchestrare lavoro specializzato
1. Cosa sono e perché ti servono
2. Subagent vs main agent: la differenza concreta
3. I subagent built-in
4. Creare un subagent custom
5. Gerarchia di precedenza
6. Invocazione automatica vs esplicita
7. Parallelismo: pattern di delega multipla
8. Ottimizzazione costi via model routing
9. Quando NON usarli
10. Subagent, Skill e Hook a confronto
Hook: automatizzare il lifecycle di Claude Code
1. Cosa sono e a cosa servono
2. Anatomia di un hook
3. Eventi del lifecycle
4. Matcher e ispezione (/hooks)
5. Input e output
6. Esempi pratici
7. Sicurezza
8. Gotchas e quando NON usarli
Plugin: pacchetti distribuibili
1. Meccanismi di estensione di Claude Code: una mappa
2. Cos'è un plugin e perché esiste
3. Anatomia di un plugin
4. Plugin marketplace
5. Creare un plugin custom
6. Distribuire un plugin
7. Sicurezza e considerazioni operative
Workflow avanzati e tips
1. Onboarding su un repository esistente
2. Bug hunting con TDD
3. Refactoring sicuro
4. Audit di performance
5. Vim mode
6. Custom slash command
7. Modalità headless per CI/CD
8. Recap delle sessioni
9. Checkpoint Git strategici
10. Fork della conversazione
Conclusioni: perché la CLI e non solo la chat
1. Contesto persistente: smettere di presentarsi ogni volta
2. Autonomia agentica: esegue, non solo suggerisce
3. Integrazione nel workflow reale
4. Quando la chat resta la scelta giusta
5. In sintesi

Allegato A — Glossario
Allegato B — Fonti
Note sull'autore

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub