Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Pisanje koda s Codexom

Lekcija 5 od 20 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Od ideje do koda jednom naredbom
  2. Stvaranje nove datoteke ili modula
  3. Dodavanje značajki postojećem kodu
  4. Generiranje koda iz specifikacije
  5. Rad s više datoteka
  6. Savjeti za optimalne rezultate
  7. Ključne točke

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