- 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
-
1. Cos'è Claude Code
- 1.1 Una breve storia
- 1.2 Claude Code rispetto a Lovable, Replit e altri ambienti AI
- 1.3 Quando conviene usarlo
- 1.4 La curva di apprendimento
-
2. Installazione e setup
- 2.1 Piani compatibili
- 2.2 Requisiti di sistema
- 2.3 Installazione su macOS e Linux
- 2.4 Installazione su Windows
- 2.5 Installazione via WSL2 (consigliata per Windows)
- 2.6 Installazione alternativa via npm (deprecata ma supportata)
- 2.7 Verifica dell'installazione
- 2.8 Autenticazione
-
3. Il primo progetto end-to-end
- 3.1 Step 1: Posizionati nella directory del progetto
- 3.2 Step 2: Inizializza il progetto
- 3.3 Step 3: Rivedi e personalizza CLAUDE.md
- 3.4 Step 4: Prima richiesta
- 3.5 Step 5: Esci dalla sessione
- 3.6 Step 6: Riprendi dove hai lasciato
-
4. Comandi e scorciatoie essenziali
- 4.1 La sintassi a comandi: perché funziona così
- 4.2 Flag CLI essenziali
- 4.3 Flag CLI avanzati
- 4.4 Slash command: il cuore della sessione interattiva
- 4.5 Slash command essenziali
- 4.6 Slash command per workflow specifici
- 4.7 Scorciatoie da tastiera
- 4.8 La sintassi @, !, / — i tre prefissi che cambiano tutto
-
5. Plan Mode: pensare prima di scrivere
- 5.1 Perché è importante
- 5.2 Come attivarlo
- 5.3 Strumenti disponibili in Plan Mode
- 5.4 Esempio di workflow con Plan Mode
- 5.5 opusplan: il modello giusto per la cosa giusta
-
6. Prompt engineering: scrivere prompt efficaci
- 6.1 Cos'è il prompt engineering e perché conta in CLI
- 6.2 Anatomia di un prompt ben fatto
- 6.3 Dai ruoli ai vincoli strutturali (la rivoluzione 2026)
- 6.4 Le tecniche fondamentali
- 6.5 Specificità di Claude Code rispetto alla chat
- 6.6 Esempi before/after
- 6.7 Anti-pattern comuni
- 6.8 Promuovere un prompt: quando va in CLAUDE.md o in custom command
- 6.9 Prompt library: archiviare e versionare
-
7. Memoria persistente: CLAUDE.md e Auto Memory
- 7.1 Generare CLAUDE.md con /init
- 7.2 Cosa mettere in CLAUDE.md
- 7.3 Esempio 1: Plugin WordPress
- 7.4 Esempio 2: Progetto Node/TypeScript generico
- 7.5 CLAUDE.md gerarchici
- 7.6 Auto Memory: cos'è e cosa cambia
- 7.7 Requisiti e abilitazione
- 7.8 Dove vivono le memorie
- 7.9 Anatomia della cartella memory
- 7.10 Auto Memory e subagent
- 7.11 Quando disabilitarla
- 7.12 CLAUDE.md vs Auto Memory: quando usare cosa
-
8. Gestione del contesto
- 8.1 Cos'è il contesto e perché conta
- 8.2 Cosa pesa nel contesto
- 8.3 Segnali di contesto saturo
- 8.4 Il comando /context: leggere ed agire
- 8.5 Compressione: /compact e /clear
- 8.6 Subagent: la strategia strutturale
- 8.7 Modelli con finestra 1M token: quando passarci
- 8.8 Regola pratica e mentalità
- 8.9 Scegliere l'architettura giusta: tabella decisionale
- 8.10 Prompt cache e osservabilità del consumo
-
9. Sicurezza, permessi e guardrail
- 9.1 I guardrail di Claude Code: difesa in profondità
- 9.2 Il sistema dei permessi
- 9.3 Configurare i permessi in settings.json
- 9.4 Proteggere i segreti
- 9.5 Modalità pericolose
- 9.6 Prompt injection
- 9.7 I test come guardrail di correttezza
-
10. Skill: il meccanismo di estensione
- 10.1 Come funziona una Skill
- 10.2 Skill native incluse — approfondimento
- 10.3 Skill della community: una selezione curata
- 10.4 Installare e gestire le skill
- 10.5 Creare una Skill personalizzata
- 10.6 Sicurezza delle skill di terzi
-
11. MCP: integrare servizi esterni
- 11.1 Cos'è MCP e perché esiste
- 11.2 Architettura del protocollo
- 11.3 Configurare un server MCP esistente
- 11.4 Server MCP utili: una selezione curata
- 11.5 Creare un server MCP da zero: pubblicare su WordPress
- 11.6 Sicurezza e considerazioni operative
- 11.7 Gestire il costo dei server MCP sul contesto
-
12. Subagent: orchestrare lavoro specializzato
- 12.1 Cosa sono e perché ti servono
- 12.2 Subagent vs main agent: la differenza concreta
- 12.3 I subagent built-in
- 12.4 Creare un subagent custom
- 12.5 Gerarchia di precedenza
- 12.6 Invocazione automatica vs esplicita
- 12.7 Parallelismo: pattern di delega multipla
- 12.8 Ottimizzazione costi via model routing
- 12.9 Quando NON usarli
- 12.10 Subagent, Skill e Hook a confronto
-
13. Hook: automatizzare il lifecycle di Claude Code
- 13.1 Cosa sono e a cosa servono
- 13.2 Anatomia di un hook
- 13.3 Eventi del lifecycle
- 13.4 Matcher e ispezione (/hooks)
- 13.5 Input e output
- 13.6 Esempi pratici
- 13.7 Sicurezza
- 13.8 Gotchas e quando NON usarli
-
14. Plugin: pacchetti distribuibili
- 14.1 Meccanismi di estensione di Claude Code: una mappa
- 14.2 Cos'è un plugin e perché esiste
- 14.3 Anatomia di un plugin
- 14.4 Plugin marketplace
- 14.5 Creare un plugin custom
- 14.6 Distribuire un plugin
- 14.7 Sicurezza e considerazioni operative
-
15. Workflow avanzati e tips
- 15.1 Onboarding su un repository esistente
- 15.2 Bug hunting con TDD
- 15.3 Refactoring sicuro
- 15.4 Audit di performance
- 15.5 Vim mode
- 15.6 Custom slash command
- 15.7 Modalità headless per CI/CD
- 15.8 Recap delle sessioni
- 15.9 Checkpoint Git strategici
- 15.10 Fork della conversazione
-
16. Conclusioni: perché la CLI e non solo la chat
- 16.1 Contesto persistente: smettere di presentarsi ogni volta
- 16.2 Autonomia agentica: esegue, non solo suggerisce
- 16.3 Integrazione nel workflow reale
- 16.4 Quando la chat resta la scelta giusta
- 16.5 In sintesi
- Allegato A — Glossario
- Allegato B — Fonti
- Note sull'autore
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…
Minimum price
Free!
$6.00
You pay
Author earns
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.
Feedback
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.
Translations
Translations
Languages
Contents
Table of Contents
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.
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.