Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Vaša prva naloga v Codexu

Lekcija 4 od 20 Posodobljeno 3. november 2026 Razvijalec
Na tej strani
  1. Zaženite svojo prvo nalogo
  2. Iz oblaka Codex (Codex Cloud)
  3. Iz razvojnega okolja (IDE)
  4. Iz ukazne vrstice (CLI)
  5. Anatomija rezultata Codex
  6. Pisanje dobrih navodil
  7. Ključne ugotovitve

Posodobljeno 3. novembra 2026 na podlagi referenčnega priročnika za ukaze Codex (CLI 0.166.0): možnosti --show-diff in --apply ne obstajata. Lokalno Codex spreminja datoteke neposredno znotraj svojega peskovnika; spremembe pregledate z ukazom /diff ali git diff. Ukaz razširitve „Codex: New Task” je bil nadomeščen z ukazom Codex: Open Codex Sidebar. Viri: Ukazi za razvijalce · Razširitev Codex IDE.

Vaš račun je nastavljen, GitHub povezan in datoteka AGENTS.md na mestu: čas je, da agenta vidite v akciji. Tukaj je zlato pravilo za vse ravni znanja – začnite z nalogo, kjer že poznate pravilen odgovor. Ne boste se veliko naučili, če boste gledali, kako Codex rešuje problem, ki ga ne znate ovrednotiti, naučili se boste pa ogromno, če boste opazovali njegovo delovanje na znanem terenu.

Iz oblaka Codex (Codex Cloud)

Na spletu ali v namizni aplikaciji izberite Work in › Cloud, izberite objavljeno okolje za svoje skladišče (2. lekcija) in v vnosno polje vnesite svojo nalogo. Nekaj namerno skromnega deluje popolnoma dobro.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Ta formulacija vključuje pogoj – „if one doesn’t already exist” (če še ne obstaja) – kar je ravno tisto, zaradi česar je opazovanje zanimivo. V oblaku Codex se naloga izvrši v okolju, ki ste ga objavili za to skladišče: Codex preveri, ali .gitignore obstaja, preveri, ali pokriva Node.js in TypeScript, če obstaja, po potrebi ustvari ali posodobi datoteko in vam nato prikaže rezultat kot razliko (diff). Dnevnik izvrševanja se pretaka v realnem času: tukaj boste videli, ali je agent upošteval pogoj ali prepisal vašo obstoječo datoteko.

Iz razvojnega okolja (IDE)

Odprite svoj projekt v VS Code (ali Cursor, Windsurf) in zaženite Codex prek njegove ikone ali palet ukazov:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Nato oblikujte zahtevo, ki izkorišča lokalni kontekst z imenovanjem specifične datoteke:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Razširitev prikaže povzetek in spremenjene vrstice ob kodi; obdržite spremembe, ki jih želite, in v istem pogovoru zahtevajte nadaljnje korake. Dokumentacija priporoča ustvarjanje kontrolne točke Git pred nalogo in po njej, da se lahko po potrebi vrnete nazaj.

Iz ukazne vrstice (CLI)

# 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 spreminja datoteke neposredno v vašem delovnem imeniku, znotraj omejitev peskovnika in pravilnika odobritve: pred dejanji, ki to zahtevajo, zaprosi za dovoljenje. Če želite pred potrditvijo pregledati spremembe, v seji vnesite /diff: ukaz prikaže razliko Git, vključno z nesledenimi datotekami. Ukaz /review pozove Codex, naj pregleda vaše delovno drevo samo. Za skriptno uporabo codex exec zažene isto nalogo brez interakcije (14. lekcija) – v tem primeru je na Gitu in vašem cevovodu, da odločita, kaj se obdrži.

Anatomija rezultata Codex

Ne glede na vstopno točko končana naloga vedno vrne iste štiri elemente. Preglejte jih v tem vrstnem redu: razlika pove, kaj se je spremenilo, dnevnik pove zakaj, testi povejo, ali je varno, in dejanja vam vrnejo nadzor.

Dostavljeni elementKaj vsebuje
Razlika sprememb (Change diff)Vsaka dodana, spremenjena ali izbrisana vrstica, datoteka za datoteko
Dnevnik izvrševanjaVsi koraki: prebrane datoteke, zagnani ukazi, razlogovanje agenta
Rezultati testovČe testi obstajajo, jih Codex zažene, da preveri, ali ni ničesar pokvarjenega
Razpoložljiva dejanjaOdobri, spremeni, ustvari PR ali ponovno zaženi z drugačnimi navodili

Začetniki pogosto zanemarijo dnevnik izvrševanja, čeprav je to element, ki vas nauči, kako oblikovati svoje naloge. Ko vidite, katere datoteke je Codex odprl pred sprejetjem odločitve, odkrijete, kaj je iskal, a ni našel – pogosto gre za konvencijo, ki bi morala biti v AGENTS.md.

Pisanje dobrih navodil

Kakovost rezultata je neposredno odvisna od kakovosti navodil, razlika med spodnjima dvema formulacijama pa je veliko večja kot razlika med dvema modeloma.

"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 različica deluje, ker odgovarja na štiri vprašanja, ki si jih agent tako ali tako zastavi. Določi vključene datoteke in ga tako reši raziskovanja in ciljanja napačne lokacije. Opredeli pričakovani izid – vedenje, vmesnik, format – tako da ve, kdaj nehati. Določi omejitve, tukaj ohranjanje javnega vmesnika, kar prepreči, da bi stvari „izboljšal” z lomljenjem klicev; drugje bi to lahko bilo „ne lomi testov”. In ko so vložki dovolj veliki, doda poslovni kontekst: navedba „to je obrazec za plačilo, varnost je kritična” dejansko spremeni njegove kompromise.

Da to prilagodite sebi, vzemite obstoječi projekt in povežite tri naloge različne narave: analizo brez sprememb („List all TypeScript files that lack associated tests”), ciljno generiranje („Generate a unit test for this file”) in popravilo omejenega obsega („Fix ESLint warnings in src/utils/”). Za vsako zapišite, kaj bi morali določiti vnaprej: ta seznam obžalovanj je vaš prvi osnutek za AGENTS.md.

Ključne ugotovitve

  • Svoje prve naloge zaženite s preprostimi, ciljnimi zahtevami
  • Codex zagotavlja popoln dnevnik izvrševanja za vsako nalogo
  • Kakovost rezultata je odvisna od natančnosti vaših navodil
  • Vedno ohranjate nadzor: odobrite, spremenite ali zavrnite
  • Začnite z nalogami z nizkim tveganjem, preden preidete na kritične spremembe