Vai al contenuto principale
Claude Code VS Code Extension Interface

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:
  1. Fai clic sull’icona Spark nella barra laterale dell’editor per aprire il pannello Claude Code
  2. Richiedi a Claude Code nello stesso modo in cui faresti nel terminale
  3. Osserva mentre Claude analizza il tuo codice e suggerisce modifiche
  4. 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:
  1. Apri le impostazioni VS Code
  2. Cerca “Claude Code: Environment Variables”
  3. Aggiungi le variabili di ambiente richieste

Variabili di ambiente

VariabileDescrizioneObbligatoriaEsempio
CLAUDE_CODE_USE_BEDROCKAbilita l’integrazione Amazon BedrockObbligatoria per Bedrock"1" o "true"
CLAUDE_CODE_USE_VERTEXAbilita l’integrazione Google Vertex AIObbligatoria per Vertex AI"1" o "true"
ANTHROPIC_API_KEYChiave API per l’accesso di terze partiObbligatoria"your-api-key"
AWS_REGIONRegione AWS per Bedrock"us-east-2"
AWS_PROFILEProfilo AWS per l’autenticazione Bedrock"your-profile"
CLOUD_ML_REGIONRegione per Vertex AI"global" o "us-east5"
ANTHROPIC_VERTEX_PROJECT_IDID progetto GCP per Vertex AI"your-project-id"
ANTHROPIC_MODELSovrascrivi modello primarioID modello di override"us.anthropic.claude-sonnet-4-5-20250929-v1:0"
ANTHROPIC_SMALL_FAST_MODELSovrascrivi modello piccolo/veloceFacoltativa"us.anthropic.claude-3-5-haiku-20241022-v1:0"
CLAUDE_CODE_SKIP_AUTH_LOGINDisabilita tutti i prompt di accessoFacoltativa"1" o "true"
Per istruzioni di configurazione dettagliate e opzioni di configurazione aggiuntive, vedi:

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
  • Completamento scheda: Completamento percorso file con tasto tab
Stiamo lavorando per aggiungere queste funzionalità negli aggiornamenti futuri.

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 code dovrebbe essere disponibile
    • Cursor: il comando cursor dovrebbe essere disponibile
    • Windsurf: il comando windsurf dovrebbe essere disponibile
    • VSCodium: il comando codium dovrebbe essere disponibile
  • Se il comando non è installato:
    1. Apri il palette dei comandi con Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows/Linux)
    2. Cerca “Shell Command: Install ‘code’ command in PATH” (o equivalente per il tuo IDE)
Per ulteriore aiuto, vedi la nostra guida alla risoluzione dei problemi.