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.

4 Min. von Erhard Sigrist

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.

BefehlWirkung
/planErstellt für eine mehrstufige Aufgabe zuerst einen überprüfbaren Plan
/reviewPrüft Änderungen oder vergleicht sie mit einem Git-Branch
/ide-contextAktiviert oder deaktiviert den automatischen VS-Code-Kontext
/localFührt die Aufgabe im geöffneten lokalen Projekt aus
/cloudÜbergibt eine umfangreichere Aufgabe an die Cloud-Umgebung
/worktreeStartet die Aufgabe in einem getrennten Git-Worktree
/initErstellt eine Vorlage für dauerhafte Projektregeln in AGENTS.md
/goalLegt ein Ziel fest, das Codex über mehrere Arbeitsschritte verfolgt
/statusZeigt unter anderem Kontextverbrauch und Nutzungslimits
/compactFasst 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:

  1. Vor der Änderung einen Git-Zwischenstand erstellen.
  2. Den relevanten Code markieren oder die benötigten Dateien hinzufügen.
  3. Ziel, Grenzen und Erfolgskriterien beschreiben.
  4. Umfangreiche Aufgaben mit /plan strukturieren.
  5. Codex die Änderung umsetzen und die passenden Tests, Linter oder Builds ausführen lassen.
  6. Die vorgenommenen Änderungen im Diff kontrollieren.
  7. Die fertige Änderung mit /review überprüfen.
  8. Anschliessend committen oder veröffentlichen.

Codex kann viele Arbeitsschritte übernehmen. Der Entwickler kontrolliert die Qualität und entscheidet über die Veröffentlichung.

Die Codex-Erweiterung in VS Code nutzt geöffnete Dateien und markierten Code für Planung, Änderungen, Tests und Kontrolle.
Die Codex-Erweiterung in VS Code nutzt geöffnete Dateien und markierten Code für Planung, Änderungen, Tests und Kontrolle.

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.