Claude Code: Guida Completa 2026 per Developer e Automatori

Claude Code è l’agente AI che opera nel tuo terminale. Scrive codice, esegue comandi, naviga la codebase e gestisce pull request in autonomia. Non è un chatbot: è un processo che accede ai tuoi file locali, legge la struttura del progetto e agisce. In questa guida trovi installazione, comandi chiave, architettura Skills/MCP, hooks, slash command personalizzati e i casi d’uso concreti per un workflow B2B.

Ultimo aggiornamento: aprile 2026 — Claude Code gira su Opus 4.6 con 1M token di context window.

Cos’è Claude Code (e cosa non è)

Claude Code non è un completamento automatico. Non è Copilot. Non è un chatbot nel terminale.

È un agente. La differenza non è sottile.

Un agente non aspetta che tu scriva ogni istruzione: riceve un obiettivo, pianifica i passi per raggiungerlo e li esegue. Se incontra un errore, analizza il contesto e corregge. Se deve navigare 50 file per capire l’architettura del progetto, lo fa prima di scrivere una riga.

Cosa fa concretamente:

• Modifica file nel progetto in base a istruzioni in linguaggio naturale
• Esegue comandi shell e interpreta i risultati
• Legge, naviga e indicizza l’intera codebase
• Gestisce operazioni Git (commit, branch, PR)
• Esegue test e analizza i risultati
• Integra tool esterni via MCP (Model Context Protocol)
• Lancia sub-agenti paralleli per task complessi
• Disponibile come CLI, desktop app (Mac/Windows), web app e estensioni IDE (VS Code, JetBrains)

Cosa non fa:

• Non accede a internet in autonomia (a meno di tool MCP specifici)
• Non ha memoria tra sessioni diverse a meno di configurazione CLAUDE.md
• Non sostituisce il giudizio su architettura e decisioni di business

Il modello predefinito da marzo 2026 è Claude Opus 4.6, con una context window da 1 milione di token. Questo significa che può leggere l’intera codebase di un progetto medio senza perdere contesto. Per task più veloci puoi switchare su Sonnet 4.6 (stesso modello, output più rapido) con il comando /fast. Per capire quale modello scegliere in base al tuo caso d’uso, leggi il confronto Opus vs Sonnet vs Haiku.

Se vuoi capire cos’è Claude come modello prima di usarlo come agente, leggi la guida completa a Claude AI.

Installazione e configurazione in 10 minuti

Claude Code richiede Node.js 18+ e un abbonamento Claude Pro ($20/mese), Team ($30/mese) o Enterprise. Con il piano Max ($100/mese o $200/mese) ottieni 5x o 20x i limiti standard — ideale per chi usa Claude Code in produzione tutto il giorno.

1. Installa via npm:

npm install -g @anthropic-ai/claude-code

2. Autenticati:

claude

Si apre il browser per il login OAuth. Dopo l’autenticazione, Claude Code è pronto.

3. Apri un progetto:

cd /tuo/progetto
claude

4. Primo comando naturale:

Analizza la struttura del progetto e dimmi cosa fa questo codebase

Claude Code legge i file, capisce l’architettura e ti restituisce un sommario. Da qui puoi chiedere qualsiasi modifica.

Configurazione con CLAUDE.md:

Il file CLAUDE.md nella root del progetto è la memoria persistente di Claude Code. Qui definisci convenzioni, regole di stile, stack tecnologico e istruzioni ricorrenti. Ogni sessione lo legge automaticamente.

I modelli disponibili: Opus 4.6, Sonnet 4.6, Haiku 4.5

Claude Code supporta tre modelli della famiglia Claude 4:

• Opus 4.6 — il default. Massima qualità di ragionamento, ideale per refactoring complessi, architettura, debugging. Context window 1M token.
• Sonnet 4.6 — stesso modello, output più veloce. Attivabile con /fast. Perfetto per task iterativi e code review rapide.
• Haiku 4.5 — il più economico e veloce. Adatto per task semplici e automazioni ad alto volume.

Il comando /fast switcha tra Opus e Sonnet senza cambiare sessione. Per automazioni batch dove il costo conta, puoi configurare Haiku via API.

Per un confronto dettagliato con costi, velocità e benchmark reali, leggi Opus 4.6 vs Sonnet 4.6 vs Haiku: quale scegliere.

MCP: Model Context Protocol

MCP è il protocollo che permette a Claude Code di collegarsi a servizi esterni. Pensa a MCP come a delle porte USB per l’AI: ogni server MCP espone tool che Claude Code può usare in autonomia.

Esempi pratici:

• Sanity MCP — query e patch di contenuti CMS direttamente dal terminale
• GitHub MCP — gestione issue, PR, code review automatiche
• Slack MCP — invio messaggi e lettura canali
• Stripe MCP — gestione pagamenti e fatture
• Database MCP — query SQL dirette su PostgreSQL, MySQL

I server MCP si configurano nel file settings.json di Claude Code. Dopo la configurazione, Claude Code vede automaticamente i tool disponibili e li usa quando servono. Non devi chiamarli manualmente — li invoca in base al contesto della richiesta.

Per la guida completa alla configurazione MCP con esempi pratici, leggi MCP e Claude: Guida Pratica per Connettere API Esterne. Se usi MCP in produzione, è essenziale conoscere i rischi: MCP Security 2026: 30 CVE in 60 Giorni.

Hooks e Custom Slash Commands

Due feature che trasformano Claude Code da strumento generico a sistema personalizzato per il tuo workflow.

Hooks sono comandi shell che si eseguono automaticamente in risposta a eventi di Claude Code. Configurabili in settings.json. Puoi agganciare azioni a eventi come PreToolUse, PostToolUse e altri. Casi d’uso reali: linting automatico dopo ogni modifica file, notifica Slack quando Claude Code completa un task, backup automatico prima di operazioni distruttive, log di audit per compliance.

Custom Slash Commands ti permettono di creare comandi personalizzati come /deploy, /audit, /review che eseguono prompt predefiniti. Si definiscono come file .md nella directory .claude/skills/. Ad esempio, un file .claude/skills/deploy.md definisce cosa succede quando digiti /deploy nella sessione di Claude Code. I slash command sono il modo più potente per standardizzare i workflow del team: ogni membro usa gli stessi comandi con lo stesso comportamento.

Task schedulati e automazioni ricorrenti

Claude Code non è solo interattivo. Con i task schedulati (remote triggers) puoi automatizzare operazioni ricorrenti senza intervento umano:

• Blog writer settimanale che genera draft di articoli da un calendario editoriale
• SEO auditor giornaliero che controlla metadata, heading structure e broken links
• Report builder che genera report analytics ogni lunedì mattina
• Content distributor che ripubblica contenuti su canali social

I trigger si configurano via API o CLI e girano su infrastruttura Anthropic. Puoi controllarli anche da Telegram e Discord. Per la guida implementativa completa, leggi Task Schedulati con Claude Code: Guida Pratica 2026.

Claude Code in produzione: casi d’uso B2B

Ho 21 automazioni Claude Code in produzione. Ecco i pattern che funzionano nel contesto B2B italiano.

1. Refactoring batch: Claude Code legge 50+ file, capisce le dipendenze e applica modifiche coerenti. Un refactoring che richiederebbe 2 giorni manuali diventa 30 minuti di supervisione.

2. SEO automation: Analisi automatica di meta tag, heading structure, structured data, internal linking. Come ho automatizzato la SEO del mio sito — caso studio con numeri reali.

3. Deploy con rollback: Pipeline CI/CD gestita da Claude Code: test, build, deploy, verifica, rollback automatico se qualcosa si rompe. Dettagli in Come Ho Automatizzato il Deploy del Mio Sito.

4. Report B2B automatici: Sub-agenti Python che raccolgono dati da fonti diverse e generano report strutturati. Leggi Claude Agent SDK: Report B2B con Sub-Agenti.

5. Outreach e CRM: Generazione email personalizzate da dati CRM, follow-up automatici, classificazione risposte. Tutto gestito da Claude Code con accesso a Gmail, CRM e database contatti.

Per 5 workflow completi con codice, leggi Workflow Claude Code per l’Automazione B2B.

Pricing e limiti (aprile 2026)

Tutti i piani usano Opus 4.6 come modello default con context window di 1 milione di token.

• Pro ($20/mese) — uso standard, ideale per developer individuali
• Team ($30/mese) — uso standard + condivisione workspace tra membri del team
• Max 5x ($100/mese) — 5 volte i limiti standard, il sweet spot per chi usa Claude Code in produzione
• Max 20x ($200/mese) — 20 volte i limiti, per team con automazioni batch intensive
• Enterprise (prezzo custom) — limiti illimitati, deployment on-premise disponibile

I limiti si riferiscono al numero di messaggi/ora. Per chi usa Claude Code in produzione tutto il giorno, il piano Max 5x è il miglior rapporto qualità-prezzo. Il Max 20x serve solo per team con automazioni batch che girano in parallelo.

Confronto con altri strumenti

Come si posiziona Claude Code rispetto alle alternative? Ecco le differenze principali:

Claude Code vs GitHub Copilot: Copilot è un assistente di completamento integrato nell’IDE. Claude Code è un agente autonomo che opera su filesystem, shell e Git. Copilot suggerisce, Claude Code agisce.

Claude Code vs Cursor: Cursor è un IDE con AI integrata. Claude Code è un agente che funziona in qualsiasi ambiente — terminale, desktop, web, IDE. La context window di Claude Code (1M token) è circa 8 volte quella di Cursor.

Claude Code vs Windsurf: Simile a Cursor, Windsurf è un IDE con capacità agentiche. Claude Code offre MCP, hooks e task schedulati che nessun IDE-based tool ha.

La differenza chiave: Claude Code è l’unico che opera come agente completo con accesso al filesystem, shell, Git e servizi esterni via MCP. Gli altri sono assistenti di completamento con capacità agentiche limitate.

FAQ

Claude Code è gratuito? No. Richiede un abbonamento Claude Pro ($20/mese) o superiore. Non esiste un tier gratuito per Claude Code.

Posso usare Claude Code senza terminale? Sì. Da aprile 2026 Claude Code è disponibile come desktop app (Mac e Windows), web app su claude.ai/code, e come estensione per VS Code e JetBrains. Il terminale resta l’interfaccia più potente.

Claude Code funziona su Windows? Sì. Supporto nativo Windows, macOS e Linux.

Qual è la differenza tra Claude Code e Claude Cowork? Claude Code opera nel terminale/IDE ed è pensato per sviluppatori. Claude Cowork opera sul desktop e interagisce con qualsiasi applicazione — browser, Figma, Excel. Cowork è l’agente per non-developer.

I miei dati sono al sicuro? Claude Code processa i file localmente e invia al modello solo il contesto necessario. Nessun dato viene usato per il training. Il piano Enterprise offre garanzie aggiuntive.

Posso usare Claude Code per gestire un sito intero? Sì. Questo sito (giovanniliguori.it) è gestito interamente con Claude Code: sviluppo, deploy, SEO, content pipeline. È il caso studio più completo che conosco.

Approfondimenti correlati

• Claude AI: Guida Completa 2026 per Freelancer e PMI
• Claude Cowork: Guida Definitiva all’Agente Desktop AI
• Claude Code: Come Ho Automatizzato il Deploy del Mio Sito
• Claude Agent SDK: Report B2B Automatici con Sub-Agenti Python
• MCP e Claude: Guida Pratica per Connettere API Esterne
• I Plugin di Claude Cowork: Come Installarli e Creare i Tuoi
• Workflow Claude Code: 5 Processi B2B Automatizzati
• Claude Code per la SEO: Caso Studio con Numeri Reali
• Task Schedulati con Claude Code: Guida Pratica 2026
• Come Costruire un Agente AI con Claude
• Come Scrivere System Prompt che Funzionano
• Opus 4.6 vs Sonnet 4.6 vs Haiku: Come Scegliere

Tutto l’ecosistema Claude in 37 pagine: Claude Mastery — 10 moduli, 4 case study, template pronti.

Per vedere Claude Code applicato a casi concreti in produzione, leggi 5 Workflow Claude Code per l’Automazione B2B: refactoring batch, report SEO, deploy Cloud Run con rollback automatico e outreach da CRM.

Approfondimenti operativi su Claude Code

• Quando il deploy diventa il collo di bottiglia: Come ho automatizzato il deploy del mio sito con Claude Code — pipeline GitHub Actions guidata da Claude, rollback automatico su 5xx.
• Per chi vuole far girare Claude Code in modalità cron senza presidio: Task schedulati con Claude Code — guida pratica 2026 — confronto Cowork scheduled vs Routines cloud, error handling esplicito, signals bus.
• Controllare l'agente da mobile o team chat: Claude Code Channels — controlla il tuo agente AI da Telegram e Discord — setup webhook, gestione permessi, prompt templating.
• Per orchestrare sub-agenti in Python invece che dentro Claude Code: Claude Agent SDK — report B2B automatici con sub-agenti Python — architettura orchestrator + N worker, gestione token e context window.
• I system prompt fanno la differenza tra prototipo e produzione: Come scrivere system prompt che funzionano — 5 pattern testati su Claude — ruolo, guardrail, output schema, esempi few-shot e regola di fallback.
• Test reali su Opus 4.7 con Claude Code: xhigh, adaptive thinking e tool use conservativo — best practices testate — quando vale la pena alzare il reasoning effort e quando è spreco.