Codex și Claude Code: ghid practic pentru începători

Ce fac Codex și Claude Code

Cei doi agenți fac același tip de muncă. Diferă producătorul, locurile în care îi folosești și contul de care ai nevoie.

Surse: OpenAI Help Center: Codex cu planul tău ChatGPT; Claude Code: documentația oficială

Cum instalezi fiecare agent

Pentru Codex, drumul cel mai simplu este aplicația ChatGPT pentru calculator, unde Codex stă lângă Chat și Work. Pentru terminal, instalezi Codex CLI cu npm, îl pornești din folderul proiectului și te autentifici cu contul ChatGPT.

Claude Code se instalează cu o comandă pe macOS, Linux și WSL, iar pe Windows folosești comanda pentru PowerShell din documentația oficială. La prima pornire te autentifici cu contul Claude. Dacă nu vrei terminal, deschide claude.ai/code în browser sau tabul Code din aplicația desktop.

# Codex CLI (cere Node.js)
npm install -g @openai/codex
cd proiectul-tau
codex

# Claude Code (macOS, Linux, WSL)
curl -fsSL https://claude.ai/install.sh | bash
cd proiectul-tau
claude

Surse: GitHub: openai/codex, instalarea Codex CLI; Claude Code: documentația oficială

Fișierul cu reguli: ce îi spui agentului o singură dată

Ambii agenți citesc la începutul sesiunii un fișier din proiect cu regulile tale: AGENTS.md pentru Codex, CLAUDE.md pentru Claude Code. Claude Code poate citi și AGENTS.md, așa că poți ține regulile într-un singur loc.

În proiectul afacere.ai, AGENTS.md conține regulile de design (culorile, colțurile rotunjite, tipul de animații permis) și regulile de text (română simplă, fără cifre inventate). Orice agent care lucrează pe site le primește înainte să schimbe ceva. Fără ele, fiecare sesiune ar reinventa stilul. Scheletul de mai jos e un punct de pornire pentru proiectul tău.

# Reguli pentru agenți

## Proiect
Site de prezentare pentru o clinică dentară. Next.js, fără bază de date.

## Înainte și după fiecare modificare
- Citește fișierele pe care le schimbi.
- După modificare, rulează npm run build și testele.

## Stil
- Text în română, la persoana a doua, fără superlative.
- Folosește doar culorile definite în globals.css.

## Nu face
- Nu șterge fișiere fără să întrebi.
- Nu pune date personale ale pacienților în cod sau în exemple.

Surse: Claude Code: instrucțiuni în CLAUDE.md și AGENTS.md

Prima sarcină: mică, verificabilă, pe o ramură separată

Începe cu o schimbare pe care o verifici cu ochii: un buton, un text, o pagină nouă după modelul uneia existente. Cere agentului să explice întâi planul și abia apoi să modifice.

Lucrează pe o ramură separată din git (branch), nu direct pe versiunea publicată. Dacă rezultatul nu e bun, renunți la ramură și nu ai stricat nimic.

Adaugă pe pagina de contact un buton „Sună acum” care deschide apelul către numărul din footer.
Înainte să modifici ceva, spune-mi ce fișiere vei schimba și de ce.
După modificare, rulează build-ul și spune-mi exact ce ai testat.
Nu schimba stilurile altor pagini.

Cum verifici ce a livrat agentul

Un agent poate raporta că a terminat când testele încă pică sau când a rezolvat altă problemă decât cea cerută. Pentru ce ajunge public răspunzi tu, așa că treci prin lista de mai jos la fiecare modificare.

• Citește lista fișierelor modificate. O schimbare mică nu atinge zeci de fișiere.
• Rulează tu build-ul și testele, nu te baza doar pe raportul agentului.
• Deschide pagina pe telefon și pe calculator.
• Caută chei și parole: nu au ce căuta în cod.
• Publică doar după ce ai văzut rezultatul pe o versiune de test (preview).

Când folosești un agent și când ai nevoie de un programator

Agenții de programare sunt potriviți pentru prototipuri, site-uri de prezentare, instrumente interne și automatizări mici. Pentru aplicații care procesează plăți, date medicale sau date personale la scară, ai nevoie de un programator care înțelege securitatea și poate răspunde pentru cod. Agentul îl face mai rapid, nu îl înlocuiește.