Usare DeepSeek in Codex CLI: Guida alla configurazione di V4 Flash / Pro

Configura DeepSeek V4 Flash e Pro in Codex CLI tramite l'endpoint Responses di APIMaster. Include configurazione della chiave API, cambio modello, test degli strumenti e risoluzione dei problemi.

Codex CLI può usare DeepSeek? I nostri test con Codex CLI 0.153.4 hanno utilizzato con successo deepseek-v4-flash e deepseek-v4-pro tramite l'endpoint Responses di APIMaster. Configura un provider personalizzato con URL di base https://apimaster.ai/v1 e wire_api = "responses". Le Chat Completions compatibili con OpenAI da sole non sono sufficienti per questa configurazione.

Ultimo test: 2026-09-07, Codex CLI 0.153.4, Linux. Entrambi i modelli hanno restituito il testo previsto, hanno invocato uno strumento shell per leggere un file di test locale e hanno risposto con il suo contenuto. Tutte le esecuzioni sono terminate con codice 0. Si sono verificati avvisi relativi ai metadati e agli eventi di streaming; vedere la sezione sulla risoluzione dei problemi. I comandi per Windows/macOS sono forniti per la configurazione, ma questo test è stato eseguito su Linux. Sessioni lunghe, input di immagini e flussi di lavoro di codifica complessi non sono stati testati.

1. Preparare Codex e la tua chiave API

Installa Codex seguendo la guida all'ambiente e la guida alla configurazione di Codex, poi verifica:

codex --version

Crea una chiave API APIMaster con accesso al modello DeepSeek selezionato e quota sufficiente. Per questo tutorial, usa la configurazione dedicata di seguito; non è necessario sostituire un auth.json esistente o disconnetterti da un altro account.

2. Imposta la chiave nel tuo terminale

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

La variabile esiste solo in questa sessione del terminale. La configurazione memorizza il nome della variabile, non il segreto stesso.

3. Crea una configurazione provider separata

In una directory che usi per questo tutorial, crea deepseek.toml con questo contenuto. Mantieni invariata la tua configurazione Codex esistente.

model = "deepseek-v4-flash"
model_provider = "apimaster_deepseek"

[model_providers.apimaster_deepseek]
name = "APIMaster DeepSeek"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"

Per un primo test copiabile e isolato, passa le stesse impostazioni come override da riga di comando. --ignore-user-config impedisce che un altro provider nella tua configurazione normale abbia la precedenza. --ephemeral evita di salvare questa sessione di test.

codex exec --ignore-user-config --ephemeral --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash -c 'model_provider="apimaster_deepseek"' -c 'model_providers.apimaster_deepseek.name="APIMaster DeepSeek"' -c 'model_providers.apimaster_deepseek.base_url="https://apimaster.ai/v1"' -c 'model_providers.apimaster_deepseek.env_key="APIMASTER_API_KEY"' -c 'model_providers.apimaster_deepseek.wire_api="responses"' "Reply with exactly: DEEPSEEK_TEST_OK"

Esegui il comando dal terminale dove hai impostato la chiave. Risposta finale prevista: DEEPSEEK_TEST_OK. Nelle versioni precedenti di Windows PowerShell, la citazione degli argomenti nativi può differire; usa PowerShell 7 o il metodo del profilo di seguito se gli argomenti TOML vengono rifiutati.

4. Salva la configurazione come profilo riutilizzabile

Per la versione CLI testata, posiziona deepseek.toml in ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Se CODEX_HOME è personalizzato, usa quella directory invece. Questo profilo nominato mantiene le impostazioni DeepSeek separate dal tuo config.toml normale.

macOS / Linux, dalla directory che contiene deepseek.toml:

mkdir -p ~/.codex
cp deepseek.toml ~/.codex/deepseek.config.toml
codex --profile deepseek --model deepseek-v4-flash

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
Copy-Item .\deepseek.toml "$env:USERPROFILE\.codex\deepseek.config.toml"
codex --profile deepseek --model deepseek-v4-flash

Esegui prima il backup di un file di profilo se quel nome file esiste già. La sintassi del profilo dipende dalla versione: questi comandi sono destinati a 0.153.4. Controlla codex --help sulla tua versione installata; le versioni precedenti possono usare profili all'interno di config.toml invece.

Per usare Pro:

codex --profile deepseek --model deepseek-v4-pro

Un profilo si sovrappone alla tua configurazione normale, quindi i server MCP esistenti o altre impostazioni possono ancora essere applicati. Il comando isolato nel passaggio 3 è utile quando si diagnosticano conflitti di configurazione.

5. Verifica una chiamata di strumento

Crea un file locale chiamato probe.txt contenente:

TOOL_PROBE_739182

Dalla stessa directory, esegui:

codex exec --profile deepseek --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash "Use your file reading or shell tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Previsto: un comando di lettura file viene eseguito con successo, seguito da TOOL_PROBE_739182. Ripeti con --model deepseek-v4-pro. Questo verifica un round trip di richiesta/risultato dello strumento, oltre a una semplice risposta testuale. Mantieni abilitati i normali prompt di autorizzazione per il lavoro di progetto effettivo.

Risoluzione dei problemi

Sintomo	Spiegazione o passo successivo
`Model metadata ... not found`	La CLI testata non aveva metadati integrati per questi ID modello e ha usato metadati di fallback. I nostri test di testo e strumento sono stati completati, ma i limiti di contesto e altri valori predefiniti non devono essere trattati come capacità del modello verificate.
Errore di parsing dell'elenco modelli	L'elenco modelli del gateway può differire dal catalogo metadati di Codex. Specifica il modello esplicitamente e verifica se la richiesta effettiva termina.
`OutputTextDelta without active item`	Visto nel nostro test di streaming. La risposta finale e il round trip dello strumento sono comunque stati completati. Se l'output è mancante o interrotto, conserva la versione CLI, il timestamp e l'errore per il supporto.
401 o richiesta che va a un altro provider	Controlla `APIMASTER_API_KEY`, la selezione del provider e le impostazioni ereditate. Riprova il comando isolato nel passaggio 3.
404 o protocollo non supportato	L'URL di base termina con `/v1`, non `/chat/completions`; imposta `wire_api = "responses"`.
Opzione da riga di comando sconosciuta	Controlla la versione CLI installata. Le opzioni documentate sono state testate con 0.153.4.

Domande frequenti

Questo significa che ogni endpoint DeepSeek funziona in Codex?

No. Questi risultati si applicano alla configurazione del gateway di APIMaster. Un provider deve supportare il protocollo e il comportamento degli strumenti che Codex si aspetta; accettare /chat/completions non stabilisce la compatibilità con Responses.

Ho bisogno di un abbonamento ChatGPT per questa configurazione?

Questo provider personalizzato usa la tua chiave API APIMaster e la quota del tuo account. Non usa la quota dell'abbonamento ChatGPT. Controlla il marketplace dei modelli per le tariffe API attuali.

Posso rivendicare piena compatibilità con Codex da questi test?

L'ambito verificato è l'output di testo breve e un round trip di strumento di lettura file locale. Gli avvisi sopra rimangono rilevanti; il comportamento a contesto lungo, ogni strumento e ogni futura versione CLI non sono coperti.