Psaní kódu s Codexem
Na této stránce
Od nápadu ke kódu v jednom příkazu
Psaní kódu je úkol, který budeš Codexu zadávat nejčastěji, a právě zde je rozdíl mezi Codexem a obyčejným generátorem úryvků nejzřetelnější. Agent nevytvoří jen izolovaný fragment kódu, který musíš následně upravovat. Místo toho si přečte tvou kódovou základnu, odvodí tvé konvence a napíše něco, co bezproblémově zapadne do tvé stávající architektury. Tvým úkolem je proto méně popisovat kód a více popisovat místo v rámci systému.
Vytváření nového souboru nebo modulu
Při generování zcela nového kódu záleží na přesnosti stejně u kontextu jako u očekávané funkcionality.
"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 si přečte auth.service.ts, aby pochopil aktuální vzor, analyzuje importy a závislosti projektu, vytvoří soubor se stejnou strukturou, přidá vhodné typy TypeScriptu a exportuje funkce v souladu s konvencemi projektu. Výsledek vypadá takto:
// 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
}
Jeden detail si zaslouží pozornost: nikdo nepožádal o validaci pomocí Zod. Codex ji přidal, protože zjistil, že projekt používá Zod všude jinde. Proto se vyplácí odkazovat na modelový soubor – desetislovná fráze ti ušetří celý odstavec specifikací.
Přidávání funkcí do stávajícího kódu
Agenti přinášejí největší hodnotu právě na stávajícím kódu, a to ne proto, že by bylo těžké napsat řádky, ale protože je náročné respektovat vše, co je kolem nich.
"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 analyzuje sousední routy, identifikuje skutečně používaný middleware, zaznamená aktuální formát odpovědi a poté konzistentně přidá endpoint. Tato průzkumná práce by ti zabrala mnohem více času než samotné kódování a je to přesně ta část, na které lidé ve spěchu šetří.
Generování kódu ze specifikace
U složitých funkcí se posuň o úroveň výše a napiš řádnou specifikaci. Každý bod se stane požadavkem, který agent bere jako takový.
"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"
Tato specifikace poskytuje číselné hodnoty, název hlavičky, stavový kód HTTP, dostupnou infrastrukturu a umístění souboru. Každý detail odstraňuje libovolné rozhodnutí, které by jinak Codex učinil za tebe – rozhodnutí, které bys objevil až během code review.
Práce s více soubory
Jediný úkol může oprávněně zasahovat do více vrstev aplikace, pokud vyjmenuješ výstupy.
"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 vytvoří všechny čtyři soubory soudržně: služba spoléhá na Prisma model, routy volají službu a testy pokrývají routy. Dosáhnout této vertikální konzistence je obtížné, pokud rozdělíš požadavek na čtyři samostatné úkoly, kde musí každý krok znovu objevovat, co rozhodl ten předchozí – a někdy tomu i odporovat.
Tipy pro optimální výsledky
Nejprve si pamatuj sílu odkazování na existující kód: „jako v auth.service.ts“ sdělí v pěti slovech vzor, jehož popis by ti zabral celou stránku. Knihovny pojmenovávej explicitně – „použij Zod pro validaci“ místo „přidej validaci“ – a specifikuj výstupní formát, když na něm záleží, například jednotný objekt { success, data, error } napříč celým tvým API. Zmiň hraniční případy, které tě trápí, jako „ošetři případ, kdy uživatel neexistuje“: pokud agenta necháš napospas, ošetří jen šťastnou cestu (happy path) a zbytek nechá na tobě. Nakonec, cokoli opakuješ z úkolu na úkol, patří do souboru AGENTS.md, čímž udržíš své pokyny stručné.
Klíčové poznatky
- Codex chápe tvou kódovou základnu a respektuje tvé stávající konvence
- Odkazuj na existující soubory pro vedení stylu a vzorů
- Podrobné specifikace přinášejí přesnější výsledky
- Codex dokáže vytvořit a upravit více souborů v rámci jednoho úkolu
- AGENTS.md doplňuje tvé pokyny o trvalá pravidla