Guida Completa a Claude Code 2026
Una panoramica dall'alto di tutte le funzioni di base, gli agenti standard, le Skills ufficiali e i Plugin.
In questo articolo, tratterò in modo completo tutte le funzionalità del Claude Code, profondamente evoluto.
A dire il vero, nel 2026, il termine "chat AI eseguita in un terminale" non basta più a descrivere Claude Code.
Ecco quanto si sono ampliate le sue capacità.
Il Claude Code di oggi può esplorare un repository da solo, organizzare i requisiti, creare piani di implementazione, modificare file, eseguire comandi, avviare applicazioni, osservare i risultati e, se qualcosa fallisce, tornare indietro per sistemarlo.
Gestisce quasi tutto questo in modo indipendente.
E non è tutto.
Può suddividere i compiti tra più agenti, implementarli in parallelo usando Git Worktrees indipendenti, eseguire processi di lunga durata in background, ricevere eventi da servizi esterni e persino pubblicare risultati come pagine web.
In breve, Claude Code è una "piattaforma di esecuzione di agenti" che raggruppa i seguenti elementi:
- Ragionamento dei modelli Claude
- Strumenti di esecuzione per gestire file, Shell, Web, LSP, ecc.
- Gestione del contesto tramite cronologia delle conversazioni, regole di progetto e Memoria
- Controlli di sicurezza tramite Permessi, Modalità Auto, Sandbox e Hook
- Elaborazione parallela tramite Subagenti, Viste Agente, Team di Agenti e Flussi di Lavoro Dinamici
- Estensibilità tramite Skills, Plugin e MCP
- Ambienti di esecuzione che spaziano da CLI, IDE, Desktop, Web, Mobile, CI e SDK
Spero che questo articolo serva da mappa per aiutarti a organizzare la tua comprensione di ciò che il sistema Claude Code possiede e come utilizzare ogni funzione in modo efficace.
Capitolo 1: I 9 Livelli di Claude Code
Nota: Ho riassunto le tecniche di configurazione e utilizzo avanzato in un PDF.
Se lo desideri, puoi ottenerlo da qui! 👇
https://x.com/MakeAI_CEO/status/2027682940847898770?s=20
Per padroneggiare Claude Code, la prima cosa da capire è la differenza tra "Modelli", "Strumenti", "Agenti", "Skills" e "Plugin".
Se questi si confondono, finirai nei guai.
Potresti ritrovarti a scrivere cose negli Hook che dovrebbero stare in CLAUDE.md, o semplicemente "chiedere" gentilmente in una Skill per un'operazione che dovrebbe essere rigorosamente bloccata dai Permessi.
Per evitare tali disallineamenti, organizziamo le idee dividendo il sistema in nove livelli.
- Modello Claude (Il Cervello)
Il modello Claude è il "cervello". Legge il codice, capisce i problemi e pensa a cosa fare dopo. Questa parte di "pensiero" è gestita dal modello.
Le famiglie di modelli rappresentative includono:
- Sonnet
- Opus
- Haiku
- Fable
Tuttavia, un equivoco comune è che il modello stesso modifichi direttamente i file o esegua comandi. Il modello decide solo cose come "Voglio leggere questo file", "Voglio cambiare questo codice" o "Voglio eseguire un test". L'azione vera e propria è compiuta dalle chiamate Strumento del runtime.
- Runtime di Claude Code (Il Comandante)
Il runtime di Claude Code è il comandante che fa da mediatore tra il modello e l'ambiente di esecuzione. Le sue funzioni principali includono:
- Salvare la cronologia delle conversazioni
- Caricare CLAUDE.md e Skills
- Passare le definizioni degli Strumenti al modello
- Eseguire le chiamate Strumento
- Determinare i Permessi
- Attivare gli Hook
- Applicare i vincoli della Sandbox
- Avviare Subagenti
- Comprimere il contesto
- Salvare e riprendere le sessioni
È interessante notare che, anche con lo stesso identico modello, il comportamento può cambiare radicalmente a seconda delle impostazioni del runtime.
- Strumenti Integrati (Le Mani e i Piedi)
Gli Strumenti Integrati sono gli "arti" integrati in Claude Code. Attraverso questi strumenti, Claude può:
- Leggere file
- Creare file
- Modificare parti di file
- Cercare nomi di file
- Cercare stringhe nel codice
- Eseguire comandi Shell
- Cercare sul Web
- Ottenere informazioni sui tipi da un Language Server
- Avviare Subagenti
- Pubblicare risultati
Senza Strumenti, Claude potrebbe solo offrire suggerimenti verbali. Gli Strumenti trasformano Claude da un "AI che si limita a consigliare" in un "AI che lavora davvero".
- Subagenti Integrati (Assistenti Standard)
Questi sono agenti ausiliari inclusi per impostazione predefinita. I tre tipi principali sono:
- Explore
- Plan
- Scopo generale
Operano in un contesto separato dalla conversazione principale, come assistenti che lavorano in una stanza diversa.
- Subagenti Personalizzati (Ruoli Specializzati)
I Subagenti Personalizzati sono agenti specializzati definiti da te o dal tuo team. Puoi creare ruoli come:
- Agente di Revisione della Sicurezza
- Agente di Progettazione API
- Agente di Creazione Test
- Agente di Migrazione Database
- Agente di Audit della Documentazione
- Agente di Analisi delle Prestazioni
- Skills (Manuali Riutilizzabili)
Le Skills sono un meccanismo per fornire a Claude procedure riutilizzabili o conoscenze specializzate. Se ti ritrovi a digitare istruzioni lunghe ripetutamente, dovrebbero essere trasformate in una Skill.
- Plugin (Scatole di Distribuzione)
I Plugin sono "scatole" usate per distribuire insieme più elementi di estensione, tra cui Skills, Subagenti, Hook, impostazioni MCP e altro.
- MCP (Standard Comune per la Connessione Esterna)
MCP sta per "Model Context Protocol", uno standard per collegare Claude Code a servizi esterni, API, database e sistemi aziendali.
- Superfici di Esecuzione (Dove Usarlo)
Claude Code non è solo per il terminale. Può essere usato in VS Code, IDE JetBrains, Claude Desktop, Web, Mobile, Slack e pipeline CI/CD.
Capitolo 2: Il Funzionamento di Base — Il Ciclo dell'Agente
Il funzionamento di base di Claude Code è meglio immaginarlo come un "ciclo" rotante:
L'utente comunica l'obiettivo -> Raccogliere le informazioni necessarie -> Pensare all'azione successiva -> Selezionare uno Strumento -> Passare attraverso Permessi/Hook/Sandbox -> Modificare file o eseguire comandi -> Osservare i risultati -> Verificare nell'ambiente di test/reale -> Se insufficiente, tornare a indagare/risolvere -> Terminare quando le condizioni di completamento sono soddisfatte.
Capitolo 3: Modelli, Impegno, Modalità Veloce e Consulente
Questa sezione copre come scegliere il modello e l'intensità giusti per il lavoro.
- Sonnet: Il cavallo di battaglia quotidiano per implementazione e correzione di bug.
- Opus: Il partner per situazioni difficili come progettazione architetturale e risoluzione di problemi complessi.
- Haiku: Veloce ed economico per ricerche semplici e riassunti.
- Fable 5: Il fondista di alto livello per l'esecuzione autonoma in repository di grandi dimensioni (a luglio 2026).
Impegno: Un cursore per determinare quanto ragionamento allocare (da Basso a Massimo).
Ultracode: Un'impostazione unica che combina ragionamento profondo con orchestrazione automatica di subagenti.
Modalità Veloce: Una configurazione ad alta velocità per Opus, circa 2,5 volte più veloce per compiti urgenti.
Consulente: Una funzionalità sperimentale in cui un secondo modello fornisce un "secondo parere" su decisioni critiche.
Capitolo 4: Contesto, CLAUDE.md, Regole e Memoria Automatica
La gestione del contesto è un fattore importante nelle prestazioni di Claude Code.
- CLAUDE.md: Un file markdown per i prerequisiti del progetto (stack tecnologico, regole di codifica, ecc.). È una guida, non un meccanismo di imposizione rigida.
- .claude/rules/: Permette di suddividere CLAUDE.md in regole specifiche che vengono caricate solo quando vengono modificati file pertinenti.
- Memoria Automatica: Annota automaticamente scoperte come comandi di build specifici o stili di implementazione preferiti.
- Compattazione Automatica: Riassume conversazioni lunghe per rimanere entro i limiti del contesto.
Capitolo 5: 42 Tipi di Strumenti Integrati
A luglio 2026, ci sono 42 strumenti integrati che coprono:
- File/Codice: Leggi, Scrivi, Modifica, Glob, Grep, LSP, ecc.
- Shell/Processo: Bash, PowerShell, Monitor.
- Pianificazione/Worktree: EnterPlanMode, EnterWorktree.
- Agente/Flusso di Lavoro: Agente, Flusso di Lavoro, SendMessage.
- Compiti: TaskCreate, TaskList.
- Web/MCP: WebSearch, WebFetch, ToolSearch.
- Utente/Cloud: AskUserQuestion, PushNotification, Artifact.
Capitolo 6: Sessione, Checkpoint, Branch, Fork e Worktree
Claude Code salva il lavoro come "Sessione", permettendoti di riprendere il lavoro, creare rami di conversazione o tornare a checkpoint precedenti. Tuttavia, i Checkpoint non sostituiscono Git; non possono annullare effetti collaterali esterni come chiamate API o aggiornamenti del database.
Capitolo 7: Agenti Predefiniti
- Explore: Un agente di sola lettura specializzato nell'esplorazione del codebase.
- Plan: Un agente di sola lettura usato durante la modalità Plan per raccogliere informazioni prima dell'implementazione.
- Scopo generale: Un agente versatile che gestisce sia l'esplorazione che l'esecuzione.
Continua nella guida 👇
