Code schrijven met Codex
Op deze pagina
Van idee naar code in één instructie
Het schrijven van code is de taak die u het vaakst aan Codex zult toewijzen. Het is ook het moment waarop het verschil tussen Codex en een simpele fragmentgenerator het duidelijkst wordt. De agent produceert niet zomaar een geïsoleerd codefragment dat u vervolgens moet aanpassen. In plaats daarvan leest hij uw codebase, leidt hij uw conventies af en schrijft hij iets dat naadloos aansluit bij uw bestaande architectuur. Uw werk bestaat daarom minder uit het beschrijven van code, en meer uit het beschrijven van een plek binnen een systeem.
Een nieuw bestand of module maken
Bij het genereren van volledig nieuwe code is precisie voor de context net zo belangrijk als voor de verwachte functionaliteit.
"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 leest auth.service.ts om het huidige patroon te begrijpen, analyseert de imports en afhankelijkheden van het project, maakt het bestand met dezelfde structuur aan, voegt de juiste TypeScript-types toe en exporteert de functies volgens de projectconventies. Het resultaat ziet er als volgt uit:
// 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
}
Eén detail verdient aandacht: niemand vroeg om Zod-validatie. Codex heeft dit toegevoegd omdat hij merkte dat het project elders overal Zod gebruikt. Dit is waarom het verwijzen naar een modelbestand zijn vruchten afwerpt; een zin van tien woorden bespaart u een hele alinea aan specificaties.
Functies toevoegen aan bestaande code
Agents leveren de meeste waarde op bestaande code, niet omdat het schrijven van de regels moeilijk is, maar omdat het respecteren van alles eromheen dat wel is.
"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 analyseert aangrenzende routes, identificeert de daadwerkelijk gebruikte middleware, noteert het huidige response-formaat en voegt vervolgens het endpoint op een consistente manier toe. Dit verkenningswerk zou u veel langer kosten dan het daadwerkelijke coderen, en het is precies het onderdeel waar mensen op bezuinigen wanneer ze haast hebben.
Code genereren op basis van een specificatie
Voor complexe functies gaat u een niveau hoger en schrijft u een degelijke specificatie. Elk punt wordt een vereiste waarmee de agent als zodanig omgaat.
"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"
Deze specificatie biedt numerieke waarden, de naam van de header, de HTTP-statuscode, de beschikbare infrastructuur en de bestandslocatie. Elk detail verwijdert een willekeurige beslissing die Codex anders voor u zou nemen; een beslissing die u pas tijdens de code-review zou ontdekken.
Werken met meerdere bestanden
Een enkele taak kan legitiem meerdere applicatielagen beslaan, mits u de deliverables opsomt.
"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 produceert alle vier de bestanden op een coherente manier: de service vertrouwt op het Prisma-model, de routes roepen de service aan en de tests dekken de routes. Het bereiken van deze verticale consistentie is moeilijk als u het verzoek opsplitst in vier aparte taken, waarbij elke stap opnieuw moet ontdekken wat de vorige heeft besloten – en dit soms zelfs tegenspreekt.
Tips voor optimale resultaten
Onthoud allereerst de kracht van het verwijzen naar bestaande code: “zoals in auth.service.ts” geeft in vijf woorden een patroon weer waar u een pagina voor nodig zou hebben om te beschrijven. Noem bibliotheken expliciet – “gebruik Zod voor validatie” in plaats van “voeg validatie toe” – en specificeer het uitvoerformaat wanneer dit van belang is, zoals een uniform { success, data, error }-object in uw hele API. Noem randgevallen die u bezighouden, zoals “behandel het geval waarin de gebruiker niet bestaat”: als de agent aan zijn lot wordt overgelaten, behandelt hij alleen het happy path en laat hij u de rest zelf ontdekken. Tot slot hoort alles wat u van taak tot taak herhaalt thuis in AGENTS.md, zodat uw instructies kort blijven.
Belangrijkste punten
- Codex begrijpt uw codebase en respecteert uw bestaande conventies
- Verwijs naar bestaande bestanden om stijl en patronen te sturen
- Gedetailleerde specificaties leveren nauwkeurigere resultaten op
- Codex kan in één taak meerdere bestanden maken en wijzigen
- AGENTS.md vult uw instructies aan met permanente regels