Codex CLI Anleitung: erster Auftrag, Berechtigungen und Code prüfen

Codex CLI ist OpenAIs Werkzeug für die Arbeit am Code im Terminal. Es kann Dateien untersuchen, Änderungen vornehmen und Befehle ausführen, soweit die gewählten Berechtigungen das erlauben. Eine gute erste Aufgabe ist klein genug, dass du ihr Ergebnis selbst überprüfen kannst.

Codex CLI installieren und anmelden

Wähle auf der offiziellen CLI-Seite die Installationsanleitung für dein Betriebssystem. Prüfe danach die Installation und melde dich an:

codex --version
codex login

Der Login mit ChatGPT und der Login mit einem API-Schlüssel sind unterschiedliche Zugangswege. API-Nutzung wird über das API-Konto abgerechnet. Prüfe den aktiven Zugang mit codex login status; die Details stehen in der Anmeldedokumentation.

Erst verstehen, dann ändern

Starte im Projektverzeichnis:

cd my-project
git status --short
codex

Ein sinnvoller erster Auftrag lautet:

Erkläre, wie die Suchfunktion in diesem Projekt aufgebaut ist. Nenne die beteiligten Dateien und vorhandenen Tests. Ändere zunächst keine Dateien.

Öffne anschließend die genannten Dateien selbst. Stimmen Einstiegspunkt und Datenfluss? Falls nicht, bitte um eine Erklärung anhand konkreter Funktionen. So erkennst du Missverständnisse, bevor sie im Code landen.

Einen überprüfbaren Auftrag formulieren

Gib Problem, gewünschtes Verhalten und Prüfverfahren zusammen an:

Bei einer leeren Suchanfrage wird ein Serverfehler angezeigt. Zeige stattdessen den vorhandenen leeren Zustand. Nutze die bestehenden UI-Komponenten, ändere nur den Suchpfad und führe die zugehörigen Tests aus.

Für größere Arbeiten ergänze, welche Schnittstellen stabil bleiben müssen. Eine Liste mit sämtlichen Dateien ist nicht zwingend nötig; klare Grenzen und ein beobachtbares Ergebnis helfen mehr als allgemeine Qualitätswünsche.

Berechtigungen kontrollieren

Mit /permissions lassen sich die verfügbaren Berechtigungseinstellungen ansehen. /status zeigt die aktuelle Sitzung. Verlasse dich nicht auf eine pauschale Aussage wie „Codex darf standardmäßig nichts schreiben“: Die konkrete Umgebung entscheidet.

Sichere offene eigene Änderungen, bevor du einen größeren Auftrag startest. Eine separate Git-Branch oder ein Worktree macht die Prüfung übersichtlicher. Das ersetzt jedoch weder Tests noch eine fachliche Kontrolle.

Den fertigen Code prüfen

git diff --stat
git diff

Prüfe drei Dinge: Löst der Code das beschriebene Problem? Bleiben die Änderungen innerhalb des Auftrags? Wurde der tatsächliche Fehlerfall getestet?

Lass dir bei einem unklaren Testbericht die ausgeführte Kommandozeile und das Ergebnis nennen. Starte wichtige Projektprüfungen selbst erneut, wenn Ergebnisse fehlen oder nachträglich weitere Änderungen erfolgt sind. Ein grüner Test prüft nur seine eigenen Fälle.

Häufige Fragen

Ersetzt Codex CLI meine IDE?

Du kannst weiterhin im gewohnten Editor arbeiten. Das CLI ergänzt den Arbeitsablauf im Terminal.

Welches Modell muss ich auswählen?

Beginne mit dem Modell, das für deinen Zugang verfügbar ist, und einer begrenzten Aufgabe. Bewerte das Ergebnis an deinen Tests. Dieser Leitfaden behauptet keinen dauerhaften Sieger für alle Projekte.

Darf ich jede Bestätigung automatisch erlauben?

Prüfe zuerst, welche Aktionen der Auftrag erfordert. Eine kleine lokale Korrektur und das Veröffentlichen einer Anwendung haben unterschiedliche Folgen. Wähle die Rechte passend zur Aufgabe.