Einführung in die Codex CLI

Dieses Tutorial führt die Codex CLI als AI Harness für begrenzte Arbeit in einem lokalen Repository ein. Es verbindet Repository-Anweisungen, Werkzeugberechtigungen, prüfbare Änderungen und Verifikation.

Quellen und Produktdetails geprüft am 25. August 2026

Verwende ein entbehrliches Übungsrepository ohne vertrauliche Dateien.Schließe vor dem Einstieg den Vorbereitungspfad ab.

Die Codex CLI verbindet ein Modell mit einem begrenzten lokalen Workspace, Werkzeugen und prüfbarer Evidenz.

Schritt 1

Bestimme Harness und Arbeitsoberfläche

Die Codex CLI ist ein terminalbasierter AI Harness für die Arbeit mit Projektdateien, Repository-Anweisungen, Werkzeugen und Ausführungsfeedback.

Bestimme den Workspace als Grenze des autorisierten Dateibereichs.
Identifiziere das aktive Modell und die bereitgestellten Werkzeuge.
Fordere Evidenz durch Diffs, Befehle und gemeldete Prüfungen an.
Behandle die menschliche Abnahme als eigenen Zustand nach der technischen Validierung.

Prüfung: Du kannst Modell, Codex, Workspace und die Evidenz für die Prüfung unterscheiden.

Offizielle Codex-CLI-Dokumentation · Codex bootcamp 101

Ein bekannter Repository-Zustand macht das erste Ergebnis beobachtbar und reversibel.

Schritt 2

Bereite ein begrenztes Repository vor

Verwende ein entbehrliches Repository ohne vertrauliche Dateien oder Zugangsdaten.
Führe git status --short außerhalb von Codex aus und halte den Ausgangszustand fest.
Bestimme die Repository-Anweisungen und die Befehle zur Prüfung der vorhandenen Artefakte.
Prüfe den aktuellen Account oder Workspace-Zugang für die gewählte Codex-Oberfläche.

Prüfung: Repository-Grenze, Git-Ausgangszustand und verfügbare Prüfungen sind vor dem Start bekannt.

Produktvoraussetzungen am 25. August 2026 anhand der offiziellen CLI-Dokumentation geprüft.

Der offizielle Installationsweg endet mit einer sichtbaren Version und einem lesenden Start.

Schritt 3

Installiere die Codex CLI über den gepflegten Weg

Folge dem aktuellen Installationsweg in der offiziellen Codex-CLI-Dokumentation.
Öffne ein neues Terminal, wenn die Installation den Suchpfad für ausführbare Dateien verändert.
Führe codex --version aus und dokumentiere die im Übungsweg verwendete Version.
Starte die CLI mit codex --sandbox read-only aus dem Übungsrepository.

Prüfung: Codex meldet seine Version und öffnet das vorgesehene Repository mit ausgewählter Read-only-Sandbox.

Installationsbefehl und CLI-Flags am 25. August 2026 geprüft. Offizielle CLI-Anleitung öffnen.

Die Arbeitsoberfläche soll Repository, Modellweg und aktuelle Aufgabengrenze sichtbar machen.

Schritt 4

Bestätige Workspace und aktiven Modellweg

Prüfe Repository und Branch, bevor du die Aufgabe übergibst.
Identifiziere das aktive Modell oder den Provider in der CLI.
Nenne die Dateien für die Untersuchung und die erwartete Rückgabe-Evidenz.
Ordne codex --oss --local-provider ollama und codex --oss --local-provider lmstudio als optionale lokale Provider-Wege ein. Diese Einführung verwendet den Standardweg.

Prüfung: Repository, Branch, Modellweg und Aufgabengrenze lassen sich aus dem sichtbaren Sitzungszustand benennen.

--oss und --local-provider am 25. August 2026 in der offiziellen Codex-CLI-Referenz geprüft.

Codex kombiniert eine globale Anweisungsdatei mit Projektanweisungen von der Repository-Wurzel bis zum Arbeitsordner.

Schritt 5

Lies die vollständige Anweisungshierarchie

Codex lädt zuerst eine globale Datei aus CODEX_HOME: AGENTS.override.md hat Vorrang vor AGENTS.md. Anschließend prüft Codex jeden Ordner von der Projektwurzel bis zum Arbeitsordner und bevorzugt erneut AGENTS.override.md. Die Anweisungen werden von der Wurzel abwärts kombiniert, sodass tiefere Regeln später gelten.

Bestimme die globale AGENTS.override.md oder AGENTS.md in CODEX_HOME.
Bestimme die geltende Anweisungsdatei in jedem Ordner von der Projektwurzel bis zum aktuellen Ordner.
Lies die wirksame Kette in Reihenfolge und ordne jeder Regel ihren Scope zu.
Verwende /init, wenn das Repository eine geprüfte erste Anweisungsdatei benötigt.

Prüfung: Du kannst die geltenden globalen und projektbezogenen Anweisungsdateien sowie ihren Vorrang benennen.

Offizielle Anleitung zu AGENTS.md, geprüft am 25. August 2026.

Sandbox, Approval Policy und Aufgaben-Scope sind getrennte Kontrollen, die zusammenpassen müssen.

Schritt 6

Prüfe Werkzeuge und Berechtigungsgrenzen vor einer Handlung

Die Sandbox setzt die technische Grenze für Befehle. Die Approval Policy bestimmt, wann Codex vor dem Überschreiten dieser Grenze anhalten und eine Autorisierung anfordern muss.

Öffne /permissions und prüfe aktive Sandbox und Approval Policy.
Halte die erste Übung in der Read-only-Sandbox und erlaube ausschließlich Dateiinspektion.
Prüfe jede angeforderte Berechtigungs- oder Sandbox-Ausweitung anhand von Aufgabe und Repository-Grenze.
Fordere von Codex die Meldung ausgeführter Befehle, beobachteter Ausgaben und verbleibender Unsicherheit.

Prüfung: Die angezeigten Berechtigungen erlauben Inspektion und schließen Workspace-Änderungen während der ersten Übung aus.

Sandboxing und Agent Approvals am 25. August 2026 in der offiziellen OpenAI-Dokumentation geprüft.

Codex besitzt getrennte Mechanismen für Verfahren, Verbindungen, Delegation und Datei-Isolation.

Schritt 7

Bestimme Erweiterungen und Mechanismen für parallele Arbeit

Skills und MCP

Skills stellen gepflegte Aufgabenverfahren bereit. Verbindungen über das Model Context Protocol liefern externe Ressourcen und Werkzeuge mit einem prüfbaren Scope.

Subagents und Worktrees

Subagents liefern Evidenz aus begrenzten Kontexten. Worktrees isolieren gleichzeitige Dateiänderungen vor der Integration.

Prüfung: Jeder aktive Mechanismus besitzt eine definierte Funktion, Quelle, Reichweite und Prüfroute.

Skills · MCP · Subagents · Worktrees

Die erste Aufgabe endet mit Evidenz aus Codex und einer unabhängigen Git-Prüfung.

Schritt 8

Führe eine reversible Repository-Orientierung aus

Bitte Codex um die Untersuchung des Repositorys, die geltenden Anweisungen und eine Erklärung der gepflegten Prüfungen. Die Aufgabe bleibt in der Read-only-Sandbox.

Fordere eine kompakte Repository-Zusammenfassung mit direkten Dateiverweisen an.
Lass Codex die geltenden globalen und projektbezogenen Anweisungsdateien sowie vorhandene Prüfbefehle benennen.
Untersuche die zitierten Dateien und vergleiche die Antwort mit dem Repository-Zustand.
Beende die Sitzung und führe git status --short außerhalb von Codex aus.

Prüfung: Repository-Evidenz stützt die Zusammenfassung und der abschließende Git-Zustand entspricht der dokumentierten Ausgangslage.

Der Arbeitsloop folgt den quellengeprüften Lernzielen von Codex bootcamp 101.