DeepSeek in Codex CLI verwenden: V4 Flash / Pro Einrichtungsanleitung

Konfigurieren Sie DeepSeek V4 Flash und Pro in der Codex CLI über den Responses-Endpunkt von APIMaster. Enthält API-Schlüssel-Einrichtung, Modellwechsel, Tool-Tests und Fehlerbehebung.

Kann die Codex CLI DeepSeek verwenden? Unsere Tests mit Codex CLI 0.153.4 haben deepseek-v4-flash und deepseek-v4-pro erfolgreich über den Responses-Endpunkt von APIMaster verwendet. Konfigurieren Sie einen benutzerdefinierten Anbieter mit der Basis-URL https://apimaster.ai/v1 und wire_api = "responses". Nur OpenAI-kompatible Chat Completions reichen für diese Konfiguration nicht aus.

Zuletzt getestet: 2026-09-07, Codex CLI 0.153.4, Linux. Beide Modelle lieferten den erwarteten Text, riefen ein Shell-Tool auf, um eine lokale Testdatei zu lesen, und antworteten mit deren Inhalt. Alle Läufe wurden mit Code 0 beendet. Es traten Warnungen zu Metadaten und Streaming-Ereignissen auf; siehe Fehlerbehebung. Windows-/macOS-Befehle werden für die Einrichtung bereitgestellt, aber dieser Test wurde unter Linux durchgeführt. Lange Sitzungen, Bildeingaben und komplexe Codierungs-Workflows wurden nicht getestet.

1. Codex und Ihren API-Schlüssel vorbereiten

Installieren Sie Codex gemäß der Umgebungsanleitung und der Codex-Einrichtungsanleitung, und überprüfen Sie dann:

codex --version

Erstellen Sie einen APIMaster-API-Schlüssel mit Zugriff auf das ausgewählte DeepSeek-Modell und ausreichendem Kontingent. Verwenden Sie für dieses Tutorial die unten stehende dedizierte Konfiguration; Sie müssen keine vorhandene auth.json ersetzen oder sich von einem anderen Konto abmelden.

2. Schlüssel im Terminal festlegen

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

Die Variable existiert nur in dieser Terminalsitzung. Die Konfiguration speichert den Namen der Variablen, nicht das Geheimnis selbst.

3. Separate Anbieterkonfiguration erstellen

Erstellen Sie in einem Verzeichnis, das Sie für dieses Tutorial verwenden, deepseek.toml mit diesem Inhalt. Lassen Sie Ihre vorhandene Codex-Konfiguration unverändert.

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"

Für einen kopierbaren, isolierten ersten Test übergeben Sie dieselben Einstellungen als Befehlszeilen-Overrides. --ignore-user-config verhindert, dass ein anderer Anbieter in Ihrer normalen Konfiguration Vorrang hat. --ephemeral vermeidet das Speichern dieser Testsitzung.

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"

Führen Sie den Befehl in dem Terminal aus, in dem Sie den Schlüssel festgelegt haben. Erwartete endgültige Antwort: DEEPSEEK_TEST_OK. In älteren Windows-PowerShell-Versionen kann die native Argumentquotierung abweichen; verwenden Sie PowerShell 7 oder die Profilmethode unten, wenn TOML-Argumente abgelehnt werden.

4. Konfiguration als wiederverwendbares Profil speichern

Für die getestete CLI-Version platzieren Sie deepseek.toml unter ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Wenn CODEX_HOME angepasst ist, verwenden Sie stattdessen dieses Verzeichnis. Dieses benannte Profil hält die DeepSeek-Einstellungen getrennt von Ihrer normalen config.toml.

macOS / Linux, aus dem Verzeichnis, das deepseek.toml enthält:

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

Sichern Sie zuerst eine Profildatei, wenn dieser Dateiname bereits existiert. Die Profilsyntax ist versionsabhängig: Diese Befehle zielen auf 0.153.4. Überprüfen Sie codex --help auf Ihrer installierten Version; ältere Versionen verwenden möglicherweise Profile innerhalb von config.toml.

Um Pro zu verwenden:

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

Ein Profil legt sich über Ihre normale Konfiguration, sodass vorhandene MCP-Server oder andere Einstellungen weiterhin gelten können. Der isolierte Befehl in Schritt 3 ist nützlich, um Konfigurationskonflikte zu diagnostizieren.

5. Einen Tool-Aufruf verifizieren

Erstellen Sie eine lokale Datei namens probe.txt mit folgendem Inhalt:

TOOL_PROBE_739182

Führen Sie aus demselben Verzeichnis aus:

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."

Erwartet: Ein Dateilesebefehl wird erfolgreich ausgeführt, gefolgt von TOOL_PROBE_739182. Wiederholen Sie mit --model deepseek-v4-pro. Dies prüft einen Tool-Request-/Tool-Result-Roundtrip, über eine einfache Textantwort hinaus. Lassen Sie normale Berechtigungsabfragen für die tatsächliche Projektarbeit aktiviert.

Fehlerbehebung

Symptom	Erklärung oder nächster Schritt
`Model metadata ... not found`	Die getestete CLI hatte keine eingebauten Metadaten für diese Modell-IDs und verwendete Fallback-Metadaten. Unsere Text- und Tool-Tests wurden abgeschlossen, aber Kontextlimits und andere Standardwerte sollten nicht als verifizierte Modellfähigkeiten behandelt werden.
Modelllisten-Parsing-Fehler	Die Modellliste des Gateways kann sich vom Metadatenkatalog von Codex unterscheiden. Geben Sie das Modell explizit an und prüfen Sie, ob die tatsächliche Anfrage abgeschlossen wird.
`OutputTextDelta without active item`	In unserem Streaming-Test gesehen. Die endgültige Antwort und der Tool-Roundtrip wurden trotzdem abgeschlossen. Wenn die Ausgabe fehlt oder unterbrochen wird, bewahren Sie die CLI-Version, den Zeitstempel und den Fehler für den Support auf.
401 oder Anfrage geht an einen anderen Anbieter	Überprüfen Sie `APIMASTER_API_KEY`, die Anbieterauswahl und geerbte Einstellungen. Wiederholen Sie den isolierten Befehl aus Schritt 3.
404 oder nicht unterstütztes Protokoll	Die Basis-URL endet auf `/v1`, nicht auf `/chat/completions`; setzen Sie `wire_api = "responses"`.
Unbekannte Befehlszeilenoption	Überprüfen Sie die installierte CLI-Version. Die dokumentierten Optionen wurden mit 0.153.4 getestet.

Häufig gestellte Fragen

Bedeutet das, dass jeder DeepSeek-Endpunkt in Codex funktioniert?

Nein. Diese Ergebnisse gelten für die Gateway-Konfiguration von APIMaster. Ein Anbieter muss das Protokoll und das Tool-Verhalten unterstützen, das Codex erwartet; die Akzeptanz von /chat/completions begründet keine Responses-Kompatibilität.

Benötige ich ein ChatGPT-Abonnement für diese Einrichtung?

Dieser benutzerdefinierte Anbieter verwendet Ihren APIMaster-API-Schlüssel und Ihr Kontokontingent. Es verwendet kein ChatGPT-Abonnementkontingent. Überprüfen Sie den Modell-Marktplatz für aktuelle API-Preise.

Kann ich aus diesen Tests volle Codex-Kompatibilität beanspruchen?

Der verifizierte Umfang ist kurze Textausgabe und ein lokaler Dateilesen-Tool-Roundtrip. Die obigen Warnungen bleiben relevant; Langzeitkontextverhalten, jedes Tool und jede zukünftige CLI-Version sind nicht abgedeckt.