For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Hauptnavigation

Codex CLI

Code im Terminal untersuchen, bearbeiten und ausführen

Untersuche Code, nimm Änderungen vor, führe Befehle aus und automatisiere wiederkehrende Aufgaben, ohne dein Terminal zu verlassen.

$ codex
╭──────────────────────────────────────────────────╮
│ >_ OpenAI Codex                                  │
│                                                  │
│ model:     gpt-5.6-sol medium/model to change │
│ directory: ~/code                                │
╰──────────────────────────────────────────────────╯

  To get started, describe a task or try one of these commands:

  /init - create an AGENTS.md file with instructions for Codex
  /status - show current session configuration
  /permissions - choose what Codex is allowed to do
  /model - choose what model and reasoning effort to use
  /review - review any changes and find issues
      

 Refactor the Dashboard component to React Hooks
      
  100% context left · ? for shortcuts
      
01

Mit deinem lokalen Repository arbeiten

Lass Codex Dateien untersuchen, Änderungen vornehmen und die bereits auf deinem Computer installierten Tools ausführen.

02

Behalte die Kontrolle

Wähle passend zur Aufgabe das Modell, den Reasoning-Aufwand, die Berechtigungen und die Befehle aus.

03

Codex in Skripte und CI einbinden

Nutze Codex interaktiv oder rufe codex exec in wiederholbaren Arbeitsabläufen und Pipelines auf.

Schnellstart

Erste Schritte mit Codex CLI

Installiere Codex, melde dich an und führe deine erste Aufgabe in einem Projektverzeichnis aus.

  1. Codex installieren

    Installiere die Codex CLI mit dem eigenständigen Installationsprogramm für macOS und Linux.

    Codex installieren

    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    Codex aktualisieren

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. Starte Codex und melde dich an

    Öffne ein Projektverzeichnis und starte codex. Wenn du Codex zum ersten Mal startest, wähle Mit ChatGPT anmelden oder eine andere verfügbare Anmeldemethode.

    Authentifizierungsoptionen prüfen
  3. Starte deine erste Aufgabe

    Beschreibe, was du erreichen möchtest. Bitte Codex zum Beispiel, das Projekt zu erklären, eine gezielte Änderung vorzunehmen oder beim Debuggen eines Problems zu helfen.

    Erkläre mir dieses Projekt

    Lege vor und nach einer Aufgabe Git-Checkpoints an, damit du Änderungen rückgängig machen kannst. Orientiere dich dabei an den bewährten Methoden.

Das kann Codex CLI

Nutze einen durchgängigen Arbeitszyklus im Terminal für interaktive Aufgaben, Automatisierung, Review und Delegation.

01

Bleib während des gesamten Entwicklungszyklus im Terminal

Starte Codex in einem Repository, um dich in unbekanntem Code zurechtzufinden, eine Änderung zu planen, Dateien zu bearbeiten und deine lokalen Entwicklungstools auszuführen. Steuere den laufenden Arbeitsschritt, prüfe Befehle und Diffs, sobald sie angezeigt werden, und erledige Folgeaufgaben in derselben Sitzung.

Mehr erfahren
02

Skills und Plug-ins verwenden

Fasse wiederverwendbare Anweisungen in Skills zusammen und füge dann Plug-ins hinzu, um Codex mit den Tools und Daten deines Teams zu verbinden, ohne die CLI zu verlassen.

Mehr erfahren
03

Änderungen vor der Auslieferung überprüfen

Prüfe gezielt noch nicht committete Änderungen, einen Commit oder einen Basis-Branch. Codex meldet priorisierte Hinweise, ohne dein Arbeitsverzeichnis zu verändern. So kannst du Risiken ausräumen, bevor du committest oder einen Pull Request öffnest.

Mehr erfahren

Hier erfährst du, mit welchen CLI-Funktionen du Sitzungen fortsetzen, visuellen Kontext und Kontext aus dem Web hinzufügen, komplexe Aufgaben aufteilen und Codex mit deinen Entwicklungstools verbinden kannst.

01 codex resume

Zu einem gespeicherten Chat zurückkehren

Öffne einen der letzten Chats aus dem aktuellen Repository erneut oder durchsuche deine lokalen Chats, wenn du frühere Arbeiten fortsetzen möchtest.

02 codex --image

Visuellen Kontext in den Prompt einbeziehen

Füge dem ersten Prompt einen Fehler-Screenshot, ein Architekturdiagramm oder eine Designreferenz hinzu. Alternativ kannst du ein Bild in den interaktiven Editor einfügen.

03 subagents

Eine größere Untersuchung aufteilen

Bitte Codex, klar abgegrenzte Aufgaben an spezialisierte Agenten zu delegieren und deren Erkenntnisse anschließend in die Hauptsitzung im Terminal zu übernehmen.

04 codex --search

Nach aktuellen Informationen suchen

Stelle einen Lauf auf Live-Websuche um, wenn eine Aufgabe aktuelle Versionen, Dokumentation oder Informationen zum Verhalten externer Systeme erfordert. Die Suchaktivitäten bleiben im Transkript sichtbar.

05 codex cloud

Aufgaben an Codex Cloud übergeben

Sieh dir aktive und abgeschlossene Chats an, übermittle Aufgaben an eine konfigurierte Umgebung und wende das Ergebnis vom Terminal aus auf dein lokales Repository an.

06 codex mcp

Externe Tools mit MCP verbinden

Füge lokale oder Remote-MCP-Server hinzu, authentifiziere dich bei Bedarf und prüfe die in der aktuellen Sitzung verfügbaren Tools, bevor Codex sie verwendet.

07 /permissions

Grenzen für jeden Lauf festlegen

Lege fest, wann Codex Dateien bearbeiten oder Befehle ausführen darf, ohne nachzufragen. Prüfe außerdem die aktive Sandbox und die beschreibbaren Root-Verzeichnisse, bevor du fortfährst.

08 codex completion

Codex an dein Terminal anpassen

Generiere Autovervollständigungen für deine Shell, wähle ein Syntax-Theme und öffne längere Prompts in dem über VISUAL oder EDITOR konfigurierten Editor.

Use Codex CLI when…

Du arbeitest im Terminal

Erkunde und bearbeite ein Repository und führe den enthaltenen Code in einem durchgängigen Arbeitszyklus aus.

Du brauchst Skripte oder CI

Führe einen nicht interaktiven Befehl in einem wiederholbaren Arbeitsablauf aus.

Du möchtest deinen Code lokal überprüfen

Prüfe Änderungen, bevor du committest oder einen Pull Request öffnest.

Du möchtest Aufgaben an die Cloud übergeben

Starte einen Cloud-Chat und kehre später zum Terminal zurück.