Risorse per sviluppatori

Claude Code in VS Code e Cursor

Installa l'estensione Claude Code in VS Code o Cursor e connetti le sue impostazioni condivise a RunAPI.

Panoramica

L’estensione ufficiale Claude Code funziona sia in VS Code che in Cursor. Entrambi gli editor utilizzano le stesse impostazioni utente di Claude Code, quindi questa guida installa l’estensione corrispondente e configura RunAPI una volta in ~/.claude/settings.json.

Prima di iniziare

Installa una versione supportata di VS Code o Cursor. La versione minima attuale di VS Code è indicata nella guida ufficiale all’estensione.
Crea una Chiave API standard seguendo la Guida introduttiva all’Autenticazione. Non inserirla nelle impostazioni del workspace né nel controllo del codice sorgente.
Copia un identificatore di modello che supporta Anthropic Messages dal Catalogo modelli.

Installa

Installa l’estensione ufficiale anthropic.claude-code:

VS Code: apri la pagina VS Code Marketplace o cerca Claude Code nelle Estensioni.
Cursor: apri cursor:extension/anthropic.claude-code o cerca Claude Code nelle Estensioni.

L’estensione include il runtime necessario per il suo pannello di chat. Installa la CLI standalone solo se desideri eseguire anche claude nel terminale integrato.

Configura RunAPI

Apri ~/.claude/settings.json e aggiungi le impostazioni di ambiente condivise a livello utente:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

Nelle impostazioni di VS Code o Cursor, cerca Claude Code login e abilita Disable Login Prompt per questo endpoint personalizzato. Le impostazioni utente sono condivise con la CLI; le impostazioni dell’estensione VS Code controllano solo il comportamento dell’estensione.

Mantieni la chiave reale fuori da .claude/settings.json e dalle impostazioni del workspace dell’editor perché questi file potrebbero essere committati.

Scegli un modello

Sostituisci YOUR_RUNAPI_MODEL_ID con un identificatore esatto dal Catalogo modelli. Nel pannello Claude Code, /model cambia la selezione corrente e /status mostra il modello attivo.

Verifica

Ricarica la finestra dell’editor dopo aver modificato l’estensione o le impostazioni.
Apri il pannello Claude Code Spark.
Esegui /status e verifica le impostazioni utente e il modello.
Invia Describe this repository in one sentence. e verifica che la risposta sia normale.

Risoluzione dei problemi

L’estensione non si installa: conferma che la versione dell’editor soddisfi i requisiti ufficiali.
L’icona Spark è assente: ricarica la finestra dell’editor, quindi riavvia l’editor.
Compare ancora una richiesta di accesso: abilita Disable Login Prompt nelle impostazioni dell’estensione Claude Code.
Il pannello non eredita le variabili della shell: usa ~/.claude/settings.json oppure avvia l’editor dal terminale configurato. Le applicazioni GUI spesso si avviano senza l’ambiente del terminale.
La CLI funziona ma il pannello no: ricarica la finestra e usa la CLI standalone per riprodurre la richiesta con diagnostica più dettagliata.
L’autenticazione o la selezione del modello non riesce: verifica la chiave nella Authentication Guide e copia l’identificatore esatto dal Model Catalog.

Passaggi successivi

Usa la guida introduttiva all’LLM API per il comportamento del protocollo e il Riferimento API Anthropic Messages per i campi di richiesta. Per aggiungere gli strumenti RunAPI all’interno dell’editor, continua con la Panoramica MCP.