SpyBara
Go Premium

how-claude-code-works.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 40 additions and 78 deletions.

2026
Wed 9 22:58 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Come funziona Claude Code

Comprendi il ciclo agentico, gli strumenti integrati e come Claude Code interagisce con il tuo progetto.

Claude Code è un assistente agentico che funziona nel tuo terminale. Sebbene eccella nella programmazione, può aiutarti con qualsiasi cosa tu possa fare dalla riga di comando: scrivere documentazione, eseguire build, cercare file, ricercare argomenti e molto altro.

Questa guida copre l'architettura principale, le capacità integrate e suggerimenti per lavorare efficacemente. Per procedure dettagliate, consulta Flussi di lavoro comuni. Per funzionalità di estensibilità come skills, MCP e hooks, consulta Estendi Claude Code.

Il ciclo agentico

Quando dai a Claude un compito, lavora attraverso tre fasi: raccogliere contesto, intraprendere azioni e verificare i risultati. Queste fasi si mescolano insieme. Claude utilizza strumenti durante tutto il processo, sia cercando file per comprendere il tuo codice, modificando per apportare cambiamenti, o eseguendo test per verificare il suo lavoro.

Diagramma del ciclo agentico: il tuo prompt porta Claude a raccogliere contesto, intraprendere azioni, verificare i risultati e ripetere fino al completamento dell'attività. Puoi interrompere in qualsiasi momento. Diagramma del ciclo agentico: il tuo prompt porta Claude a raccogliere contesto, intraprendere azioni, verificare i risultati e ripetere fino al completamento dell'attività. Puoi interrompere in qualsiasi momento.

Il ciclo si adatta a quello che chiedi. Una domanda sulla tua base di codice potrebbe richiedere solo la raccolta di contesto. Una correzione di bug cicla attraverso tutte e tre le fasi ripetutamente. Un refactoring potrebbe comportare una verifica estesa. Claude decide cosa richiede ogni passaggio in base a quello che ha imparato dal passaggio precedente, concatenando dozzine di azioni insieme e correggendo il corso lungo il percorso.

Anche tu fai parte di questo ciclo. Puoi interrompere in qualsiasi momento per indirizzare Claude in una direzione diversa, fornire contesto aggiuntivo o chiedergli di provare un approccio diverso. Claude lavora autonomamente ma rimane reattivo al tuo input.

Il ciclo agentico è alimentato da due componenti: modelli che ragionano e strumenti che agiscono. Claude Code funge da harness agentico intorno a Claude: fornisce gli strumenti, la gestione del contesto e l'ambiente di esecuzione che trasformano un modello di linguaggio in un agente di codifica capace.

Modelli

Claude Code utilizza i modelli Claude per comprendere il tuo codice e ragionare sui compiti. Claude può leggere codice in qualsiasi linguaggio, comprendere come i componenti si collegano e capire cosa deve cambiare per raggiungere il tuo obiettivo. Per compiti complessi, suddivide il lavoro in passaggi, li esegue e si adatta in base a quello che impara.

Sono disponibili più modelli con diversi compromessi. Sonnet gestisce bene la maggior parte dei compiti di codifica. Opus fornisce un ragionamento più forte per decisioni architettoniche complesse. Cambia con /model durante una sessione o inizia con claude --model <name>.

Quando questa guida dice "Claude sceglie" o "Claude decide", è il modello che sta facendo il ragionamento.

Strumenti

Gli strumenti sono ciò che rende Claude Code agentico. Senza strumenti, Claude può solo rispondere con testo. Con gli strumenti, Claude può agire: leggere il tuo codice, modificare file, eseguire comandi, cercare il web e interagire con servizi esterni. Ogni utilizzo di uno strumento restituisce informazioni che si alimentano nel ciclo, informando la decisione successiva di Claude.

Gli strumenti integrati generalmente rientrano in cinque categorie, ognuna rappresentante un diverso tipo di agenzia.

Categoria Cosa Claude può fare
Operazioni su file Leggere file, modificare codice, creare nuovi file, rinominare e riorganizzare
Ricerca Trovare file per pattern, cercare contenuto con regex, esplorare basi di codice
Esecuzione Eseguire comandi shell, avviare server, eseguire test, usare git
Web Cercare il web, recuperare documentazione, cercare messaggi di errore
Intelligenza del codice Vedere errori di tipo e avvisi dopo le modifiche, saltare alle definizioni, trovare riferimenti (richiede plugin di intelligenza del codice)

Queste sono le capacità principali. Claude ha anche strumenti per generare subagents, farti domande e altri compiti di orchestrazione. Consulta Strumenti disponibili per Claude per l'elenco completo.

Claude sceglie quali strumenti utilizzare in base al tuo prompt e a quello che impara lungo il percorso. Quando dici "correggi i test falliti", Claude potrebbe:

  1. Eseguire la suite di test per vedere cosa sta fallendo
  2. Leggere l'output dell'errore
  3. Cercare i file sorgente rilevanti
  4. Leggere quei file per comprendere il codice
  5. Modificare i file per correggere il problema
  6. Eseguire di nuovo i test per verificare

Ogni utilizzo di uno strumento fornisce a Claude nuove informazioni che informano il passaggio successivo. Questo è il ciclo agentico in azione.

Estensione delle capacità di base: Gli strumenti integrati sono la fondazione. Puoi estendere quello che Claude sa con skills, connetterti a servizi esterni con MCP, automatizzare flussi di lavoro con hooks e delegare compiti a subagents. Queste estensioni formano un livello sopra il ciclo agentico principale. Consulta Estendi Claude Code per una guida sulla scelta dell'estensione giusta per le tue esigenze.

A cosa Claude può accedere

Quando esegui claude in una directory, Claude Code ottiene accesso a:

  • Il tuo progetto. File nella tua directory e sottodirectory, più file altrove con la tua autorizzazione.
  • Il tuo terminale. Qualsiasi comando che potresti eseguire: strumenti di build, git, gestori di pacchetti, utilità di sistema, script. Se puoi farlo dalla riga di comando, Claude può farlo anche lui.
  • Il tuo stato git. Ramo corrente, modifiche non committate e cronologia dei commit recenti.
  • Il tuo CLAUDE.md. Un file markdown dove memorizzi istruzioni specifiche del progetto, convenzioni e contesto che Claude dovrebbe conoscere ogni sessione.
  • Auto memory. Apprendimenti che Claude salva automaticamente mentre lavori, come le tue preferenze. Le prime 200 righe o 25KB di MEMORY.md, a seconda di quale viene raggiunto per primo, si caricano all'inizio di ogni sessione.
  • Estensioni che configuri. Server MCP per servizi esterni, skills per flussi di lavoro, subagents per lavoro delegato e Claude in Chrome per l'interazione del browser.

Poiché Claude vede l'intero tuo progetto, può lavorare su di esso. Quando chiedi a Claude di "correggere il bug di autenticazione", cerca file rilevanti, legge più file per comprendere il contesto, apporta modifiche coordinate su di essi, esegue test per verificare la correzione e committa le modifiche se lo chiedi. Questo è diverso dagli assistenti di codice inline che vedono solo il file corrente.

Ambienti e interfacce

Il ciclo agentico, gli strumenti e le capacità descritti sopra sono gli stessi ovunque tu usi Claude Code. Quello che cambia è dove il codice viene eseguito e come interagisci con esso.

Ambienti di esecuzione

Claude Code funziona in tre ambienti, ognuno con diversi compromessi per dove il tuo codice viene eseguito.

Ambiente Dove viene eseguito il codice Caso d'uso
Locale La tua macchina Predefinito. Accesso completo ai tuoi file, strumenti e ambiente
Cloud VM gestite da Anthropic, o ambienti auto-ospitati che la tua organizzazione gestisce Delegare compiti, lavorare su repo che non hai localmente
Remote Control La tua macchina, controllata da un browser Usa l'interfaccia web mantenendo l'esecuzione e i tuoi file locali

Interfacce

Puoi accedere a Claude Code tramite il terminale, l'app desktop, estensioni IDE, claude.ai/code, Remote Control, Slack e pipeline CI/CD. L'interfaccia determina come vedi e interagisci con Claude, ma il ciclo agentico sottostante è identico. Consulta Usa Claude Code ovunque per l'elenco completo.

Lavora con le sessioni

Claude Code salva la tua conversazione localmente mentre lavori. Ogni messaggio, utilizzo di strumento e risultato viene scritto in un file JSONL in testo semplice sotto ~/.claude/projects/, il che consente il rewind, la ripresa e il fork delle sessioni. Prima che Claude apporta modifiche al codice, crea anche uno snapshot dei file interessati in modo da poter ripristinare se necessario. Per i percorsi, la conservazione e come cancellare questi dati, consulta dati dell'applicazione in ~/.claude.

Le sessioni sono indipendenti. Ogni nuova sessione inizia con una finestra di contesto fresca, senza la cronologia della conversazione dalle sessioni precedenti. Claude può persistere gli apprendimenti tra le sessioni utilizzando auto memory e puoi aggiungere le tue istruzioni persistenti in CLAUDE.md.

Lavora tra i rami

Ogni conversazione di Claude Code è una sessione legata alla tua directory corrente. Il picker /resume mostra sessioni dal worktree corrente per impostazione predefinita, con scorciatoie da tastiera per ampliare l'elenco ad altri worktrees o progetti. Consulta Gestisci sessioni per l'elenco completo delle scorciatoie del picker e come funziona la risoluzione dei nomi.

Claude vede i file del tuo ramo corrente. Quando cambi ramo, Claude vede i file del nuovo ramo, ma la cronologia della tua conversazione rimane la stessa. Claude ricorda quello che hai discusso anche dopo il cambio di ramo.

Poiché le sessioni sono legate alle directory, puoi eseguire sessioni Claude parallele utilizzando git worktrees, che creano directory separate per singoli rami.

Riprendi o fai il fork delle sessioni

Riprendere una sessione con claude --continue o claude --resume la riapre con lo stesso ID di sessione e aggiunge nuovi messaggi alla conversazione esistente. Fare il fork con --fork-session o /branch copia la cronologia in un nuovo ID di sessione, lasciando l'originale invariato.

Diagramma della continuità della sessione: resume continua la stessa sessione, fork crea un nuovo ramo con un nuovo ID. Diagramma della continuità della sessione: resume continua la stessa sessione, fork crea un nuovo ramo con un nuovo ID.

Per i flag di ripresa, il picker /resume, la denominazione e cosa succede quando la stessa sessione è aperta in due terminali, consulta Gestisci sessioni.

La finestra di contesto

La finestra di contesto di Claude contiene la cronologia della tua conversazione, i contenuti dei file, gli output dei comandi, CLAUDE.md, auto memory, le skills caricate e le istruzioni di sistema. Man mano che lavori, il contesto si riempie. Claude compatta automaticamente, ma le istruzioni dall'inizio della conversazione possono andare perse. Metti le regole persistenti in CLAUDE.md ed esegui /context per vedere cosa sta usando lo spazio.

Per una procedura interattiva di quello che si carica e quando, consulta Esplora la finestra di contesto.

Quando il contesto si riempie

Claude Code gestisce il contesto automaticamente mentre ti avvicini al limite. Cancella prima gli output degli strumenti più vecchi, quindi riassume la conversazione se necessario. Le tue richieste e i frammenti di codice chiave vengono preservati; le istruzioni dettagliate dall'inizio della conversazione possono andare perse. Metti le regole persistenti in CLAUDE.md piuttosto che fare affidamento sulla cronologia della conversazione.

Per controllare cosa viene preservato durante la compattazione, aggiungi una sezione "Compact Instructions" a CLAUDE.md o esegui /compact con un focus (come /compact focus on the API changes).

Se un singolo file o output di strumento è così grande che il contesto si riempie immediatamente dopo ogni riassunto, Claude Code smette di compattare automaticamente dopo alcuni tentativi e mostra un errore invece di fare un ciclo. Consulta Auto-compaction stops with a thrashing error per i passaggi di recupero.

Esegui /context per vedere cosa sta usando lo spazio. Le definizioni degli strumenti MCP vengono differite per impostazione predefinita e caricate su richiesta tramite ricerca degli strumenti, quindi solo i nomi degli strumenti e le istruzioni del server consumano contesto fino a quando Claude utilizza uno strumento specifico.

Gestisci il contesto con skills e subagents

Oltre alla compattazione, puoi utilizzare altre funzionalità per controllare cosa viene caricato nel contesto.

Skills si caricano su richiesta. Claude vede le descrizioni delle skills all'inizio della sessione, ma il contenuto completo si carica solo quando una skill viene utilizzata. Per le skills che invochi manualmente, imposta disable-model-invocation: true per mantenere le descrizioni fuori dal contesto fino a quando non ne hai bisogno. Per le skills che non hai scritto, utilizza skillOverrides per fare lo stesso dalle impostazioni.

Subagents lavorano nella loro finestra di contesto. Un subagent inizia da zero a meno che non sia un fork, che inizia con una copia della tua conversazione fino a quel momento. In entrambi i casi, le chiamate di strumento del subagent rimangono fuori dal tuo contesto e Claude riceve un riassunto quando il subagent finisce.

Consulta costi del contesto per quello che ogni funzionalità costa e riduci l'utilizzo dei token per suggerimenti sulla gestione del contesto.

Rimani al sicuro con checkpoint e permessi

Claude ha due meccanismi di sicurezza: i checkpoint ti permettono di annullare le modifiche ai file e i permessi controllano cosa Claude può fare senza chiedere.

Annulla le modifiche con i checkpoint

Ogni modifica ai file è reversibile. Prima che Claude modifichi un file, crea uno snapshot dei contenuti attuali. Se qualcosa va storto, premi Esc due volte per tornare a uno stato precedente, o chiedi a Claude di annullare.

I checkpoint sono separati da git e rimangono disponibili quando riprendi una conversazione. Coprono solo le modifiche ai file, e un ripristino salta i file con collegamento simbolico e collegamento fisico. Le azioni che influenzano i sistemi remoti (database, API, distribuzioni) non possono essere checkpointed. Li controlli con la tua modalità di permesso e le tue regole di permesso.

Controlla cosa Claude può fare

Scegli una modalità di permesso per impostare cosa Claude può fare senza chiedere. Premi Shift+Tab per scorrere le modalità di permesso:

  • Auto: un classificatore esamina la maggior parte delle azioni in background e blocca quelle rischiose invece di chiedere. Nei piani Pro, Max e Team, è la modalità di permesso iniziale integrata per le sessioni interattive di terminale e VS Code
  • Manual: Claude chiede prima delle modifiche ai file e dei comandi shell
  • Accept edits: Claude modifica i file ed esegue comandi comuni del file system come mkdir e mv senza chiedere, chiede ancora per altri comandi
  • Plan: Claude esplora e propone un piano senza modificare i tuoi file sorgente

Puoi anche consentire comandi specifici in .claude/settings.json in modo che Claude non chieda ogni volta. Questo è utile per comandi affidabili come npm test o git status. Le impostazioni possono essere scoped da politiche a livello di organizzazione fino alle preferenze personali. Consulta Permessi per i dettagli.

Lavora efficacemente con Claude Code

Questi suggerimenti ti aiutano a ottenere risultati migliori da Claude Code. Per ulteriori informazioni su prompt specifici, verifica e pianificazione, vedi Best practices.

Chiedi aiuto a Claude Code

Claude Code può insegnarti come usarlo. Fai domande come "come configuro gli hooks?" o "qual è il modo migliore per strutturare il mio CLAUDE.md?" e Claude spiegherà.

I comandi integrati ti guidano anche attraverso la configurazione:

  • /init ti guida attraverso la creazione di un CLAUDE.md per il tuo progetto
  • /doctor esegue un controllo di configurazione che diagnostica i problemi di installazione e configurazione e può risolverli

È una conversazione

Claude Code è conversazionale. Non hai bisogno di prompt perfetti. Inizia con quello che vuoi, quindi affina:

Correggi il bug di login

[Claude indaga, prova qualcosa]

Non è del tutto giusto. Il problema è nella gestione della sessione.

[Claude adatta l'approccio]

Quando il primo tentativo non è giusto, non ricominciare da capo. Itera.

Interrompi e indirizza

Puoi reindirizzare Claude in qualsiasi momento senza aspettare che il turno finisca o ricominciare da capo:

  • Premi Esc per fermare Claude immediatamente. La chiamata dello strumento in esecuzione viene annullata e Claude attende la tua prossima istruzione. Se hai messaggi in coda, Claude Code li invia successivamente.
  • Digita una correzione e premi Invio per inviarla senza fermare lo strumento in esecuzione. Claude la legge non appena l'azione corrente si completa e si adatta prima di decidere il suo prossimo passo.

Delega, non dettare

Pensa di delegare a un collega capace. Fornisci contesto e direzione, quindi affida a Claude di capire i dettagli:

Il flusso di checkout è rotto per gli utenti con carte scadute.
Il codice rilevante è in src/payments/. Puoi indagare e correggerlo?

Non hai bisogno di specificare quali file leggere o quali comandi eseguire. Claude lo capisce.

Cosa c'è dopo

puzzle-piece Estendi con funzionalità

Aggiungi skills e connessioni MCP
graduation-cap Flussi di lavoro comuni

Guide passo dopo passo per compiti tipici