Skip to main content

Kurzantwort

Codex CLI ist der lokale Coding-Agent von OpenAI für die Kommandozeile. Er läuft in deinem Terminal, liest den ausgewählten Workspace, bearbeitet Dateien, führt Befehle aus und befolgt bei Entwicklungsaufgaben deine Sandbox- und Freigabeeinstellungen. Es ist nützlich, wenn du möchtest, dass ein Agent bei Codeänderungen, Code-Review, Testkorrekturen, Skripten und mehrstufiger Engineering-Arbeit in einem lokalen Repository hilft. Codex CLI unterscheidet sich von einer normalen ChatGPT-Unterhaltung. Es schlägt nicht nur Code vor. Es arbeitet mit aktuellem Verzeichnis, Projektanweisungen, Tool-Ergebnissen und lokalen Ausführungsberechtigungen.

Wann das wichtig ist

  • Du installierst @openai/codex zum ersten Mal
  • Du vergleichst Codex CLI, Codex App und Codex Web
  • Du möchtest, dass ein Agent Dateien in einem lokalen Projekt bearbeitet
  • Du musst einen eigenen API-Provider, eine Base URL oder ein Modell konfigurieren
  • Du möchtest Sandbox, Freigabe und AGENTS.md verstehen

Grundlegende Konzepte

Empfohlener Workflow

  1. Starte Codex CLI im Projektverzeichnis, das du ändern möchtest.
  2. Bitte es, relevante Dateien oder Anweisungen zu prüfen, bevor es umfassende Änderungen vornimmt.
  3. Bitte bei komplexer Arbeit um einen Plan, bevor du Dateien ändern lässt.
  4. Wähle Sandbox- und Freigabeeinstellungen anhand des Risikos der Aufgabe.
  5. Lege dauerhafte Projektregeln in AGENTS.md und einmalige Anforderungen in der aktuellen Unterhaltung ab.
Wenn du einen Drittanbieter-API-Provider verwendest, konzentriere dich auf model_provider, base_url, wire_api und Modellfelder in config.toml. Codex und andere OpenAI-kompatible Tools verwenden normalerweise einen OpenAI-kompatiblen Endpunkt, der in dieser Dokumentation https://www.bettertoken.ai/v1 lautet.

Häufige Fehler

  • Codex CLI als reinen Chat-Assistenten behandeln.
  • Annehmen, dass Codex CLI, Codex App und Codex Web in derselben Umgebung laufen.
  • Nur model ändern, ohne den passenden Provider und die passende Base URL zu konfigurieren.
  • Sandbox- und Freigabeeinstellungen ohne Tests, Review oder Befehlsgrenzen lockern.
  • OpenAI-kompatible und Anthropic-kompatible Base URLs vermischen.

Über BetterToken

Wenn du einen eigenen OpenAI-kompatiblen Provider verwendest, kann BetterToken als Modell-API-Schicht für Codex CLI dienen. Es verarbeitet API Key, Base URL, Modellrouting, Guthaben und Nutzungsaufzeichnungen. BetterToken ersetzt weder die lokale Sandbox und Freigaben von Codex CLI noch AGENTS.md oder die Richtlinie zur Befehlsausführung.

Verwandte Dokumentation

Referenzen