
Estensione VS Code (Beta)
L’estensione VS Code, disponibile in beta, ti permette di vedere i cambiamenti di Claude in tempo reale attraverso un’interfaccia grafica nativa integrata direttamente nel tuo IDE. L’estensione VS Code rende più facile accedere e interagire con Claude Code per gli utenti che preferiscono un’interfaccia visiva al terminale.Funzionalità
L’estensione VS Code fornisce:- Esperienza IDE nativa: Pannello laterale dedicato a Claude Code accessibile tramite l’icona Spark
- Modalità piano con modifica: Rivedi e modifica i piani di Claude prima di accettarli
- Modalità accettazione automatica modifiche: Applica automaticamente i cambiamenti di Claude mentre vengono apportati
- Gestione file: Menziona file con @ o allega file e immagini utilizzando il selettore file di sistema
- Utilizzo server MCP: Usa server Model Context Protocol configurati tramite CLI
- Cronologia conversazioni: Accesso facile alle conversazioni passate
- Sessioni multiple: Esegui più sessioni di Claude Code simultaneamente
- Scorciatoie da tastiera: Supporto per la maggior parte delle scorciatoie da CLI
- Comandi slash: Accedi alla maggior parte dei comandi slash CLI direttamente nell’estensione
Requisiti
- VS Code 1.98.0 o superiore
Installazione
Scarica e installa l’estensione da Visual Studio Code Extension Marketplace.Come funziona
Una volta installata, puoi iniziare a usare Claude Code tramite l’interfaccia VS Code:- Fai clic sull’icona Spark nella barra laterale dell’editor per aprire il pannello Claude Code
- Richiedi a Claude Code nello stesso modo in cui faresti nel terminale
- Osserva mentre Claude analizza il tuo codice e suggerisce modifiche
- Rivedi e accetta le modifiche direttamente nell’interfaccia
- Suggerimento: Trascina la barra laterale più larga per vedere i diff inline, quindi fai clic su di essi per espandere per i dettagli completi
Utilizzo di provider di terze parti (Vertex e Bedrock)
L’estensione VS Code supporta l’utilizzo di Claude Code con provider di terze parti come Amazon Bedrock e Google Vertex AI. Quando configurata con questi provider, l’estensione non richiederà l’accesso. Per utilizzare provider di terze parti, configura le variabili di ambiente nelle impostazioni dell’estensione VS Code:- Apri le impostazioni VS Code
- Cerca “Claude Code: Environment Variables”
- Aggiungi le variabili di ambiente richieste
Variabili di ambiente
| Variabile | Descrizione | Obbligatoria | Esempio |
|---|---|---|---|
CLAUDE_CODE_USE_BEDROCK | Abilita l’integrazione Amazon Bedrock | Obbligatoria per Bedrock | "1" o "true" |
CLAUDE_CODE_USE_VERTEX | Abilita l’integrazione Google Vertex AI | Obbligatoria per Vertex AI | "1" o "true" |
ANTHROPIC_API_KEY | Chiave API per l’accesso di terze parti | Obbligatoria | "your-api-key" |
AWS_REGION | Regione AWS per Bedrock | "us-east-2" | |
AWS_PROFILE | Profilo AWS per l’autenticazione Bedrock | "your-profile" | |
CLOUD_ML_REGION | Regione per Vertex AI | "global" o "us-east5" | |
ANTHROPIC_VERTEX_PROJECT_ID | ID progetto GCP per Vertex AI | "your-project-id" | |
ANTHROPIC_MODEL | Sovrascrivi modello primario | ID modello di override | "us.anthropic.claude-sonnet-4-5-20250929-v1:0" |
ANTHROPIC_SMALL_FAST_MODEL | Sovrascrivi modello piccolo/veloce | Facoltativa | "us.anthropic.claude-3-5-haiku-20241022-v1:0" |
CLAUDE_CODE_SKIP_AUTH_LOGIN | Disabilita tutti i prompt di accesso | Facoltativa | "1" o "true" |
Non ancora implementato
Le seguenti funzionalità non sono ancora disponibili nell’estensione VS Code:- Configurazione completa server MCP: Devi configurare i server MCP tramite CLI prima, quindi l’estensione li utilizzerà
- Configurazione subagenti: Configura subagenti tramite CLI per usarli in VS Code
- Checkpoint: Salva e ripristina lo stato della conversazione in punti specifici
- Scorciatoie avanzate:
- Scorciatoia
#per aggiungere alla memoria - Scorciatoia
!per eseguire comandi bash direttamente
- Scorciatoia
- Completamento scheda: Completamento percorso file con tasto tab
Considerazioni sulla sicurezza
Quando Claude Code viene eseguito in VS Code con i permessi di modifica automatica abilitati, potrebbe essere in grado di modificare i file di configurazione dell’IDE che possono essere eseguiti automaticamente dal tuo IDE. Questo può aumentare il rischio di eseguire Claude Code in modalità modifica automatica e consentire di aggirare i prompt di permesso di Claude Code per l’esecuzione bash. Quando esegui in VS Code, considera:- Abilitare Modalità ristretta VS Code per aree di lavoro non attendibili
- Utilizzare la modalità di approvazione manuale per le modifiche
- Prestare particolare attenzione per assicurarsi che Claude sia utilizzato solo con prompt attendibili
Integrazione CLI legacy
La prima integrazione VS Code che abbiamo rilasciato consente a Claude Code in esecuzione nel terminale di interagire con il tuo IDE. Fornisce condivisione del contesto di selezione (la selezione/scheda corrente viene condivisa automaticamente con Claude Code), visualizzazione diff nell’IDE invece del terminale, scorciatoie di riferimento file (Cmd+Option+K su Mac o Alt+Ctrl+K su Windows/Linux per inserire riferimenti file come @File#L1-99), e condivisione diagnostica automatica (errori di lint e sintassi).
L’integrazione legacy si installa automaticamente quando esegui claude dal terminale integrato di VS Code. Semplicemente esegui claude dal terminale e tutte le funzionalità si attivano. Per terminali esterni, usa il comando /ide per connettere Claude Code alla tua istanza VS Code. Per configurare, esegui claude, inserisci /config, e imposta lo strumento diff su auto per il rilevamento automatico dell’IDE.
Sia l’estensione che l’integrazione CLI funzionano con Visual Studio Code, Cursor, Windsurf e VSCodium.
Risoluzione dei problemi
Estensione non si installa
- Assicurati di avere una versione compatibile di VS Code (1.85.0 o successiva)
- Verifica che VS Code abbia il permesso di installare estensioni
- Prova a installare direttamente dal sito web del marketplace
Integrazione legacy non funziona
- Assicurati di eseguire Claude Code dal terminale integrato di VS Code
- Assicurati che la CLI per la tua variante IDE sia installata:
- VS Code: il comando
codedovrebbe essere disponibile - Cursor: il comando
cursordovrebbe essere disponibile - Windsurf: il comando
windsurfdovrebbe essere disponibile - VSCodium: il comando
codiumdovrebbe essere disponibile
- VS Code: il comando
- Se il comando non è installato:
- Apri il palette dei comandi con
Cmd+Shift+P(Mac) oCtrl+Shift+P(Windows/Linux) - Cerca “Shell Command: Install ‘code’ command in PATH” (o equivalente per il tuo IDE)
- Apri il palette dei comandi con