Skip to main content
Codex CLI ist ein Open-Source-lokaler Programmierungs-Agent, der von OpenAI bereitgestellt wird und in deinem Terminal läuft. Er kann Code lesen, Dateien ändern, Befehle ausführen, Fehler erklären und bei der Erledigung alltäglicher Entwicklungsaufgaben unterstützen. Codex CLI unterstützt benutzerdefinierte Modellanbieter. Du kannst es über einen OpenAI Responses-kompatiblen Proxy verwenden, der von Ace Data Cloud bereitgestellt wird, ohne ein separates OpenAI-Konto abonnieren zu müssen. Nach der Konfiguration sendet Codex CLI Anfragen an https://api.acedata.cloud/v1.

​
Antragsprozess

Um Codex CLI zu verwenden, kannst du zunächst im Ace Data Cloud Dashboard deinen API-Token erhalten und als Backup aufbewahren. Wenn du noch nicht eingeloggt oder registriert bist, wirst du automatisch zur Login-Seite weitergeleitet, um dich zu registrieren und anzumelden. Nach dem Login wirst du automatisch auf die aktuelle Seite zurückgeleitet. Beim ersten Antrag erhältst du ein kostenloses Kontingent, um den Codex CLI-Service kostenlos zu testen.

​
Installation von Codex CLI

Codex CLI unterstützt macOS, Linux, Windows und WSL. Du kannst es via npm installieren oder Homebrew (nur macOS) verwenden.

​
npm-Installation (empfohlen)

Wenn Node.js bereits installiert ist, kannst du es direkt via npm installieren. Diese Methode erfordert Node.js Version 18 oder höher.

​
Homebrew-Installation (macOS)

macOS-Nutzer können auch Homebrew verwenden:

​
Überprüfung der Installation

Nach der Installation öffne dein Terminal erneut und prüfe, ob der Befehl verfügbar ist:
Wenn die Meldung command not found erscheint, ist dein aktuelles Terminal wahrscheinlich noch nicht mit dem neuen PATH aktualisiert. Schließe das Terminal und öffne es erneut oder überprüfe die PATH-Konfiguration, die im Installationsprozess ausgegeben wurde.

​
Konfiguration von Codex CLI

Nach der Installation versucht Codex CLI standardmäßig, sich mit den offiziellen OpenAI-Servern zu verbinden. Um stattdessen Ace Data Cloud zu verwenden, musst du in der Konfigurationsdatei einen benutzerdefinierten model_provider angeben und den API-Token in die entsprechende Umgebungsvariable setzen.

​
Schritt 1: Umgebungsvariable setzen

Es wird empfohlen, den API-Token in deine Shell-Konfigurationsdatei einzufügen, z.B. ~/.zshrc, ~/.bashrc oder ~/.bash_profile:
Ersetze {token} durch den API-Token, den du im Ace Data Cloud Dashboard kopiert hast. Nach der Konfiguration öffne dein Terminal neu oder führe den folgenden Befehl aus, um die Änderungen sofort zu aktivieren:

​
Schritt 2: Konfigurationsdatei bearbeiten

Codex CLI verwendet ~/.codex/config.toml als globale Konfigurationsdatei. Falls diese noch nicht existiert, kannst du sie erstellen:
Füge den folgenden Inhalt in ~/.codex/config.toml ein:
Erläuterung der Felder:

​
Cache der OpenAI-Anmeldung löschen

Wenn du dich zuvor mit einem offiziellen OpenAI-Konto bei Codex CLI angemeldet hast, ist möglicherweise eine lokale Cache-Datei (~/.codex/auth.json) vorhanden. Vor dem Wechsel zu Ace Data Cloud solltest du diese alte Anmeldung löschen:
Falls der Befehl codex logout nicht verfügbar ist, kannst du die Cache-Datei auch manuell entfernen:
Wenn du dich noch nie mit einem OpenAI-Konto angemeldet hast, kannst du diesen Schritt überspringen.

​
Sitzung starten

Gehe in dein Projektverzeichnis und starte Codex CLI:
Sobald die Codex-Oberfläche erscheint, kannst du direkt deine Anforderungen eingeben, z.B.:

​
Konfiguration überprüfen

Nach dem Start kannst du im interaktiven Modus den aktuellen Modell- und Anbieterstatus prüfen:
Du solltest eine Ausgabe ähnlich wie folgt sehen:
Wenn ein anderer Anbieter angezeigt wird, ist die Konfiguration nicht wirksam. Überprüfe in diesem Fall nochmals die Datei ~/.codex/config.toml sowie die Umgebungsvariable ACEDATACLOUD_API_KEY:
Außerdem kannst du die Anfragehistorie und Abrechnungsdetails im Ace Data Cloud Dashboard - Nutzungshistorie einsehen und die verbleibenden Kontingente im Ace Data Cloud Dashboard - Anwendungen.

​
Funktionsweise

Codex CLI nutzt native das OpenAI Responses API-Protokoll. Ace Data Cloud bietet unter https://api.acedata.cloud/v1/responses einen Proxy, der mit dem OpenAI Responses API kompatibel ist. Damit ist kein lokaler Proxy oder zusätzliche Plugins erforderlich. Der Ablauf ist wie folgt:
  1. Codex CLI liest model_provider aus ~/.codex/config.toml und lädt den entsprechenden Abschnitt [model_providers.acedatacloud].
  2. Es liest den API-Token aus der in env_key angegebenen Umgebungsvariable (ACEDATACLOUD_API_KEY).
  3. Anfragen werden im responses-Protokoll an base_url + /responses gesendet, also https://api.acedata.cloud/v1/responses.
  4. Ace Data Cloud überprüft den API-Token, validiert das Kontingent und leitet die Anfrage an den verfügbaren Upstream-Modelkanal weiter.
  5. Nach Abschluss der Anfrage werden die Nutzung und Abzüge anhand des tatsächlichen Verbrauchs erfasst.
Das bedeutet, du nutzt weiterhin den ursprünglichen codex-Befehl und die native Interaktion, nur dass die zugrunde liegenden Modellservices auf Ace Data Cloud umgestellt sind.

​
Modelle konfigurieren

Der model-Eintrag in ~/.codex/config.toml bestimmt das Standardmodell. Der OpenAI Responses-Service von Ace Data Cloud unterstützt verschiedene Modelle, z.B.: Möchtest du das Modell temporär ändern, kannst du beim Starten von Codex die --model-Option verwenden:
Oder du änderst den model-Eintrag in ~/.codex/config.toml und startest neu. Eine vollständige Modellliste findest du in der Ace Data Cloud OpenAI-Dokumentation.

​
Vertrauensstufen für Projekte

Codex CLI ermöglicht es, für verschiedene Projekte unterschiedliche Vertrauensstufen zu setzen, um zu steuern, welche Aktionen der Agent ausführen darf. Füge dazu in ~/.codex/config.toml am Ende hinzu:
  • trusted: Der Agent hat volle Berechtigungen, kann Befehle ausführen und Dateien ändern.
  • untrusted: Der Agent ist eingeschränkt, geeignet für Projekte, bei denen du dem Agent nicht voll vertraust.

​
Weitere Informationen