Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Kód írása a Codex segítségével

5. lecke 20 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Ötlettől a kódig egyetlen utasítással
  2. Új fájl vagy modul létrehozása
  3. Funkciók hozzáadása meglévő kódhoz
  4. Kód generálása specifikáció alapján
  5. Munka több fájllal
  6. Tippek az optimális eredményekhez
  7. Főbb megállapítások

Ötlettől a kódig egyetlen utasítással

A kódírás az a feladat, amelyet a leggyakrabban bízol a Codexre, és ez az a terület, ahol a Codex és egy egyszerű kódrészlet-generátor közötti különbség a legszembetűnőbb. Az ügynök nem csupán egy elszigetelt kódrészletet állít elő, amelyet aztán neked kell igazítanod. Ehelyett beolvassa a kódállományodat, következtet a konvencióidra, és olyat ír, amely zökkenőmentesen illeszkedik a meglévő architektúrádba. A te feladatod tehát kevésbé a kód leírása, sokkal inkább egy hely meghatározása a rendszeren belül.

Új fájl vagy modul létrehozása

Teljesen új kód generálásakor a pontosság ugyanolyan fontos a kontextus szempontjából, mint a várt funkcionalitás tekintetében.

"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)."

A Codex beolvassa a auth.service.ts fájlt, hogy megértse az aktuális mintát, elemzi a projekt importálásait és függőségeit, létrehozza a fájlt ugyanazzal a szerkezettel, hozzáadja a megfelelő TypeScript típusokat, és a projekt konvencióinak megfelelően exportálja a függvényeket. Az eredmény így néz ki:

// 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
}

Egy részlet külön figyelmet érdemel: senki nem kért Zod validálást. A Codex mégis hozzáadta, mert észrevette, hogy a projekt mindenhol máshol Zodot használ. Ezért éri meg egy modellfájlra hivatkozni: egy tíz szavas kifejezés megspórol neked egy egész bekezdésnyi specifikációt.

Funkciók hozzáadása meglévő kódhoz

Az ügynökök a meglévő kódon nyújtják a legnagyobb értéket, nem azért, mert nehéz lenne leírni a sorokat, hanem mert nehéz betartani mindent, ami körülveszi őket.

"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."

A Codex elemzi a szomszédos útvonalakat, azonosítja a ténylegesen használt middleware-t, megjegyzi az aktuális válaszformátumot, majd következetesen hozzáadja a végpontot. Ez a felderítő munka sokkal több időt venne igénybe tőled, mint maga a kódolás, és pontosan ez az a rész, amin az emberek spórolni szoktak, amikor sietnek.

Kód generálása specifikáció alapján

Komplex funkciók esetén lépj egy szinttel feljebb, és írj egy megfelelő specifikációt. Minden pont egy követelménnyé válik, amelyet az ügynök annak is kezel.

"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"

Ez a specifikáció numerikus értékeket, a fejléc nevét, a HTTP státuszkódot, a rendelkezésre álló infrastruktúrát és a fájl helyét tartalmazza. Minden egyes részlet kiküszöböl egy önkényes döntést, amelyet a Codex egyébként helyetted hozna meg – egy döntést, amelyre csak a kódreview során derülne fény.

Munka több fájllal

Egyetlen feladat jogosan spanzolhat több alkalmazásrétegen is, feltéve, hogy felsorolod a szállítandó elemeket.

"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"

A Codex mind a négy fájlt koherensen állítja elő: a szolgáltatás a Prisma modellre támaszkodik, az útvonalak meghívják a szolgáltatást, a tesztek pedig lefedik az útvonalakat. Ezt a függőleges konzisztenciát nehéz elérni, ha a kérést négy külön feladatra bontod, ahol minden lépésnek újra fel kell fedeznie, mit döntött az előző – és néha ellentmond annak.

Tippek az optimális eredményekhez

Először is, ne feledd a meglévő kódra való hivatkozás erejét: a „mint az auth.service.ts-ben“ kifejezés öt szóval közvetít egy mintát, amelyet neked egy oldal leírni. Nevezd meg expliciten a könyvtárakat – „használj Zodot a validáláshoz“ ahelyett, hogy „adj hozzá validálást“ –, és add meg a kimeneti formátumot, amikor számít, például egy egységes { success, data, error } objektumot az egész API-dban. Említsd meg azokat a perem eseteket, amelyek aggasztanak, például: „kezeld azt az esetet, amikor a felhasználó nem létezik“: ha magára hagyod, az ügynök csak a boldog utat (happy path) kezeli, a többit pedig rád hagyja felfedezni. Végül pedig bármit, amit feladatról feladatra ismételsz, az AGENTS.md fájlba érdemes tenni, így rövidebben tarthatod az utasításaidat.

Főbb megállapítások

  • A Codex megérti a kódállományodat és tiszteli a meglévő konvencióidat
  • Hivatkozz meglévő fájlokra a stílus és minták irányításához
  • A részletes specifikációk pontosabb eredményeket hoznak
  • A Codex képes több fájlt létrehozni és módosítani egyetlen feladat keretében
  • Az AGENTS.md állandó szabályokkal egészíti ki az utasításaidat