Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Psaní kódu s Codexem

Lekce 5 z 20 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Od nápadu ke kódu v jednom příkazu
  2. Vytváření nového souboru nebo modulu
  3. Přidávání funkcí do stávajícího kódu
  4. Generování kódu ze specifikace
  5. Práce s více soubory
  6. Tipy pro optimální výsledky
  7. Klíčové poznatky

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