Come usare Claude Code con VS Code?

Nicolas, Apr 10, 2026

---

Claude Code è l'assistente IA di Anthropic progettato per gli sviluppatori. Disponibile direttamente in VS Code tramite un'estensione ufficiale, consente di generare, modificare, analizzare e fare debug del codice senza lasciare l'editor. Dal 2025, l'estensione nativa è il metodo consigliato per usare Claude Code in VS Code — ecco come installarla e sfruttarla al meglio.

Prerequisiti prima dell'installazione

Prima di installare l'estensione Claude Code, verifica i seguenti requisiti:

• VS Code 1.98.0 o superiore — le versioni precedenti non sono compatibili con l'estensione
• Un account Anthropic — accederai quando apri l'estensione per la prima volta. Claude Code richiede un abbonamento Claude Pro, Max, Team o Enterprise
• Se usi Amazon Bedrock o Google Vertex AI come provider, è necessaria una configurazione specifica in settings.json

Installare l'estensione Claude Code

L'installazione avviene direttamente da VS Code in pochi secondi:

• Apri VS Code e premi Ctrl+Shift+X (Windows/Linux) o Cmd+Shift+X (Mac) per aprire il pannello Estensioni
• Cerca "Claude Code" nella barra di ricerca
• Installa l'estensione pubblicata da Anthropic — verifica bene l'editore per evitare estensioni di terze parti non ufficiali
• Se l'icona Spark non appare dopo l'installazione, riavvia VS Code o esegui "Developer: Reload Window" dalla palette dei comandi

Lo sapevi? l'estensione include automaticamente il CLI (interfaccia a riga di comando) di Claude Code. Non è necessario installare il CLI separatamente — è accessibile direttamente dal terminale integrato di VS Code per le funzionalità avanzate.

Aprire Claude Code in VS Code

Una volta installata l'estensione, l'icona Spark (⚡) identifica Claude Code in tutta l'interfaccia di VS Code. Diversi modi per accedervi:

• Barra degli strumenti dell'editor: clicca sull'icona Spark nell'angolo in alto a destra dell'editor — visibile solo quando un file è aperto
• Barra delle attività: clicca sull'icona Spark nella barra laterale sinistra per aprire l'elenco delle sessioni. Sempre visibile anche senza file aperto
• Palette dei comandi: Cmd+Shift+P / Ctrl+Shift+P, digita "Claude Code" e scegli "Open in New Tab"
• Barra di stato: clicca su ✱ Claude Code nell'angolo in basso a destra della finestra

Alla prima apertura del pannello appare una checklist di avvio guidato. Percorri ogni passaggio cliccando su "Show me" oppure ignorala con la X.

Inviare la prima richiesta

Claude Code vede automaticamente il file aperto nell'editor. Per interagire:

• Seleziona del codice nel file — Claude Code include automaticamente quella selezione nel contesto della richiesta
• Premi Option+K (Mac) / Alt+K (Windows/Linux) per inserire un riferimento @file.ts#5-10 alla tua selezione nel prompt
• Digita la tua richiesta in linguaggio naturale: "Spiega questa funzione", "Correggi questo bug", "Aggiungi test unitari per questa classe"…

Quando Claude Code propone di modificare un file, mostra un confronto diff affiancato delle modifiche proposte prima di applicarle. Puoi accettare, rifiutare o chiedere aggiustamenti.

Modalità di permesso

Claude Code offre tre modalità di permesso accessibili dal fondo della casella del prompt:

La modalità Plan è particolarmente utile per modifiche significative: Claude apre il piano come documento Markdown in cui puoi aggiungere commenti inline prima che inizi a modificare il codice.

Referenziare file con le @-menzioni

Per fornire contesto aggiuntivo a Claude Code, usa le @-menzioni nel prompt:

• Digita @ seguito dal nome del file per menzionarlo: @auth.ts
• Aggiungi un intervallo di righe per puntare a una sezione specifica: @auth.ts#10-25
• Menziona un'intera cartella: @src/components/
• Usa Option+K / Alt+K da una selezione per inserire automaticamente il riferimento

Gestire più conversazioni

VS Code consente di aprire più sessioni Claude Code contemporaneamente — utile per lavorare in parallelo su più funzionalità o cartelle del workspace:

• Ogni sessione mantiene il proprio contesto indipendente
• Apri una nuova conversazione con Cmd+N (Mac) / Ctrl+N (Windows/Linux) dal pannello Claude
• Accedi alla cronologia delle conversazioni dall'icona Spark nella barra delle attività
• Le sessioni possono essere aperte come schede o finestre separate in base alle proprie preferenze

Lo sapevi? se lavori su un progetto monorepo o microservizi, ogni cartella del workspace può avere la propria sessione Claude Code con il proprio contesto. Per personalizzare il comportamento di Claude sul tuo progetto, crea un file CLAUDE.md alla radice del repository — Claude Code lo leggerà automaticamente per adattare le risposte al progetto, alle convenzioni e alle istruzioni specifiche.

Usare il CLI dal terminale integrato

L'estensione VS Code include il CLI di Claude Code, accessibile dal terminale integrato di VS Code. Il CLI offre funzionalità avanzate non disponibili nell'interfaccia grafica:

• Esegui claude nel terminale integrato per avviare una sessione CLI
• Usa claude -p "il tuo prompt" per richieste non interattive (modalità print)
• Il comando /terminal-setup in una sessione configura automaticamente la scorciatoia Shift+Enter per i prompt su più righe
• Passa dall'interfaccia grafica al CLI tramite il menu delle impostazioni dell'estensione

Scorciatoie da tastiera essenziali

Lo sapevi? Claude Code per VS Code funziona anche con Cursor, Windsurf e VSCodium — la procedura di installazione è identica. Per i team che usano Amazon Bedrock o Google Vertex AI, aggiungi le variabili d'ambiente corrispondenti nel file settings.json di VS Code per configurare il provider alternativo.