VS Code
Usa l'estensione Claude Code per VS Code con OneProvider: aggiungi endpoint e chiave in settings.json, riavvia, salta la richiesta di accesso e prova.
L'estensione Claude Code di VS Code legge le variabili d'ambiente da un settings.json nella tua cartella home. Inserisci l'endpoint e la chiave di OneProvider e riavvia.
Tutti i modelli, le funzionalità e i prezzi Indice della documentazione per agenti AI:https://oneprovider.dev/docs/llms.txt Sistema operativo Prima di iniziare: una chiave dalla tua area personale Apri la tua area personale: nel bot Telegram @oneprovider_robot («Area personale») oppure su app.oneprovider.dev . Premi «Emetti una chiave», dalle un nome (per esempio, questo client) e un limite di spesa, poi copia la chiave. Il saldo si ricarica nello stesso posto. Altro sull'area personale e sulle chiavi . Installazione
Cerca «Claude Code» nel VS Code Marketplace (publisher anthropic.claude-code) e installala. L'estensione include un proprio runtime: per l'editor non serve installare una CLI a parte.
Configurazione
Crea un settings.json nel percorso specifico del tuo sistema operativo qui sotto. L'estensione legge questo file all'avvio e usa il blocco env per ogni richiesta in uscita.
Percorso: ~/.claude/settings.json
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.oneprovider.dev",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key-here",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
} Crea il file se non esiste, poi riavvia completamente VS Code in modo che il nuovo blocco env venga caricato.
Se l'estensione chiede di accedere
L'estensione controlla le credenziali prima di avviarsi e può mostrare una schermata di accesso se non hai un account Claude. La soluzione affidabile è impostare indirizzo e chiave nelle impostazioni utente di VS Code: apri la Command Palette (Riquadro comandi: ⌘⇧P / Ctrl+Shift+P ) → Preferences: Open User Settings (JSON) e aggiungi (uguale su macOS, Linux e Windows):
{
"claudeCode.disableLoginPrompt": true,
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "https://api.oneprovider.dev" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-your-key-here" }
]
} Riavvia VS Code. Una chiave OneProvider funziona sia come ANTHROPIC_AUTH_TOKEN (Bearer) sia come ANTHROPIC_API_KEY.
Verifica
Apri il pannello di Claude Code ( ⌘⇧P / Ctrl+Shift+P → Claude Code: Focus), scrivi ping e invia. Una risposta entro pochi secondi conferma che l'override dell'endpoint è attivo.
Quale modello scegliere
L'estensione usa lo stesso motore di Claude Code, quindi i modelli si scelgono allo stesso modo. Tieni claude-sonnet-5-5 come predefinito per le modifiche quotidiane, passa a claude-opus-5-5 per i grandi refactoring e usa claude-haiku-5-5 per domande rapide ed economiche. Cambia il modello con /model nel pannello. Gli ID e le tariffe sono nella pagina dei modelli e nella pagina dei prezzi ; un limite di spesa sulla chiave rende il conto prevedibile.
Errori comuni e soluzioni
L'estensione mostra una schermata di accesso
L'estensione controlla le credenziali prima di avviarsi. Aggiungi claudeCode.disableLoginPrompt e il blocco claudeCode.environmentVariables della sezione qui sopra alle impostazioni utente (JSON) di VS Code, poi riavvia VS Code completamente.
401 Invalid API key
Il valore contiene una virgoletta o uno spazio di troppo, oppure un ANTHROPIC_AUTH_TOKEN estraneo di un altro servizio sovrascrive la tua chiave. Imposta la chiave OneProvider intera, senza virgolette, in un solo posto.
404 o endpoint sbagliato
La base URL è https://api.oneprovider.dev senza /v1. Il percorso lo aggiunge l'estensione.
Dopo aver modificato le impostazioni non è cambiato nulla
Chiudi completamente VS Code (non basta ricaricare la finestra) per caricare il nuovo blocco env. In una finestra Remote-SSH, WSL o dev-container l'estensione di solito legge le impostazioni sul lato remoto, quindi mettile lì.
Gli stream si interrompono
Disattiva le VPN o i proxy VLESS sulla macchina che esegue l'estensione: mettono in buffer l'SSE e rompono HTTP/2.
Ho incollato il blocco in settings.json ma non è cambiato nulla
Sono due file diversi. Il blocco env va in ~/.claude/settings.json; le impostazioni utente di VS Code (JSON) accettano solo le chiavi claudeCode.disableLoginPrompt e claudeCode.environmentVariables della sezione precedente. Controlla che ~/.claude/settings.json non abbia una virgola dopo l’ultimo elemento, poi chiudi completamente VS Code.
FAQ
Mi serve anche la CLI di Claude Code?
No. L'estensione include un proprio runtime. Se usi anche la CLI, entrambe leggono lo stesso ~/.claude/settings.json, vedi Claude Code .
Mi serve un abbonamento Claude?
No, basta la chiave di OneProvider.
Quale formato di chiave accetta?
La chiave sk-… così com'è, come ANTHROPIC_AUTH_TOKEN (Bearer) o ANTHROPIC_API_KEY.
Dove vedo il costo?
Nella pagina «Consumo» della Dashboard della chiave. Aggiungi un limite di spesa quando emetti la chiave.
Posso usare nell’estensione un id GPT o un altro del catalogo?
Sì, un id di testo dal catalogo : anche il nostro endpoint Anthropic risponde a questi id. Metti "model": "gpt-6.1-terra" in ~/.claude/settings.json; le chiamate agli strumenti dipendono dal modello.
Posso usare invece GitHub Copilot Chat o Continue?
Sì, entrambi accettano un endpoint in stile OpenAI. Copilot Chat: palette comandi → Chat: Manage Language Models → Add Models → Custom Endpoint, poi in chatLanguageModels.json imposta "apiType": "chat-completions", id gpt-6.1-terra, url https://api.oneprovider.dev/v1/chat/completions e "toolCalling": true (un modello senza chiamate agli strumenti è nascosto), più maxInputTokens e maxOutputTokens dalla riga del catalogo. Nelle sessioni dell’harness Copilot attiva anche chat.agentHost.byokModels.enabled. Copre chat e agente, non i suggerimenti inline. Continue: aggiungi a config.yaml un modello con provider: openai, apiBase: https://api.oneprovider.dev/v1, la tua chiave e l’id del modello.
Risposte rapide
Quale base URL devo usare?
Claude Code e gli SDK Anthropic usano https://api.oneprovider.dev. Gli SDK OpenAI e i client compatibili con OpenAI usano https://api.oneprovider.dev/v1. Con una sola chiave funzionano entrambi; l'elenco dei modelli è nella pagina dei modelli , le tariffe nella pagina dei prezzi .
Come mi autentico?
Invia la chiave sk-… così com'è in x-api-key oppure in Authorization: Bearer: uno dei due, mai entrambi. Tieni la chiave in una variabile d'ambiente, non in un file che finisce nel commit. Altro sull'autenticazione .
Dove ottengo una chiave?
Apri la tua area personale nel bot Telegram @oneprovider_robot oppure su app.oneprovider.dev, ricarica il saldo e premi «Emetti una chiave». Ogni chiave può avere un proprio limite di spesa. Area personale e chiavi API .
Cosa significano 401, 404 e 429?
401: la chiave manca, è scritta male o è inviata nell'header sbagliato; incolla la chiave intera, senza virgolette né spazi. 404: di solito la base URL è sbagliata, per esempio manca /v1 o è doppio. 429 con “Insufficient balance”: il saldo dell'area personale o il limite di spesa della chiave è esaurito, quindi ricarica invece di riprovare; qualsiasi altro 429 è un limite di frequenza, quindi attendi il tempo indicato in Retry-After. Dettagli: codici di errore e risoluzione dei problemi .
Perché gli stream si interrompono o si resettano?
VPN e proxy VLESS spesso mettono in buffer gli SSE o rompono la negoziazione HTTP/2. OneProvider non ha restrizioni regionali e non mette in buffer gli stream: disattiva il proxy e riprova.
Dove chiedo se non basta?
Scrivi a @Oneproviderhelpbot su Telegram oppure apri «Assistenza» nell'area personale sul sito, indicando il codice di stato HTTP e il testo esatto dell'errore. Come funziona l'assistenza .
Ultimo aggiornamento: 2026-11-17 Hai trovato un errore? @Oneproviderhelpbot