Usa Claude Code in VS Code

Installa e configura l'estensione Claude Code per VS Code. Ottieni assistenza di codifica con IA con diff inline, @-mention, revisione del piano e scorciatoie da tastiera.

L'estensione VS Code fornisce un'interfaccia grafica nativa per Claude Code, integrata direttamente nel vostro IDE. Questo è il modo consigliato per utilizzare Claude Code in VS Code.

Con l'estensione, potete rivedere e modificare i piani di Claude prima di accettarli, accettare automaticamente le modifiche mentre vengono apportate, @-mention file con intervalli di righe specifici dalla vostra selezione, accedere alla cronologia delle conversazioni e aprire più conversazioni in schede o finestre separate.

Prerequisiti

Prima di installare, assicurati di avere:

• VS Code 1.94.0 o superiore
• Un account Anthropic: qualsiasi abbonamento Claude a pagamento (Pro, Max, Team o Enterprise) o un account Claude Console funziona, e non è richiesta alcuna chiave API. Accederai con questo account quando aprirai l'estensione per la prima volta. Se accedi a Claude tramite un provider di terze parti come Amazon Bedrock o Google Cloud's Agent Platform, consulta Usa provider di terze parti per le istruzioni di configurazione.

Installa l'estensione

Fai clic sul link per il tuo IDE per installare direttamente:

• Installa per VS Code
• Installa per Cursor

Oppure in VS Code, premi Cmd+Shift+X (Mac) o Ctrl+Shift+X (Windows/Linux) per aprire la visualizzazione Estensioni, cerca "Claude Code" e fai clic su Installa.

L'estensione si installa anche in altri fork di VS Code come Devin Desktop o Kiro. Cerca "Claude Code" nella visualizzazione Estensioni dell'editor, oppure installa dal registro Open VSX. Se il tuo editor non riesce a installare l'estensione, installa la CLI ed esegui claude nel suo terminale integrato. La CLI funziona in qualsiasi terminale.

Iniziare

Una volta installato, puoi iniziare a utilizzare Claude Code attraverso l'interfaccia di VS Code:

1

Apri il pannello Claude Code

In tutto VS Code, l'icona Spark indica Claude Code: <img src="https://mintcdn.com/claude-code/c5r9_6tjPMzFdDDT/images/vs-code-spark-icon.svg?fit=max&auto=format&n=c5r9_6tjPMzFdDDT&q=85&s=3ca45e00deadec8c8f4b4f807da94505" alt="Icona Spark" style={{display: "inline", height: "0.85em", verticalAlign: "middle"}} width="16" height="16" data-path="images/vs-code-spark-icon.svg" />

Il modo più veloce per aprire Claude è fare clic sull'icona Spark nella Barra degli strumenti dell'editor (angolo in alto a destra dell'editor). L'icona appare solo quando hai un file aperto.

Altri modi per aprire Claude Code:

• Activity Bar: fai clic sull'icona Spark nella barra laterale sinistra per aprire l'elenco delle sessioni. Fai clic su qualsiasi sessione per aprirla nella tua posizione preferita, o avvia una nuova. Questa icona è sempre visibile nella Activity Bar.
• Command Palette: Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux), digita "Claude Code" e seleziona un'opzione come "Open in New Tab"
• Status Bar: se hai impostato preferredLocation su sidebar, o hai aperto Claude con Claude Code: Open in Side Bar, fai clic su ✻ Claude Code nell'angolo in basso a destra della finestra. Questo funziona anche quando nessun file è aperto.

Puoi trascinare il pannello Claude per riposizionarlo ovunque in VS Code. Vedi Personalizza il tuo flusso di lavoro per i dettagli.

2

Accedi

La prima volta che apri il pannello, appare una schermata di accesso. Fai clic su Sign in e completa l'autorizzazione nel tuo browser.

Se vedi Not logged in · Please run /login in seguito, l'estensione riaprirà automaticamente la schermata di accesso. Se non appare, ricarica la finestra dalla Command Palette con Developer: Reload Window.

Se hai ANTHROPIC_API_KEY impostato nella tua shell ma vedi ancora il prompt di accesso, VS Code potrebbe non aver ereditato l'ambiente della tua shell. Avvia VS Code da un terminale con code . in modo che erediti le tue variabili di ambiente, oppure accedi con il tuo account Claude.

Dopo aver effettuato l'accesso, appare una checklist Learn Claude Code. Completa ogni elemento facendo clic su Show me, oppure chiudila con la X. Per riaprirla in seguito, deseleziona Hide Onboarding nelle impostazioni di VS Code in Extensions → Claude Code.

3

Invia un prompt

Chiedi a Claude di aiutarti con il tuo codice o i tuoi file, che si tratti di spiegare come funziona qualcosa, eseguire il debug di un problema o apportare modifiche.

Ecco un esempio di domanda su una riga particolare in un file:

4

Rivedi le modifiche

Quello che vedi dipende dalla modalità di autorizzazione mostrata in fondo alla casella del prompt:

• In modalità Auto o Edit automatically, Claude modifica la maggior parte dei file nel tuo workspace senza chiedere.
• In modalità Manual, quando Claude vuole modificare un file, mostra un confronto affiancato dell'originale e delle modifiche proposte, quindi chiede l'autorizzazione. Puoi accettare, rifiutare o dire a Claude cosa fare invece. Se modifichi il contenuto proposto direttamente nella vista diff prima di accettare, Claude viene informato che l'hai modificato in modo che non assuma che il file corrisponda alla sua proposta originale.

Per altre idee su cosa puoi fare con Claude Code, vedi Flussi di lavoro comuni.

Usa la casella di prompt

La casella di prompt supporta diverse funzionalità:

• Modalità di autorizzazione: fai clic sull'indicatore di modalità nella parte inferiore della casella di prompt per cambiare le modalità di autorizzazione. Nei piani Pro, Max e Team, Auto è la modalità di autorizzazione predefinita all'avvio. Consulta come l'estensione sceglie la modalità di autorizzazione iniziale per sapere cosa la cambia e ogni modalità di autorizzazione che l'indicatore offre.

  • Auto: un classificatore esamina la maggior parte delle azioni invece di chiederti. Consulta modalità auto per sapere cosa esamina e blocca.
  • Manual: Claude chiede l'autorizzazione prima delle modifiche ai file e della maggior parte dei comandi shell.
  • Plan: Claude descrive cosa farà e attende l'approvazione prima di apportare modifiche. VS Code apre automaticamente il piano come documento Markdown completo dove puoi aggiungere commenti inline per fornire feedback prima che Claude inizi.
  • Edit automatically: Claude apporta modifiche senza chiedere.

• Model: seleziona Switch model… dal menu dei comandi per cambiare il modello durante la sessione. Puoi anche fare clic sul nome del modello nella parte inferiore della casella di prompt per aprire lo stesso selettore. Quando il modello attuale supporta livelli di sforzo, il selettore mostra anche una riga Effort e il pulsante del nome del modello mostra il livello selezionato. Il pulsante del nome del modello e la riga Effort richiedono Claude Code v2.1.257 o successivo.

• Command menu: fai clic su / o digita / per aprire il menu dei comandi. Le opzioni includono l'allegazione di file, il cambio di modelli e l'attivazione del pensiero esteso. La sezione Customize fornisce accesso ai server MCP, slash commands, stili di output, hooks, memoria, autorizzazioni e plugin. Gli elementi con un'icona di terminale si aprono nel terminale integrato.

  • Per sfogliare comandi come /usage o /remote-control, seleziona Slash commands nella sezione Customize. Una finestra di dialogo li elenca con una casella di filtro. Scegline uno per eseguirlo. Digitare / nella casella di prompt suggerisce comunque i comandi inline. Richiede Claude Code v2.1.257 o successivo.

  • Seleziona Output styles nella sezione Customize per scegliere uno stile di output, inclusi i tuoi stili personalizzati. Richiede Claude Code v2.1.257 o successivo.

    Per creare uno stile personalizzato, seleziona Build a custom style dal menu Output styles. Claude Code scrive il file di stile per te a livello di progetto o utente. Richiede Claude Code v2.1.261 o successivo.

  • Seleziona Hooks nella sezione Customize per visualizzare gli hooks caricati nella sessione, raggruppati per evento. Puoi aggiungere, modificare o rimuovere gli hooks salvati nei tuoi file di impostazioni utente, progetto e locale. Gli hooks da altre fonti, come impostazioni gestite o plugin, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.

  • Seleziona Permissions nella sezione Customize per visualizzare le regole di autorizzazione della sessione, raggruppate in Allow, Ask e Deny. Puoi aggiungere regole ai tuoi file di impostazioni utente, progetto o locale e rimuovere le regole salvate lì. Le regole da altre fonti, come impostazioni gestite o approvazioni effettuate solo per questa sessione, sono di sola lettura. Richiede Claude Code v2.1.269 o successivo.

  • La sezione Settings include Enable Remote Control for all sessions, che imposta remoteControlAtStartup per controllare se le nuove sessioni interattive si connettono a Remote Control automaticamente. Richiede Claude Code v2.1.203 o successivo.

    Quando attivi o disattivi l'interruttore in una finestra di VS Code, la modifica si applica alle sessioni già aperte in quella finestra di VS Code, non solo alle sessioni che avvii successivamente. Se lo disattivi, le sessioni aperte si disconnettono. Con Claude Code v2.1.261 o successivo, la modifica raggiunge anche le sessioni aperte nelle altre finestre di VS Code.

  • La sezione Settings include anche Focus view, che nasconde le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i tuoi prompt e le risposte di Claude. Attivalo lì, con Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux), o dalla Tavolozza dei comandi con Claude Code: Toggle Focus view. La modifica si applica a ogni sessione aperta e persiste tra le sessioni. Richiede Claude Code v2.1.221 o successivo.

    L'elenco di cose da fare più recente di Claude rimane visibile, così come il testo di una domanda in sospeso da Claude; questo richiede Claude Code v2.1.225 o successivo. Mentre Claude esegue subagenti, le righe di progresso in tempo reale con la loro attività più recente appaiono sotto il gruppo di chiamate di strumenti che le ha avviate. Questo richiede Claude Code v2.1.269 o successivo.

  • Per segnalare un bug, fai clic su Report a problem nella parte inferiore del menu, o digita /bug o /feedback con una descrizione facoltativa che precompila il rapporto. Quando invii il rapporto e sei connesso ad Anthropic su una connessione di prima parte, Claude Code lo invia ad Anthropic. Su un provider di terze parti, o senza credenziali Anthropic, la finestra di dialogo si apre comunque, ma l'invio mostra un errore e non invia nulla: a differenza di /bug della CLI, l'estensione non scrive un archivio locale. Richiede Claude Code v2.1.229 o successivo.

• Side questions: digita /btw seguito da una domanda per chiedere informazioni sulla tua sessione senza aggiungere alla conversazione. La risposta si apre in un pannello accanto alla chat, dove puoi fare domande di follow-up. Il thread sopravvive ai ricaricamenti della finestra. Claude Code mantiene i 20 scambi più recenti e scade i thread archiviati secondo la pianificazione cleanupPeriodDays, purché Claude Code possa determinare in sicurezza il periodo di conservazione. Per cancellare un thread, fai clic sull'icona del cestino nel pannello. Richiede Claude Code v2.1.227 o successivo.

• Context indicator: la casella di prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude compatta automaticamente quando necessario, oppure puoi eseguire /compact manualmente.

• Agent map: quando la conversazione include subagenti, un conteggio di agenti come 2 agents appare nella parte inferiore della casella di prompt. Il suo punto mostra se un subagente sta lavorando o in attesa della tua autorizzazione.

  Fai clic sul conteggio degli agenti per aprire la mappa degli agenti, che disegna i subagenti della conversazione come un albero sotto l'agente principale, ognuno con il suo stato, tempo trascorso e conteggio dei token. Fai clic su un subagente per vedere il suo prompt e le chiamate di strumenti, aprire la sua trascrizione di sola lettura, o fermarlo mentre è in esecuzione. Richiede Claude Code v2.1.269 o successivo.

• Extended thinking: consente a Claude di dedicare più tempo al ragionamento su problemi complessi. Attivalo tramite il menu dei comandi (/). Il ragionamento di Claude appare nella conversazione come blocchi compressi: fai clic su un blocco per leggerlo, o premi Ctrl+O per espandere o comprimere ogni blocco di pensiero nella sessione. Consulta Extended thinking per i dettagli.

• Multi-line input: premi Shift+Enter per aggiungere una nuova riga senza inviare. Questo funziona anche nell'input di testo libero "Other" delle finestre di dialogo delle domande.

Riferimenti a file e cartelle

Usa le menzioni @-mention per fornire a Claude il contesto su file o cartelle specifiche. Quando digiti @ seguito da un nome di file o cartella, Claude legge quel contenuto e può rispondere a domande su di esso o apportare modifiche. Claude Code supporta la corrispondenza fuzzy, quindi puoi digitare nomi parziali per trovare quello che ti serve:

Explain the logic in @auth (fuzzy matches auth.js, AuthService.ts, etc.)
What's in @src/components/ (include a trailing slash for folders)

Per i PDF di grandi dimensioni, puoi chiedere a Claude di leggere pagine specifiche invece dell'intero file: una singola pagina, un intervallo come pagine 1-10, o un intervallo aperto come pagina 3 in poi.

Quando selezioni il testo nell'editor, Claude può vedere il tuo codice evidenziato automaticamente. Il piè di pagina della casella di prompt mostra quante righe sono selezionate. Premi Option+K (Mac) / Alt+K (Windows/Linux) per inserire una menzione @-mention con il percorso del file e i numeri di riga (ad es. @app.ts#5-10). Fai clic sulla X sull'indicatore di selezione per rimuoverlo in modo che Claude non riceva la selezione. L'indicatore riappare quando selezioni altro testo o passi a un file diverso.

Per allegare un'immagine, incollala dagli appunti nella casella di prompt. Puoi anche tenere premuto Shift mentre trascini i file nella casella di prompt per aggiungerli come allegati. Fai clic sulla X su qualsiasi allegato per rimuoverlo dal contesto.

Riprendi conversazioni passate

Fai clic sul pulsante Session history nella parte superiore del pannello Claude Code per accedere alla cronologia delle conversazioni. Puoi cercare per parola chiave o sfogliare per ora.

Fai clic su qualsiasi conversazione per riprenderla con la cronologia completa dei messaggi. Se la conversazione è già aperta in un'altra scheda della finestra corrente, facendo clic su di essa passerai a quella scheda. Per ulteriori informazioni sulla ripresa delle sessioni, consulta Manage sessions.

• Session titles: le nuove sessioni ricevono titoli generati dall'IA in base al tuo primo messaggio.
• Rename and archive: passa il mouse su una sessione per rivelare queste azioni. Rinomina per darle un titolo descrittivo, o archivia per spostarla nel gruppo Archived sessions nella parte inferiore dell'elenco.

Per impostazione predefinita, una sessione senza attività per 14 giorni si sposta automaticamente in Archived sessions, a meno che non sia aperta, non letta o in un gruppo. L'archiviazione automatica richiede Claude Code v2.1.265 o successivo. Per modificare il periodo o disattivarlo, apri l'impostazione Archive Inactive Sessions e seleziona un numero di giorni o Never.

Per ripristinare una sessione archiviata, espandi Archived sessions e fai clic su Unarchive session. Prima della v2.1.257, l'azione era Delete session, che nascondeva una sessione senza modo di ripristinarla. Le sessioni che hai eliminato allora appaiono sotto Archived sessions dopo l'aggiornamento.

Quando la conversazione che riprendi è terminata in modalità plan, Claude Code ripristina la modalità plan. Richiede Claude Code v2.1.246 o successivo. Claude Code non la ripristina in due casi:

• L'estensione sceglie la modalità di autorizzazione iniziale da claudeCode.initialPermissionMode o una scelta che si trasporta da una conversazione precedente
• Hai claudeCode.claudeProcessWrapper configurato

Riprendi sessioni cloud da Claude.ai

Se usi Claude Code sul web, puoi riprendere quelle sessioni cloud direttamente in VS Code. Questo richiede l'accesso con Claude.ai Subscription, non Anthropic Console.

Controlla account e utilizzo

Esegui /usage per aprire la finestra di dialogo Account & usage. La finestra di dialogo richiede un accesso a claude.ai, quindi non è offerta su un provider di terze parti. Mostra il tuo account connesso, il tuo piano e le barre di utilizzo per i limiti del tuo piano, come la sessione corrente e la settimana. Ogni barra mostra quanto tempo rimane prima che il suo limite si ripristini.

La finestra di dialogo suddivide anche ciò che contribuisce ai limiti del tuo piano. Contrassegna i comportamenti che rappresentano il 10% o più dell'utilizzo recente, come mancate cache, contesto lungo e sessioni pesanti di subagent o altamente parallele, ognuna con un suggerimento per ridurlo. Le tabelle di attribuzione mostrano quanto utilizzo è provenuto da ogni skill, subagent, plugin e server MCP.

Usa l'interruttore Day e Week per passare tra le ultime 24 ore e gli ultimi 7 giorni. Le cifre sono approssimative e calcolate dalle sessioni locali su questa macchina, quindi l'utilizzo da altri dispositivi o da claude.ai non è incluso. Per ulteriori informazioni sul tracciamento e la riduzione dell'utilizzo, consulta Track your costs.

Personalizza il tuo flusso di lavoro

Puoi riposizionare il pannello Claude, eseguire più conversazioni, organizzare l'elenco delle sessioni in gruppi o passare alla modalità terminale.

Scegli dove Claude si trova

Puoi trascinare il pannello Claude per riposizionarlo ovunque in VS Code. Afferra la scheda o la barra del titolo del pannello e trascinalo in:

• Barra laterale secondaria: il lato destro della finestra. Mantiene Claude visibile mentre codifichi.
• Barra laterale primaria: la barra laterale sinistra con icone per Explorer, Search, ecc.
• Area editor: apre Claude come scheda accanto ai tuoi file. Utile per attività secondarie.

Dopo aver eseguito Developer: Reload Window o riavviato VS Code, se una chat torna con la sua conversazione dipende da dove era aperta:

• Scheda editor: la conversazione torna con la sua scheda.
• Barra laterale: la conversazione torna se hai inviato un messaggio o Claude ha risposto in essa negli ultimi 10 minuti. Se non torna, riprendi la conversazione da Cronologia sessioni.

Esegui più conversazioni

Usa Open in New Tab o Open in New Window dalla Command Palette per avviare conversazioni aggiuntive. Ogni conversazione mantiene la propria cronologia e contesto, permettendoti di lavorare su diversi compiti in parallelo.

Quando usi le schede, un piccolo punto colorato sull'icona della scintilla indica lo stato: blu significa che una richiesta di autorizzazione è in sospeso, arancione significa che Claude ha terminato mentre la scheda era nascosta.

Organizza le sessioni in gruppi

Nell'elenco delle sessioni nella Activity Bar, puoi raccogliere le sessioni correlate in gruppi denominati e comprimibili. Richiede Claude Code v2.1.229 o successivo.

• Raggruppa o separa una sessione: fai clic con il pulsante destro del mouse su una sessione per creare un gruppo da essa, spostarla in un gruppo esistente o rimuoverla dal suo gruppo. Ogni sessione appartiene a un gruppo alla volta, quindi spostarla in un altro gruppo la rimuove dal primo.
• Sposta più sessioni contemporaneamente: Cmd-click (Mac) / Ctrl-click (Windows/Linux) su ogni sessione, o Shift-click per selezionare un intervallo, quindi fai clic con il pulsante destro del mouse sulla selezione.
• Raggruppa una sessione dalla sua scheda: esegui Claude Code: Add Session Tab to Group dalla Command Palette, quindi scegli o crea un gruppo. Richiede Claude Code v2.1.257 o successivo.
• Rinomina o elimina un gruppo: fai clic con il pulsante destro del mouse su un'intestazione di gruppo. L'eliminazione di un gruppo rimuove solo il gruppo e le sue sessioni tornano all'elenco non raggruppato.

L'estensione salva i gruppi per cartella di workspace, quindi sopravvivono ai ricaricamenti della finestra e appaiono in ogni finestra in cui apri la stessa cartella. Quando cerchi nell'elenco, l'estensione mostra i risultati in un elenco piatto su tutti i gruppi.

Passa alla modalità terminale

Per impostazione predefinita, l'estensione apre un pannello di chat grafico. Se preferisci l'interfaccia in stile CLI, apri l'impostazione Use Terminal e seleziona la casella.

Puoi anche aprire le impostazioni di VS Code (Cmd+, su Mac o Ctrl+, su Windows/Linux), vai a Extensions → Claude Code e seleziona Use Terminal.

Gestire i plugin

L'estensione VS Code include un'interfaccia grafica per installare e gestire i plugin. Digitate /plugins nella casella del prompt per aprire l'interfaccia Manage plugins.

Installare i plugin

La finestra di dialogo dei plugin mostra due schede: Plugins e Marketplaces.

Nella scheda Plugins:

• I plugin installati appaiono in alto con interruttori per abilitarli o disabilitarli
• I plugin disponibili dai vostri marketplace configurati appaiono di seguito
• Cercate per filtrare i plugin per nome o descrizione
• Fate clic su Install su qualsiasi plugin disponibile

Quando installate un plugin, scegliete l'ambito di installazione:

• Install for you: disponibile in tutti i vostri progetti (ambito utente)
• Install for this project: condiviso con i collaboratori del progetto (ambito progetto)
• Install locally: solo per voi, solo in questo repository (ambito locale)

Condividere un collegamento di installazione del plugin

Per inviare a qualcuno un collegamento diretto all'installazione di un plugin specifico, fornitegli l'URL install-plugin dell'estensione. L'apertura di questo URL avvia o mette a fuoco VS Code, apre il pannello Claude Code e apre la finestra di dialogo Manage plugins sulla scelta dell'ambito di quel plugin. Nulla viene installato finché la persona non sceglie un ambito. Se il marketplace del plugin non è ancora configurato in Claude Code, la finestra di dialogo chiede prima di aggiungerlo.

vscode://anthropic.claude-code/install-plugin?plugin=code-review&marketplace=anthropics/claude-plugins-official

L'URL accetta due parametri di query:

Due casi terminano con un messaggio nella finestra di dialogo invece della scelta dell'ambito:

• Il marketplace non elenca un plugin con quel nome: la finestra di dialogo segnala che il plugin non è stato trovato. Controllate il valore plugin rispetto all'elenco del marketplace.
• Il plugin è già installato: la finestra di dialogo lo comunica e nulla cambia.

I README di GitHub, i problemi e alcuni altri host Markdown rimuovono i collegamenti il cui schema non è http o https, quindi un collegamento vscode:// lì viene visualizzato come testo semplice. Inserite l'URL in un blocco di codice su questi host, come Il collegamento viene visualizzato come testo semplice invece di essere cliccabile descrive per i collegamenti claude-cli://.

Gestire i marketplace

Passate alla scheda Marketplaces per aggiungere o rimuovere fonti di plugin:

• Inserite un repository GitHub, un URL o un percorso locale per aggiungere un nuovo marketplace
• Fate clic sull'icona di aggiornamento per aggiornare l'elenco dei plugin di un marketplace
• Fate clic sull'icona del cestino per rimuovere un marketplace

Le modifiche ai plugin che apportate nella finestra di dialogo si applicano immediatamente alle sessioni Claude Code aperte in quella finestra VS Code. Se la sessione da cui avete aperto la finestra di dialogo non riesce a ricaricare i suoi plugin, la finestra di dialogo offre di riprovare o di riavviare Claude in quella sessione.

Per ulteriori informazioni sul sistema dei plugin, consultate Plugins e Plugin marketplaces.

Automatizzare attività del browser con Chrome

Connetti Claude al tuo browser Chrome per testare app web, eseguire il debug con i log della console e automatizzare i flussi di lavoro del browser senza lasciare VS Code. Questo richiede l'estensione Claude in Chrome versione 1.0.36 o superiore.

Digita @browser nella casella del prompt seguito da ciò che desideri che Claude faccia:

@browser go to localhost:3000 and check the console for errors

Puoi anche aprire il menu degli allegati per selezionare strumenti specifici del browser come aprire una nuova scheda o leggere il contenuto della pagina.

Claude apre nuove schede per le attività del browser e condivide lo stato di accesso del tuo browser, quindi può accedere a qualsiasi sito a cui sei già connesso.

Per le istruzioni di configurazione, l'elenco completo delle funzionalità e la risoluzione dei problemi, consulta Usa Claude Code con Chrome.

Comandi e scorciatoie da tastiera di VS Code

Apri il Riquadro comandi (Cmd+Shift+P su Mac o Ctrl+Shift+P su Windows/Linux) e digita "Claude Code" per visualizzare tutti i comandi VS Code disponibili per l'estensione Claude Code.

Alcuni scorciatoie dipendono da quale pannello è "attivo" (riceve input da tastiera). Quando il cursore è in un file di codice, l'editor è attivo. Quando il cursore è nella casella di prompt di Claude, Claude è attivo. Usa Cmd+Esc / Ctrl+Esc per alternare tra loro.

Avvia una scheda VS Code da altri strumenti

L'estensione registra un gestore URI in vscode://anthropic.claude-code/open. Usalo per aprire una nuova scheda Claude Code dal tuo strumento: un alias shell, un segnalibro del browser o qualsiasi script che possa aprire un URL. Se VS Code non è già in esecuzione, l'apertura dell'URL lo avvia prima. Se VS Code è già in esecuzione, l'URL si apre nella finestra attualmente attiva.

Richiama il gestore con l'opener URL del tuo sistema operativo.

open "vscode://anthropic.claude-code/open"

xdg-open "vscode://anthropic.claude-code/open"

Start-Process "vscode://anthropic.claude-code/open"

start "" "vscode://anthropic.claude-code/open"

Il gestore accetta due parametri di query facoltativi:

Ad esempio, per aprire una scheda pre-compilata con "review my changes":

vscode://anthropic.claude-code/open?prompt=review%20my%20changes

L'estensione gestisce anche vscode://anthropic.claude-code/install-plugin, che apre la finestra di dialogo del plugin su un plugin. Per avviare una sessione terminale invece di una scheda VS Code, usa il gestore claude-cli:// della CLI. Vedi Launch sessions from links.

Configurare le impostazioni

L'estensione ha due tipi di impostazioni:

• Impostazioni dell'estensione in VS Code: controllano il comportamento dell'estensione all'interno di VS Code. Aprire con Cmd+, (Mac) o Ctrl+, (Windows/Linux), quindi andare a Estensioni → Claude Code. È anche possibile digitare / e selezionare General config… per aprire le impostazioni.
• Impostazioni di Claude Code in ~/.claude/settings.json: condivise tra l'estensione e CLI. Utilizzarle per i comandi consentiti, le variabili di ambiente, gli hooks e i server MCP. Nei piani Pro, Max e Team, è anche uno degli input della modalità di autorizzazione con cui iniziano le conversazioni. Switch permission modes elenca l'ordine. Vedere Settings per i dettagli.

Impostazioni dell'estensione

VS Code legge initialPermissionMode dalle impostazioni utente e ignora i valori dell'area di lavoro. Prima della v2.1.225, VS Code impostava per impostazione predefinita l'impostazione su default e applicava i valori dell'area di lavoro.

Utilizzare un lettore di schermo

Il pannello di chat dell'estensione funziona con i lettori di schermo. Non è necessario attivare nulla: l'estensione annuncia l'attività della conversazione per ogni utente, senza alcun cambiamento visivo. Questo è separato dalla modalità lettore di schermo opzionale della CLI, che adatta l'interfaccia del terminale.

Il supporto del lettore di schermo nel pannello di chat richiede Claude Code v2.1.236 o versione successiva.

Durante una conversazione, l'estensione annuncia:

• Risposte di Claude: l'estensione annuncia ogni risposta una sola volta, quando è completa, e rimane silenziosa mentre il testo viene trasmesso. Il lettore di schermo legge i blocchi di codice come un riepilogo del conteggio delle righe, legge i link in base alla loro etichetta e legge le tabelle cella per cella; la risposta completa rimane leggibile nella trascrizione.
• Richieste di autorizzazione e domande: l'estensione annuncia una richiesta quando appare il suo prompt di autorizzazione, indicando lo strumento che Claude vuole utilizzare. Annuncia allo stesso modo quando Claude ti pone una domanda e quando Claude termina un piano e attende la tua revisione.
• Cambiamenti di stato: l'estensione annuncia quando Claude inizia a lavorare, quando Claude è pronto per il tuo input e quando Claude Code inizia a compattare la conversazione.
• Errori e prompt del modello: l'estensione annuncia gli errori nella conversazione e annuncia quando appare il prompt di consenso per i crediti di utilizzo o il prompt di richiesta contrassegnata.

Ogni turno nella trascrizione inizia con un'intestazione visivamente nascosta etichettata con il prompt che ha avviato il turno, in modo da poter saltare tra i turni utilizzando la navigazione per intestazioni del lettore di schermo. Puoi anche spostare lo stato attivo sulla trascrizione stessa con Tab, poiché l'estensione la espone come una regione etichettata, e leggerla al tuo ritmo. Mentre Claude lavora, il lettore di schermo legge un'etichetta di testo al posto dell'animazione dello spinner di avanzamento.

Quando riapri una sessione o passi a un'altra, l'estensione non annuncia nulla: la cronologia ripristinata, i prompt di autorizzazione in sospeso e lo stato in corso rimangono silenziosi fino a quando non accade qualcosa di nuovo.

Estensione VS Code vs. Claude Code CLI

Claude Code è disponibile sia come estensione VS Code (pannello grafico) che come CLI (interfaccia da riga di comando nel terminale). Alcune funzionalità sono disponibili solo nella CLI. Se hai bisogno di una funzionalità disponibile solo nella CLI, esegui claude nel terminale integrato di VS Code. Ciò richiede l'installazione CLI standalone: l'estensione non aggiunge claude al vostro PATH. Vedi Eseguire CLI in VS Code.

Rewind con checkpoints

L'estensione VS Code supporta i checkpoints, che tracciano le modifiche ai file di Claude e consentono di tornare a uno stato precedente. Passa il mouse su qualsiasi messaggio per rivelare il pulsante di rewind, quindi scegli tra tre opzioni:

• Fork conversation from here: avvia un nuovo ramo di conversazione da questo messaggio mantenendo intatte tutte le modifiche al codice
• Rewind code to here: ripristina le modifiche ai file fino a questo punto nella conversazione mantenendo la cronologia completa della conversazione
• Fork conversation and rewind code: avvia un nuovo ramo di conversazione e ripristina le modifiche ai file fino a questo punto

Per i dettagli completi su come funzionano i checkpoints e le loro limitazioni, vedi Checkpointing.

Eseguire CLI in VS Code

Per utilizzare la CLI rimanendo in VS Code, apri il terminale integrato (Ctrl+` su Windows/Linux o Cmd+` su Mac) ed esegui claude. La CLI si integra automaticamente con il vostro IDE per funzionalità come la visualizzazione dei diff e la condivisione dei diagnostici.

L'installazione dell'estensione non aggiunge claude al vostro PATH della shell. L'estensione raggruppa una copia privata della CLI per il suo pannello chat, ma digitare claude in un terminale richiede l'installazione CLI standalone. Esegui l'installazione una volta e i comandi su questa pagina, inclusi claude mcp add e claude --resume, funzionano in qualsiasi terminale. Se claude non viene ancora trovato dopo l'installazione, verifica il vostro PATH.

Se utilizzi un terminale esterno, esegui /ide all'interno di Claude Code per collegarlo a VS Code.

Passare tra estensione e CLI

L'estensione e la CLI condividono la stessa cronologia di conversazione. Per continuare una conversazione dell'estensione nella CLI, esegui claude --resume nel terminale. Questo apre un selettore interattivo dove puoi cercare e selezionare la tua conversazione.

Includere l'output del terminale nei prompt

Fai riferimento all'output del terminale nei tuoi prompt utilizzando @terminal:name dove name è il titolo del terminale. Questo consente a Claude di vedere l'output dei comandi, i messaggi di errore o i log senza copia-incolla.

Monitorare i processi in background

La visibilità per le attività in background nell'estensione è limitata rispetto alla CLI. Per una migliore visibilità, chiedi a Claude di generare il comando in modo da poterlo eseguire nel terminale integrato di VS Code.

Connettere strumenti esterni con MCP

I server MCP (Model Context Protocol) danno a Claude accesso a strumenti esterni, database e API.

Per gestire i server MCP senza lasciare VS Code, digita /mcp nel pannello chat. Dalla finestra di dialogo che si apre, puoi aggiungere server, rimuovere server salvati a livello locale, utente o progetto scope, abilitare o disabilitare server, riconnettersi a un server e gestire l'autenticazione OAuth. L'aggiunta e la rimozione di server nella finestra di dialogo richiede Claude Code v2.1.261 o versione successiva.

Puoi anche eseguire claude mcp add nel terminale integrato di VS Code (Ctrl+` o Cmd+`). La finestra di dialogo e il comando del terminale salvano nella stessa configurazione MCP, e le modifiche da entrambi hanno effetto nelle conversazioni che avvii successivamente. L'esempio seguente aggiunge il server MCP remoto di GitHub, che si autentica con un personal access token passato come intestazione:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

Sostituisci YOUR_GITHUB_PAT con il tuo personal access token. Il comando claude mcp add salva la configurazione senza convalidare le credenziali, quindi un valore segnaposto è accettato qui ma il server non riesce a connettersi in seguito. Per verificare la connessione, avvia una nuova conversazione, digita /mcp e controlla che il server mostri Connected. Un server con credenziali errate mostra Failed.

Una volta configurato, chiedi a Claude di utilizzare gli strumenti (ad esempio, "Review PR #456").

Per trovare server a cui connettersi, vedi Find and build MCP servers.

Lavorare con git

Claude Code si integra con git per aiutare con i flussi di lavoro di controllo versione direttamente in VS Code. Chiedete a Claude di eseguire il commit delle modifiche, creare pull request o lavorare tra i rami. Per avviare Claude in un worktree isolato con i propri file e ramo, consultate Eseguire sessioni parallele con worktrees.

Creare commit e pull request

Claude può mettere in stage le modifiche, scrivere messaggi di commit e creare pull request in base al vostro lavoro:

commit my changes with a descriptive message
create a pr for this feature
summarize the changes I've made to the auth module

Quando create pull request, Claude genera descrizioni basate sulle modifiche effettive del codice e può aggiungere contesto riguardante le decisioni di test o implementazione.

Utilizzare provider di terze parti

Per impostazione predefinita, Claude Code si connette direttamente all'API di Anthropic. Se la vostra organizzazione utilizza Amazon Bedrock, Google Cloud's Agent Platform o Microsoft Foundry per accedere a Claude, configurate l'estensione per utilizzare il vostro provider:

Su un provider di terze parti, l'estensione non offre funzionalità che richiedono un account claude.ai, come il tracciamento dell'utilizzo, la dettatura vocale e la scheda Web per le sessioni cloud. Un accesso claude.ai rimasto da un precedente /login rimane inutilizzato: l'estensione non lo invia con alcuna richiesta.

Sicurezza e privacy

Il vostro codice rimane privato. Claude Code elabora il vostro codice per fornire assistenza ma non lo utilizza per addestrare i modelli. Per dettagli sulla gestione dei dati e su come disattivare la registrazione, consultate Data and privacy.

Con le autorizzazioni di auto-edit abilitate, Claude Code può modificare i file di configurazione di VS Code (come settings.json o tasks.json) che VS Code potrebbe eseguire automaticamente. Per ridurre il rischio quando si lavora con codice non attendibile:

• Abilitate VS Code Restricted Mode per gli spazi di lavoro non attendibili
• Utilizzate la modalità Manual invece di Edit automatically o Auto per le modifiche
• Esaminate attentamente le modifiche prima di accettarle

The built-in IDE MCP server

Quando l'estensione è attiva, esegue un server MCP locale a cui il CLI si connette automaticamente. È così che il CLI apre i diff nel visualizzatore diff nativo di VS Code, legge la selezione corrente per le menzioni @ e — quando state lavorando in un notebook Jupyter — chiede a VS Code di eseguire le celle.

Il server è denominato ide ed è nascosto da /mcp perché non c'è nulla da configurare. Se la vostra organizzazione utilizza un hook PreToolUse per creare un elenco di strumenti MCP consentiti, tuttavia, dovrete sapere che esiste.

Selection and open-file context. Mentre è connesso, il CLI include la selezione dell'editor corrente e il percorso del file attivo come contesto su ogni prompt che inviate. La trascrizione mostra una riga ⧉ Selected N lines from <file> quando ciò accade. Per escludere un file sensibile come .env, aggiungete una regola di negazione Read per il suo percorso. Una regola di negazione corrispondente impedisce sia il testo selezionato che l'avviso del file aperto per quel file di raggiungere Claude.

Transport and authentication. Il server si associa a 127.0.0.1 su una porta casuale nell'intervallo 10000–65535, e la porta non è configurabile. Il trasporto è ws:// non crittografato; poiché il socket è solo loopback, qualsiasi processo che potrebbe catturare il traffico può anche leggere il token dal file di blocco, quindi TLS non aggiungerebbe protezione. Ogni attivazione dell'estensione genera un token di autenticazione casuale fresco, lo scrive in un file di blocco in ~/.claude/ide/<port>.lock, e il CLI deve presentarlo come intestazione X-Claude-Code-Ide-Authorization per connettersi. Il file di blocco ha autorizzazioni 0600 in una directory 0700, quindi solo l'utente che esegue VS Code può leggerlo. Se CLAUDE_CONFIG_DIR è impostato, il file di blocco viene scritto in $CLAUDE_CONFIG_DIR/ide/ invece.

Tools exposed to the model. Il server ospita una dozzina di strumenti, ma solo due sono visibili al modello. Il resto è RPC interno che il CLI utilizza per la propria interfaccia utente — apertura di diff, lettura di selezioni, salvataggio di file — e viene filtrato prima che l'elenco degli strumenti raggiunga Claude.

Jupyter execution always asks first. mcp__ide__executeCode non può eseguire nulla silenziosamente. Ad ogni chiamata, il codice viene inserito come una nuova cella alla fine del notebook attivo, VS Code lo scorre in vista, e un Quick Pick nativo vi chiede di Execute o Cancel. Annullare — o chiudere il picker con Esc — restituisce un errore a Claude e nulla viene eseguito. Lo strumento rifiuta anche completamente quando non c'è un notebook attivo, quando l'estensione Jupyter (ms-toolsai.jupyter) non è installata, o quando il kernel non è Python.

• Assicurati di avere una versione compatibile di VS Code (1.94.0 o successiva)
• Verifica che VS Code abbia il permesso di installare estensioni
• Prova a installare direttamente dal VS Code Marketplace

L'icona Spark non è visibile

L'icona Spark appare nella Editor Toolbar (in alto a destra dell'editor) quando hai un file aperto. Se non la vedi:

1. Apri un file: L'icona richiede che un file sia aperto. Avere solo una cartella aperta non è sufficiente.
2. Controlla la versione di VS Code: Richiede 1.94.0 o superiore (Help → About)
3. Riavvia VS Code: Esegui "Developer: Reload Window" dalla Command Palette
4. Disabilita le estensioni in conflitto: Disabilita temporaneamente altre estensioni AI (Cline, Continue, ecc.)
5. Controlla la fiducia dell'area di lavoro: L'estensione non funziona in Restricted Mode

In alternativa, se hai impostato preferredLocation su sidebar, o hai aperto Claude con Claude Code: Open in Side Bar, fai clic su "✻ Claude Code" nella Status Bar (angolo in basso a destra). Questo funziona anche senza un file aperto. Puoi anche usare la Command Palette (Cmd+Shift+P / Ctrl+Shift+P) e digitare "Claude Code".

Cmd+Esc non fa nulla su macOS

Su macOS Tahoe e versioni successive, la scorciatoia di sistema Game Overlay è associata a Cmd+Esc per impostazione predefinita e intercetta la pressione del tasto prima che raggiunga VS Code. Per liberare la scorciatoia:

1. Apri System Settings
2. Vai a Keyboard, quindi Keyboard Shortcuts, quindi Game Controllers
3. Deseleziona la casella di controllo Game Overlay

In alternativa, riassegna l'estensione a un tasto diverso: apri l'editor Keyboard Shortcuts di VS Code (Cmd+K Cmd+S), cerca Claude Code: Focus input e assegna una nuova associazione.

Claude Code non risponde mai

Se Claude Code non risponde ai tuoi prompt:

1. Controlla la tua connessione Internet: Assicurati di avere una connessione Internet stabile
2. Avvia una nuova conversazione: Prova ad avviare una conversazione nuova per vedere se il problema persiste
3. Prova la CLI: Esegui claude dal terminale per vedere se ricevi messaggi di errore più dettagliati

Se i problemi persistono, segnala un problema su GitHub con i dettagli dell'errore.

Disinstallare l'estensione

Per disinstallare l'estensione Claude Code:

1. Aprire la visualizzazione Estensioni (Cmd+Shift+X su Mac o Ctrl+Shift+X su Windows/Linux)
2. Cercare "Claude Code"
3. Fare clic su Disinstalla

Se eseguite claude in un terminale integrato di VS Code, Claude Code reinstalla automaticamente l'estensione. Per mantenerla disinstallata, disattivate Auto-install IDE extension in /config, oppure impostate autoInstallIdeExtension su false. Potete anche impostare la variabile di ambiente CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL su 1.

Per rimuovere anche i dati dell'estensione e ripristinare tutte le impostazioni, eliminate la directory di archiviazione dell'estensione per la vostra piattaforma.

Su macOS:

rm -rf ~/Library/"Application Support"/Code/User/globalStorage/anthropic.claude-code

Su Linux:

rm -rf ~/.config/Code/User/globalStorage/anthropic.claude-code

Su Windows, in PowerShell:

Remove-Item -Recurse -Force "$env:APPDATA\Code\User\globalStorage\anthropic.claude-code"

Per ulteriore aiuto, consultate la guida alla risoluzione dei problemi.

Passaggi successivi

Ora che hai Claude Code configurato in VS Code:

• Esplora i flussi di lavoro comuni per ottenere il massimo da Claude Code
• Configura i server MCP per estendere le capacità di Claude con strumenti esterni. Aggiungili e gestiscili con /mcp nel pannello della chat.
• Configura le impostazioni di Claude Code per personalizzare i comandi consentiti, gli hook e altro ancora. Queste impostazioni sono condivise tra l'estensione e la CLI.