Salt la conținutul principal
Română— Alege o limbă
Meniu

Scrierea codului cu Codex

Lecția 5 din 20 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. De la idee la cod într-o singură instrucțiune
  2. Crearea unui fișier sau modul nou
  3. Adăugarea de funcționalități în codul existent
  4. Generarea codului dintr-o specificație
  5. Lucrul cu mai multe fișiere
  6. Sfaturi pentru rezultate optime
  7. Puncte cheie

De la idee la cod într-o singură instrucțiune

Scrierea codului este sarcina pe care o veți atribui cel mai adesea lui Codex și este domeniul în care diferența dintre Codex și un simplu generator de fragmente de cod devine cea mai evidentă. Agentul nu produce doar un fragment de cod izolat pe care trebuie apoi să îl adaptați. În schimb, el citește baza de cod, deduce convențiile dumneavoastră și scrie ceva care se integrează perfect în arhitectura existentă. Sarcina dumneavoastră este, prin urmare, mai puțin despre descrierea codului și mai mult despre descrierea unui loc într-un sistem.

Crearea unui fișier sau modul nou

Atunci când generați cod complet nou, precizia contează la fel de mult pentru context pe cât contează pentru funcționalitatea așteptată.

"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 citește auth.service.ts pentru a înțelege modelul curent, analizează importurile și dependențele proiectului, creează fișierul cu aceeași structură, adaugă tipurile TypeScript corespunzătoare și exportă funcțiile conform convențiilor proiectului. Rezultatul arată astfel:

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

Un detaliu merită atenție: nimeni nu a cerut validarea Zod. Codex a adăugat-o pentru că a observat că proiectul folosește Zod peste tot. De aceea, referirea la un fișier model este benefică – o frază de zece cuvinte vă scutește de un întreg paragraf de specificații.

Adăugarea de funcționalități în codul existent

Agenții oferă cea mai mare valoare pe codul existent, nu pentru că scrierea liniilor este dificilă, ci pentru că respectarea a tot ceea ce le înconjoară este.

"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 analizează rutele învecinate, identifică middleware-ul efectiv utilizat, notează formatul curent al răspunsului și apoi adaugă endpoint-ul în mod coerent. Această muncă de recunoaștere v-ar lua mult mai mult timp decât codarea propriu-zisă și este exact partea pe care oamenii o neglijează atunci când sunt grăbiți.

Generarea codului dintr-o specificație

Pentru funcționalități complexe, ridicați nivelul și scrieți o specificație adecvată. Fiecare punct devine o cerință pe care agentul o tratează ca atare.

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

Această specificație oferă valori numerice, numele antetului, codul de stare HTTP, infrastructura disponibilă și locația fișierului. Fiecare detaliu elimină o decizie arbitrară pe care Codex ar fi luat-o în locul dumneavoastră – o decizie pe care ați fi descoperit-o abia în timpul revizuirii codului.

Lucrul cu mai multe fișiere

O singură sarcină poate legitima să cuprindă mai multe straturi ale aplicației, cu condiția să enumerați livrabilele.

"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 produce toate cele patru fișiere în mod coerent: serviciul se bazează pe modelul Prisma, rutele apelează serviciul, iar testele acoperă rutele. Obținerea acestei consistențe verticale este dificilă dacă descompuneți cererea în patru sarcini separate, unde fiecare pas trebuie să redescopere ceea ce a decis cel anterior – și uneori să contrazică acel lucru.

Sfaturi pentru rezultate optime

În primul rând, amintiți-vă puterea referirii la codul existent: „ca în auth.service.ts“ transmite în cinci cuvinte un model pe care v-ar lua o pagină să îl descrieți. Numiți bibliotecile în mod explicit – „folosiți Zod pentru validare“ în loc de „adăugați validare“ – și specificați formatul de ieșire atunci când contează, cum ar fi un obiect uniform { success, data, error } în întreaga dumneavoastră API. Menționați cazurile limită care vă preocupă, cum ar fi „gestionați cazul în care utilizatorul nu există“: lăsat pe seama propriilor dispozitive, agentul gestionează scenariul ideal și vă lasă să descoperiți restul. În final, orice repetați de la o sarcină la alta aparține în AGENTS.md, menținând instrucțiunile dumneavoastră scurte.

Puncte cheie

  • Codex înțelege baza dumneavoastră de cod și respectă convențiile existente
  • Referențiați fișierele existente pentru a ghida stilul și modelele
  • Specificațiile detaliate produc rezultate mai precise
  • Codex poate crea și modifica mai multe fișiere într-o singură sarcină
  • AGENTS.md completează instrucțiunile dumneavoastră cu reguli permanente