Erste Schritte mit Codex: Best Practices für bessere Ergebnisse

Wenn Sie neu bei @OpenAI Codex oder Coding-Agenten im Allgemeinen sind, hilft Ihnen dieser Leitfaden, schneller bessere Ergebnisse zu erzielen. Er behandelt die grundlegenden Gewohnheiten, die Codex in der CLI, IDE-Erweiterungen und der Codex-App effektiver machen – von Prompting und Planung bis hin zu Validierung, MCP, Skills und Automatisierungen.

Codex funktioniert am besten, wenn Sie es weniger wie einen einmaligen Assistenten und mehr wie ein Teammitglied behandeln, das Sie im Laufe der Zeit konfigurieren und verbessern.

Ein nützliches mentales Modell ist: Beginnen Sie mit dem richtigen Aufgabenkontext, verwenden Sie AGENTS.md für dauerhafte Anleitungen, konfigurieren Sie Codex passend zu Ihrem Workflow, verbinden Sie externe Systeme mit MCP, verwandeln Sie wiederkehrende Arbeiten in Skills und automatisieren Sie stabile Workflows.

1. Richten Sie Codex für eine starke erste Nutzung mit klarem Kontext und Prompting ein

Codex ist bereits stark genug, um auch bei unvollkommenen Prompts nützlich zu sein. Oft können Sie ihm ein schwieriges Problem mit minimaler Einrichtung geben und trotzdem ein starkes Ergebnis erzielen. Klares Prompting ist nicht erforderlich, um einen Nutzen zu erzielen, aber es macht die Ergebnisse zuverlässiger, insbesondere in größeren Codebasen oder bei Aufgaben mit höherem Risiko.

Wenn Sie in einem großen oder komplexen Repository arbeiten, besteht der größte Hebel in der Regel darin, Codex den richtigen Aufgabenkontext und eine klare Struktur für das zu geben, was Sie erreichen möchten.

Ein guter Standard ist, vier Dinge in Ihren Prompt aufzunehmen:

• Ziel: Was möchten Sie ändern oder erstellen?
• Kontext: Welche Dateien, Ordner, Dokumentationen, Beispiele oder Fehler sind für diese Aufgabe relevant? Sie können bestimmte Dateien als Kontext mit @ erwähnen.
• Einschränkungen: Welche Standards, Architektur, Sicherheitsanforderungen oder Konventionen sollte Codex befolgen?
• Erledigt, wenn: Was sollte wahr sein, bevor die Aufgabe abgeschlossen ist, z. B. bestandene Tests, geändertes Verhalten oder ein behobener Fehler?

Dies hilft Codex, im Rahmen zu bleiben, weniger Annahmen zu treffen und Arbeiten zu produzieren, die leichter zu überprüfen und zu validieren sind.

Wählen Sie ein Reasoning-Level basierend auf dem Schwierigkeitsgrad der Aufgabe und testen Sie, was für Ihren Workflow am besten funktioniert. Unterschiedliche Benutzer und Aufgaben profitieren von unterschiedlichen Einstellungen.

• Niedrig für schnellere, klar abgegrenzte Aufgaben
• Mittel oder Hoch für komplexere Änderungen oder Debugging
• Sehr Hoch für lange, agentische, reasoning-intensive Aufgaben

Tipp für neue Benutzer

: Die meisten Benutzer kommen am schnellsten zurecht, indem sie mit ein paar einfachen Erfolgen beginnen, wie Codex Fragen zur Codebasis zu stellen oder es für eine kleine, abgegrenzte Korrektur zu verwenden. Sehr empfehlenswert ist die Verwendung der Spracheingabe in der Codex-App, um Iterationen zu beschleunigen.

Codex Reasoning-Efforts

2. Reduzieren Sie Fehler bei schwierigen Aufgaben, indem Codex zuerst plant

Wenn die Aufgabe komplex, mehrdeutig oder schwer klar zu beschreiben ist, bitten Sie Codex, zu planen, bevor es mit dem Programmieren beginnt.

Es gibt einige gute Möglichkeiten, dies zu tun:

Plan-Modus verwenden: Für die meisten Benutzer ist dies die einfachste und effektivste Option. Der Plan-Modus ermöglicht Codex, Kontext zu sammeln, klärende Fragen zu stellen und einen stärkeren Plan vor der Implementierung zu erstellen. Umschalten mit /plan oder Umschalt+Tab.

Codex bitten, Sie zu interviewen: Wenn Sie eine grobe Vorstellung davon haben, was Sie wollen, aber nicht sicher sind, wie Sie es gut beschreiben sollen, bitten Sie Codex, Sie zuerst zu befragen. Sagen Sie ihm, es soll Ihre Annahmen hinterfragen und die vage Idee in etwas Konkretes verwandeln, bevor es Code schreibt.

Eine PLANS.md-Vorlage verwenden: Für fortgeschrittenere Workflows können Sie Codex so konfigurieren, dass es eine PLANS.md- oder Ausführungsplanvorlage für länger laufende oder mehrschrittige Arbeiten befolgt. Weitere Details finden Sie in unserem Leitfaden zu Ausführungsplänen.

Plan-Modus

3. Machen Sie erfolgreiche Anleitungen mit AGENTS.md wiederverwendbar

Sobald ein Prompting-Muster funktioniert, besteht der nächste Schritt darin, es nicht mehr manuell zu wiederholen. Hier kommt AGENTS.md ins Spiel.

Betrachten Sie AGENTS.md als eine README-Datei für Agenten. Es ist ein einfaches, offenes Format, das automatisch in den Kontext geladen wird und der beste Ort, um zu codieren, wie Sie und Ihr Team möchten, dass Codex in einem Repository arbeitet.

Eine gute AGENTS.md deckt in der Regel ab:

• Repo-Layout und wichtige Verzeichnisse
• Wie das Projekt ausgeführt wird
• Build-, Test- und Lint-Befehle
• Engineering-Konventionen und PR-Erwartungen
• Einschränkungen und Do-Not-Regeln
• Was "erledigt" bedeutet und wie die Arbeit überprüft wird

Der Slash-Befehl /init in der CLI ist der Schnellstartbefehl, um eine erste AGENTS.md im aktuellen Verzeichnis zu erstellen. Es ist ein großartiger Ausgangspunkt, aber Sie sollten das Ergebnis bearbeiten, um es an die tatsächliche Arbeitsweise Ihres Teams beim Erstellen, Testen, Überprüfen und Ausliefern von Code anzupassen.

Sie können AGENTS.md-Dateien auf mehreren Ebenen erstellen: eine globale AGENTS.md für persönliche Standardeinstellungen in ~/.codex, eine Datei auf Repo-Ebene für gemeinsame Standards und spezifischere Dateien in Unterverzeichnissen für lokale Regeln. Wenn es eine spezifischere Datei näher an Ihrem aktuellen Verzeichnis gibt, hat diese Anleitung Vorrang.

Halten Sie es praktisch. Eine kurze, genaue AGENTS.md ist nützlicher als eine lange Datei voller vager Regeln. Beginnen Sie mit den Grundlagen und fügen Sie neue Regeln nur hinzu, wenn Sie wiederholte Fehler bemerken.

Wenn AGENTS.md zu groß wird, halten Sie die Hauptdatei präzise und verweisen Sie für Dinge wie Planung, Code-Review oder Architektur auf aufgabenspezifische Markdown-Dateien.

Tipp

: Wenn Codex denselben Fehler zweimal macht, bitten Sie es um eine Retrospektive und aktualisieren Sie AGENTS.md. Die Anleitung bleibt praktisch und basiert auf echten Reibungspunkten.

AGENTS.md-Website

4. Erzielen Sie konsistenteres Verhalten, indem Sie Codex an Ihren Workflow anpassen

Die Konfiguration ist eine der wichtigsten Möglichkeiten, um Codex über Sitzungen und Oberflächen hinweg konsistenter zu verhalten. Sie können beispielsweise Standardwerte für Modellwahl, Reasoning-Aufwand, Sandbox-Modus, Genehmigungsrichtlinie, Profile und MCP-Einrichtung festlegen.

Ein guter Startansatz ist:

• Persönliche Standardeinstellungen in ~/.codex/config.toml speichern (Einstellungen → Konfiguration → config.toml öffnen in der Codex-App)
• Repo-spezifisches Verhalten in .codex/config.toml speichern
• Befehlszeilen-Überschreibungen nur für einmalige Situationen verwenden (wenn Sie die CLI verwenden)

Config.toml ist der Ort, an dem Sie dauerhafte Präferenzen wie MCP-Server, Profile, Multi-Agenten-Setup und experimentelle Funktionen definieren. Sie können es direkt bearbeiten oder Codex bitten, es für Sie zu aktualisieren.

Codex verfügt über eine Betriebssystem-Sandboxing-Funktion und hat zwei Hauptstelligrößen, die Sie steuern können. Der Genehmigungsmodus bestimmt, wann Codex um Ihre Erlaubnis zum Ausführen eines Befehls bittet, und der Sandbox-Modus bestimmt, ob Codex im Verzeichnis lesen oder schreiben kann und auf welche Dateien der Agent zugreifen kann.

Wenn Sie völlig neu bei Coding-Agenten sind, wird empfohlen, konservativ mit Standardberechtigungen zu beginnen. Halten Sie Genehmigung und Sandboxing standardmäßig eng und lockern Sie die Berechtigungen nur für vertrauenswürdige Repos oder bestimmte Workflows, wenn der Bedarf klar ist.

Beachten Sie, dass die CLI, die IDE und die Codex-App dieselben Konfigurationsebenen teilen. Erfahren Sie mehr auf unserer Beispielkonfigurations-Dokumentationsseite.

Tipp

: Konfigurieren Sie Codex frühzeitig für Ihre tatsächliche Umgebung. Viele Qualitätsprobleme sind eigentlich Einrichtungsprobleme, wie das falsche Arbeitsverzeichnis, fehlender Schreibzugriff, falsche Modellvorgaben oder fehlende Tools und Verbindungen.

5. Verbessern Sie die Zuverlässigkeit, indem Codex die Arbeit testet, validiert und überprüft

Hören Sie nicht damit auf, Codex zu bitten, eine Änderung vorzunehmen. Bitten Sie es, bei Bedarf Tests zu erstellen, die relevanten Prüfungen durchzuführen, das Ergebnis zu validieren und die Arbeit zu überprüfen, bevor Sie sie akzeptieren.

Codex kann diese Schleife für Sie durchführen, aber nur, wenn es weiß, wie "gut" aussieht. Diese Anleitung kann entweder aus dem Prompt oder AGENTS.md stammen.

Das kann beinhalten:

• Schreiben oder Aktualisieren von Tests für die Änderung
• Ausführen der entsprechenden Testsuiten
• Überprüfen von Lint-, Formatierungs- oder Typprüfungen
• Bestätigen, dass das endgültige Verhalten der Anfrage entspricht
• Überprüfen des Diffs auf Fehler, Regressionen oder riskante Muster

Tipp:

Schalten Sie das Diff-Panel in der Codex-App um, um Änderungen direkt

lokal zu überprüfen . Klicken Sie auf eine bestimmte Zeile, um Feedback zu geben, das als Kontext für den nächsten Codex-Durchgang verwendet wird.

Eine nützliche Option hier ist der Slash-Befehl /review, der Ihnen mehrere verschiedene Möglichkeiten zur Code-Überprüfung bietet:

• Überprüfung gegen einen Basis-Branch für PR-ähnliche Überprüfungen
• Überprüfung von nicht committeten Änderungen
• Überprüfung eines Commits
• Verwendung benutzerdefinierter Überprüfungsanweisungen

Wenn Sie und Ihr Team eine code_review.md-Datei haben, auf die in AGENTS.md verwiesen wird, kann Codex diese Anleitung auch während der Überprüfung befolgen. Dies ist ein starkes Muster für Teams, die ein konsistentes Überprüfungsverhalten über Repositories und Mitwirkende hinweg wünschen.

Codex sollte nicht nur Code generieren. Mit den richtigen Anweisungen kann es auch helfen, ihn zu testen, zu validieren und zu überprüfen.

Wenn Sie GitHub Cloud verwenden, können Sie Codex einfach einrichten, um Code-Reviews für Ihre PRs durchzuführen. Wir lassen bei OpenAI 100 % der PRs von Codex überprüfen. Sie haben die Möglichkeit, automatische Überprüfungen zu aktivieren oder Codex reaktiv überprüfen zu lassen, wenn Sie @Codex erwähnen.

/review in der Codex CLI

6. Bringen Sie externe Tools und Live-Kontext mit MCPs in Codex

Verwenden Sie MCPs, wenn der Kontext, den Codex benötigt, außerhalb des Repos liegt. Es ermöglicht Codex, eine Verbindung zu den Tools und Systemen herzustellen, die Sie bereits verwenden, sodass Sie nicht ständig Live-Informationen in Prompts kopieren und einfügen müssen.

Model Context Protocol, oder MCP, ist ein offener Standard zum Verbinden von Codex mit externen Tools und Systemen.

Verwenden Sie MCP, wenn:

• Der benötigte Kontext außerhalb des Repos liegt
• Die Daten sich häufig ändern
• Sie möchten, dass Codex ein Tool verwendet, anstatt sich auf eingefügte Anweisungen zu verlassen
• Sie eine wiederholbare Integration über Benutzer oder Projekte hinweg benötigen

Codex unterstützt sowohl STDIO- als auch Streamable-HTTP-Server mit OAuth.

Gehen Sie in der Codex-App zu Einstellungen → MCP-Server, um benutzerdefinierte und empfohlene Server zu sehen. Oft kann Codex Ihnen helfen, die benötigten Server zu installieren. Sie müssen es nur bitten. Sie können auch den Befehl codex mcp add in der CLI verwenden, um Ihre benutzerdefinierten Server mit einem Namen, einer URL und allen zusätzlichen Informationen hinzuzufügen.

Tipp

: Fügen Sie Tools nur hinzu, wenn sie einen echten Workflow ermöglichen. Beginnen Sie nicht damit, jedes Tool, das Sie verwenden, zu integrieren. Starten Sie mit ein oder zwei Tools, die klar eine manuelle Schleife entfernen, die Sie bereits oft durchführen, und erweitern Sie dann von dort aus.

MCP Serververwaltung

7. Verwandeln Sie wiederkehrende Workflows in wiederverwendbare Skills

Sobald ein Workflow wiederholbar wird, hören Sie auf, sich auf lange Prompts oder wiederholtes Hin und Her zu verlassen. Verwenden Sie einen Skill, um die Anweisungen in einer SKILL.md-Datei, Kontext und unterstützende Logik zu verpacken, die Codex konsistent anwenden soll. Skills funktionieren in der CLI, der IDE-Erweiterung und der Codex-App.

Halten Sie jeden Skill eng auf eine Aufgabe ausgerichtet. Beginnen Sie mit 2 bis 3 konkreten Anwendungsfällen, definieren Sie klare Eingaben und Ausgaben und schreiben Sie die Beschreibung so, dass sie klar sagt, was der Skill tut und wann er verwendet wird. Fügen Sie die Arten von Auslösephrasen hinzu, die ein Benutzer tatsächlich sagen würde.

Versuchen Sie nicht, von Anfang an jeden Randfall abzudecken. Beginnen Sie mit einer repräsentativen Aufgabe, bringen Sie sie zum Laufen, verwandeln Sie diesen Workflow dann in einen Skill und verbessern Sie ihn von dort aus. Fügen Sie Skripte oder zusätzliche Ressourcen nur hinzu, wenn sie die Zuverlässigkeit sinnvoll verbessern.

Eine gute Faustregel: Wenn Sie denselben Prompt immer wieder verwenden oder denselben Workflow korrigieren, sollte dies wahrscheinlich ein Skill werden.

Skills sind besonders nützlich für wiederkehrende Aufgaben wie:

• Log-Triage
• Entwurf von Release Notes
• PR-Review anhand einer Checkliste
• Migrationsplanung
• Telemetrie- oder Incident-Zusammenfassungen
• Standard-Debugging-Abläufe

Der $skill-creator-Skill ist der beste Ort, um zu beginnen, um die erste Version eines Skills zu erstellen, und verwenden Sie den $skill-installer-Skill, um ihn lokal zu installieren. Einer der wichtigsten Teile eines Skills ist die Beschreibung. Sie sollte klar sagen, was der Skill tut und wann er verwendet wird.

Tipp

: Persönliche Skills werden in

$HOME /.agents/skills gespeichert, und gemeinsame Team-Skills können in .agents/skills innerhalb eines Repositorys eingecheckt werden. Dies ist besonders hilfreich für die Einarbeitung neuer Teammitglieder.

S kill-Erstellung und -Installation

Codex App Skills-Oberfläche

8. Sparen Sie Zeit bei wiederkehrenden Arbeiten mit Automatisierungen

Sobald ein Workflow stabil ist, können Sie Codex planen, um ihn im Hintergrund für Sie auszuführen. In der Codex-App ermöglichen Ihnen Automatisierungen, das Projekt, den Prompt, den Rhythmus und die Ausführungsumgebung für eine wiederkehrende Aufgabe auszuwählen.

Sobald eine Aufgabe für Sie repetitiv wird, können Sie im Tab "Automatisierungen" in der Codex-App einfach eine Automatisierung erstellen. Sie können auswählen, in welchem Projekt sie ausgeführt wird, welchen Prompt sie verwendet (Sie können Skills aufrufen) und in welchem Rhythmus sie läuft. Sie können auch wählen, ob die Automatisierung in einem dedizierten Git-Worktree oder in Ihrer lokalen Umgebung ausgeführt wird. Erfahren Sie mehr über Git Worktrees.

Gute Kandidaten sind:

• Zusammenfassen aktueller Commits
• Scannen nach wahrscheinlichen Fehlern
• Entwerfen von Release Notes
• Überprüfen von CI-Fehlschlägen
• Erstellen von Standup-Zusammenfassungen
• Ausführen wiederholbarer Analyse-Workflows nach einem Zeitplan

Eine nützliche Regel ist, dass Skills die Methode definieren, Automatisierungen den Zeitplan. Wenn ein Workflow noch viel Steuerung benötigt, machen Sie ihn zuerst zu einem Skill. Sobald er vorhersagbar ist, wird Automatisierung zu einem Kraftvervielfacher.

Tipp

: Verwenden Sie Automatisierungen für Reflexion und Wartung, nicht nur für die Ausführung. Überprüfen Sie aktuelle Sitzungen, fassen Sie wiederholte Reibungspunkte zusammen und verbessern Sie Prompts, Anweisungen oder Workflow-Setups im Laufe der Zeit.

Erstellung von Automatisierungen in der Codex-App

9. Bleiben Sie bei länger laufenden Arbeiten mit Sitzungssteuerung organisiert

Codex-Sitzungen sind nicht nur der Chat-Verlauf. Sie sind Arbeits-Threads, die im Laufe der Zeit Kontext, Entscheidungen und Aktionen ansammeln, daher hat eine gute Verwaltung einen großen Einfluss auf die Qualität.

Die Verwaltung mehrerer Threads ist in der Codex-App-Oberfläche mit der Möglichkeit, Threads anzuheften und Worktrees zu erstellen, am einfachsten. Wenn Sie jedoch die CLI verwenden, sind diese Slash-Befehle besonders nützlich:

• /experimental, um experimentelle Funktionen umzuschalten und zu Ihrer config.toml hinzuzufügen
• /resume, um ein gespeichertes Gespräch fortzusetzen
• /fork, um einen neuen Thread zu erstellen, während das ursprüngliche Transkript erhalten bleibt
• /compact, wenn der Thread lang wird und Sie eine zusammengefasste Version des früheren Kontexts möchten. Beachten Sie, dass Codex Gespräche automatisch für Sie komprimiert
• /agent, wenn Sie mehrere Agenten ausführen und zwischen dem aktiven Agenten-Thread wechseln möchten
• /theme, um ein Syntax-Highlighting-Thema auszuwählen
• /apps, um ChatGPT-Apps direkt in Codex zu verwenden
• /status, um den aktuellen Sitzungszustand zu überprüfen

Halten Sie einen Thread pro zusammenhängender Arbeitseinheit. Wenn die Arbeit noch Teil desselben Problems ist, ist es oft besser, im selben Thread zu bleiben, da dies die Argumentationskette bewahrt. Forken Sie nur, wenn die Arbeit wirklich abzweigt.

Tipp:

Verwenden Sie die

Multi-Agenten -Workflows von Codex, um abgegrenzte Arbeiten aus dem Hauptthread auszulagern. Halten Sie den Hauptagenten auf das Kernproblem fokussiert und verwenden Sie Unteragenten für Aufgaben wie Exploration, Tests oder Triage.

10. Häufige Fehler, die Sie vermeiden sollten

Einige häufige Fehler, die Sie bei der ersten Verwendung von Codex vermeiden sollten:

• Überladen des Prompts mit dauerhaften Regeln, anstatt sie in AGENTS.md oder einen Skill zu verschieben
• Dem Agenten nicht erlauben, seine Arbeit zu sehen, indem Sie keine Details zur optimalen Ausführung von Build- und Testbefehlen angeben
• Planung bei mehrschrittigen und komplexen Aufgaben überspringen
• Codex volle Berechtigung für Ihren Computer geben, bevor der Workflow verstanden ist
• Mehrere Live-Threads auf denselben Dateien ausführen, ohne Git Worktrees zu verwenden
• Eine wiederkehrende Aufgabe in eine Automatisierung umwandeln, bevor sie manuell zuverlässig ist
• Codex parallel zu Ihrer eigenen Arbeit verwenden, anstatt es als etwas zu betrachten, das Sie Schritt für Schritt überwachen müssen

Checkliste für den Einstieg

1. Geben Sie Codex das richtige Ziel, den richtigen Kontext, die richtigen Einschränkungen und das richtige "Erledigt, wenn"
2. Bitten Sie Codex bei schwierigen Aufgaben zuerst um einen Plan
3. Erstellen Sie eine erste AGENTS.md
4. Teilen Sie Codex mit, wie es bauen, testen, validieren und überprüfen soll
5. Legen Sie Konfigurationsstandards fest, die Ihrem Workflow entsprechen
6. Fügen Sie MCP für hochwertige externe Tools hinzu
7. Verwandeln Sie wiederkehrende Workflows in Skills
8. Verwenden Sie Automatisierungen, sobald ein Workflow stabil ist

Je mehr Sie Ihren Workflow, Ihre Standards und Ihren Kontext in etwas verwandeln, das Codex verwenden kann, desto mehr werden Sie sehen, was der Agent wirklich kann. Legen Sie noch heute los!