Codex in VS Code: Die wichtigsten Funktionen für Webentwickler
Codex benötigt für Webentwicklungsaufgaben einen klaren Projektkontext, definierte Grenzen und überprüfbare Erfolgskriterien. Die VS-Code-Erweiterung nutzt geöffnete Dateien und markierten Code direkt und unterstützt Planung, Umsetzung, Tests und Kontrolle.
Die Codex-Erweiterung bringt den KI-Coding-Agenten direkt in Visual Studio Code. Geöffnete Dateien und markierte Codebereiche dienen unmittelbar als Kontext. Darauf aufbauend kann Codex Fehler untersuchen, Dateien bearbeiten, Befehle und Tests ausführen und die vorgenommenen Änderungen zur Kontrolle anzeigen.
Wofür eignet sich Codex?
Webentwickler können Codex unter anderem für folgende Aufgaben einsetzen:
- Fehler in PHP, JavaScript oder CSS untersuchen
- bestehende Funktionen erweitern
- Code erklären und dokumentieren
- Tests, Linter und Builds ausführen
- Änderungen auf Fehler und Regressionen prüfen
- unbekannte Projekte schneller verstehen
- umfangreiche Aufgaben planen und schrittweise umsetzen
Die offizielle Dokumentation zur Codex-IDE-Erweiterung empfiehlt, relevante Dateien oder markierte Codebereiche direkt als Kontext zu verwenden. Die vorgenommenen Änderungen lassen sich anschliessend im Diff kontrollieren.empfiehlt, relevante Dateien oder markierte Codebereiche direkt als Kontext zu verwenden und Änderungen anschliessend im Diff zu kontrollieren.
Cheat Sheet: Die wichtigsten Befehle
Slash-Befehle werden direkt in das Eingabefeld von Codex geschrieben. Die Eingabe von / öffnet eine Liste der verfügbaren Befehle.
| Befehl | Wirkung |
|---|---|
/plan | Erstellt für eine mehrstufige Aufgabe zuerst einen überprüfbaren Plan |
/review | Prüft Änderungen oder vergleicht sie mit einem Git-Branch |
/ide-context | Aktiviert oder deaktiviert den automatischen VS-Code-Kontext |
/local | Führt die Aufgabe im geöffneten lokalen Projekt aus |
/cloud | Übergibt eine umfangreichere Aufgabe an die Cloud-Umgebung |
/worktree | Startet die Aufgabe in einem getrennten Git-Worktree |
/init | Erstellt eine Vorlage für dauerhafte Projektregeln in AGENTS.md |
/goal | Legt ein Ziel fest, das Codex über mehrere Arbeitsschritte verfolgt |
/status | Zeigt unter anderem Kontextverbrauch und Nutzungslimits |
/compact | Fasst einen langen Chat zusammen und schafft wieder Kontextplatz |
Die verfügbaren Befehle richten sich nach der verwendeten Version und Umgebung. Die aktuelle Auswahl erscheint in der Erweiterung nach der Eingabe von /. Weitere Erläuterungen enthält die offizielle OpenAI-Referenz für die IDE-Erweiterung
Ein nachvollziehbarer Arbeitsablauf
Ein zuverlässiger Workflow mit Codex sieht so aus:
- Vor der Änderung einen Git-Zwischenstand erstellen.
- Den relevanten Code markieren oder die benötigten Dateien hinzufügen.
- Ziel, Grenzen und Erfolgskriterien beschreiben.
- Umfangreiche Aufgaben mit
/planstrukturieren. - Codex die Änderung umsetzen und die passenden Tests, Linter oder Builds ausführen lassen.
- Die vorgenommenen Änderungen im Diff kontrollieren.
- Die fertige Änderung mit
/reviewüberprüfen. - Anschliessend committen oder veröffentlichen.
Codex kann viele Arbeitsschritte übernehmen. Der Entwickler kontrolliert die Qualität und entscheidet über die Veröffentlichung.

Vorlage für einen guten Auftrag
Ziel:
[Was soll erreicht werden?]
Kontext:
[Projekt, Technologie, relevante Dateien und aktuelles Verhalten]
Grenzen:
[Welche Bereiche bleiben unverändert? Für welche Aktionen soll Codex nachfragen?]
Erfolgskriterien:
[Woran lässt sich erkennen, dass die Aufgabe erfüllt ist?]
Untersuche zuerst den bestehenden Code und die Projektkonventionen.
Implementiere die kleinste sichere und wartbare Lösung.
Führe die passenden Tests aus. Liste die tatsächlich ausgeführten
Prüfungen auf und kennzeichne offene Prüfpunkte.
Berichte abschliessend kurz über Änderungen, Testergebnisse und Risiken.
Diese Struktur bietet Codex eine verlässlichere Arbeitsgrundlage als die allgemeine Anweisung «Repariere den Fehler».
Beispiel für ein WordPress-Projekt
Untersuche den markierten WordPress-Code und finde die Ursache des Fehlers.
Verändere keine WordPress-Core-Dateien und keine Dateien im
vendor-Verzeichnis. Installiere keine neue Abhängigkeit ohne Rückfrage.
Implementiere die kleinste kompatible Korrektur. Prüfe anschliessend
die PHP-Syntax, vorhandene Tests und mögliche Nebenwirkungen.
Liste die tatsächlich ausgeführten Prüfungen und ihre Ergebnisse auf.
Dauerhafte Regeln mit AGENTS.md
Eine AGENTS.md hält wiederkehrende Projektregeln einmalig für alle folgenden Aufgaben fest. Codex liest die Datei vor der Arbeit und richtet seine Vorgehensweise an den enthaltenen Anweisungen aus.
Für ein WordPress-Projekt könnten beispielsweise folgende Regeln gelten:
# Projektregeln
- Verändere keine WordPress-Core- oder vendor-Dateien.
- Beachte die vorhandenen PHP-, JavaScript- und CSS-Konventionen.
- Installiere keine neue Abhängigkeit ohne Rückfrage.
- Führe nach Änderungen die vorhandenen Tests aus.
- Nenne nur tatsächlich ausgeführte Prüfungen.
- Frage vor Deployment, Migration oder Löschung nach.
Mit /init lässt sich eine Vorlage für diese Datei erstellen. Weitere Details erklärt die offizielle Dokumentation zu AGENTS.md.
Ergebnis
Ein klarer Rahmen
für verlässliche Codex-Aufgaben.
Codex arbeitet besonders wirkungsvoll mit relevantem Projektkontext, einem überprüfbaren Ziel und klar definierten Grenzen. Planung, Tests und die Kontrolle im Diff machen die Umsetzung nachvollziehbar.
Klar beauftragt
Ziel, Kontext, Grenzen und Erfolgskriterien geben Codex eine eindeutige Arbeitsgrundlage.
Nachvollziehbar geprüft
Tests, Diffs und Reviews machen Änderungen und ihre Auswirkungen kontrollierbar.
Dauerhaft ausgerichtet
Eine AGENTS.md stellt wiederkehrende Projektregeln für alle folgenden Aufgaben bereit.