Skriva kod med Codex
På denna sida
Från idé till kod på en enda instruktion
Att skriva kod är den uppgift du oftast kommer att delegera till Codex, och det är här skillnaden mellan Codex och en enkel kodgenerator blir som tydligast. Agenten producerar inte bara ett isolerat kodfragment som du sedan måste anpassa. Istället läser den din kodbas, härleder dina konventioner och skriver något som smälter sömlöst in i din befintliga arkitektur. Ditt jobb handlar därför mindre om att beskriva kod och mer om att beskriva en plats inom ett system.
Skapa en ny fil eller modul
När du genererar helt ny kod är precision lika viktig för kontexten som för den förväntade funktionaliteten.
"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 läser auth.service.ts för att förstå det aktuella mönstret, analyserar projektets import och beroenden, skapar filen med samma struktur, lägger till lämpliga TypeScript-typer och exporterar funktionerna enligt projektets konventioner. Resultatet ser ut så här:
// 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
}
En detalj förtjänar uppmärksamhet: ingen bad om Zod-validering. Codex lade till den eftersom agenten noterade att projektet använder Zod överallt annars. Det är därför det löner sig att referera till en modellfil – en fras på tio ord sparar dig ett helt stycke specifikation.
Lägga till funktioner i befintlig kod
Agenter levererar mest värde på befintlig kod, inte för att det är svårt att skriva själva raderna, utan för att det är utmanande att respektera allt runtomkring dem.
"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 analyserar närliggande rutter, identifierar den faktiska mellanvaru som används, noterar det nuvarande svarsformatet och lägger sedan till slutpunkten på ett konsekvent sätt. Detta rekognoseringsarbete skulle ta dig betydligt längre tid än själva kodningen, och det är exakt den del människor genvägar genom när de har bråttom.
Generera kod från en specifikation
För komplexa funktioner bör du höja nivån och skriva en ordentlig specifikation. Varje punkt blir ett krav som agenten behandlar som sådant.
"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"
Denna specifikation ger numeriska värden, rubriknamn, HTTP-statuskod, tillgänglig infrastruktur och filplats. Varje detalj tar bort ett godtyckligt beslut som Codex annars skulle ha fattat åt dig – ett beslut du annars bara skulle upptäcka under kodgranskning.
Arbeta med flera filer
En enda uppgift kan legitimt sträcka sig över flera applikationslager, förutsatt att du listar leverablerna.
"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 producerar alla fyra filerna sammanhängande: tjänsten förlitar sig på Prisma-modellen, rutterna anropar tjänsten och testerna täcker rutterna. Att uppnå denna vertikala konsistens är svårt om du delar upp begäran i fyra separata uppgifter, där varje steg måste återupptäcka vad det föregående beslutade – och ibland motsäga det.
Tips för optimala resultat
Kom först ihåg kraften i att referera till befintlig kod: «liksom i auth.service.ts» förmedlar på fem ord ett mönster som skulle ta en hel sida att beskriva. Namnge bibliotek explicit – «använd Zod för validering» snarare än «lägg till validering» – och specificera utdataformatet när det spelar roll, till exempel ett enhetligt { success, data, error }-objekt över hela ditt API. Nämn fallkantsscenarier som bekymrar dig, som «hantera fallet där användaren inte finns»: om agenten lämnas åt sig själv hanterar den bara lyckofallet och lämnar åt dig att upptäcka resten. Slutligen hör allt du upprepar från uppgift till uppgift hemma i AGENTS.md, vilket håller dina instruktioner korta.
Viktiga punkter
- Codex förstår din kodbas och respekterar dina befintliga konventioner
- Referera till befintliga filer för att styra stil och mönster
- Detaljerade specifikationer ger mer precisa resultat
- Codex kan skapa och modifiera flera filer i en enda uppgift
- AGENTS.md kompletterar dina instruktioner med permanenta regler