Claude Desktop

Usa Claude Code dentro l'app Claude Desktop (scheda Code) su OneProvider, senza un account Claude.

App Claude Desktop con la scheda Code

Cosa funziona

La scheda Code (Claude Code con un'interfaccia visuale) e Cowork funzionano su OneProvider tramite la modalità gateway integrata di Claude Desktop, che Anthropic chiama third-party inference (inferenza di terze parti). Non serve alcun account Claude o Anthropic. Funziona su macOS 14+ e Windows 10 (2004) o successivi, compreso Windows 11.

Limite del client

La modalità gateway è solo locale: le sessioni girano sul tuo computer, senza sessioni cloud, SSH o Remote Control. Desktop prende il gateway dal modulo qui sotto, non da ANTHROPIC_BASE_URL né da ~/.claude/settings.json (che servono per la riga di comando di Claude Code). Senza il modulo, Desktop si apre solo con un abbonamento Claude a pagamento.

Configurazione

1. Installa Claude Desktop e non accedere

   Scarica l'app da claude.com/download (macOS: .dmg, trascina Claude in Applicazioni; Windows: programma di installazione .msix) e avviala. Resta sulla schermata di accesso: non accedere e non creare un account Anthropic.

2. Attiva la Developer Mode

   macOS: nella barra dei menu scegli Help → Troubleshooting → Enable Developer Mode (Aiuto → Risoluzione dei problemi → Abilita modalità sviluppatore). Windows: clicca sul menu dell'applicazione ☰ in alto a sinistra nella schermata di accesso, poi su Help → Troubleshooting → Enable Developer Mode. L'app si riavvia e compare un menu Developer; resta attivo anche dopo i riavvii.

3. Apri Configure Third-Party Inference

   Scegli Developer → Configure Third-Party Inference… (Configura inferenza di terze parti). Nella sezione Connection imposta Inference provider su Gateway e compila la scheda Gateway credentials come mostrato. La base URL è esattamente questa, senza /v1 e senza altro percorso; incolla la tua chiave di OneProvider in Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (funziona anche x-api-key)

4. Controlla l'elenco dei modelli

   Lascia prima vuoto Models: Desktop interroga https://api.oneprovider.dev/v1/models e mostra i modelli Claude del catalogo. Se il selettore resta vuoto, apri la sezione Models e aggiungi l'ID esatto del modello Claude (<your-compatible-model-id>) dal catalogo dei modelli; la prima voce è quella predefinita per le nuove sessioni Code.

5. Applica, riavvia e parti in modalità gateway

   Clicca su Apply Changes, poi su Save & Restart. Dopo il riavvio la schermata di accesso propone di partire con la configurazione del tuo inference provider: scegli quell'opzione, non l'accesso Anthropic. Apri la scheda Code, scegli una cartella di progetto locale e invia un messaggio.

Verifica la connessione

Controlla la richiesta nella tua area personale

Invia un breve messaggio in una nuova sessione Code. Entro un minuto la richiesta dovrebbe comparire nell'area personale sotto «Consumo», con il modello, i token e un addebito. Se fallisce:

Schermata di accesso standard senza l'opzione del provider → il modulo non è stato applicato: chiudi completamente l'app (Cmd+Q su macOS, Gestione attività su Windows) e riaprila
"Gateway was unreachable" → controlla la base URL (esattamente https://api.oneprovider.dev) e disattiva VPN o proxy
401 → chiave sbagliata, revocata o scaduta: controllala nell'area personale sotto «Chiavi»
429 insufficient balance → ricarica il saldo dell'area personale, poi reinvia
Selettore dei modelli vuoto → aggiungi l'ID del modello nella sezione Models
"Error 403: Forbidden" → sei sul percorso di accesso Anthropic: scegli invece l'opzione del provider
Cosa ha applicato Desktop: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Log: ~/Library/Logs/Claude-3p/main.log (macOS) o %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Dati di connessione

Protocollo

anthropic

Endpoint

https://api.oneprovider.dev

Sicurezza della chiave

La chiave è conservata nella configurazione di Desktop solo su questo computer. Usa una chiave dedicata con un limite di spesa; se il computer è condiviso o la chiave trapela, elimina o metti in pausa quella chiave nell'area personale e il resto del tuo saldo resta al sicuro.

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 .