SpyBara
Go Premium

vs-code.md 2026-09-08 20:00 UTC to 2026-09-09 22:58 UTC

This page contains 256 additions and 198 deletions.

2026
Wed 9 22:58 Sat 12 03:02 Mon 14 22:58 Fri 18 23:58 Tue 22 23:59 Wed 23 23:57 Fri 25 23:58

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.

Editor VS Code con il pannello dell'estensione Claude Code aperto sul lato destro, che mostra una conversazione con Claude

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:

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.

VS Code editor che mostra l'icona Spark nella Barra degli strumenti dell'editor

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 come scheda editor completa, 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:

VS Code editor con le righe 2-3 selezionate in un file Python, e il pannello Claude Code che mostra una domanda su quelle righe con un riferimento @-mention
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.
VS Code che mostra un diff delle modifiche proposte da Claude con un prompt di autorizzazione che chiede se effettuare la modifica

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. 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.

    • 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. 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. 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.

    • 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.
  • 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 sull'indicatore di selezione per attivare/disattivare se Claude può vedere il testo evidenziato - l'icona occhio-barra significa che la selezione è nascosta a Claude.

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. Per ulteriori informazioni sulla ripresa delle sessioni, consulta Manage sessions.

Le nuove sessioni ricevono titoli generati dall'IA in base al tuo primo messaggio. Passa il mouse su una sessione per rivelare le azioni di ridenominazione e archiviazione: rinomina per darle un titolo descrittivo, o archivia per spostarla nel gruppo Archived sessions nella parte inferiore dell'elenco.

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:

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.

1

Open session history

Fai clic sul pulsante Session history nella parte superiore del pannello Claude Code.

2

Select the Web tab

La finestra di dialogo mostra due schede: Local e Web. Fai clic su Web per vedere le sessioni da claude.ai.

3

Select a session to resume

Sfoglia o cerca le tue sessioni cloud. Fai clic su qualsiasi sessione per scaricarla e continuare la conversazione localmente.

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 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. Richiede Claude Code v2.1.174 o successivo.

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.

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, o fai clic con il pulsante destro del mouse sulla scheda dell'editor della sessione, 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)

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

Dopo aver apportato modifiche, un banner vi chiede di riavviare Claude Code per applicarle.

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.

Comando Scorciatoia Descrizione
Focus Input Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) Alterna lo stato attivo tra editor e Claude
Open in Side Bar - Apri Claude nella barra laterale
Open in Terminal - Apri Claude in modalità terminale
Open in New Tab Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) Apri una nuova conversazione come scheda editor
Open in New Window - Apri una nuova conversazione in una finestra separata
New Conversation Cmd+N (Mac) / Ctrl+N (Windows/Linux) Avvia una nuova conversazione. Richiede che Claude sia attivo e enableNewConversationShortcut impostato su true
Reopen Closed Session Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux) Riapri la scheda sessione Claude chiusa più di recente. Ricade al normale riapertura-editor-chiuso di VS Code quando l'ultima scheda chiusa non era una sessione Claude. Disabilita con enableReopenClosedSessionShortcut
Insert @-Mention Reference Option+K (Mac) / Alt+K (Windows/Linux) Inserisci un riferimento al file corrente e alla selezione (richiede che l'editor sia attivo)
Toggle Focus view Ctrl+Option+F (Mac) / Ctrl+Alt+F (Windows/Linux) Nascondi o mostra l'attività dello strumento nella conversazione. Funziona mentre un pannello Claude o la barra laterale è visibile. Richiede Claude Code v2.1.221 o successivo
Rename Session Tab - Rinomina la sessione nella scheda Claude attiva. Il comando appare anche nel menu di scelta rapida della scheda. Richiede Claude Code v2.1.257 o successivo
Add Session Tab to Group - Aggiungi la sessione nella scheda Claude attiva a un gruppo di sessioni che scegli o crei. Il comando appare anche nel menu di scelta rapida della scheda. Richiede Claude Code v2.1.257 o successivo
Mark Session as Unread - Contrassegna la sessione nella scheda Claude attiva come non letta nell'elenco delle sessioni. Il comando appare anche nel menu di scelta rapida della scheda. Richiede Claude Code v2.1.257 o successivo
Show Logs - Visualizza i log di debug dell'estensione
Logout - Esci dal tuo account Anthropic

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"

Il gestore accetta due parametri di query facoltativi:

Parametro Descrizione
prompt Testo da pre-compilare nella casella di prompt. Deve essere codificato in URL. Il prompt è pre-compilato ma non inviato automaticamente.
session Un ID di sessione da riprendere invece di avviare una nuova conversazione. La sessione deve appartenere all'area di lavoro attualmente aperta in VS Code. Se la sessione non viene trovata, viene avviata una conversazione nuova. Se la sessione è già aperta in una scheda, quella scheda è attiva. Per acquisire un ID di sessione a livello di programmazione, vedi Continue conversations.

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

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

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.

Impostazione Predefinito Descrizione
useTerminal false Avvia Claude in modalità terminale invece di pannello grafico
initialPermissionMode - Controlla i prompt di approvazione per le nuove conversazioni: default, plan, acceptEdits o bypassPermissions. manual è un alias per default e seleziona la modalità etichettata Manual nell'indicatore di modalità. Quando lo lasciate non impostato, l'estensione sceglie la modalità di autorizzazione iniziale come descritto in Switch permission modes.
preferredLocation panel Dove Claude si apre: sidebar (destra) o panel (nuova scheda)
autosave true Salva automaticamente i file prima che Claude li legga o scriva
useCtrlEnterToSend false Usa Ctrl/Cmd+Invio invece di Invio per inviare i prompt
enableNewConversationShortcut false Abilita Cmd/Ctrl+N per avviare una nuova conversazione
enableReopenClosedSessionShortcut true Usa Cmd/Ctrl+Maiusc+T per riaprire la scheda della sessione Claude chiusa più di recente. Quando l'ultima scheda chiusa non era una sessione Claude, la scorciatoia esegue il comando di riapertura dell'editor chiuso normale di VS Code.
hideOnboarding false Nascondi la checklist di onboarding (icona del berretto di laurea)
focusView false Nascondi le chiamate di strumenti, i risultati degli strumenti e il pensiero dietro righe espandibili, lasciando i vostri prompt e le risposte di Claude. L'elenco di cose da fare più recente di Claude rimane visibile; questo richiede Claude Code v2.1.225 o successivo. È anche possibile attivare/disattivare Focus view dal menu dei comandi. Richiede Claude Code v2.1.221 o successivo
respectGitIgnore true Escludere i modelli .gitignore dalle ricerche di file
usePythonEnvironment true Attiva l'ambiente Python dell'area di lavoro quando si esegue Claude. Richiede l'estensione Python.
environmentVariables [] Imposta le variabili di ambiente per il processo Claude. Utilizzare le impostazioni di Claude Code per la configurazione condivisa.
disableLoginPrompt false Salta i prompt di autenticazione (per configurazioni di provider di terze parti)
allowDangerouslySkipPermissions false Aggiunge Bypass permissions al selettore di modalità. Utilizzarlo solo in sandbox senza accesso a Internet.
claudeProcessWrapper - Eseguibile utilizzato per avviare il processo Claude. Il percorso binario in bundle viene passato come argomento quando presente. Impostarlo su un binario claude installato separatamente se la build dell'estensione non ne include uno per la vostra piattaforma. In una configurazione con wrapper, le conversazioni iniziano in modalità Manual a meno che non impostiate initialPermissionMode o non abbiate scelto Manual, Edit automatically o Auto in una conversazione precedente, perché l'estensione salta i passaggi delle impostazioni e del valore predefinito incorporato lì; vedere Switch permission modes. Un errore "Unsupported platform" all'attivazione significa che nessun binario è in bundle per la vostra piattaforma; vedere which platforms have prebuilt binaries.

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.

Funzionalità CLI Estensione VS Code
Comandi e skills Tutti Sottoinsieme (digita / per vedere quelli disponibili)
Configurazione server MCP Sì Sì (aggiungi e gestisci server con /mcp nel pannello chat)
Checkpoints Sì Sì
Scorciatoia bash ! Sì No
Completamento scheda Sì No

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:

1

Disabilitare il prompt di accesso

Aprite l'impostazione Disable Login Prompt e spuntate la casella.

Potete anche aprire le impostazioni di VS Code (Cmd+, su Mac o Ctrl+, su Windows/Linux), cercare "Claude Code login" e spuntare Disable Login Prompt.

2

Configurare il vostro provider

Seguite la guida di configurazione per il vostro provider:

Queste guide coprono la configurazione del vostro provider in ~/.claude/settings.json, che garantisce che le vostre impostazioni siano condivise tra l'estensione VS Code e la CLI.

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.

Tool name (as seen by hooks) What it does Read-only
mcp__ide__getDiagnostics Restituisce i diagnostici del language server — gli errori e gli avvisi nel pannello Problemi di VS Code. Facoltativamente limitato a un file. Yes
mcp__ide__executeCode Esegue il codice Python nel kernel del notebook Jupyter attivo. Consultate il flusso di conferma di seguito. No

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.

Risolvere i problemi comuni

L'estensione non si installa

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: