
Prerequisiti
- VS Code 1.98.0 o versione successiva
- Un account Anthropic (accederai quando aprirai l’estensione per la prima volta). Se stai utilizzando un provider di terze parti come Amazon Bedrock o Google Vertex AI, consulta invece Usa provider di terze parti.
Installa l’estensione
Fai clic sul link per il tuo IDE per installare direttamente: Oppure in VS Code, premiCmd+Shift+X (Mac) o Ctrl+Shift+X (Windows/Linux) per aprire la visualizzazione Estensioni, cerca “Claude Code” e fai clic su Installa.
Se l’estensione non appare dopo l’installazione, riavvia VS Code o esegui “Developer: Reload Window” dalla Tavolozza dei comandi.
Inizia
Una volta installata, puoi iniziare a utilizzare Claude Code tramite l’interfaccia VS Code:Apri il pannello Claude Code
In tutto VS Code, l’icona Spark indica Claude Code:
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:

- Tavolozza dei comandi:
Cmd+Shift+P(Mac) oCtrl+Shift+P(Windows/Linux), digita “Claude Code” e seleziona un’opzione come “Apri in Nuova Scheda” - Barra di stato: Fai clic su ✱ Claude Code nell’angolo in basso a destra della finestra. Funziona anche quando nessun file è aperto.
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:

Usa la casella dei prompt
La casella dei prompt supporta diverse funzionalità:- Modalità di permesso: Fai clic sull’indicatore di modalità in fondo alla casella dei prompt per cambiare modalità. In modalità normale, Claude chiede il permesso prima di ogni azione. In Plan Mode, Claude descrive cosa farà e attende l’approvazione prima di apportare modifiche. In modalità auto-accept, Claude apporta modifiche senza chiedere. Imposta il valore predefinito nelle impostazioni di VS Code in
claudeCode.initialPermissionMode. - Menu dei comandi: Fai clic su
/o digita/per aprire il menu dei comandi. Le opzioni includono l’allegato di file, il cambio di modelli, l’attivazione del pensiero esteso e la visualizzazione dell’utilizzo del piano (/usage). La sezione Personalizza fornisce accesso ai server MCP, hooks, memoria, autorizzazioni e plugin. Gli elementi con un’icona di terminale si aprono nel terminale integrato. - Indicatore di contesto: La casella dei prompt mostra quanto della finestra di contesto di Claude stai utilizzando. Claude si compatta automaticamente quando necessario, oppure puoi eseguire
/compactmanualmente. - Pensiero esteso: Consente a Claude di dedicare più tempo al ragionamento su problemi complessi. Attivalo tramite il menu dei comandi (
/). Consulta Pensiero esteso per i dettagli. - Input multi-riga: Premi
Shift+Enterper aggiungere una nuova riga senza inviare. Funziona anche nell’input di testo libero “Altro” delle finestre di dialogo delle domande.
Fai riferimento a file e cartelle
Usa @-mention per dare 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:
Option+K (Mac) / Alt+K (Windows/Linux) per inserire un @-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 tuo testo evidenziato - l’icona occhio-barra significa che la selezione è nascosta a Claude.
Puoi anche tenere premuto Shift mentre trascini i file nella casella dei prompt per aggiungerli come allegati. Fai clic sulla X su qualsiasi allegato per rimuoverlo dal contesto.
Riprendi conversazioni passate
Fai clic sul menu a discesa in cima al pannello Claude Code per accedere alla cronologia delle conversazioni. Puoi cercare per parola chiave o sfogliare per tempo (Oggi, Ieri, Ultimi 7 giorni, ecc.). Fai clic su qualsiasi conversazione per riprenderla con la cronologia completa dei messaggi. Per ulteriori informazioni sulla ripresa delle sessioni, consulta Flussi di lavoro comuni.Riprendi sessioni remote da Claude.ai
Se utilizzi Claude Code sul web, puoi riprendere quelle sessioni remote direttamente in VS Code. Ciò richiede l’accesso con Claude.ai Subscription, non Anthropic Console.Apri Conversazioni Passate
Fai clic sul menu a discesa Conversazioni Passate in cima al pannello Claude Code.
Seleziona la scheda Remote
La finestra di dialogo mostra due schede: Local e Remote. Fai clic su Remote per vedere le sessioni da claude.ai.
Solo le sessioni web avviate con un repository GitHub appaiono nella scheda Remote. La ripresa carica la cronologia della conversazione localmente; le modifiche non vengono sincronizzate di nuovo su claude.ai.
Personalizza il tuo flusso di lavoro
Una volta che sei operativo, puoi riposizionare il pannello Claude, eseguire più sessioni o passare alla modalità terminale.Scegli dove vive Claude
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 dell’editor: Apre Claude come scheda insieme ai tuoi file. Utile per attività secondarie.
Esegui più conversazioni
Usa Apri in Nuova Scheda o Apri in Nuova Finestra dalla Tavolozza dei comandi per avviare conversazioni aggiuntive. Ogni conversazione mantiene la propria cronologia e contesto, permettendoti di lavorare su diversi compiti in parallelo. Quando utilizzi le schede, un piccolo punto colorato sull’icona spark indica lo stato: blu significa che una richiesta di permesso è in sospeso, arancione significa che Claude ha finito mentre la scheda era nascosta.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 Usa terminale e seleziona la casella. Puoi anche aprire le impostazioni di VS Code (Cmd+, su Mac o Ctrl+, su Windows/Linux), vai a Estensioni → Claude Code e seleziona Usa terminale.
Gestisci i plugin
L’estensione VS Code include un’interfaccia grafica per installare e gestire i plugin. Digita/plugins nella casella dei prompt per aprire l’interfaccia Gestisci plugin.
Installa i plugin
La finestra di dialogo dei plugin mostra due schede: Plugin e Marketplace. Nella scheda Plugin:- I plugin installati appaiono in cima con interruttori di attivazione/disattivazione
- I plugin disponibili dai tuoi marketplace configurati appaiono sotto
- Cerca per filtrare i plugin per nome o descrizione
- Fai clic su Installa su qualsiasi plugin disponibile
- Installa per te: Disponibile in tutti i tuoi progetti (ambito utente)
- Installa per questo progetto: Condiviso con i collaboratori del progetto (ambito progetto)
- Installa localmente: Solo per te, solo in questo repository (ambito locale)
Gestisci i marketplace
Passa alla scheda Marketplace per aggiungere o rimuovere fonti di plugin:- Inserisci un repository GitHub, URL o percorso locale per aggiungere un nuovo marketplace
- Fai clic sull’icona di aggiornamento per aggiornare l’elenco dei plugin di un marketplace
- Fai clic sull’icona del cestino per rimuovere un marketplace
La gestione dei plugin in VS Code utilizza gli stessi comandi CLI sotto il cofano. I plugin e i marketplace che configuri nell’estensione sono disponibili anche nella CLI e viceversa.
Automatizza le 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. Ciò richiede l’estensione Claude in Chrome versione 1.0.36 o successiva. Digita@browser nella casella dei prompt seguito da quello che vuoi che Claude faccia:
Comandi e scorciatoie da tastiera di VS Code
Apri la Tavolozza dei comandi (Cmd+Shift+P su Mac o Ctrl+Shift+P su Windows/Linux) e digita “Claude Code” per vedere tutti i comandi VS Code disponibili per l’estensione Claude Code.
Alcune scorciatoie dipendono da quale pannello è “focalizzato” (riceve input da tastiera). Quando il tuo cursore è in un file di codice, l’editor è focalizzato. Quando il tuo cursore è nella casella dei prompt di Claude, Claude è focalizzato. Usa Cmd+Esc / Ctrl+Esc per alternare tra loro.
Questi sono comandi VS Code per controllare l’estensione. Non tutti i comandi Claude Code incorporati sono disponibili nell’estensione. Consulta Estensione VS Code vs. Claude Code CLI per i dettagli.
| Comando | Scorciatoia | Descrizione |
|---|---|---|
| Focus Input | Cmd+Esc (Mac) / Ctrl+Esc (Windows/Linux) | Alterna lo stato attivo tra editor e Claude |
| Apri nella Barra laterale | - | Apri Claude nella barra laterale sinistra |
| Apri nel Terminale | - | Apri Claude in modalità terminale |
| Apri in Nuova Scheda | Cmd+Shift+Esc (Mac) / Ctrl+Shift+Esc (Windows/Linux) | Apri una nuova conversazione come scheda dell’editor |
| Apri in Nuova Finestra | - | Apri una nuova conversazione in una finestra separata |
| Nuova Conversazione | Cmd+N (Mac) / Ctrl+N (Windows/Linux) | Avvia una nuova conversazione (richiede che Claude sia focalizzato) |
| Inserisci Riferimento @-Mention | Option+K (Mac) / Alt+K (Windows/Linux) | Inserisci un riferimento al file corrente e alla selezione (richiede che l’editor sia focalizzato) |
| Mostra Log | - | Visualizza i log di debug dell’estensione |
| Esci | - | Esci dal tuo account Anthropic |
Configura 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. Apri con
Cmd+,(Mac) oCtrl+,(Windows/Linux), quindi vai a Estensioni → Claude Code. Puoi anche digitare/e selezionare General Config per aprire le impostazioni. - Impostazioni Claude Code in
~/.claude/settings.json: Condivise tra l’estensione e la CLI. Usa per comandi consentiti, variabili di ambiente, hooks e server MCP. Consulta Impostazioni per i dettagli.
Impostazioni dell’estensione
| Impostazione | Predefinito | Descrizione |
|---|---|---|
selectedModel | default | Modello per le nuove conversazioni. Cambia per sessione con /model. |
useTerminal | false | Avvia Claude in modalità terminale invece di pannello grafico |
initialPermissionMode | default | Controlla i prompt di approvazione: default (chiedi ogni volta), plan, acceptEdits o bypassPermissions |
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+Enter invece di Enter per inviare i prompt |
enableNewConversationShortcut | true | Abilita Cmd/Ctrl+N per avviare una nuova conversazione |
hideOnboarding | false | Nascondi la checklist di onboarding (icona del berretto di laurea) |
respectGitIgnore | true | Escludi i modelli .gitignore dalle ricerche di file |
environmentVariables | [] | Imposta le variabili di ambiente per il processo Claude. Usa invece le impostazioni Claude Code per la configurazione condivisa. |
disableLoginPrompt | false | Salta i prompt di autenticazione (per configurazioni di provider di terze parti) |
allowDangerouslySkipPermissions | false | Ignora tutti i prompt di permesso. Usa con estrema cautela. |
claudeProcessWrapper | - | Percorso eseguibile utilizzato per avviare il processo Claude |
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à solo CLI, eseguiclaude nel terminale integrato di VS Code.
| Funzionalità | CLI | Estensione VS Code |
|---|---|---|
| Comandi e skills | Tutti | Sottoinsieme (digita / per vedere quelli disponibili) |
| Configurazione server MCP | Sì | No (configura tramite CLI, usa nell’estensione) |
| Checkpoint | Sì | Sì |
Scorciatoia bash ! | Sì | No |
| Completamento scheda | Sì | No |
Riavvolgi con checkpoint
L’estensione VS Code supporta i checkpoint, che tracciano le modifiche ai file di Claude e ti permettono di riavvolgere a uno stato precedente. Passa il mouse su qualsiasi messaggio per rivelare il pulsante di riavvolgimento, quindi scegli tra tre opzioni:- Crea un ramo di conversazione da qui: avvia un nuovo ramo di conversazione da questo messaggio mantenendo intatte tutte le modifiche al codice
- Riavvolgi il codice a qui: ripristina le modifiche ai file a questo punto della conversazione mantenendo la cronologia completa della conversazione
- Crea un ramo di conversazione e riavvolgi il codice: avvia un nuovo ramo di conversazione e ripristina le modifiche ai file a questo punto
Esegui 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 tuo IDE per funzionalità come la visualizzazione dei diff e la condivisione dei diagnostici.
Se utilizzi un terminale esterno, esegui /ide all’interno di Claude Code per connetterlo a VS Code.
Passa tra estensione e CLI
L’estensione e la CLI condividono la stessa cronologia delle conversazioni. Per continuare una conversazione dell’estensione nella CLI, eseguiclaude --resume nel terminale. Questo apre un selettore interattivo dove puoi cercare e selezionare la tua conversazione.
Includi l’output del terminale nei prompt
Fai riferimento all’output del terminale nei tuoi prompt usando@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.
Monitora i processi in background
Quando Claude esegue comandi di lunga durata, l’estensione mostra l’avanzamento nella barra di stato. Tuttavia, la visibilità per le attività in background è limitata rispetto alla CLI. Per una migliore visibilità, chiedi a Claude di emettere il comando in modo da poterlo eseguire nel terminale integrato di VS Code.Connettiti a strumenti esterni con MCP
I server MCP (Model Context Protocol) danno a Claude accesso a strumenti esterni, database e API. Configurali tramite CLI, quindi usali sia nell’estensione che nella CLI. Per aggiungere un server MCP, apri il terminale integrato (Ctrl+` o Cmd+`) ed esegui:
claude nel terminale, quindi digita /mcp per autenticarti. Consulta la documentazione MCP per i server disponibili.
Lavora con git
Claude Code si integra con git per aiutare con i flussi di lavoro di controllo della versione direttamente in VS Code. Chiedi a Claude di eseguire il commit delle modifiche, creare pull request o lavorare tra i rami.Crea commit e pull request
Claude può mettere in stage le modifiche, scrivere messaggi di commit e creare pull request in base al tuo lavoro:Usa git worktrees per attività parallele
I git worktrees consentono a più sessioni di Claude Code di lavorare su rami separati contemporaneamente, ciascuno con file isolati:Usa provider di terze parti
Per impostazione predefinita, Claude Code si connette direttamente all’API di Anthropic. Se la tua organizzazione utilizza Amazon Bedrock, Google Vertex AI o Microsoft Foundry per accedere a Claude, configura l’estensione per utilizzare il tuo provider:Disabilita il prompt di accesso
Apri l’impostazione Disabilita prompt di accesso e seleziona la casella.Puoi anche aprire le impostazioni di VS Code (
Cmd+, su Mac o Ctrl+, su Windows/Linux), cercare “Claude Code login” e selezionare Disabilita prompt di accesso.Configura il tuo provider
Segui la guida di configurazione per il tuo provider:Queste guide coprono la configurazione del tuo provider in
~/.claude/settings.json, che garantisce che le tue impostazioni siano condivise tra l’estensione VS Code e la CLI.Sicurezza e privacy
Il tuo codice rimane privato. Claude Code elabora il tuo codice per fornire assistenza ma non lo utilizza per addestrare i modelli. Per i dettagli sulla gestione dei dati e su come rinunciare alla registrazione, consulta Dati e privacy. Con le autorizzazioni di modifica automatica abilitate, Claude Code può modificare i file di configurazione di VS Code (comesettings.json o tasks.json) che VS Code potrebbe eseguire automaticamente. Per ridurre il rischio quando si lavora con codice non attendibile:
- Abilita Modalità limitata di VS Code per aree di lavoro non attendibili
- Usa la modalità di approvazione manuale invece di auto-accept per le modifiche
- Rivedi attentamente le modifiche prima di accettarle
Risolvi i problemi comuni
L’estensione non si installa
- Assicurati di avere una versione compatibile di VS Code (1.98.0 o successiva)
- Verifica che VS Code abbia il permesso di installare estensioni
- Prova a installare direttamente dal Marketplace di VS Code
L’icona Spark non è visibile
L’icona Spark appare nella Barra degli strumenti dell’editor (in alto a destra dell’editor) quando hai un file aperto. Se non la vedi:- Apri un file: L’icona richiede che un file sia aperto. Avere solo una cartella aperta non è sufficiente.
- Controlla la versione di VS Code: Richiede 1.98.0 o successiva (Aiuto → Informazioni)
- Riavvia VS Code: Esegui “Developer: Reload Window” dalla Tavolozza dei comandi
- Disabilita le estensioni in conflitto: Disabilita temporaneamente altre estensioni AI (Cline, Continue, ecc.)
- Controlla l’attendibilità dell’area di lavoro: L’estensione non funziona in Modalità limitata
Cmd+Shift+P / Ctrl+Shift+P) e digitare “Claude Code”.
Claude Code non risponde mai
Se Claude Code non risponde ai tuoi prompt:- Controlla la tua connessione Internet: Assicurati di avere una connessione Internet stabile
- Avvia una nuova conversazione: Prova ad avviare una conversazione nuova per vedere se il problema persiste
- Prova la CLI: Esegui
claudedal terminale per vedere se ottieni messaggi di errore più dettagliati
Disinstalla l’estensione
Per disinstallare l’estensione Claude Code:- Apri la visualizzazione Estensioni (
Cmd+Shift+Xsu Mac oCtrl+Shift+Xsu Windows/Linux) - Cerca “Claude Code”
- Fai clic su Disinstalla
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. Configura i server usando la CLI, quindi usali nell’estensione.
- Configura le impostazioni di Claude Code per personalizzare i comandi consentiti, gli hooks e altro. Queste impostazioni sono condivise tra l’estensione e la CLI.
