DeepSeek V4 Flash e Pro in Codex: configurazione e selezione del modello
Configura DeepSeek in Codex con APIMaster. Trova config.toml su Windows, macOS e Linux, imposta la tua chiave API, avvia una chat interattiva e seleziona un modello.
Configura la tua chiave API di APIMaster e il config.toml di Codex, poi esegui codex per chattare con DeepSeek. Usa deepseek-v4-flash, deepseek-v4-pro. Codex si connette tramite l'API Responses all'indirizzo https://apimaster.ai/v1.
Prima di iniziare
Completa la verifica dell'ambiente, installa Codex seguendo la guida generale e ottieni una chiave API di APIMaster con accesso a questi modelli e con credito sufficiente.
codex --version
1. Apri la directory di configurazione
Windows
Premi Win + R, inserisci il seguente percorso e premi Invio:
%USERPROFILE%\.codex
Crea la cartella se non esiste. Apri o crea config.toml con un editor di testo. Assicurati che il nome del file non sia config.toml.txt.
macOS / Linux
Su macOS, in Finder premi Command + Shift + G e inserisci:
~/.codex
Su Linux, apri la stessa directory con il tuo file manager o editor. Se necessario, creala dal terminale:
mkdir -p ~/.codex
Apri o crea config.toml in questa directory. Se usi una directory di stato personalizzata per Codex, usa quella directory.
2. Configura config.toml
Entrambe le piattaforme usano gli stessi contenuti:
model = "deepseek-v4-flash"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Se il file esiste già, creane una copia di backup e unisci queste impostazioni. Sostituisci le chiavi di primo livello esistenti invece di duplicarle, e collocale prima della prima intestazione [tabella]. Unisci la sezione del provider se esiste già. Questo modifica il provider e il modello predefiniti per le nuove sessioni di Codex.
L'URL base include /v1. Mantieni wire_api = "responses"; un endpoint Chat Completions da solo non è sufficiente per questo flusso di lavoro. Le impostazioni sui riepiloghi disattivano i riepiloghi di reasoning opzionali, non il pensiero interno del modello.
Per mantenere il tuo provider predefinito esistente, metti questa configurazione in ~/.codex/deepseek.config.toml invece (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Aggiungi quindi --profile deepseek ai comandi di avvio qui sotto. I file di profilo con nome richiedono Codex 0.134.0 o successivo ed ereditano le altre impostazioni di base.
3. Imposta la tua chiave API
Sostituisci YOUR_APIMASTER_API_KEY con la chiave ottenuta da APIMaster. La configurazione TOML memorizza il nome della variabile d'ambiente, non la chiave stessa.
Windows PowerShell
Esegui nel terminale da cui lancerai Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Per salvarla anche per i terminali futuri:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
Apri un nuovo terminale dopo aver salvato una variabile permanente, oppure continua a usare il terminale corrente in cui hai eseguito il primo comando.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Questo vale per il terminale corrente. Per riutilizzarla in nuovi terminali, aggiungi la stessa riga di export al file di avvio della tua shell, ad esempio ~/.zshrc per Zsh o ~/.bashrc per Bash interattivo, poi apri un nuovo terminale. Mantieni i file contenenti chiavi reali privati e fuori dai repository condivisi.
4. Avvia Codex e chatta
Apri un terminale nella directory del tuo progetto ed esegui:
codex
Dopo i normali prompt del primo avvio o di attendibilità del progetto, verifica che il modello attivo sia deepseek-v4-flash. Nella conversazione di Codex, inserisci:
Reply with exactly OK.
Una risposta normale conferma la connessione di base. Puoi quindi chiedergli di spiegare codice, leggere un file o apportare una modifica. Rivedi i consueti prompt di permesso per file e comandi.
5. Seleziona un altro modello
Per questi ID di modello personalizzati, scegli il modello esplicitamente all'avvio di Codex. Esegui un comando alla volta nel tuo terminale:
codex --model deepseek-v4-flash
codex --model deepseek-v4-pro
Ogni comando apre una conversazione interattiva. Per passare a un altro modello da una sessione aperta, inserisci /exit, poi esegui il comando per il modello desiderato. Per continuare una conversazione salvata esistente con un altro modello, usa codex resume SESSION_ID --model MODEL_ID invece di avviare una nuova conversazione.
In Codex, /model apre il catalogo dei modelli e /status mostra il modello attivo. Il menu non elenca automaticamente tutti i modelli del marketplace di APIMaster. Se il tuo modello DeepSeek non è presente, usa --model come sopra. Non dare per scontato che la sintassi /model MODEL_ID di Claude Code funzioni in Codex; non è il percorso verificato per la selezione di modelli personalizzati in questo caso.
Per il profilo con nome opzionale, ad esempio:
codex --profile deepseek --model deepseek-v4-flash
Per modificare il predefinito per gli avvii futuri, modifica il valore model di primo livello nella configurazione che usi.
Risoluzione dei problemi
| Sintomo | Verifica |
|---|---|
| Chiave API mancante / 401 | Imposta APIMASTER_API_KEY nel terminale che avvia Codex; controlla la validità della chiave e il credito. |
| Continua a usare un altro provider | Controlla model_provider, il profilo selezionato, le sovrascritture del progetto e i flag di avvio. Riavvia dopo aver modificato la configurazione. |
| Errore di parsing TOML | Evita chiavi o tabelle duplicate; le impostazioni di primo livello devono precedere le intestazioni di tabella. |
| 404 / protocollo non supportato | Usa https://apimaster.ai/v1 e wire_api = "responses". |
| Modello assente da /model | Usa l'ID completo del modello con codex --model. Il catalogo integrato non è l'elenco dei modelli del gateway. |
| Avviso su metadati o elenco modelli | Questi ID potrebbero non avere metadati Codex. Controlla la risposta finale; i limiti di contesto di fallback non sono capacità verificate del modello. |
| Avviso sul flusso di reasoning/output | Controlla la risposta finale e i risultati dei tool. Segnala l'output interrotto con il modello, la versione della CLI, l'ora UTC e l'ID della richiesta se disponibile. |
Validazione e verifica opzionale dei tool
Test di integrazione registrati: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. Tutti i modelli elencati qui hanno restituito il testo previsto e hanno usato un tool per leggere un file locale. Attività di coding complesse erano fuori dall'ambito di quel test. Le istruzioni di configurazione per Windows e macOS sono fornite, ma quei sistemi operativi non facevano parte delle esecuzioni registrate. Queste verifiche non stabiliscono la piena compatibilità delle funzionalità, il comportamento in sessioni lunghe o i limiti massimi di contesto.
Per verificare i tool per i file, crea probe.txt in un progetto temporaneo contenente:
FILE_PROBE_739182
Avvia Codex lì con il modello scelto, poi inserisci:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Conferma che viene eseguito un tool di lettura dei file e che la risposta corrisponde al contenuto del file. Usa questa verifica dopo che la conversazione di base funziona.
FAQ
Usa il mio abbonamento ChatGPT?
Le richieste usano la tua chiave e il tuo credito di APIMaster. Codex è il client; DeepSeek è il modello selezionato. Questa configurazione non rende DeepSeek un modello OpenAI.
Perché Claude Code usa un URL diverso?
Codex usa https://apimaster.ai/v1 per Responses. Claude Code usa la radice del sito https://apimaster.ai e aggiunge /v1/messages da sé.