Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Code mit Codex schreiben

Lektion 5 von 20 Aktualisiert am 29. Juli 2026 Entwickler
Auf dieser Seite
  1. Vom Gedanken zum Code in einer Anweisung
  2. Erstellen einer neuen Datei oder eines neuen Moduls
  3. Hinzufügen von Funktionen zu bestehendem Code
  4. Generieren von Code aus einer Spezifikation
  5. Arbeiten mit mehreren Dateien
  6. Tipps für optimale Ergebnisse
  7. Kernaussagen

Vom Gedanken zum Code in einer Anweisung

Das Schreiben von Code ist die Aufgabe, die Sie Codex am häufigsten zuweisen, und hier zeigt sich der Unterschied zwischen Codex und einem einfachen Snippet-Generator am deutlichsten. Der Agent erzeugt nicht nur einen isolierten Code-Ausschnitt, den Sie anschließend anpassen müssen. Stattdessen liest er Ihren Codebestand, leitet Ihre Konventionen ab und schreibt etwas, das nahtlos in Ihre bestehende Architektur passt. Ihre Aufgabe besteht daher weniger darin, Code zu beschreiben, sondern vielmehr darin, einen Platz innerhalb eines Systems zu definieren.

Erstellen einer neuen Datei oder eines neuen Moduls

Beim Generieren von vollständig neuem Code ist Präzision für den Kontext ebenso wichtig wie für die erwartete Funktionalität.

"Create a service at src/services/notification.service.ts that handles 
sending notifications via email and webhook. Use the same pattern as 
src/services/auth.service.ts. The service must expose sendEmail(to, subject, body) 
and sendWebhook(url, payload)."

Codex liest auth.service.ts, um das aktuelle Muster zu verstehen, analysiert die Imports und Abhängigkeiten des Projekts, erstellt die Datei mit derselben Struktur, fügt die passenden TypeScript-Typen hinzu und exportiert die Funktionen gemäß den Projektkonventionen. Das Ergebnis sieht wie folgt aus:

// src/services/notification.service.ts
import { z } from "zod";
import { logger } from "@/lib/logger";
import { env } from "@/lib/env";

const emailSchema = z.object({
  to: z.string().email(),
  subject: z.string().min(1),
  body: z.string().min(1),
});

export async function sendEmail(
  to: string, 
  subject: string, 
  body: string
): Promise<void> {
  const validated = emailSchema.parse({ to, subject, body });
  // ... implementation
}

export async function sendWebhook(
  url: string, 
  payload: Record<string, unknown>
): Promise<Response> {
  // ... implementation
}

Ein Detail verdient besondere Aufmerksamkeit: Niemand hat nach Zod-Validierung gefragt. Codex hat sie hinzugefügt, weil er bemerkt hat, dass das Projekt überall sonst Zod verwendet. Dies ist der Grund, warum das Verweisen auf eine Modelldatei sich lohnt: Ein zehnwörtiger Satz spart Ihnen einen ganzen Absatz an Spezifikation.

Hinzufügen von Funktionen zu bestehendem Code

Agenten liefern den größten Mehrwert bei bestehendem Code, nicht weil das Schreiben der Zeilen schwierig ist, sondern weil das Beachten des gesamten Umfelds darum entscheidend ist.

"In src/api/routes/users.ts, add a GET /users/:id/activity endpoint 
that returns the user's last 50 actions. Use the same authentication 
middleware as the other routes."

Codex analysiert die benachbarten Routen, identifiziert die tatsächlich verwendete Middleware, notiert das aktuelle Antwortformat und fügt dann die Endpunkt konsistent hinzu. Diese Aufklärungsarbeit würde Sie weitaus länger in Anspruch nehmen als das eigentliche Coden, und genau dieser Teil ist es, bei dem Menschen in Eile Abkürzungen wählen.

Generieren von Code aus einer Spezifikation

Bei komplexen Funktionen sollten Sie eine Ebene höher gehen und eine ordnungsgemäße Spezifikation verfassen. Jeder Punkt wird zu einer Anforderung, die der Agent als solche behandelt.

"Implement a rate limiting system for the API:
- Maximum 100 requests per minute per IP
- Maximum 1000 requests per hour per authenticated user
- Return an X-RateLimit-Remaining header
- Return 429 Too Many Requests when the limit is reached
- Store counters in Redis (already configured in the project)
- Create the middleware in src/middleware/rate-limit.ts"

Diese Spezifikation liefert numerische Werte, den Header-Namen, den HTTP-Statuscode, verfügbare Infrastruktur und den Dateipfad. Jeder Detailpunkt entfernt eine willkürliche Entscheidung, die Codex sonst für Sie treffen müsste – eine Entscheidung, die Sie erst während der Code-Review entdecken würden.

Arbeiten mit mehreren Dateien

Eine einzelne Aufgabe kann rechtmäßig mehrere Anwendungsebenen umfassen, sofern Sie die zu liefernden Ergebnisse auflisten.

"Add an in-app notification system:
1. Prisma model Notification (id, userId, type, message, read, createdAt)
2. Service at src/services/notification.service.ts
3. CRUD API routes in src/api/routes/notifications.ts
4. Tests in src/api/routes/notifications.test.ts"

Codex erstellt alle vier Dateien kohärent: Der Dienst stützt sich auf das Prisma-Modell, die Routen rufen den Dienst auf, und die Tests decken die Routen ab. Diese vertikale Konsistenz zu erreichen, ist schwierig, wenn Sie die Anfrage in vier separate Aufgaben aufteilen, bei denen jeder Schritt erneut feststellen muss, was der vorherige Schritt entschieden hat – und manchmal widerspricht er ihm sogar.

Tipps für optimale Ergebnisse

Erinnern Sie sich zunächst an die Kraft des Verweises auf bestehenden Code: „wie in auth.service.ts” übermittelt in fünf Wörtern ein Muster, das Sie auf einer ganzen Seite beschreiben müssten. Nennen Sie Bibliotheken explizit – „verwenden Sie Zod für die Validierung” statt „fügen Sie Validierung hinzu” – und legen Sie das Ausgabeformat fest, wenn dies wichtig ist, wie beispielsweise ein einheitliches { success, data, error }-Objekt über Ihre gesamte API hinweg. Erwähnen Sie Randfälle, die Sie betreffen, wie „behandeln Sie den Fall, dass der Benutzer nicht existiert”: Wenn der Agent sich selbst überlassen ist, behandelt er den glücklichen Weg und lässt Sie den Rest entdecken. Schließlich gehört alles, was Sie von Aufgabe zu Aufgabe wiederholen, in die AGENTS.md, um Ihre Anweisungen kurz zu halten.

Kernaussagen

  • Codex versteht Ihren Codebestand und respektiert Ihre bestehenden Konventionen
  • Verweisen Sie auf bestehende Dateien, um Stil und Muster zu lenken
  • Detaillierte Spezifikationen führen zu präziseren Ergebnissen
  • Codex kann mehrere Dateien in einer einzigen Aufgabe erstellen und ändern
  • AGENTS.md ergänzt Ihre Anweisungen mit dauerhaften Regeln