Una guida che supera le trecento pagine ha un difetto che nessuna revisione può correggere: prima di decidere se vale la pena leggerla bisogna, almeno in parte, leggerla. Questa pagina esiste per risparmiarti quel paradosso, perché raccoglie in un solo posto tutti i capitoli della Guida pratica a Claude Code nella versione 6.1 di ottobre 2026, ciascuno accompagnato da una breve sinossi che ti dice che cosa impari e quali sono le sezioni su cui conviene fermarsi.
Puoi usarla come mappa prima di scaricare il PDF gratuito, come promemoria quando ti serve ritrovare al volo dove si parla di hook o di prompt cache, oppure come lista della spesa per decidere da quale capitolo partire se Claude Code lo usi già da un po’ e non hai alcuna intenzione di rileggerti l’installazione. Io, che l’ho scritta, la uso soprattutto per la terza ragione, e non me ne vergogno.
Prima di cominciare: prefazione e premessa
La prefazione è una valutazione scritta da Claude Opus 4.7 durante la lavorazione del manoscritto, che racconta con franchezza che cosa funziona nel libro e che cosa il lettore deve tenere a mente. La premessa spiega perché la guida esiste, a chi si rivolge, che cosa trovi e che cosa no, come leggerla, come è stata scritta con Claude Code stesso e come segnalare errori e proposte di errata corrige.
Capitolo 1. Cos’è Claude Code
Il capitolo di apertura presenta Claude Code come agente che lavora sull’intero progetto e non sul singolo file, partendo dalla sua storia (1.1) e dal confronto con Lovable, Replit e altri ambienti AI (1.2). Seguono gli scenari in cui conviene usarlo (1.3), la curva di apprendimento (1.4), la linea temporale dei modelli (1.5), la distinzione fra modello e harness con il ciclo agentico (1.6) e il percorso che va dal prompt engineering al graph engineering (1.7).
Capitolo 2. Installazione e setup
Qui si passa alla pratica: quali piani permettono di usare Claude Code (2.1), quali sono i requisiti di sistema (2.2) e come si installa su macOS e Linux (2.3), su Windows (2.4) e tramite WSL2, che è la strada consigliata per chi lavora su Windows (2.5). Chiudono il capitolo l’installazione alternativa via npm (2.6), la verifica dell’installazione (2.7) e l’autenticazione, compreso l’uso di più account (2.8).
Capitolo 3. Il primo progetto end-to-end
Un flusso completo, in sei passi, su un plugin WordPress da analizzare: ci si posiziona nella directory del progetto, lo si inizializza (3.2), si rivede e personalizza il file CLAUDE.md (3.3) e si scrive una prima richiesta di sola esplorazione (3.4), con un avvertimento sulla modalità di partenza in auto mode. Infine si esce dalla sessione (3.5) e la si riprende dove la si era lasciata (3.6).
Capitolo 4. Comandi e scorciatoie essenziali
Claude Code si comanda scrivendo, e questo capitolo spiega prima la filosofia della sintassi a comandi (4.1) e poi i flag CLI essenziali e avanzati, dalla modalità headless con -p alla ripresa delle sessioni (4.2 e 4.3). Il cuore sono gli slash command, essenziali e per workflow specifici (4.4, 4.5 e 4.6), seguiti dalle scorciatoie da tastiera (4.7) e dai tre prefissi @, ! e / che cambiano il modo di lavorare (4.8).
Capitolo 5. Plan Mode: pensare prima di scrivere
Plan Mode è la modalità di sola analisi in cui Claude legge il progetto e propone un piano senza modificare alcun file finché non lo approvi. Il capitolo spiega perché è importante (5.1), come attivarlo (5.2), quali strumenti restano disponibili (5.3) e come si svolge un workflow tipico, con approvazione o rifiuto del piano (5.4), per chiudere con opusplan e il principio per cui non sempre serve Opus (5.5).
Capitolo 6. Prompt engineering: scrivere prompt efficaci
Dopo aver capito che cosa chiedere, si impara come chiederlo, lasciando alle spalle lo «Hope Coding». Il capitolo descrive l’anatomia di un prompt ben fatto (6.2), il passaggio dai ruoli ai vincoli strutturali con i delimitatori XML (6.3) e le tecniche fondamentali, da Chain of Thought al meta-prompting (6.4), poi le specificità della CLI e dei modelli della generazione 5 (6.5), esempi prima e dopo (6.6), anti-pattern (6.7) e la promozione dei prompt ricorrenti (6.8 e 6.9).
Capitolo 7. Memoria persistente: CLAUDE.md e Auto Memory
Due meccanismi di memoria che convivono: CLAUDE.md, il contratto statico scritto da te, e Auto Memory, gli apprendimenti che il modello annota da solo. La prima parte copre la generazione con /init, i contenuti, due esempi completi e i file gerarchici su monorepo con import e regole modulari (7.1 a 7.5), più la lezione di Karpathy e le quattro regole di Forrest Chang (7.6); la seconda spiega Auto Memory, dove vive, quando disabilitarla e quando usare cosa (7.7 a 7.13).
Capitolo 8. Gestione del contesto
La finestra di contesto è la risorsa più preziosa e la più maltrattata: il capitolo spiega che cosa la riempie (8.2), quali segnali indicano che è satura (8.3) e come leggerla con /context (8.4). Seguono la compressione con /compact e /clear (8.5), i subagent come strategia strutturale (8.6), i modelli con finestra da un milione di token (8.7), una tabella decisionale per scegliere l’architettura giusta (8.9) e il prompt cache con il monitoraggio dei consumi (8.10).
Capitolo 9. Sicurezza, permessi e guardrail
Un agente che esegue comandi in millisecondi comprime il tempo in cui un errore resta reversibile, e il capitolo parte da tre scenari concreti per dimostrarlo. Poi descrive la difesa in profondità (9.1), il sistema dei permessi e la sua configurazione in settings.json (9.2 e 9.3), la protezione dei segreti (9.4), le modalità pericolose (9.5), la prompt injection (9.6), i test come guardrail (9.7) e infine sandbox e managed settings (9.8).
Capitolo 10. Skill: il meccanismo di estensione
Le skill sono playbook che Claude carica da solo o che invochi come comandi, e nelle quali sono confluiti i custom command. Dopo il funzionamento di base (10.1) il capitolo passa in rassegna le skill di Anthropic, da pdf a mcp-builder (10.2), e una selezione della community che comprende Superpowers, WordPress Agent Skills e Caveman (10.3), per poi spiegare come installarle (10.4), come crearne una propria (10.5) e come valutare quelle di terzi (10.6).
Capitolo 11. MCP: integrare servizi esterni
Il Model Context Protocol estende l’insieme dei sistemi a cui Claude Code può collegarsi: API, database, servizi SaaS. Il capitolo spiega perché esiste (11.1), come è fatto il protocollo (11.2), come configurare un server esistente (11.3) e quali server vale la pena conoscere (11.4); poi costruisce da zero, in Python, un server MCP che pubblica su WordPress (11.5), e chiude con sicurezza (11.6) e costo degli schemi sul contesto (11.7).
Capitolo 12. Subagent: orchestrare lavoro specializzato
I subagent sono istanze di Claude con contesto e tool propri, paragonate a schede separate del browser che restituiscono solo il risultato. Il capitolo ne chiarisce la differenza rispetto al main agent (12.2), presenta quelli built-in (12.3) e la creazione di subagent custom (12.4), poi affronta precedenza e invocazione (12.5 e 12.6), parallelismo e annidamento (12.7), model routing per contenere i costi (12.8), i casi in cui non usarli (12.9) e il confronto con skill e hook (12.10).
Capitolo 13. Hook: automatizzare il lifecycle di Claude Code
Gli hook intercettano gli eventi del ciclo di vita, come l’avvio di una sessione o il momento prima di eseguire un tool, e possono validarli, modificarli o bloccarli. Dopo anatomia, eventi, matcher e formato di input e output (13.2 a 13.5) arrivano sei esempi pratici (13.6), dal blocco di rm -rf in wp-content al backup del transcript prima di /compact, seguiti da sicurezza (13.7) e gotchas con i casi in cui non usarli (13.8).
Capitolo 14. Plugin: pacchetti distribuibili
Il plugin è il contenitore che raggruppa skill, server MCP, subagent e comandi in un pacchetto installabile, una sorta di pacchetto npm o Composer dell’ecosistema. Il capitolo apre con una mappa dei quattro meccanismi di estensione (14.1), spiega cos’è un plugin e come è fatto (14.2 e 14.3), come si usano i marketplace (14.4), come crearne (14.5) e distribuirne uno (14.6) e come valutare la sicurezza dei plugin di terzi (14.7).
Capitolo 15. Workflow avanzati e tips
La cassetta degli attrezzi del libro: quattro workflow pratici, cioè onboarding su un repository esistente, bug hunting con TDD, refactoring sicuro e audit di performance (15.1 a 15.4), poi otto tips che vanno dai custom slash command (15.6) alla modalità headless per CI/CD (15.7), dai checkpoint Git (15.9) al fork della conversazione (15.10), fino ai workflow dinamici e a /goal (15.11 e 15.12). Chiude una panoramica su sessioni parallele, programmate e remote (15.13).
Capitolo 16. Gli harness: Claude Code e gli altri agenti di coding
Ripartendo dalla distinzione fra modello e harness della sezione 1.6, il capitolo mette Claude Code accanto ad altri agenti di coding e li misura con uno schema comune (16.1). Le schede riguardano Claude Code (16.2), OpenAI Codex (16.3) e OpenCode (16.4), riassunte in una tabella comparativa (16.5); seguono una mappa del resto del panorama, da GitHub Copilot CLI ad Aider (16.6), e i criteri per scegliere (16.7).
Capitolo 17. Conclusioni: perché la CLI e non solo la chat
La domanda finale è legittima: perché usare la CLI quando basterebbe incollare il codice in una chat? Le risposte sono tre, cioè il contesto persistente che evita di ripresentarsi ogni volta (17.1), l’autonomia agentica di uno strumento che esegue e non si limita a suggerire (17.2) e l’integrazione nel workflow reale (17.3), con un’onesta sezione sui casi in cui la chat resta la scelta giusta (17.4) e una sintesi (17.5).
Allegati
La postfazione è firmata da Claude Fable 5, il modello che ha riletto e revisionato il libro a giugno 2026, e riflette sul metodo più che sullo strumento. Seguono il glossario dei termini ricorrenti (Allegato A), le fonti ufficiali per verifiche e approfondimenti (Allegato B), le note di rilascio che collegano le funzioni citate alla versione della CLI in cui sono comparse (Allegato C) e la cronologia dei modelli Claude da Opus 4.5 a Sonnet 5.5, con una scheda per ciascuno (Allegato D). Chiudono le note sull’autore.
Scarica la guida
Se la mappa ti ha convinto, il passo successivo è il più semplice: scarica il PDF, che è gratuito e rilasciato sotto licenza Creative Commons BY-SA 4.0, oppure torna alla pagina della guida per tutte le altre informazioni. E se durante la lettura trovi un refuso, un comando che nel frattempo ha cambiato nome o una sinossi che promette più di quanto il capitolo mantenga, segnalalo sul repository GitHub del progetto: ogni correzione finisce nella versione successiva, e il merito nelle note di rilascio.
