> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Was ist Codex CLI?

> Verstehe, was Codex CLI ist, wie es funktioniert, wann du es verwendest und wie es sich von Codex App und Codex Web unterscheidet.

## 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

| Konzept       | Bedeutung                                                                                             |
| ------------- | ----------------------------------------------------------------------------------------------------- |
| Codex CLI     | Der Codex-Coding-Agent, der in deinem lokalen Terminal läuft                                          |
| Workspace     | Das Verzeichnis, das Codex lesen, durchsuchen und bearbeiten kann                                     |
| `config.toml` | Die lokale Codex-Konfigurationsdatei für Modelle, Provider, Sandbox, Freigaben und anderes Verhalten  |
| `AGENTS.md`   | Eine Projekt-Anweisungsdatei, die Codex Repository-Regeln und Präferenzen für Zusammenarbeit mitteilt |
| Sandbox       | Die lokale Sicherheitsgrenze für Dateisystem-, Netzwerk- und Befehlszugriff                           |
| Freigabe      | Die Richtlinie, die entscheidet, welche Aktionen eine Bestätigung benötigen                           |

## 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

* [Codex mit BetterToken einrichten](/de/ai-tools/codex)
* [Codex CLI, Codex App und Codex Web im Vergleich](/de/faq/codex/codex-cli-vs-app-vs-web)
* [Codex CLI config.toml konfigurieren](/de/faq/codex/config-toml)
* [OpenAI-kompatible API und Anthropic-kompatible API: Unterschiede](/de/faq/concepts/openai-compatible-vs-anthropic-compatible)

## Referenzen

* [Codex-CLI-Dokumentation](https://developers.openai.com/codex/cli)
* [OpenAI-Codex-GitHub-Repository](https://github.com/openai/codex)
* [Codex-Konfigurationsreferenz](https://developers.openai.com/codex/config-reference)