Claude Code è l'agente di codifica AI basato su terminale di Anthropic. Scrivi ciò che vuoi in inglese semplice, e lui legge il tuo codebase, scrive codice, esegue comandi, corregge errori e commette le modifiche — tutto dal tuo terminale. Nessun plugin IDE. Nessuna scheda del browser. Solo tu e l'AI in una finestra del terminale.
A differenza di Cursor (che funziona all'interno di un IDE) o Codex (che funziona nel cloud), Claude Code gira localmente nel tuo ambiente di sviluppo reale. Vede i tuoi file, la tua cronologia git e l'output del tuo terminale. Questo lo rende più veloce per molti workflow perché non c'è alternanza di contesto tra l'AI e il tuo codice.
Questa guida copre l'installazione, il tuo primo progetto, i comandi principali e il workflow che fa funzionare Claude Code alla perfezione.
| Tool | Ideale per | Dove gira | Workflow |
|---|---|---|---|
| Claude Code | Codifica agentica interattiva | Terminale locale | Tu guidi + esegue i passaggi in tempo reale |
| Cursor | Codifica quotidiana + modifiche inline | All'interno dell'IDE | Diff visibili + autocompletamento |
| Codex | Compiti delegati asincroni | Sandbox cloud | Invia compito → rivedi PR dopo |
Come installare Claude Code
Hai bisogno di Node.js 18+ e di un account Claude (Pro o API).
Passo 1: Installa globalmente via npm:
npm install -g @anthropic-ai/claude-code
Passo 2: Vai nella directory del tuo progetto:
cd your-project
Passo 3: Avvia Claude Code:
claude
La prima volta che lo avvii, ti chiederà di autenticarti con il tuo account Anthropic. Se usi Claude Pro ($20/mese), ottieni un generoso limite di token. Se usi l'API, pagherai per token (controlla le tariffe attuali nel nostro guida sui limiti di tasso).
Stima dei costi (per evitare sorprese)
Se usi la fatturazione API, una sessione tipica di 30–60 minuti su un repository medio costa spesso $2–$10 a seconda del modello + numero di iterazioni. Usa /cost regolarmente e verifica le sessioni lunghe con il Vibe Coding Cost Calculator.
I Tuoi Primi 5 Minuti con Claude Code
Una volta avviato Claude Code, sei in una sessione interattiva. L'AI ha accesso all'intera directory del tuo progetto. Inizia in modo semplice:
Chiedigli di esplorare: Digita "Cos'è questo progetto? Dammi una panoramica di alto livello." Claude legge i tuoi file principali (package.json, README, punti di ingresso principali) e riassume ciò che trova. È un buon modo per verificare che capisca la struttura del tuo progetto.
Chiedigli di trovare qualcosa: "Dove si trova la logica di autenticazione?" Claude cerca nel tuo codice e ti indica i file rilevanti. Capisce la struttura del codice, non solo il matching di testo.
Chiedigli di cambiare qualcosa: "Aggiungi validazione input al form di registrazione. L'email deve essere in formato valido, password minima 8 caratteri." Claude identifica il componente del form, scrive la logica di validazione e ti mostra la diff prima di applicarla.
L'intuizione chiave: Claude Code opera sui tuoi file reali. Quando fa un cambiamento, è reale — i tuoi file vengono modificati su disco. Puoi vedere le modifiche nel tuo editor, eseguire test e committizzarli normalmente.
Comandi Essenziali
Claude Code ha diversi comandi slash che controllano il suo comportamento:
| Comando | Cosa Fa | Quando Usarlo |
|---|---|---|
/init | Crea un file CLAUDE.md nella root del progetto | Prima del tuo primo compito serio su un repo |
/compact | Comprimi la cronologia della conversazione vicino ai limiti di contesto | Sessioni lunghe; prima che la qualità cali |
/cost | Mostra i token usati + costo stimato | Fatturazione API, monitoraggio budget |
/clear | Reimposta la conversazione mantenendo il contesto | Passaggio tra compiti non correlati |
Stai ricavando valore da questo? Pubblichiamo guide settimanali su strumenti e workflow di coding con AI. Ricevile nella tua inbox →
Il File CLAUDE.md — Il Contesto AI del Tuo Progetto
Il file CLAUDE.md è la cosa più importante nel tuo flusso di lavoro con Claude Code. È un file markdown nella root del tuo progetto che Claude legge all'inizio di ogni sessione. Pensalo come istruzioni personalizzate per il tuo codice.
Un buon CLAUDE.md include:
Panoramica del progetto: Cosa fa il progetto, lo stack tecnologico e l'architettura in 3-5 frasi.
Convenzioni di codice: Le tue preferenze di formattazione, convenzioni di nomenclatura e pattern da seguire. "Usa componenti funzionali con hook. Preferisci export nominati. Usa Tailwind per lo styling."
File chiave: Indica a Claude i file più importanti da capire. "I modelli dati principali sono in lib/models/. Le route API sono in app/api/."
Cose da evitare: "Non modificare i file di migrazione del database. Non cambiare nulla in vendor/. Esegui sempre i test dopo aver modificato file api/."
Senza CLAUDE.md, Claude Code produce codice generico che potrebbe non adattarsi allo stile del tuo progetto. Con esso, l'output sembra codice scritto da qualcuno che è nel team da mesi. Questo è context engineering in pratica.
Flusso di Lavoro Reale: Costruire una Funzionalità
Ecco come uso Claude Code per una sessione tipica di sviluppo di una feature:
1. Inizia con l'obiettivo: "Aggiungi un rate limiter all'API. Usa Redis. Applicalo all'endpoint /api/submit con un limite di 10 richieste al minuto per IP."
2. Lascia che Claude pianifichi: Legge il codice API esistente, verifica se Redis è già configurato e propone un approccio. Rivedi il piano prima che inizi a codificare.
3. Guardalo lavorare: Claude crea il modulo rate limiter, lo integra nella route API, aggiunge variabili d'ambiente per la connessione Redis e scrive un test.
4. Test: Claude esegue i test. Se qualcosa fallisce, legge l'errore, adatta il codice e riprova. Questo ciclo di iterazione è dove gli agenti eccellono — gestisce il ciclo di debug che normalmente richiede più round di lavoro manuale.
5. Rivedi e committizza: Controlla la diff. Fai eventuali aggiustamenti. Committizza. Claude può scrivere anche il messaggio di commit se glielo chiedi.
Per una feature come questa, Claude Code risparmia tipicamente il 60-70% del tempo rispetto a scriverla manualmente. Il vero risparmio è nel boilerplate, nel codice di integrazione e nella scrittura dei test — le parti noiose ma non intellettualmente challenging.
Gestione dell'Uso dei Token
Claude Code usa token per ogni interazione. Sessioni lunghe su codebase grandi possono diventare costose con la fatturazione API. Ecco le abitudini che mantengono i costi ragionevoli:
Usa /compact regolarmente. Non aspettare che il contesto sia pieno. Compatta dopo aver completato ogni compito distinto.
Sii specifico. "Correggi il bug nel form di login" costa meno di "Guarda l'intera applicazione e trova bug." Richieste specifiche significano meno lettura di codice.
Usa /clear tra compiti non correlati. Se hai lavorato sul frontend e passi alle migrazioni del database, pulisci il contesto. Il vecchio contesto spreca token e può confondere il modello.
Controlla /cost frequentemente. Imposta un budget mentale per ogni sessione e verificarlo. Una sessione feature tipica di 30 minuti costa $2-8 con fatturazione API.
Per un confronto dettagliato dei costi tra Claude Code e Cursor, vedi il nostro confronto reale dei costi dopo 30 giorni.
Claude Code vs Cursor vs Codex
Guida rapida per la scelta:
| Opzione | Migliore quando... | Compromesso |
|---|---|---|
| Claude Code | Vuoi modifiche interattive su tutto il repository in locale | Richiede una revisione attenta (modifica file reali) |
| Cursor | Vuoi AI dentro il tuo IDE + ciclo di modifica rapido | Meno autonomia hands-off rispetto agli agenti terminal |
| Codex | Vuoi delega asincrona basata su PR | Meno interattivo; il contesto può deviare |
Claude Code: Ideale per sviluppatori che vogliono contesto su tutto il progetto e workflow nativi del terminale. Interattivo, in tempo reale, lavora sui tuoi file reali. Perfetto per feature complesse, refactoring e debugging.
Cursor: Ideale per sviluppatori che vogliono AI dentro il loro IDE. Vedi le modifiche in tempo reale con diff inline. Perfetto per la codifica quotidiana con suggerimenti AI. Confronto completo qui.
Codex: Ideale per team che vogliono task di codifica asincroni e batch. Invia un task, rivedi la PR dopo. Perfetto per task ben definiti che vuoi delegare completamente. Confronto completo qui.
Molti sviluppatori usano due o più tool. Claude Code per feature complesse, Cursor per editing quotidiano, Codex per task batch.
Vuoi migliorare i tuoi prompt per qualsiasi tool di codifica AI? The Prompt Optimizer ti aiuta a strutturare le richieste per output più chiari e specifici.
Ne vuoi altri così? Pubblichiamo settimanalmente su tool di codifica AI e workflow per sviluppatori. Iscriviti gratis →
Domande Frequenti
Claude Code funziona su Windows?
Sì, tramite WSL (Windows Subsystem for Linux), PowerShell o Command Prompt. WSL offre la migliore esperienza poiché molti tool di sviluppo sono nativi Linux.
Claude Code può accedere a internet?
Claude Code non naviga il web di per sé, ma può eseguire comandi che lo fanno — curl, npm install, git clone. Può anche usare server MCP per accedere a servizi esterni come GitHub, database e API.
Come gestisce Claude Code codebase grandi?
La finestra di contesto da 200K token di Claude significa che può caricare e processare migliaia di file sorgente simultaneamente. Per monorepo molto grandi, legge selettivamente i file rilevanti invece di caricare tutto. Il file CLAUDE.md lo aiuta a sapere quali parti del codebase contano per ogni compito.
Il mio codice viene inviato ai server di Anthropic?
Sì, il tuo codice viene inviato all'API di Anthropic per l'elaborazione. Anthropic non addestra sui input API per impostazione predefinita, ma controlla i termini attuali se lavori con codice sensibile o proprietario. Considera di usare l'API con ritenzione dati disabilitata per la massima privacy.
Divulgazione: Alcuni link in questo articolo sono link affiliati. Raccomandiamo solo tool che abbiamo testato e usiamo regolarmente. Vedi la nostra politica di divulgazione completa.