Claude Code in VS Code: l'estensione, l'uso dal terminale e gli errori

Installa l'estensione Claude Code per VS Code

Cerca Claude Code di Anthropic nella vista Estensioni, oppure incolla vscode:extension/anthropic.claude-code nel browser per aprirla direttamente. L'estensione è un'interfaccia per la CLI: al primo avvio verifica la presenza dell'eseguibile claude e lo installa se manca (per l'installazione tramite npm è richiesto Node.js 18+; l'installer nativo non richiede nulla). Dopo, l'icona di Claude nella barra delle attività apre un pannello in cui puoi chattare, e ogni modifica apportata dall'agente appare come un diff in linea che puoi accettare o rifiutare — lo stesso ciclo del terminale, con l'editor come interfaccia di revisione.

# check the CLI the extension will use
claude --version
# if it is missing, install it yourself and reload VS Code
npm install -g @anthropic-ai/claude-code     # or: curl -fsSL https://claude.ai/install.sh | bash

Oppure salta l'estensione: Claude Code nel terminale integrato

Apri il terminale di VS Code ed esegui claude. È l'agente completo — modalità di pianificazione, sottoagenti, hook, MCP, /compact — e funziona in qualsiasi fork di VS Code, inclusi Cursor e VSCodium, senza l'estensione. Le modifiche vengono applicate immediatamente ai file aperti e la vista diff di VS Code le mostra. Per attività autonome lunghe, la maggior parte degli utenti preferisce questa modalità; per piccole modifiche interattive, il pannello dell'estensione è più comodo. Possono essere eseguiti contemporaneamente.

Verifica quale account sta usando Claude Code in VS Code

Sia l'estensione sia il terminale leggono la stessa configurazione, quindi la risposta è la stessa in entrambi i casi: esegui /status all'interno di una sessione. Mostra l'endpoint (ANTHROPIC_BASE_URL), se è attiva una chiave API o un abbonamento /login , il modello e la versione. Se nell'ambiente è impostata una chiave API, questa ha la precedenza sull'accesso, ed è il motivo più comune per cui si verifica la situazione "Ho effettuato l'accesso con Max, ma gli addebiti vengono scalati dal mio saldo API". Per cambiare, rimuovi ANTHROPIC_API_KEY per usare l'abbonamento, oppure impostala (insieme a ANTHROPIC_BASE_URL per un gateway) per l'uso a consumo.

# use this gateway from VS Code: put these in your shell profile, restart VS Code
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key

VS Code eredita le variabili d'ambiente dalla shell che lo ha avviato. Se /status mostra ancora il vecchio endpoint dopo aver modificato il profilo, chiudi completamente VS Code e avvialo da un nuovo terminale — ricaricare la finestra non basta.

Errore: comando 'claude-vscode.editor.openlast' non trovato

Questo messaggio appare quando una scorciatoia da tastiera o la tavolozza dei comandi richiama l'estensione prima che si sia attivata, oppure quando l'estensione si è attivata ma non ha trovato la CLI sottostante.

In ordine: 1) Ricarica la finestra (Developer: Reload Window) — nella maggior parte dei casi il problema si risolve qui. 2) Esegui claude --version nel terminale; se non viene trovato, installa la CLI (vedi sopra) e ricarica di nuovo. 3) Verifica che l'estensione sia abilitata per questo spazio di lavoro, non solo installata. 4) Se usi un fork di VS Code, verifica che la versione dell'estensione lo supporti — altrimenti la modalità tramite terminale funziona comunque. 5) Come ultima risorsa, disinstalla l'estensione, elimina ~/.claude/ le cache solo se accetti di perdere la cronologia locale delle sessioni, quindi reinstalla.

Altri problemi dell'estensione

• Il pannello si apre ma resta vuoto → la CLI è in fase di avvio; controlla il pannello Output (Claude Code) per individuare l'errore effettivo, di solito una versione obsoleta di Node.js.
• I diff in linea non compaiono mai → lo spazio di lavoro non è considerato attendibile; VS Code blocca le estensioni in modalità con restrizioni.
• Funziona nel terminale, ma non nel pannello → un proxy o ANTHROPIC_BASE_URL è impostato solo nel profilo della shell, non nell'ambiente da cui è stato avviato VS Code.
• 401 / chiave non valida → la chiave non corrisponde all'endpoint; un URL di gateway richiede una chiave del gateway, mentre l'URL di Anthropic richiede una chiave della console.

Costi in VS Code

L'estensione applica la stessa fatturazione della CLI — per token, attraverso il servizio sottostante. Su questo gateway si usano crediti con un valore nominale pari a 7.69231 volte il prezzo pagato ($13 acquistano $100 di utilizzo, con uno sconto del 87%) oppure un piano illimitato a tariffa fissa a partire da $1; la guida ai prezzi fornisce i dettagli e la guida ai modelli elenca ciò che /model può selezionare.

Tutti i piani illimitati →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Domande frequenti

AI Prime Tech è un gateway API indipendente e non è affiliato ad Anthropic, né approvato o sponsorizzato da Anthropic. «Claude» e «Claude Code» sono marchi di Anthropic. Le funzionalità di Claude Code descritte qui rispecchiano la documentazione pubblica di Anthropic al momento della stesura e cambiano frequentemente; i prezzi e gli elenchi dei modelli presenti in questa pagina vengono letti dalle impostazioni attuali di questo gateway.