Zum Hauptinhalt springen
Diese Anleitung zeigt, wie du OpenAI Codex CLI mit Venice betreibst, indem du die offiziellen Codex-Konfigurationspfade verwendest: ~/.codex/config.toml (Benutzerebene) oder .codex/config.toml (Projektebene).

Einfaches Setup

Eine Konfigurationsdatei in deinem Projekt

OpenAI-kompatibel

Verwendet Venices OpenAI-kompatible API

Modell-Flexibilität

Tausche jedes unterstützte Venice-Textmodell ein

​
Voraussetzungen

  • Ein Venice API-Schlüssel von venice.ai/settings/api
  • Codex CLI installiert und einsatzbereit auf deinem Rechner

​
Einrichtung

1

Projekt-Konfigurationspfad anlegen

Vom Projekt-Root aus:
mkdir -p .codex
2

.codex/config.toml erstellen

Erstelle die Datei und füge die folgende Konfiguration ein:
#:schema https://developers.openai.com/codex/config-schema.json

model = "openai-gpt-54" # verwende ein beliebiges Venice-Modell
model_provider = "venice"
model_reasoning_effort = "high"
personality = "pragmatic"
sandbox_mode = "workspace-write"

[model_providers.venice]
name = "Venice"
base_url = "https://api.venice.ai/api/v1/"
experimental_bearer_token = "YOUR VENICE API KEY"
wire_api = "responses"
3

Beide Platzhalter ersetzen

Aktualisiere:
  • model mit der Venice-Modell-ID, die du nutzen möchtest
  • experimental_bearer_token mit deinem echten Venice API-Schlüssel
Verfügbare Modell-IDs findest du im Textmodell-Katalog.
4

Codex CLI ganz normal starten

Starte Codex CLI im selben Projekt. Es lädt .codex/config.toml (für vertrauenswürdige Projekte) und leitet Anfragen über Venice.

​
Offizielle Speicherorte der Codex-Konfiguration

  • Benutzer-Defaults: ~/.codex/config.toml
  • Projekt-Overrides: .codex/config.toml (wird nur für vertrauenswürdige Projekte geladen)
Wenn Venice-Einstellungen überall gelten sollen, lege dieselbe Konfiguration in ~/.codex/config.toml ab.

​
Konfigurations-Vorrang (Höchster zuerst)

  1. CLI-Flags und --config-Overrides
  2. Profilwerte (--profile <name>)
  3. Projektkonfigurations-Ebenen (.codex/config.toml, das nächstgelegene Verzeichnis gewinnt)
  4. Benutzerkonfiguration (~/.codex/config.toml)
  5. System-Konfiguration (/etc/codex/config.toml, Unix)
  6. Eingebaute Defaults

​
Hinweise

  • Halte deinen API-Schlüssel privat und committe niemals echte Schlüssel nach git.
  • Codex ignoriert die Projekt-.codex/-Konfiguration, wenn ein Projekt als nicht vertrauenswürdig markiert ist.
  • Wenn du Modelle wechselst, aktualisiere nur das Feld model.
  • Die Einstellung wire_api = "responses" ist für dieses Provider-Setup erforderlich.

​
Ressourcen

Venice API-Referenz

Vollständige Endpoint- und Parameter-Dokumentation

Venice Textmodelle

Verfügbare Modell-IDs