OpenAI Codex: ghid pas cu pas cu 3 exemple practice

Pe scurt

• OpenAI Codex este un agent de inginerie software în cloud disponibil în ChatGPT (planurile Plus, Pro, Team și Enterprise)

• Conectează Codex la un repo GitHub, apoi atribuie-i sarcini: repararea bugurilor, aplicarea de patch-uri, generarea de teste sau explicarea codului

• Fiecare sarcină rulează într-un sandbox izolat; Codex deschide un pull request pe care îl revizuiești înainte de a-l face merge

• Folosește un fișier AGENTS.md pentru a defini convențiile de cod pe care Codex le va respecta la fiecare sarcină

• Codex rulează și în terminal prin Codex CLI și ca extensie pentru VS Code

Ce este Codex de la OpenAI?

OpenAI Codex este un agent de inginerie software în cloud care poate scrie și edita cod, rula teste, repara buguri și chiar propune pull request-uri. Fiecare sarcină este executată în propriul mediu sandbox.

Codex este alimentat de cele mai noi modele frontieră ale OpenAI și este construit pentru siguranță, testabilitate și productivitate pentru dezvoltatori. Îl poți ghida folosind fișiere AGENTS.md sau poți interacționa direct cu el în bara laterală a ChatGPT.

Cu Codex CLI, poți aduce aceste capabilități direct în terminal.

Opțiuni de acces la Codex dintr-o privire:

Configurarea Codex de la OpenAI

Configurarea Codex durează doar câteva minute. Iată un ghid pas cu pas ca să începi.

Pasul 1: Găsirea instrumentului Codex

Începe prin a te autentifica în ChatGPT. Caută Codex în bara de instrumente din stânga. La lansare, Codex a fost disponibil pentru utilizatorii ChatGPT Pro, Business și Enterprise. Acum este inclus în toate planurile (deși accesul pentru Free și Go este foarte limitat).

Pasul 2: Începutul cu Codex

Dă clic pe Codex și vei fi dus într-o altă filă pentru configurarea inițială. Dă clic pe „Get Started” și urmează procedura de autentificare arătată în pasul următor.

Pasul 3: Autentificare multi-factor

Dă clic pe „Set up MFA to continue” și scanează codul QR folosind aplicația ta preferată de autentificare (cum ar fi Google Authenticator sau Authy). Introdu codul pentru verificare și ai terminat!

Pasul 4: Conectează-te la GitHub

După ce finalizezi autentificarea multi-factor, conectează Codex la GitHub.

Pasul 4.1: Autorizează conectorul GitHub

„Connect to GitHub” te va duce la un pop-up pentru a autoriza conectorul GitHub. Citește detaliile din pop-up și autorizează.

Pasul 4.2: Adaugă-ți contul GitHub

După ce GitHub este conectat, trebuie să adăugăm contul. În fila organizației GitHub, selectează „Add a GitHub account”. 

Vei ajunge într-un alt pop-up pentru „Install and Authorize”. Dă clic pentru a autoriza, iar toate repository-urile tale vor apărea în interfața ChatGPT. Poți autoriza și doar anumite repository-uri.

Pasul 4.3: Crearea unui mediu

Alege repository-ul pe care vrei să lucrezi și dă clic pe „Create environment”.

Vei ajunge la „Data Controls”. Codex este încă în dezvoltare activă și e posibil să vezi un prompt opțional pentru a permite folosirea datelor tale la îmbunătățirea modelului. Poți dezactiva această opțiune și continua.

Acum mediul tău e gata de explorat. Codex îți permite să pornești sarcini în paralel cu taskuri preselectate.

Pur și simplu dă clic pe „Start tasks” sau alege sarcinile în funcție de nevoile tale. Vei fi dus la o interfață unde poți pune întrebări sau îi poți cere agentului să îți scrie o funcționalitate.

Când toate sarcinile sunt pregătite, selectează pe cea la care vrei să lucrezi sau lucrează în paralel la mai multe.

Pasul 5: fișierul AGENTS.md (opțional)

Fișierul AGENTS.md este un fișier special de configurare introdus de OpenAI pentru platforma Codex, conceput pentru a-i ghida pe agenții AI în timp ce lucrează în codul tău. Gândește-te la el ca la un manual pentru coechipierii AI, similar cu un README.md, dar axat pe instrucțiuni pentru agenți autonomi. Iată un exemplu de fișier AGENTS.md:

# AGENTS.md

## Code Style
- Use Black for Python formatting.
- Avoid abbreviations in variable names.

## Testing
- Run pytest tests/ before finalizing a PR.
- All commits must pass lint checks via flake8.

## PR Instructions
- Title format: [Fix] Short description
- Include a one-line summary and a "Testing Done" section

Când Codex rulează o sarcină în codul tău, acesta:

• Caută fișiere AGENTS.md al căror scop include fișierul(ele) pe care le modifică.
• Aplică instrucțiunile din acele fișiere pentru a formata, testa și documenta schimbările.
• Prioritizează instrucțiunile mai adânc imbricate când se aplică mai multe fișiere (ca într-o configurație în cascadă).

Pentru o privire mai amplă asupra construirii de sisteme care acționează prin instrumente și API-uri, vezi tutorialul OpenAI Agents SDK.

OpenAI Codex: trei exemple practice

Hai să vedem cum te poate ajuta Codex în dezvoltarea de zi cu zi folosind trei exemple pe care le-am rulat pe un repository.

Exemplul 1: Remedieri de bază și typo-uri

Uneori, Codex împarte o cerere într-un set de subtasks, cum ar fi corectarea typo-urilor, îmbunătățirea unui README sau scrierea de teste, totul în același workspace.

Poți porni o sarcină nouă în cadrul uneia existente pe baza revizuirii inițiale, poți cere modificări ale codului existent sau poți pune întrebări în caseta de text. Pentru a extinde sarcina sau a repara ceva nou, dă clic pe „Code” și pornește direct un subtask nou.

Când ești mulțumit de modificări, dă clic pe „Push”, ceea ce va crea un pull request nou. După câteva secunde, poți da clic pe „View Pull Request” pentru a accesa pull request-ul și a-l face merge în branch-ul principal.

Exemplul 2: Explicarea codebase-ului

Apoi am folosit Codex pentru o sarcină fără editare: explorarea codebase-ului și întrebarea „ce pot face în continuare?”. Este util mai ales dacă ești nou într-un proiect, încerci să te integrezi rapid sau te-ai blocat încercând să înțelegi cum funcționează o anumită funcție.

Codex a navigat proiectul și a oferit o prezentare clară, prietenoasă pentru începători, a structurii codebase-ului. În loc să listeze doar fișierele, Codex le-a grupat după scop:

• A evidențiat că qwen3_demo.py este scriptul principal, care lansează două interfețe bazate pe Gradio — una pentru comutarea modului de reasoning și alta pentru traducere multilingvă.
• A identificat qwen3_demo.ipynb ca alternativă interactivă tip notebook.
• A indicat test_qwen3_demo.py pentru teste unitare și README.md pentru documentație și walkthrough-uri video.

În plus, Codex a listat și „Puncte cheie de știut”, precum dependențe (Ollama CLI), rolul funcției _run_ollama și sugestii pentru extinderea interfeței. A propus chiar și pași următori, cum ar fi explorarea versionării modelului, îmbunătățirea UI și adăugarea de tratare a erorilor.

Exemplul 3: Găsește și repară un bug

Codex poate scana întregul codebase, identifica un bug, propune un fix și îți poate arăta o previzualizare a modificărilor. Acest proces seamănă cu revizuirile de modificări de cod pe GitHub.

Poți revizui jurnalele pentru a înțelege procesul din spate al modificărilor făcute dând clic pe „Logs”.

Codex returnează un rezumat al modificărilor făcute, împreună cu fișierele create sau afectate. Poți pune întrebări despre schimbări sau îi poți cere lui Codex să scrie cod nou pentru a îmbunătăți implementarea curentă.

Când ești mulțumit de remedierea codului, dă clic pe „Push” și „Create New PR” pentru a deschide un pull request nou.

După câteva secunde, poți da clic pe „View Pull Request” pentru a accesa pull request-ul și a-l face merge în principal.

Codex face posibil merge-ul modificărilor în doar câteva clicuri.

Modificările apar pe branch-ul principal în câteva secunde.

De ce este important Codex?

Codex este un agent colaborativ, nu un generator pasiv de cod. Îi poți cere să scrie, să refactoreze, să testeze, să depaneze sau să explice, iar el îți va arăta jurnalele din terminal, citările și rezultatele pentru fiecare pas.

Iată câteva beneficii din lumea reală pe care le-am observat:

• Sarcinile sunt trasabile și verificabile.
• Codex lucrează în paralel, astfel încât poți pune în coadă mai multe schimbări.
• Respectă setup-ul tău de dezvoltare, mai ales dacă ai configurat convenții printr-un fișier AGENTS.md.
• Se aliniază cu standardele umane pentru PR-uri și poate trece testele CI.

Pentru mine, pare că OpenAI tocmai a lansat un intern de inginerie software.

Gânduri finale

Am învățat cum Codex poate repara buguri, aplica patch-uri de funcționalitate și explica logica unui cod, în timp ce generează pull request-uri, rulează teste și își citează acțiunile prin jurnale de terminal și diff-uri.

Acest walkthrough practic ilustrează cum Codex îți poate îmbunătăți fluxul de lucru zilnic, fie că depanezi cod legacy, te integrezi într-un repo nou sau triajzi sarcini de mentenanță.

Pe măsură ce Codex evoluează, mă aștept la integrări mai profunde cu IDE-urile, pipeline-urile CI și planificatoarele de sarcini, făcându-l o adiție practică pentru orice flux de lucru de inginerie. Pentru a afla mai multe despre Codex, citește postarea oficială de lansare și găsești și exemple de utilizare pe canalul YouTube al OpenAI.

Pentru a intra mai adânc în modelele și instrumentele OpenAI axate pe inginerie, îți recomand aceste bloguri:

• Tutorial OpenAI Codex CLI
• Ghid GPT-5.1 Codex: Construirea unui agent de analiză a problemelor GitHub
• Codex CLI pentru automatizarea fluxurilor de date: un ghid complet
• Tutorial Codex CLI MCP: Construirea unui agent pentru un dashboard de portofoliu