Home → Guides → Puntare Claude Desktop e Codex su APICLAN
Le applicazioni desktop non hanno un campo per la base URL nelle proprie impostazioni. CC Switch scrive quella configurazione al posto tuo. Ecco esattamente cosa inserire e le due cose che spiegano quasi tutte le configurazioni fallite.
Ti servono un account con credito e una chiave API. Creala nella console, in «Chiavi API»: scegli la famiglia di fornitore che chiamerai — Anthropic per Claude Desktop, OpenAI per Codex — e poi il gruppo di chiavi da cui spendere. Il gruppo determina la tua tariffa; quanto costa ogni modello è sulla pagina prezzi.
Una chiave appartiene esattamente a un gruppo. Una chiave creata per i modelli di testo non può chiamare i modelli di immagini, e viceversa; questo torna come 404 sul modello, non come errore di permessi. Se ti servono entrambi, crea due chiavi. Che cosa può chiamare una data chiave lo dice sempre GET /v1/models inviato con quella chiave.
Ogni richiesta deve arrivare su un percorso che inizia con /v1. Se tu debba scrivere /v1 nel client dipende dal client: alcuni lo aggiungono da soli, altri no. Questo singolo dettaglio è dietro la maggior parte delle segnalazioni «non si connette».
| Client | Indirizzo di richiesta da inserire |
|---|---|
| Claude Desktop (via CC Switch) | https://apiclan.us/v1 |
| Codex / ChatGPT desktop app | https://apiclan.us/v1 |
| OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studio | https://apiclan.us/v1 |
| Cursor, Cline, Roo Code | https://apiclan.us/v1 |
| Claude Code | https://apiclan.us |
| Anthropic SDK | https://apiclan.us |
Al contrario, la richiesta dà 404 sul bordo della rete: non raggiunge mai il gateway e non compare mai nel registro di utilizzo — quindi un registro vuoto è di per sé il sintomo. Non lasciare mai una barra finale nell'indirizzo.
Codex è stato integrato nell'applicazione desktop ChatGPT. Su Windows installa ChatGPT dal Microsoft Store; su macOS scaricala dal sito di OpenAI. Il Codex da riga di comando usa le stesse impostazioni.
In CC Switch aggiungi un fornitore per Codex, incolla la chiave e inserisci https://apiclan.us/v1 come indirizzo di richiesta. Attiva quel fornitore, poi chiudi Codex completamente — non basta chiudere la finestra — e riavvialo. La configurazione viene letta all'avvio, quindi un'istanza in esecuzione mantiene le vecchie impostazioni e sembra che non sia successo nulla.
Se preferisci modificare il file di configurazione a mano invece di usare CC Switch, la base URL e il posto della chiave sono descritti nella nostra guida rapida.
Installa Claude Desktop da claude.com, poi configura il fornitore in CC Switch:
https://apiclan.us/v1 come indirizzo di richiesta — il client vi aggiunge /messages. Nessuna barra finale.Se CC Switch ti fa scegliere tra connessione diretta e mappatura dei modelli, leggi la sezione seguente prima di decidere. È quell'impostazione a determinare se il selettore dei modelli funziona.
Un avviso che dice che la connessione funziona ma il fornitore ha rifiutato la richiesta riguarda quasi sempre il nome del modello, non la chiave. L'app desktop invia i propri identificatori di modello integrati, e un gateway può servire soltanto i modelli che i suoi account a monte offrono davvero.
La soluzione è la mappatura dei modelli invece della connessione diretta: fai corrispondere le voci dell'app ai nomi serviti da questo gateway. La connessione diretta funziona solo se il fornitore accetta esattamente gli identificatori inviati dall'app.
Invia GET /v1/models con la tua chiave per ottenere l'elenco su cui mappare. Quell'elenco è costruito dal gruppo della tua chiave, quindi è la risposta reale per il tuo account e non un catalogo generico.
Non viene sovrascritto nulla in modo permanente. In CC Switch riattiva il fornitore ufficiale e riavvia il client: l'app desktop torna al tuo abbonamento. Puoi tenere entrambi configurati e passare da uno all'altro quando vuoi — il credito qui è prepagato e non scade, quindi una configurazione inutilizzata non costa nulla.
/v1 e togli eventuali barre finali.Ancora bloccato? Scrivi a support@apiclan.us indicando il nome del modello che ha fallito e più o meno quando hai provato. Legge una persona.
No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.
Read the 30-second quickstartPrices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.