Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Ihre erste Codex-Aufgabe

Lektion 4 von 20 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Starten Sie Ihre erste Aufgabe
  2. Vom Codex Cloud
  3. Vom IDE
  4. Vom CLI
  5. Anatomie eines Codex-Ergebnisses
  6. Schreiben guter Anweisungen
  7. Kernaussagen

Aktualisiert am 3. November 2026 basierend auf der Codex-Befehlsreferenz (CLI 0.166.0): Die Optionen --show-diff und --apply existieren nicht. Lokal ändert Codex Dateien direkt innerhalb seines Sandboxes; überprüfen Sie Änderungen mit /diff oder git diff. Der Erweiterungsbefehl “Codex: New Task” wurde durch Codex: Open Codex Sidebar ersetzt. Quellen: Developer commands · Codex IDE extension.

Starten Sie Ihre erste Aufgabe

Ihr Konto ist eingerichtet, GitHub ist verbunden und AGENTS.md steht bereit: Es ist Zeit, das Agentenverhalten in Aktion zu sehen. Hier ist eine Faustregel für jede Kompetenzstufe: Beginnen Sie mit einer Aufgabe, bei der Sie bereits die richtige Lösung kennen. Sie werden wenig lernen, wenn Sie beobachten, wie Codex ein Problem löst, das Sie nicht bewerten können, aber Sie werden eine enorme Menge lernen, indem Sie beobachten, wie es auf vertrautem Terrain operiert.

Vom Codex Cloud

Wählen Sie im Web oder in der Desktop-App Work in › Cloud, wählen Sie die veröffentlichte Umgebung für Ihr Repository aus (Lektion 2) und geben Sie Ihre Aufgabe in das Eingabefeld ein. Etwas bewusst bescheidenes funktioniert bereits perfekt.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Diese Formulierung enthält eine Bedingung – “falls eine bereits existiert” – was genau das macht, dass es interessant zu beobachten ist. Im Codex Cloud läuft die Aufgabe in der Umgebung aus, die Sie für dieses Repository veröffentlicht haben: Codex prüft, ob eine .gitignore-Datei existiert, verifiziert, ob sie Node.js und TypeScript abdeckt, falls vorhanden, erstellt oder aktualisiert die Datei entsprechend und zeigt Ihnen das Ergebnis als Diff an. Die Ausführungsprotokolle werden in Echtzeit übertragen: Hier sehen Sie, ob der Agent die Bedingung respektiert oder Ihre vorhandene Datei überschrieben hat.

Vom IDE

Öffnen Sie Ihr Projekt in VS Code (oder Cursor, Windsurf) und starten Sie Codex über sein Symbol oder die Befehlspalette:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Formulieren Sie dann eine Anfrage, die lokalen Kontext nutzt, indem Sie die spezifische Datei benennen:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Die Erweiterung zeigt eine Zusammenfassung und die geänderten Zeilen neben dem Code an; Sie behalten die gewünschten Änderungen und stellen Nachfragen innerhalb desselben Gesprächs. Die Dokumentation empfiehlt, vor und nach der Aufgabe einen Git-Checkpoint zu erstellen, um im Bedarfsfall zurückrollen zu können.

Vom CLI

# Navigieren Sie zum Projektverzeichnis
cd my-project

# Starten Sie eine Sitzung mit einer ersten Anweisung
codex "Add a README.md with the project description, installation instructions, and available commands"

Lokal ändert Codex Dateien direkt in Ihrem Arbeitsverzeichnis, innerhalb der Grenzen des Sandboxes und der Genehmigungsrichtlinie: Es fragt nach Erlaubnis, bevor es Aktionen durchführt, die diese erfordern. Um zu überprüfen, was geändert wurde, bevor Sie commiten, geben Sie /diff in der Sitzung ein: Der Befehl zeigt das Git-Diff an, einschließlich nicht verfolgter Dateien. /review bittet Codex, Ihren Arbeitsbaum selbst zu überprüfen. Für skriptbasierte Nutzung führt codex exec dieselbe Aufgabe ohne Interaktion aus (Lektion 14) – in diesem Fall liegt es an Git und Ihrer Pipeline, zu entscheiden, was behalten wird.

Anatomie eines Codex-Ergebnisses

Unabhängig vom Einstiegspunkt gibt eine abgeschlossene Aufgabe immer dieselben vier Elemente zurück. Überprüfen Sie sie in dieser Reihenfolge: Das Diff sagt, was geändert wurde, das Protokoll sagt warum, die Tests sagen, ob es sicher ist, und die Aktionen geben die Kontrolle zurück an Sie.

Geliefertes ElementInhalt
Change diffJede hinzugefügte, geänderte oder gelöschte Zeile, Datei für Datei
Execution logAlle Schritte: gelesene Dateien, ausgeführte Befehle, Agenten-Reasoning
Test resultsFalls Tests existieren, führt Codex sie aus, um zu verifizieren, dass nichts kaputt ist
Available actionsGenehmigen, ändern, PR erstellen oder erneut ausführen mit anderen Anweisungen

Anfänger vernachlässigen oft das Ausführungsprotokoll, doch es ist das Element, das Ihnen lehrt, wie Sie Ihre Aufgaben formulieren. Indem Sie sehen, welche Dateien Codex geöffnet hat, bevor es eine Entscheidung traf, entdecken Sie, wonach es gesucht hat, aber nicht finden konnte – oft eine Konvention, die in AGENTS.md stehen sollte.

Schreiben guter Anweisungen

Die Ergebnisqualität hängt direkt von der Qualität der Anweisung ab, und die Lücke zwischen den beiden folgenden Formulierungen ist weitaus größer als die Lücke zwischen zwei Modellen.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

Die zweite Version funktioniert, weil sie vier Fragen beantwortet, die sich der Agent ohnehin selbst stellt. Sie spezifiziert die beteiligten Dateien und spart ihm das Erkunden und das Zielen auf die falsche Stelle. Sie definiert das erwartete Ergebnis – Verhalten, Schnittstelle, Format –, sodass er weiß, wann er aufhören soll. Sie setzt Einschränkungen, hier das Bewahren der öffentlichen Schnittstelle, was verhindert, dass er “verbessert”, indem er Aufrufe kaputt macht; anderswo könnte dies “Tests nicht kaputt machen” lauten. Und wenn die Risiken dies rechtfertigen, fügt er Geschäftskontext hinzu: Die Spezifikation “dies ist ein Zahlungsformular, Sicherheit ist kritisch” ändert seine Abwägungen tatsächlich.

Um dies zu eigen zu machen, nehmen Sie ein bestehendes Projekt und verknüpfen Sie drei Aufgaben unterschiedlicher Art: eine Analyse ohne Änderung, “Liste alle TypeScript-Dateien, die keine zugehörigen Tests haben”; eine gezielte Generierung, “Generiere eine Unit-Test für diese Datei”; eine begrenzte Reparatur, “Beheben Sie ESLint-Warnungen in src/utils/”. Für jede Notieren Sie, was Sie ursprünglich spezifiziert haben sollten: Diese Liste von Bedauern ist Ihr erster Entwurf für AGENTS.md.

Kernaussagen

  • Starten Sie Ihre ersten Aufgaben mit einfachen, gezielten Anfragen
  • Codex stellt für jede Aufgabe ein vollständiges Ausführungsprotokoll bereit
  • Die Ergebnisqualität hängt von der Präzision Ihrer Anweisungen ab
  • Sie behalten stets die Kontrolle: Genehmigen, ändern oder ablehnen
  • Beginnen Sie mit risikolosen Aufgaben, bevor Sie zu kritischen Änderungen übergehen