Se sviluppi software nel 2026, Claude Code è uno strumento che può rivoluzionare il tuo flusso di lavoro. Non parliamo di un semplice assistente AI per il coding: Claude Code è un vero e proprio agente autonomo che vive nel tuo terminale, capace di leggere file, modificare codice, eseguire comandi bash, gestire Git e molto altro.
In questa guida completa troverai tutto ciò che serve per padroneggiare Claude Code: dall'installazione ai comandi avanzati, dai keyboard shortcuts alle configurazioni enterprise, dalle skills personalizzate agli MCP servers. Considera questa la tua cheatsheet definitiva da consultare ogni volta che hai bisogno di un riferimento rapido.
Cos'è Claude Code e perché dovresti usarlo
Claude Code è l'interfaccia CLI ufficiale di Anthropic per Claude, pensata specificamente per sviluppatori. A differenza di ChatGPT o altri assistenti generici, Claude Code è progettato per lavorare direttamente nel tuo ambiente di sviluppo.
Le principali caratteristiche che lo rendono unico sono la capacità di leggere automaticamente il contesto dei tuoi file senza che tu debba copiare e incollare codice, l'integrazione nativa con Git per commit, branch e pull request gestiti in linguaggio naturale, l'esecuzione di comandi bash e script per automazione completa, la possibilità di creare skills personalizzate per workflow specifici, e l'integrazione con strumenti esterni tramite MCP (Model Context Protocol).
Se stai cercando di ottimizzare il tuo workflow di AI coding, Claude Code rappresenta un passo avanti significativo rispetto a strumenti come Cursor o GitHub Copilot.
Installazione rapida su ogni sistema
Claude Code supporta Windows, macOS e Linux. Ecco i metodi di installazione più veloci per ogni piattaforma.
macOS e Linux con curl
Il metodo consigliato per Unix è tramite curl. Apri il terminale e lancia questo comando:
curl -fsSL https://claude.ai/install.sh | bash
Questo scarica ed esegue lo script di installazione ufficiale. In pochi secondi Claude Code sarà disponibile nel tuo sistema.
macOS con Homebrew
Se preferisci Homebrew, puoi installare Claude Code come qualsiasi altra applicazione:
brew install --cask claude-code
Nota che le installazioni Homebrew non si aggiornano automaticamente. Ricordati di eseguire periodicamente brew upgrade claude-code per ottenere le ultime funzionalità.
Windows con PowerShell
Su Windows, apri PowerShell come amministratore ed esegui:
irm https://claude.ai/install.ps1 | iex
Anche in questo caso, dovrai aggiornare manualmente con winget upgrade Anthropic.ClaudeCode quando disponibili nuove versioni.
Installazione globale con npm
Se hai Node.js 18 o superiore, puoi installare Claude Code come pacchetto npm globale:
npm install -g @anthropic-ai/claude-code
Una volta installato, avvia Claude Code nella directory del tuo progetto con un semplice comando claude. Al primo avvio ti verrà chiesto di autenticarti con il tuo account Anthropic.
Keyboard shortcuts essenziali
Imparare gli shortcuts è fondamentale per lavorare velocemente con Claude Code. Ecco i comandi da tastiera che dovresti memorizzare fin da subito.
Il prefisso ! attiva la bash mode: quando inizi un messaggio con !, Claude Code esegue direttamente il comando bash. Usa @ per menzionare file o cartelle specifiche nel tuo prompt, così Claude sa esattamente dove guardare. Se devi andare a capo nel prompt senza inviare il messaggio, usa backslash + Enter.
Per interrompere Claude mentre sta elaborando, premi Esc una volta. Se vuoi aprire il menu rewind per annullare modifiche, premi Esc due volte. Questo è uno dei comandi più utili quando Claude ha fatto modifiche che vuoi annullare.
Con Ctrl+R visualizzi l'output completo e il contesto della sessione. Puoi incollare immagini direttamente nel prompt con Ctrl+V, utile per debug visivo o per mostrare design da replicare.
La "yolo mode" si attiva con Shift+Tab: Claude Code accetterà automaticamente tutte le modifiche senza chiedere conferma. Usala solo quando sei sicuro di cosa sta facendo. Per la plan mode, dove Claude pianifica prima di agire, usa Shift+Tab+Tab.
Infine, Cmd+Esc su Mac o Ctrl+Esc su Windows/Linux lancia rapidamente Claude Code dal tuo IDE preferito, mentre Cmd+Option+K o Alt+Ctrl+K inserisce riferimenti ai file nel prompt.
Configurazione avanzata del sistema
Claude Code usa un sistema gerarchico di configurazione che ti permette di impostare preferenze a livello enterprise, utente o progetto. La priorità viene applicata in questo ordine: configurazione enterprise, impostazioni locali del progetto, impostazioni condivise del team, e infine impostazioni globali dell'utente.
File di configurazione e priorità
Le impostazioni enterprise vivono in /etc/claude-code/managed-settings.json e hanno la massima priorità. Le impostazioni personali del progetto vanno in .claude/settings.local.json e sono ignorate da Git. Il file .claude/settings.json contiene le impostazioni condivise dal team, mentre ~/.claude/settings.json contiene i tuoi default personali.
I comandi per gestire la configurazione sono semplici. Usa claude config list per vedere tutte le impostazioni correnti, claude config get chiave per controllare un valore specifico, e claude config set chiave valore per modificare un'impostazione. Per aggiungere elementi a liste usa claude config add chiave valore, mentre per rimuoverli usa claude config remove chiave valore.
Checkpointing: il sistema di undo automatico
Una delle funzionalità più sottovalutate di Claude Code è il sistema di checkpointing automatico. Ogni volta che invii un prompt, Claude crea un checkpoint dello stato dei tuoi file. Se qualcosa va storto, puoi facilmente tornare indietro.
Premi Esc+Esc per aprire il menu rewind, oppure usa il comando /rewind. Avrai quattro opzioni: ripristinare solo il codice mantenendo la conversazione, ripristinare solo la conversazione mantenendo il codice, ripristinare entrambi allo stato precedente, o annullare l'operazione.
È importante sapere che i checkpoints non tracciano le modifiche fatte tramite comandi bash come rm, mv o cp. Anche le modifiche manuali fatte fuori da Claude Code non vengono catturate. I checkpoints sono perfetti per un recupero rapido, ma non sostituiscono Git per la storia permanente del progetto.
Slash commands per controllo totale
I slash commands sono comandi interattivi che controlli direttamente nella chat di Claude Code. A differenza delle skills (che Claude usa autonomamente), i slash commands li invochi tu esplicitamente.
Comandi built-in fondamentali
Ecco i comandi più utili che dovresti conoscere. Con /help ottieni l'elenco completo dei comandi disponibili. /clear cancella la cronologia della conversazione corrente. /config apre la gestione della configurazione.
Per compattare una conversazione troppo lunga usa /compact, opzionalmente seguito da istruzioni specifiche su cosa mantenere. /status mostra lo stato dell'account e del sistema. /model permette di cambiare il modello AI in uso.
Il comando /review è particolarmente utile: chiedi a Claude di fare una code review dettagliata del tuo lavoro. /permissions gestisce i permessi per strumenti e comandi, mentre /memory modifica i file CLAUDE.md che contengono la memoria del progetto.
Per vedere i commenti delle pull request usa /pr_comments. Il comando /sandbox abilita un ambiente bash isolato per maggiore sicurezza. Con /vim entri in vim mode per chi preferisce questa modalità di editing.
Creare slash commands personalizzati
Puoi creare i tuoi slash commands salvando file markdown in .claude/commands/ per comandi di progetto o in ~/.claude/commands/ per comandi personali disponibili ovunque.
Ecco un esempio di comando per ottimizzazione del codice. Salva questo in .claude/commands/optimize.md:
Analizza questo codice per problemi di performance e suggerisci ottimizzazioni
Per comandi più avanzati puoi usare placeholder come $ARGUMENTS per tutti gli argomenti passati, oppure $1, $2, $3 per argomenti posizionali specifici. Puoi anche eseguire comandi bash prima di processare il prompt usando la sintassi !`comando`.
Un esempio più complesso per commit Git potrebbe includere il frontmatter YAML per specificare tool permessi, hint sugli argomenti e descrizione. Questo ti permette di creare workflow riutilizzabili per operazioni ripetitive.
Agent Skills: capacità modulari riutilizzabili
Le Skills sono diverse dai slash commands: sono capacità modulari che Claude invoca autonomamente quando rileva che sono rilevanti per il task. Questo le rende perfette per workflow complessi che vuoi automatizzare completamente.
Le Skills vivono in .claude/skills/ per il progetto o ~/.claude/skills/ per uso personale. Ogni skill è una directory che contiene almeno un file SKILL.md con le istruzioni.
Esempio: Skill per Code Review automatica
Salva questo in .claude/skills/code-reviewer/SKILL.md:
---
name: code-reviewer
description: Expert code review specialist. Reviews code for quality, security, and maintainability. Use immediately after writing or modifying code.
tools: Read, Grep, Glob, Bash
---
You are a senior code reviewer ensuring high standards.
When invoked:
1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately
Review checklist:
- Code is simple and readable
- Functions are well-named
- No duplicated code
- Proper error handling
- No exposed secrets
- Good test coverage
Nota la keyword "Use immediately after" nella description: questo indica a Claude di usare proattivamente questa skill ogni volta che finisci di scrivere codice.
Skills vs Slash Commands: quando usare cosa
I slash commands sono invocati dall'utente, sono prompt semplici e stanno in un singolo file. Le Skills sono invocate dal modello autonomamente, possono essere complesse con script e file multipli, e sono perfette per workflow elaborati.
Usa le skills quando vuoi che Claude agisca automaticamente in certi contesti. Usa i slash commands per prompt che vuoi controllare esplicitamente tu.
MCP Servers: integrazioni con tool esterni
Il Model Context Protocol (MCP) è uno standard aperto che permette a Claude Code di connettersi a servizi esterni. Pensa agli MCP servers come a plugin che estendono le capacità di Claude.
Gestione MCP servers
Per aggiungere un server MCP usa claude mcp add nome comando [args]. Per server con transport SSE usa claude mcp add --transport sse nome url. Visualizza tutti i server installati con claude mcp list e rimuovine uno con claude mcp remove nome.
MCP servers più utili per sviluppatori
Tra le integrazioni più popolari troviamo GitHub per gestire repository e pull request, Notion per leggere documenti e gestire task, Supabase per operazioni su database, Playwright per automazione browser avanzata, e Stripe per gestire pagamenti e sottoscrizioni.
Altri server interessanti includono Linear per issue tracking, Sentry per monitoraggio errori, Figma per accesso al design context, e Canva per generare design. Per progetti e-commerce, Square e PayPal offrono integrazioni complete.
Un aspetto importante: i permessi MCP non supportano wildcard. Devi approvare specificamente ogni tool o l'intero server. Per approvare tutti i tool di un server usa "allow": ["mcp__github"], mentre per un singolo tool usa "allow": ["mcp__github__get_issue"].
Subagenti: AI specializzati per task paralleli
I subagenti sono istanze specializzate di Claude che puoi lanciare per gestire task specifici in parallelo. Ogni subagente ha il proprio contesto separato e i propri permessi, perfetto per isolare operazioni complesse.
I subagenti vivono in .claude/agents/ per il progetto o ~/.claude/agents/ per uso personale. Sono file markdown con frontmatter YAML che specifica nome, descrizione, strumenti permessi e modello da usare.
Esempio: Subagente Debugger specializzato
Salva questo in .claude/agents/debugger.md:
---
name: debugger
description: Debugging specialist for errors and test failures. Use when encountering issues.
tools: Read, Edit, Bash, Grep, Glob
model: sonnet
---
You are an expert debugger specializing in root cause analysis.
When invoked:
1. Capture error message and stack trace
2. Identify reproduction steps
3. Isolate the failure location
4. Implement minimal fix
5. Verify solution works
Focus on fixing the underlying issue, not symptoms.
Puoi invocare esplicitamente un subagente con claude "Use the debugger subagent to fix this error", oppure fare in modo che Claude lo usi automaticamente includendo "Use when" o "proactively" nella description.
La potenza dei subagenti emerge quando ne concateni diversi: "Use debugger then optimizer subagents" eseguirà prima il debugging e poi l'ottimizzazione, mantenendo contesti separati.
Git Worktrees: sviluppo parallelo senza context loss
Una funzionalità poco conosciuta ma potentissima è l'uso di Git worktrees con Claude Code. I worktrees ti permettono di avere multiple copie dello stesso repository su branch diversi contemporaneamente.
Perché è utile con Claude Code? Zero context loss: ogni sessione di Claude mantiene la piena comprensione del progetto. Lavoro parallelo: gestisci hotfix urgenti mentre continui lo sviluppo di feature. Esperimenti sicuri: testa modifiche rischiose in completo isolamento. Confronto modelli: esegui modelli AI diversi sugli stessi task.
Comandi essenziali per worktrees
Per creare un worktree con branch esistente usa git worktree add percorso branch. Per creare un worktree con nuovo branch usa git worktree add percorso -b nuovo-branch punto-partenza. Elenca tutti i worktrees con git worktree list e rimuovine uno con git worktree remove percorso.
Un esempio pratico di workflow parallelo potrebbe essere creare due worktrees per feature diverse, lanciare Claude Code in ognuno, e lavorare contemporaneamente su entrambi senza perdere contesto o dover fare stash/checkout continui.
Hooks: automazione e controllo avanzato
Gli hooks di Claude Code ti permettono di eseguire script automaticamente in risposta a eventi specifici. Sono perfetti per formattazione automatica, logging, notifiche e gestione permessi custom.
Attenzione: gli hooks eseguono comandi shell con le tue credenziali. Rivedi sempre il codice degli hooks prima di aggiungerli per evitare rischi di sicurezza.
Eventi hook disponibili
Gli eventi principali sono PreToolUse (prima delle chiamate ai tool, può bloccarle), PostToolUse (dopo le chiamate ai tool), UserPromptSubmit (quando invii un prompt), Notification (quando Claude invia notifiche), Stop (quando Claude finisce di rispondere), SubagentStop (quando completano i subagenti), e SessionStart/SessionEnd per inizio e fine sessione.
Esempio: Auto-formattazione codice
Questo hook esegue Prettier automaticamente su ogni file modificato. Aggiungi al tuo .claude/settings.json:
{
"hooks": {
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "npx prettier --write $FILE_PATH"
}]
}]
}
}
Gli hooks possono accedere a variabili d'ambiente come $FILE_PATH, $CLAUDE_PROJECT_DIR e ricevono dati JSON via stdin che puoi parsare con jq.
Headless mode per automazione e CI/CD
Claude Code può girare in modalità non interattiva, perfetto per script di automazione, bot SRE, pipeline CI/CD e agent integrations.
Usa il flag --print o -p per eseguire in modalità headless. Puoi combinarlo con --output-format json per output strutturato, --continue per continuare l'ultima conversazione, o --resume id per riprendere una sessione specifica.
Esempio: Incident response automatizzato
claude -p "Analyze these errors" \
--append-system-prompt "You are an SRE expert" \
--output-format json \
--allowedTools "Bash,Read,mcp__datadog"
Questo comando analizza errori in modalità SRE, restituisce JSON strutturato e ha accesso a bash, lettura file e Datadog MCP. Perfetto per essere integrato in runbook di incident response.
Plugins: estendere Claude Code
I plugin permettono di installare pacchetti completi di funzionalità da marketplace. Un plugin può includere comandi custom, agenti specializzati, skills, hooks e MCP servers.
Gestisci i plugin con /plugin per aprire l'interfaccia, /plugin marketplace add url per aggiungere un marketplace, /plugin install nome@marketplace per installare, e /plugin enable/disable/uninstall per gestire i plugin installati.
Puoi anche creare un marketplace locale per sviluppo di plugin con /plugin marketplace add ./dev-marketplace.
Best practices e suggerimenti avanzati
Dopo aver esplorato tutte le funzionalità, ecco alcune best practices che ti faranno risparmiare tempo e frustrazione.
Crea sempre un file CLAUDE.md nella root del progetto con regole specifiche, convenzioni di naming, stack tecnologico e struttura del progetto. Claude lo legge automaticamente e adatta il suo comportamento.
Usa la plan mode (Shift+Tab+Tab) per task complessi. Claude esplorerà il codebase, capirà i pattern esistenti e proporrà un piano prima di implementare. Solo dopo la tua approvazione procederà.
Per progetti grandi, sfrutta i subagenti per isolare operazioni. Un agente Explore con Haiku per ricerche veloci, un agente principale con Sonnet per implementazione, un agente Reviewer con Opus per code review finali.
Quando lavori con immagini, usa Ctrl+V per incollare screenshot. È perfetto per debug visivo, replicare design o mostrare errori di layout. Claude può analizzare screenshot e ricreare componenti pixel-perfect.
Se hai bisogno di tool esterni, esplora il marketplace MCP prima di scrivere integrazioni custom. Ci sono già server per GitHub, databases, browser automation, payment processors e molto altro, come illustrato nella nostra guida agli agenti AI open source.
Permessi e sicurezza aziendale
Per ambienti enterprise, Claude Code offre controlli granulari sui permessi. La configurazione managed vive in /etc/claude-code/managed-settings.json e ha priorità assoluta su tutte le altre impostazioni.
Puoi creare allowlist e denylist per MCP servers con allowedMcpServers e deniedMcpServers. La denylist ha sempre precedenza assoluta sull'allowlist.
Per un setup di sicurezza base, blocca file sensibili, permetti comandi dev comuni e chiedi conferma per operazioni rischiose. In ambienti production, passa tutto in modalità "ask" e nega tool pericolosi come curl, wget, ssh.
Leggi anche
- AI Coding nel 2026: 10 Consigli da Full Stack per Risparmiare Token
- SERA: Gli Agenti AI Open Source che Rivoluzioneranno il Coding
- Emirati Arabi: Falcon H1R 7B e K2 Think, Rivoluzione Open Source
- Agentic Vision: Google Rivoluziona la Computer Vision con Gemini 3
- Kimi K2.5: il Modello AI Cinese che Crea Siti con 100 Agenti
Conclusione: il futuro dello sviluppo è qui
Claude Code rappresenta un cambio di paradigma nello sviluppo software. Non è solo un copilota che suggerisce codice: è un collega AI che comprende il contesto, esegue operazioni complesse e si adatta al tuo workflow specifico.
Le funzionalità che abbiamo esplorato - skills modulari, subagenti specializzati, integrazioni MCP, git worktrees, hooks automatici - non sono gadget. Sono strumenti pensati per risolvere problemi reali di sviluppatori che lavorano su progetti complessi.
Se sviluppi software professionalmente, Claude Code può aumentare significativamente la tua produttività. La curva di apprendimento iniziale è ripagata dalla possibilità di automatizzare operazioni ripetitive, gestire refactoring complessi con sicurezza e mantenere standard di qualità elevati senza sforzo manuale.
Inizia con i comandi base, poi esplora gradualmente funzionalità avanzate come skills e subagenti. In poche settimane scoprirai di non poterne più fare a meno.
Hai bisogno di sviluppare applicazioni web complesse o vuoi integrare AI nel tuo workflow di sviluppo? Contattami per una consulenza personalizzata. Posso aiutarti a configurare Claude Code per il tuo team e creare workflow ottimizzati per le tue esigenze specifiche.
