Versioni applicabili: CC Switch 3.16.0 e successive. Questo articolo è organizzato basandosi sulla documentazione e sul codice del repository, utilizzando DeepSeek come esempio di un'interfaccia compatibile con OpenAI Chat Completions. Gli screenshot provengono dall'interfaccia frontend corrente, generati utilizzando dati di esempio desensibilizzati per evitare la divulgazione di chiavi API reali o saldi degli account.
Perché è necessario il routing locale
La nuova versione di Codex CLI è orientata verso l'API OpenAI Responses, mentre molti provider come DeepSeek, Kimi, MiniMax e SiliconFlow espongono in realtà il formato OpenAI Chat Completions, ovvero /chat/completions. I corpi delle richieste, gli eventi di streaming e le strutture di ritorno di questi due protocolli sono diversi. Inserire direttamente un'interfaccia Chat nella configurazione di Codex spesso produce elenchi di modelli errati, errori 404/400 o risposte in streaming che Codex non riesce a interpretare correttamente.
L'approccio di CC Switch è di far connettere Codex sempre a un route locale, inviando comunque le richieste tramite l'API Responses; il route identifica internamente se il provider corrente è in formato Chat, riscrive la richiesta in Chat Completions per inviarla all'upstream, e infine converte la risposta Chat di nuovo in formato Responses per restituirla a Codex.
Questa catena è principalmente suddivisa in quattro passaggi:
- Quando Codex subentra, la configurazione locale viene scritta come
http://127.0.0.1:15721/v1ewire_api = "responses"viene forzato. - Il
meta.apiFormat = "openai_chat"del Provider dice al route: l'upstream reale è Chat Completions. - Il route riscrive
/responseso/v1/responsesin/chat/completionse converte il corpo della richiesta Responses in un corpo della richiesta Chat. - Dopo che l'upstream ha risposto, il route converte il JSON Chat o SSE di nuovo in JSON/SSE Responses che Codex può comprendere.
Preparazione
Devi preparare tre cose prima:
- CC Switch installato e pronto per essere avviato.
- Codex CLI installato ed eseguito almeno una volta in modo che esista la struttura di directory
~/.codex/config.toml. - Una chiave API per DeepSeek o un provider simile di Chat Completions.
La documentazione ufficiale di DeepSeek attualmente indica che l'URL base compatibile con OpenAI è https://api.deepseek.com (altri provider usano spesso un URL base con suffisso /v1), e il percorso dell'API Chat è /chat/completions; il preset DeepSeek di CC Switch è già configurato con queste informazioni, quindi dai priorità all'uso del preset invece di costruire manualmente i percorsi dell'interfaccia.
Passaggio 1: Aggiungere un provider Codex
Apri CC Switch, passa alla scheda Codex in alto, e clicca sul segno più nell'angolo in alto a destra per aggiungere un provider.
Seleziona DeepSeek dai preset incorporati; devi solo fare due cose:
- Inserire la chiave API di DeepSeek.
- Salvare il provider.
Il preset include già l'indirizzo della richiesta di DeepSeek, il modello predefinito, il menu dei modelli e i parametri di pensiero/ragionamento, e attiverà automaticamente "Richiede mappatura del routing locale". Puoi regolare il modello predefinito o il nome visualizzato del modello secondo necessità; la conversione del protocollo è gestita dal layer di routing.
Passaggio 2: Abilitare il routing locale e subentrare a Codex
Vai alla pagina Routing nelle Impostazioni, espandi Routing locale e completa due attivazioni:
- Attiva l'interruttore principale di routing per avviare il servizio locale. L'indirizzo predefinito è
127.0.0.1:15721. - Attiva Codex in Abilitazione routing. Se vuoi solo che Codex passi attraverso il route, puoi tenere spenti Claude e Gemini.
Dopo il subentro, CC Switch punterà la configurazione live di Codex al route locale e gestirà l'autenticazione con segnaposto. La vera chiave DeepSeek è ancora salvata nella configurazione del provider di CC Switch e viene iniettata dal route locale durante l'inoltro, quindi non è necessario esporre la chiave nella configurazione live di Codex.
Passaggio 3: Cambiare provider e riavviare Codex
Torna all'elenco dei provider di Codex e clicca su Abilita per il provider DeepSeek. Se vedi un tag "Richiede route", significa che questo provider deve essere utilizzato mentre il route è in esecuzione; se il route non è avviato, CC Switch mostrerà un messaggio che dice "Il servizio di routing è necessario per l'uso normale".
Dopo il cambio, si consiglia di riavviare la sessione terminale corrente di Codex perché:
- Il processo di Codex potrebbe aver già letto il vecchio
config.toml. - Dopo che
modelcatalogjsonè stato generato, il menu/modelrichiede solitamente un nuovo processo per essere aggiornato.
Una volta in Codex, puoi usare /model per verificare se il modello corrente proviene dal preset DeepSeek, ad esempio DeepSeek V4 Flash. Attualmente, l'app Codex non supporta la selezione personalizzata di più modelli e utilizzerà per impostazione predefinita il primo modello nella configurazione.
Come gestire altri provider Chat
I provider comuni in formato Chat come DeepSeek, Kimi, MiniMax e SiliconFlow hanno già preset in CC Switch; dai priorità al loro utilizzo. Solo per i provider non presenti nei preset è necessario scegliere una configurazione personalizzata; in tal caso, inserisci la chiave API, l'URL base e il modello secondo la loro documentazione, e imposta il formato API su OpenAI Chat Completions (richiede routing).
Se l'upstream supporta direttamente l'API OpenAI Responses, non è necessario attivare "Richiede mappatura del routing locale"; in questo caso, CC Switch può connettersi direttamente tramite Responses senza conversione Chat.
FAQ
Codex segnala 404 o non riesce a trovare /responses
Di solito, ciò accade perché il subentro di Codex non è abilitato, o hai scritto manualmente l'URL base Chat dell'upstream direttamente in Codex. Verifica che ~/.codex/config.toml punti a http://127.0.0.1:15721/v1.
L'upstream DeepSeek segnala 404
Se si utilizza il preset DeepSeek incorporato, conferma prima che il provider corrente provenga effettivamente dal preset e che il routing di Codex sia abilitato. Solo quando si utilizza un provider personalizzato è necessario ricontrollare l'URL base: dovrebbe essere l'indirizzo root del servizio, non il percorso completo dell'interfaccia con /chat/completions.
/model non mostra i modelli DeepSeek
Riavvia Codex dopo aver salvato il provider. CC Switch genera cc-switch-model-catalog.json e scrive il percorso in modelcatalogjson, ma un processo Codex in esecuzione potrebbe non caricare a caldo la directory dei modelli.
Attualmente, l'app Codex non supporta la selezione di più modelli e utilizza per impostazione predefinita il primo modello.
Il route è attivo ma le richieste vanno ancora al provider sbagliato
Conferma che tre stati siano consistenti: il provider corrente sotto la scheda Codex è DeepSeek; il servizio di routing locale è in esecuzione; e l'interruttore Codex in Abilitazione routing è attivo.
Posso utilizzare l'account OpenAI Codex ufficiale tramite il routing locale?
Non raccomandato. CC Switch impedisce il passaggio a provider ufficiali in modalità di subentro del routing locale perché l'uso di un proxy per accedere all'API ufficiale può comportare rischi per l'account. Il routing è principalmente per scenari di terze parti, aggregazione o conversione di protocollo.
![Le geniali tecniche di utilizzo dell'IA di Yusuke Narita [Edizione da conservare]](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1784137658627_u4bwry_HNMS89bbsAAUPJI.jpg)
