Prima dumneavoastră sarcină Codex
Pe această pagină
Actualizat la 3 noiembrie 2026 pe baza referinței de comenzi Codex (CLI 0.166.0): opțiunile
--show-diffși--applynu există. Local, Codex modifică fișierele direct în mediul său izolat (sandbox); revizuiți modificările folosind/diffsaugit diff. Comanda extensiei „Codex: New Task“ a fost înlocuită de Codex: Open Codex Sidebar. Surse: Comenzi pentru dezvoltatori · Extensia IDE Codex.
Lansarea primei dumneavoastră sarcini
Contul dumneavoastră este configurat, GitHub este conectat, iar AGENTS.md este la locul său: a sosit momentul să vedeți agentul în acțiune. Iată o regulă de bază valabilă pentru orice nivel de experiență: începeți cu o sarcină pentru care cunoașteți deja răspunsul corect. Nu veți învăța multe urmărind Codex rezolvând o problemă pe care nu o puteți evalua, dar veți învăța enorm urmărindu-l cum operează pe un teren familiar.
Din Codex Cloud
Pe web sau în aplicația desktop, alegeți Work in › Cloud, selectați mediul publicat pentru repository-ul dumneavoastră (Lecția 2) și tastați sarcina în câmpul de introducere. O formulare deliberat modestă funcționează perfect.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Această formulare include o condiție—„dacă nu există deja“—ceea ce o face exact interesant de observat. În Codex Cloud, sarcina rulează în mediul pe care l-ați publicat pentru acest repository: Codex verifică dacă există un .gitignore, se asigură că acoperă Node.js și TypeScript dacă acesta există, creează sau actualizează fișierul după caz și apoi vă arată rezultatul sub formă de diff. Jurnalul de execuție este transmis în timp real: aici veți vedea dacă agentul a respectat condiția sau dacă a suprascriat fișierul existent.
Din IDE
Deschideți proiectul în VS Code (sau Cursor, Windsurf) și lansați Codex prin intermediul iconiței sale sau din Paleta de Comenzi:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Apoi, formulați o cerere care valorifică contextul local prin numirea fișierului specific:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Extensia afișează un rezumat și liniile modificate alături de cod; păstrați modificările dorite și solicitați follow-up-uri în cadrul aceleiași conversații. Documentația recomandă crearea unui punct de control Git înainte și după sarcină, astfel încât să puteți reveni la starea anterioară dacă este necesar.
Din CLI
# Navigați în directorul proiectului
cd my-project
# Inițiați o sesiune cu o instrucțiune inițială
codex "Add a README.md with the project description, installation instructions, and available commands"
Local, Codex modifică fișierele direct în directorul de lucru, în limitele mediului izolat și ale politicii de aprobare: cere permisiunea înainte de a întreprinde acțiuni care necesită acest lucru. Pentru a revizui ce s-a modificat înainte de a face commit, tastați /diff în sesiune: comanda afișează diff-ul Git, inclusiv fișierele neurmărite. /review cere Codex să revizuiască chiar arborele de lucru. Pentru utilizarea scriptată, codex exec rulează aceeași sarcină fără interacțiune (Lecția 14)—în acest caz, depinde de Git și de pipeline-ul dumneavoastră să decidă ce se păstrează.
Anatomia unui rezultat Codex
Indiferent de punctul de intrare, o sarcină finalizată returnează întotdeauna aceleași patru elemente. Revizuiți-le în această ordine: diff-ul spune ce s-a schimbat, jurnalul spune de ce, testele spun dacă este sigur, iar acțiunile vă redau controlul.
| Element livrat | Conținut |
|---|---|
| Diff al modificărilor | Fiecare linie adăugată, modificată sau ștearsă, fișier cu fișier |
| Jurnal de execuție | Toți pașii: fișiere citite, comenzi rulate, raționamentul agentului |
| Rezultatele testelor | Dacă există teste, Codex le rulează pentru a verifica dacă nimic nu este stricat |
| Acțiuni disponibile | Aprobare, modificare, creare PR sau rerulare cu instrucțiuni diferite |
Începătorii neglijează adesea jurnalul de execuție, deși acesta este elementul care vă învață cum să vă formulați sarcinile. Văzând ce fișiere a deschis Codex înainte de a lua o decizie, descoperiți ce căuta dar nu a putut găsi—adesea o convenție care ar fi trebuit să fie în AGENTS.md.
Scrierea unor instrucțiuni bune
Calitatea rezultatului depinde direct de calitatea instrucțiunilor, iar decalajul dintre cele două formulări de mai jos este mult mai mare decât decalajul dintre două modele.
"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling
with the jose library. Keep the same public interface
(signToken, verifyToken). Update the corresponding tests."
A doua versiune funcționează deoarece răspunde la patru întrebări pe care agentul și le pune oricum. Specifică fișierele implicate, scutindu-l de explorare și țintirea locației greșite. Definește rezultatul așteptat—comportament, interfață, format—astfel încât să știe când să se oprească. Stabilește constrângeri, aici păstrând interfața publică, ceea ce îl împiedică să „îmbunătățească“ lucrurile stricând apelatorii; în alte contexte, aceasta ar putea fi „nu strica testele“. Iar atunci când miza justifică, adaugă context de afaceri: specificarea „acesta este un formular de plată, securitatea este critică“ îi schimbă efectiv compromisurile.
Pentru a face acest lucru al dumneavoastră, luați un proiect existent și înlănțuiți trei sarcini de naturi diferite: o analiză fără modificare, „Listați toate fișierele TypeScript care nu au teste asociate“; o generare țintită, „Generați un test unitar pentru acest fișier“; o remediere cu scop limitat, „Remediați avertismentele ESLint în src/utils/“. Pentru fiecare, notați ce ar fi trebuit să specificați de la început: această listă de regrete constituie prima dumneavoastră schiță de AGENTS.md.
Puncte cheie
- Lansați primele dumneavoastră sarcini cu cereri simple și țintite
- Codex oferă un jurnal de execuție complet pentru fiecare sarcină
- Calitatea rezultatului depinde de precizia instrucțiunilor dumneavoastră
- Păstrați întotdeauna controlul: aprobați, modificați sau respingeți
- Începeți cu sarcini cu risc redus înainte de a trece la modificări critice