Come usare Claude Code: guida completa e workflow

Circa 6,600 persone negli Stati Uniti cercano “how to use Claude Code” ogni mese. L'installazione è la parte più semplice. La vera competenza sta nel decidere cosa Claude può toccare, fornirgli il giusto contesto senza saturare la sessione e definire cosa significa “completato” prima ancora che scriva una singola riga.

Cosa fa realmente Claude Code

Claude Code è una sessione di lavoro connessa direttamente al tuo ambiente di sviluppo. Può leggere file, cercare all'interno di un repository, modificare codice, eseguire comandi da terminale, usare git, recuperare documentazione e ispezionare errori tramite plugin compatibili di code intelligence. È disponibile da terminale, VS Code, IDE JetBrains, nell'app desktop di Claude, via web, su mobile, Slack e nei workflow CI/CD.

Immagina il modello linguistico come l'ingegnere e Claude Code come l'officina che lo circonda. Il modello ragiona sul task. L'officina fornisce file, strumenti, permessi, memoria e un ambiente per eseguire verifiche. Ecco perché può rispondere a “correggi i test falliti” leggendo l'errore, individuando il codice rilevante, modificando più file contemporaneamente, rieseguendo i test e correggendo il tiro se la prima soluzione non regge.

Dietro le quinte, ogni attività segue un ciclo in tre parti:

1. Raccogliere contesto: ispezionare il repository, l'output degli errori, lo stato di git, le istruzioni di progetto ed eventuali riferimenti forniti dall'utente.
2. Agire: modificare file, lanciare comandi, utilizzare tool o richiedere una decisione all'utente.
3. Verificare: eseguire test, build, linter o altri controlli, per poi iterare se il risultato fallisce.

Claude Code può essere eseguito localmente sulla tua macchina, in un ambiente cloud gestito da Anthropic oppure tramite Remote Control, dove il codice rimane sul tuo computer mentre gestisci la sessione da un browser. Il ciclo dell'agente è identico, ma cambiano la posizione dei file, i tool disponibili e l'accesso alla rete.

Come installare e avviare Claude Code

La versione da terminale offre la comprensione più chiara di come opera Claude. Ti servono un progetto software e un piano Claude a pagamento, un account Claude Console o l'accesso tramite un provider cloud supportato. Il piano gratuito di Claude non include Claude Code.

Anthropic consiglia l'installer nativo. Scegli il comando adatto al tuo terminale:

# macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows con WinGet
winget install Anthropic.ClaudeCode

Le installazioni native si aggiornano automaticamente in background. Le installazioni tramite Homebrew, WinGet e i gestori di pacchetti Linux richiedono aggiornamenti manuali per impostazione predefinita. Esegui claude --version per verificare l'installazione o claude doctor se la configurazione presenta anomalie.

Apri quindi la cartella del progetto che vuoi far analizzare a Claude:

cd /path/to/your-project
claude

Al primo avvio si aprirà una procedura di login nel browser. Successivamente, comincia con una richiesta di sola lettura, come ad esempio: “Cosa fa questo progetto, qual è l'entry point principale e come si eseguono i suoi test?”. Claude legge i file all'occorrenza, eliminando la necessità di allegare l'intero repository file per file.

Se preferisci evitare il terminale, installa l'estensione per VS Code o apri la scheda Code nell'app desktop di Claude. La versione web su claude.ai/code esegue le elaborazioni in un ambiente cloud ed è indicata per task prolungati o per repository che non mantieni in locale.

Il workflow ideale: come usare Claude Code in modo affidabile

L'impostazione predefinita più solida è lineare: definisci l'ambito, pianifica, sviluppa, verifica e revisiona. Usa tutti e cinque i passaggi per modifiche che coinvolgono più file. Salta la pianificazione solo quando l'intervento è talmente circoscritto da poter descrivere il diff in una singola frase.

1. Parti da un obiettivo ben delimitato

Chiedere di “migliorare questa applicazione” costringe Claude a scansionare il codice a largo raggio e a tirare a indovinare. Una richiesta efficace specifica il sintomo, la posizione probabile, i vincoli e le condizioni di successo:

Questi dettagli non sono semplice decorazione del prompt: ciascuno elimina un'ambiguità che Claude dovrebbe altrimenti risolvere arbitrariamente.

2. Attiva la modalità Plan prima di modifiche rischiose

Premi Shift+Tab finché il terminale non mostra la modalità Plan, oppure avvia la sessione con claude --permission-mode plan. In questo stato Claude può leggere i file ed eseguire comandi di sola lettura, ma non modificherà il codice sorgente. Chiedigli di tracciare il flusso corrente, individuare i file interessati, elencare i rischi e proporre una strategia di verifica.

Analizza il piano come fosse una breve specifica tecnica. Correggi subito eventuali presupposti errati, prima che si trasformino in una patch dispersa su cinque file. Approva il piano solo quando l'ambito e i controlli proposti risultano convincenti.

3. Fornisci un controllo automatizzabile

Test unitari, un codice di uscita della build, un linter, un confronto di fixture o uno screenshot possono fungere da segnale univoco di successo o fallimento. Senza un controllo simile, Claude si ferma non appena il lavoro sembra plausibile. Con un riscontro oggettivo, può leggere l'errore e tentare nuovamente una correzione.

Per una modifica al backend, richiedi prima un test che fallisce e, al termine, una suite completamente verde. Per una modifica all'interfaccia utente, fornisci l'immagine di riferimento e chiedi a Claude di confrontarla con un nuovo screenshot. Per una migrazione, imponi il conteggio delle chiamate deprecate residue. Un riscontro oggettivo si verifica molto più rapidamente di una generica rassicurazione sul completamento del lavoro.

4. Mantieni i permessi proporzionati all'attività

La modalità predefinita chiede conferma prima di effettuare modifiche e prima della maggior parte dei comandi shell. La modalità Accept Edits rimuove le richieste di approvazione per la modifica dei file, continuando a proteggere le altre azioni. La modalità Plan impedisce qualunque modifica al codice sorgente. La modalità Auto impiega controlli di sicurezza in background, ma rimane una preview di ricerca.

Evita di usare Bypass Permissions sul tuo computer principale. Anthropic limita questa modalità a container isolati o macchine virtuali poiché ignora quasi tutte le richieste di conferma. I permessi, inoltre, non rendono sicura un'istruzione errata. Regole di esclusione (deny rules), sandboxing e hook costituiscono difese molto più robuste quando determinati percorsi o azioni devono restare inaccessibili.

5. Esamina le prove, non ogni singolo carattere digitato

Chiedi a Claude di riepilogare i file modificati, mostrare git diff, indicare il comando esatto eseguito per i test con il relativo esito e segnalare eventuali rischi irrisolti. Se l'intervento è corretto, invitalo a creare un commit descrittivo o una pull request. Se la direzione intrapresa è sbagliata, premi Esc per interromperlo. Premi due volte Esc o digita /rewind per tornare a un checkpoint precedente.

I checkpoint ripristinano le modifiche ai file effettuate tramite gli strumenti di editing di Claude. Non annullano scritture su database, deploy, chiamate API, modifiche dirette via Bash o processi esterni. Mantieni sempre git all'interno del ciclo di lavoro.

Fai ricordare a Claude il progetto, non l'intera conversazione

Il file CLAUDE.md funge da guida operativa persistente per il repository. Claude lo legge all'inizio di ogni sessione. Esegui /init per generare una prima bozza, quindi conserva solo le indicazioni che Claude non può dedurre autonomamente dal codice.

Tra le voci utili rientrano il comando preferito per i test, regole architetturali non convenzionali, variabili d'ambiente necessarie, convenzioni sui branch e insidie note del progetto. Non inserire una descrizione file per file né consigli generici di programmazione. Anthropic raccomanda di mantenere ogni file sotto le 200 righe: istruzioni troppo lunghe consumano contesto e riducono l'accuratezza con cui vengono seguite.

Usa gli hook quando una regola deve essere applicata sistematicamente. L'istruzione “esegui il formatter dopo ogni modifica” appartiene a un hook, se non sono ammesse eccezioni. Usa le skill per procedure che servono solo saltuariamente. Ricorri a MCP quando Claude deve interagire con un servizio esterno come un issue tracker o un design system. Impiega i subagenti quando un'indagine preliminare richiederebbe la lettura di una quantità di dati tale da intasare la sessione principale. L'approfondimento sui subagenti di Claude Code esamina in dettaglio questo modello di isolamento.

Il contesto è la risorsa più preziosa. La conversazione, i contenuti dei file, l'output dei comandi, le istruzioni e le definizioni dei tool competono tutti per lo stesso spazio. Esegui /clear tra task non correlati. Usa /compact quando l'attività è la stessa ma la sessione si è allungata. Riprendi l'ultima sessione con claude --continue, oppure selezionane una precedente con claude --resume.

Otto casi d'uso per Claude Code, ordinati per ritorno pratico

1. Rilasciare una funzionalità circoscritta su più file

Un product engineer che aggiunge il login con Google OAuth può chiedere a Claude di mappare il flusso di sessione esistente in modalità Plan, identificare ogni interfaccia coinvolta, scrivere i test di callback, implementare la modifica, eseguire la suite di test e preparare la pull request. Il vantaggio risiede nel coordinare interventi su route, modelli di dati, configurazione e test senza dover incollare manualmente ciascun file nella chat.

2. Riprodurre e risolvere un bug di produzione

Un ingegnere reperibile che riceve uno stack trace può fornire a Claude il comando di riproduzione e il modulo sospetto. Claude può eseguire il test fallito, tracciare il percorso della chiamata, scrivere un test di regressione, applicare il fix e rieseguire la specifica suite di test. Questo approccio è particolarmente conveniente quando la parte complessa è risalire alla causa primaria, non scrivere la patch.

3. Inserire un nuovo sviluppatore in una codebase sconosciuta

Una nuova risorsa può interrogare Claude sugli entry point del repository, il flusso dei dati, il percorso di autenticazione, i comandi di deploy e un glossario dei termini interni. Le domande possono passare dall'architettura generale al comportamento di una singola funzione. In questo modo si riducono le interruzioni per i colleghi senior, che altrimenti dovrebbero ripetere le stesse spiegazioni.

4. Modernizzare codice legacy ripetitivo

Un team di piattaforma che deve migrare un'API deprecata può incaricare Claude di individuare ogni occorrenza, proporre un lotto ridotto di modifiche, preservare la retrocompatibilità, aggiornare il primo gruppo, lanciare test mirati e conteggiare i riferimenti rimanenti. Piccoli incrementi verificati sono fondamentali: una richiesta generica di “modernizzare il repository” apre la strada a rotture silenziose.

5. Ridurre il debito sui test

Un maintainer può chiedere a Claude di individuare i rami di codice privi di copertura in un determinato servizio, studiare lo stile dei test già presenti, aggiungere casi per i percorsi più critici ed eseguire unicamente la suite di riferimento. Il vero valore non è la quantità di test scritti, bensì il percorso riproducibile: partire da un comportamento non coperto, dimostrare che il nuovo test fallisce per il motivo corretto e verificare che passi dopo la correzione.

6. Preparare una pull request più pulita

Prima della revisione, uno sviluppatore può chiedere a Claude di esaminare il diff attuale, rimuovere modifiche accidentali, lanciare linter e test, riassumere i cambiamenti comportamentali, evidenziare potenziali rischi e redigere una bozza descrittiva per la PR. I revisori umani ricevono così una modifica più compatta e spiegata chiaramente, senza dover ricostruire le intenzioni dell'autore dal diff.

7. Mantenere la documentazione allineata al codice

Un team di developer relations o di piattaforma può indirizzare Claude verso un'API modificata per fargli aggiornare esempi di codice, istruzioni del file README e release note, verificando subito dopo che ogni comando documentato sia ancora funzionante. Le richieste agli assistenti IA per “code documentation generator” si attestano intorno a 81 volte al mese (in crescita rispetto alle 49 dell'anno precedente), anche se la query specifica su Google genera volumi inferiori. Questa discrepanza suggerisce che l'esigenza viene spesso espressa direttamente all'interno delle conversazioni con le IA piuttosto che nei motori di ricerca.

8. Automatizzare la manutenzione ricorrente del repository

Un engineering manager può trasformare l'audit delle dipendenze, la stesura delle release note o il triage mattutino delle PR in una procedura pianificata, un task desktop o un comando CI non interattivo tramite claude -p. Il ritorno è la costanza nell'esecuzione di attività importanti ma continuamente rimandate. I task non presidiati richiedono permessi più restrittivi e una destinazione di output ben definita, non essendoci una persona pronta a chiarire richieste ambigue.

Tre prodotti che vale la pena costruire attorno a Claude Code

Il mercato generale degli assistenti di programmazione è già saturo. I prodotti sostenibili sono livelli di controllo specializzati che presidiano un workflow oneroso, conservano prove verificabili e offrono ai clienti un motivo valido per preferirli all'uso diretto di Claude Code.

Il più solido: un gate verticale per il rischio nelle PR

Sviluppa un revisore focalizzato su una specifica categoria di errori ad alto costo, come anomalie di autorizzazione nelle API fintech, migrazioni rischiose in software sanitari o breaking change su piattaforme TypeScript. Questo strumento ispezionerebbe la pull request confrontandola con le policy specifiche del repository, eseguirebbe controlli approvati e restituirebbe riscontri puntuali a livello di file anziché generici commenti di stile. I clienti ideali sono engineering lead e team attenti alla compliance.

La domanda è più contenuta rispetto al coding generico, ma molto più qualificata. La ricerca “AI code review” registra circa 1,300 ricerche mensili negli Stati Uniti, con un CPC di $63.85. La query “AI powered code review platform” aggiunge 1,600 ricerche al mese ed è cresciuta del 3,173% anno su anno. Greptile applica una tariffa di $30 per utente al mese per il suo piano di revisione del codice, a dimostrazione che i team sono già disposti a sostenere un costo ricorrente per questa funzione.

La versione minima commercializzabile prevede un'integrazione con GitHub, il supporto per un linguaggio o framework, cinque controlli ad alto valore, un commento di review con prove a supporto e una riesecuzione automatica dopo la patch. Il ciclo dell'agente di Claude Code o il Claude Agent SDK possono farsi carico dell'ispezione del repository e dell'esecuzione dei tool. Il prodotto effettivo consiste nel pacchetto di policy, nel dataset di valutazione e nel tracciamento di audit.

L'ostacolo principale è la concorrenza diretta dei revisori generici e delle piattaforme di sviluppo. Un generico “revisore IA” non ha vantaggi difendibili. Questa opportunità è la più valida solo se il prodotto intercetta falle di dominio che un revisore generico non è in grado di cogliere, dimostrando tale efficacia su un set di test costantemente aggiornato.

Un kit di adozione di Claude Code per team

Crea una configurazione guidata e un livello di policy per engineering manager che intendono adottare Claude Code su più repository contemporaneamente. Il prodotto verificherebbe l'installazione, genererebbe una prima versione sintetica di CLAUDE.md, proporrebbe regole per i permessi, installerebbe gli hook approvati, guiderebbe il primo task sul repository e produrrebbe una checklist di adozione pronta per l'amministrazione.

La specifica query su come procedere genera 6,600 ricerche mensili negli USA con un CPC di $5.71, eppure il dataset di citazioni di ChatGPT attualmente non restituisce fonti per essa. Un corso dedicato a Claude Code richiede un pagamento una tantum di $50, mentre Claude Pro costa $20 al mese. Questi dati evidenziano sia una frizione nell'apprendimento, sia una concreta disponibilità economica.

Un MVP potrebbe essere una CLI locale abbinata a un workflow guidato di 60 minuti per un singolo stack tecnologico. La prima versione può essere venduta come pacchetto di implementazione, per poi trasformare i controlli ricorrenti in software. Il limite è che un semplice tutorial diventa obsoleto man mano che Anthropic ottimizza l'onboarding. Il valore duraturo deve scaturire dalle policy aziendali, dalla configurazione dei repository e dalla misurazione dell'adozione, non da schermate della procedura d'installazione.

Un assistente di programmazione verticale per uno stack specifico

Realizza un assistente di sviluppo circoscritto per un'attività d'agenzia ricorrente, come la manutenzione di temi Shopify, la correzione di plugin WordPress o un framework proprietario per tool interni. Il cliente invia un ticket delimitato, esamina il piano proposto e riceve una pull request testata secondo i pattern previsti da quello specifico stack.

La ricerca “AI coding assistant” registra circa 22,200 ricerche mensili negli USA con intento commerciale e un CPC di $27.85. La query più specifica “agentic AI coding assistant” genera altre 2,900 ricerche con intento transazionale. Il mercato è evidentemente ampio, ma gli assistenti generici dominano già i casi d'uso generici.

L'MVP dovrebbe supportare un solo framework, un solo provider di repository, una suite di verifica e un gate di approvazione. Costruisci il livello di acquisizione, le policy e la raccolta prove attorno a Claude Code o all'Agent SDK. I rischi consistono nella dipendenza dalla piattaforma e nella responsabilità per eventuali patch difettose. Se il prodotto non riesce a definire un'attività ristretta che verifica meglio rispetto a una normale sessione generica, resta soltanto un'interfaccia superficiale costruita sull'agente di qualcun altro.

Cosa non risolve Claude Code

Claude Code non sostituisce il giudizio critico dell'ingegnere. Può produrre una patch che supera test molto specifici ma viola comunque un presupposto di prodotto, introduce una vulnerabilità di sicurezza o rende il sistema più difficile da manutenere. Le verifiche impostate rilevano esclusivamente gli scenari di errore per cui sono state progettate.

I permessi riducono il rischio di modifiche involontarie, ma non convalidano le intenzioni architetturali. I checkpoint possono ripristinare i file modificati, ma non annullano effetti collaterali remoti o modifiche apportate via shell. Inoltre, una sessione prolungata tende a perdere efficacia e a diventare più costosa man mano che il contesto si satura. Pulisci la cronologia tra task differenti, mantieni corte le istruzioni di progetto e fai revisionare le modifiche critiche da una sessione separata o da un collega.

Anche i costi sono una variabile da monitorare. Claude Code è incluso nei piani a pagamento, a partire da Pro a $20 al mese o $17 al mese con fatturazione annuale anticipata. L'utilizzo attinge allo stesso monte risorse delle altre interfacce di Claude, senza un numero fisso di messaggi. I clienti API pagano in base al consumo effettivo di token. Se il prezzo è un fattore determinante, consulta l'attuale analisi dei prezzi di Claude Code prima di standardizzare il flusso di lavoro per un intero team.

La conclusione più pragmatica è semplice: utilizza Claude Code per compiti con confini chiari e un criterio di completamento verificabile dalla macchina. Mantieni sotto il controllo umano le decisioni di architettura, le operazioni delicate e i compromessi di prodotto più complessi. L'agente offre il massimo rendimento quando può esplorare liberamente, agire all'interno di un perimetro definito e dimostrare oggettivamente il risultato ottenuto.

Se desideri integrare nella tua azienda un agente di sviluppo consapevole della codebase o realizzare uno di questi workflow verticali, scopri lo sviluppo di agenti IA.