Tvoj prvi zadatak u Codexu
Na ovoj stranici
Ažurirano 3. studenog 2026. na temelju referencije za Codex naredbe (CLI 0.166.0): opcije
--show-diffi--applyne postoje. Lokalno, Codex izravno modificira datoteke unutar svog sandboxa; promjene pregledavaj pomoću/diffiligit diff. Naredba proširenja “Codex: New Task” zamijenjena je s Codex: Open Codex Sidebar. Izvori: Developer commands · Codex IDE extension.
Pokreni svoj prvi zadatak
Tvoj račun je postavljen, GitHub povezan, a AGENTS.md na mjestu: vrijeme je da vidiš agenta na djelu. Evo pravila za sve razine vještine—započni sa zadatkom za koji već znaš točan odgovor. Nećeš puno naučiti gledajući kako Codex rješava problem koji ne možeš evaluirati, ali ćeš naučiti ogromnu količinu promatrajući kako radi na poznatom terenu.
Iz Codex Clouda
Na webu ili u desktop aplikaciji odaberi Work in › Cloud, odaberi objavljeno okruženje za svoj repozitorij (Lekcija 2) i upiši svoj zadatak u polje za unos. Nešto namjerno skromno savršeno će funkcionirati.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Ova formulacija uključuje uvjet—“if one doesn’t already exist”—što je upravo ono što je zanimljivo za promatrati. U Codex Cloudu, zadatak se izvršava u okruženju koje si objavio za ovaj repozitorij: Codex provjerava postoji li .gitignore, potvrđuje pokriva li Node.js i TypeScript ako postoji, stvara ili ažurira datoteku po potrebi, a zatim ti prikazuje rezultat kao diff. Dnevnik izvršavanja struji u stvarnom vremenu: ovdje ćeš vidjeti je li agent poštovao uvjet ili prepisao tvoju postojeću datoteku.
Iz IDE-a
Otvori svoj projekt u VS Codeu (ili Cursoru, Windsurfu) i pokreni Codex putem njegove ikone ili Palete naredbi:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Zatim formuliraj zahtjev koji iskorištava lokalni kontekst imenovanjem specifične datoteke:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Proširenje prikazuje sažetak i modificirane retke uz kod; zadržavaš promjene koje želiš i tražiš daljnje korake unutar istog razgovora. Dokumentacija preporučuje stvaranje Git kontrolne točke prije i nakon zadatka kako bi se mogao vratiti unatrag ako je potrebno.
Iz CLI-ja
# Navigate to the project directory
cd my-project
# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"
Lokalno, Codex izravno modificira datoteke u tvom radnom direktoriju, unutar ograničenja sandboxa i politike odobravanja: traži dopuštenje prije poduzimanja radnji koje to zahtijevaju. Da pregledaš što se promijenilo prije commita, upiši /diff u sesiji: naredba prikazuje Git diff, uključujući nepraćene datoteke. /review traži od Codexa da pregleda tvoje radno stablo. Za skriptiranu upotrebu, codex exec pokreće isti zadatak bez interakcije (Lekcija 14)—u tom slučaju, na Gitu i tvom pipelineu je da odluče što se zadržava.
Anatomija Codex rezultata
Bez obzira na ulaznu točku, dovršeni zadatak uvijek vraća ista četiri elementa. Pregledaj ih ovim redoslijedom: diff govori što se promijenilo, dnevnik govori zašto, testovi govore je li sigurno, a radnje ti vraćaju kontrolu.
| Isporučeni element | Što sadrži |
|---|---|
| Diff promjena | Svaki dodani, modificirani ili izbrisani redak, datoteka po datoteka |
| Dnevnik izvršavanja | Svi koraci: pročitane datoteke, pokrenute naredbe, rezoniranje agenta |
| Rezultati testova | Ako testovi postoje, Codex ih pokreće kako bi provjerio da ništa nije slomljeno |
| Dostupne radnje | Odobri, modificiraj, stvori PR ili ponovno pokreni s drugačijim uputama |
Početnici često zanemaruju dnevnik izvršavanja, a ipak je to element koji te uči kako formulirati svoje zadatke. Gledajući koje je datoteke Codex otvorio prije donošenja odluke, otkrivaš što je tražio, a nije mogao pronaći—često konvenciju koja je trebala biti u AGENTS.md.
Pisanje dobrih uputa
Kvaliteta rezultata izravno ovisi o kvaliteti uputa, a jaz između dviju donjih formulacija daleko je veći od jaza između dva modela.
"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."
Druga verzija funkcionira jer odgovara na četiri pitanja koja si agent ionako postavlja. Specificira uključene datoteke, štedeći ga od istraživanja i ciljanja pogrešne lokacije. Definira očekivani ishod—ponašanje, sučelje, format—pa zna kada stati. Postavlja ograničenja, ovdje očuvanje javnog sučelja, što ga sprječava da “poboljšava” stvari kvaranjem pozivatelja; drugdje bi to moglo biti “ne kvar testove”. A kada ulog to opravdava, dodaje poslovni kontekst: specificiranje “ovo je obrazac za plaćanje, sigurnost je kritična” doista mijenja njegove kompromise.
Da to učiniš svojim, uzmi postojeći projekt i poveži tri zadatka različite prirode: analizu bez modifikacije, “Navedi sve TypeScript datoteke koje nemaju pridružene testove”; ciljano generiranje, “Generiraj jedinični test za ovu datoteku”; popravak ograničenog opsega, “Popravi ESLint upozorenja u src/utils/”. Za svaki zapiši što si trebao specificirati unaprijed: taj popis žaljenja tvoj je prvi nacrt AGENTS.md.
Ključne točke
- Pokreni svoje prve zadatke s jednostavnim, ciljanim zahtjevima
- Codex pruža kompletan dnevnik izvršavanja za svaki zadatak
- Kvaliteta rezultata ovisi o preciznosti tvojih uputa
- Uvijek zadržavaš kontrolu: odobri, modificiraj ili odbaci
- Započni sa zadacima niskog rizika prije prelaska na kritične promjene