Pisanje koda s Codexom
Na ovoj stranici
Od ideje do koda jednom naredbom
Pisanje koda zadatak je koji ćeš Codexu povjeravati najčešće i upravo tu razlika između Codexa i običnog generatora isječaka koda postaje najočitija. Agent ne proizvodi samo izolirani fragment koda koji potom moraš prilagoditi. Umjesto toga, on čita tvoju bazu koda, zaključuje tvoje konvencije i piše nešto što se besprijekorno uklapa u tvoju postojeću arhitekturu. Tvoj je posao stoga manje opisivanje koda, a više opisivanje mjesta unutar sustava.
Stvaranje nove datoteke ili modula
Kada generiraš potpuno novi kod, preciznost je jednako važna za kontekst koliko i za očekivanu funkcionalnost.
"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 čita auth.service.ts kako bi razumio trenutni uzorak, analizira uvoze i ovisnosti projekta, stvara datoteku s istom strukturom, dodaje odgovarajuće TypeScript tipove i izvozi funkcije u skladu s konvencijama projekta. Rezultat izgleda ovako:
// 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
}
Jedan detalj zaslužuje pozornost: nitko nije tražio validaciju pomoću Zoda. Codex ju je dodao jer je primijetio da projekt svugdje drugdje koristi Zod. Zato se isplati referencirati model datoteku – fraza od deset riječi štedi ti cijeli odlomak specifikacije.
Dodavanje značajki postojećem kodu
Agenti donose najveću vrijednost na postojećem kodu, ne zato što je pisanje redaka teško, već zato što je poštivanje svega što ih okružuje izazovno.
"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 analizira susjedne rute, identificira stvarni middleware koji se koristi, bilježi trenutni format odgovora, a zatim dosljedno dodaje krajnju točku. Ovaj izviđački posao trajao bi ti znatno dulje od samog kodiranja, a upravo je to dio oko kojeg ljudi rade kompromise kada žure.
Generiranje koda iz specifikacije
Za složene značajke podigni razinu i napiši pravu specifikaciju. Svaka točka postaje zahtjev koji agent tretira kao takav.
"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"
Ova specifikacija pruža numeričke vrijednosti, naziv zaglavlja, HTTP status kod, dostupnu infrastrukturu i lokaciju datoteke. Svaki detalj uklanja proizvoljnu odluku koju bi Codex inače donio umjesto tebe – odluku koju bi otkrio tek tijekom pregleda koda.
Rad s više datoteka
Jedan zadatak legitimno može obuhvatiti više slojeva aplikacije, pod uvjetom da navedeš isporuke.
"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 koherentno proizvodi sve četiri datoteke: servis se oslanja na Prisma model, rute pozivaju servis, a testovi pokrivaju rute. Postići ovu vertikalnu dosljednost teško je ako zahtjev razbiješ u četiri odvojena zadatka, gdje svaki korak mora iznova otkrivati što je prethodni odlučio – a ponekad tome i proturječiti.
Savjeti za optimalne rezultate
Prvo, zapamti snagu referenciranja postojećeg koda: „kao u auth.service.ts“ prenosi uzorak u pet riječi za koji bi ti trebala stranica opisa. Eksplicitno imenuj biblioteke – „koristi Zod za validaciju“ umjesto „dodaj validaciju“ – i specificiraj format izlaza kada je to bitno, poput uniformnog objekta { success, data, error } u cijelom tvom API-ju. Spomeni rubne slučajeve koji te brinu, poput „obradi slučaj kada korisnik ne postoji“: prepušten sam sebi, agent obrađuje sretan put (happy path), a tebe ostavlja da otkriješ ostalo. Naposljetku, sve što ponavljaš iz zadatka u zadatak pripada u AGENTS.md, čime tvoje upute ostaju kratke.
Ključne točke
- Codex razumije tvoju bazu koda i poštuje tvoje postojeće konvencije
- Referenciraj postojeće datoteke kako bi usmjerio stil i uzorke
- Detaljne specifikacije daju preciznije rezultate
- Codex može stvoriti i modificirati više datoteka u jednom zadatku
- AGENTS.md nadopunjuje tvoje upute trajnim pravilima