Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Sinu esimene Codexi ülesanne

Õppetund 4 / 20 Värskendatud 3. november 2026 Arendajatele
Sellel lehel
  1. Käivita oma esimene ülesanne
  2. Codex Cloudi kaudu
  3. IDE kaudu
  4. Käsurea (CLI) kaudu
  5. Codexi tulemuse anatoomia
  6. Heade juhendite kirjutamine
  7. Peamised punktid

Uuendatud 3. novembril 2026, lähtudes Codexi käsurea viitest (CLI 0.166.0): valikud --show-diff ja --apply ei eksisteeri. Kohalikult muudab Codex faile otse oma liivakastis; vaata muudatusi üle käsuga /diff või git diff. Laiendi käsk „Codex: New Task“ on asendatud käsuga Codex: Open Codex Sidebar. Allikad: Arendaja käsud · Codexi IDE laiend.

Käivita oma esimene ülesanne

Sinu konto on seadistatud, GitHub on ühendatud ja AGENTS.md on olemas: on aeg näha agentit tegevuses. Siin on kuldreegel igale oskustasemele – alusta ülesandest, mille õiget vastust sa juba tead. Sa ei õpi palju, vaadates, kuidas Codex lahendab probleemi, mida sa hinnata ei oska, kuid õpid tohutult, jälgides selle tegutsemist tuttavatel radadel.

Codex Cloudi kaudu

Veebis või töölauarakenduses vali Work in › Cloud, vali oma hoidla jaoks avaldatud keskkond (2. õppetund) ja sisesta oma ülesanne sisendväljale. Mida tagasihoidlikum, seda parem.

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

See sõnastus sisaldab tingimust – „kui seda veel ei eksisteeri“ – mis teebki selle vaatlemise huvitavaks. Codex Cloudis jookseb ülesanne keskkonnas, mille selle hoidla jaoks avaldasid: Codex kontrollib, kas .gitignore on olemas, veendub, et see hõlmab Node.js-i ja TypeScripti (kui fail on olemas), loob või uuendab faili vastavalt vajadusele ning näitab tulemust diffina. Täitmise logi voogab reaalajas: just siit näed, kas agent järgis tingimust või kirjutas su olemasoleva faili üle.

IDE kaudu

Ava oma projekt VS Code’is (või Cursoris, Windsurfis) ja käivita Codex selle ikooni või käsupaleti kaudu:

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

Seejärel formuleeri päring, mis kasutab kohalikku konteksti, nimetades konkreetset faili:

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

Laiend kuvab kokkuvõtte ja muudetud read koodi kõrval; sa säilitad soovitud muudatused ja küsid järelküsimusi samas vestluses. Dokumentatsioon soovitab enne ja pärast ülesannet luua Giti kontrollpunkti, et vajadusel saaksid tehtu tagasi pöörata.

Käsurea (CLI) kaudu

# Liigu projekti kataloogi
cd my-project

# Alusta sessiooni esialgse juhendiga
codex "Add a README.md with the project description, installation instructions, and available commands"

Kohalikult muudab Codex faile otse sinu töökataloogis, jäädes liivakasti ja heakskiidupoliitika piiridesse: see küsib luba enne toiminguid, mis seda nõuavad. Enne kommitimist muudatuste ülevaatamiseks sisesta sessioonis /diff: käsk kuvab Giti diffi, kaasates jälgimatud failid. /review palub Codexil üle vaadata sinu tööpuu ise. Skriptitud kasutuseks käivitab codex exec sama ülesande ilma interaktsioonita (14. õppetund) – sel juhul otsustavad Git ja sinu torustik, mis alles jääb.

Codexi tulemuse anatoomia

Sõltumata sisendpunktist tagastab lõpetatud ülesanne alati need neli elementi. Vaata need üle selles järjekorras: diff ütleb, mis muutus, logi ütleb, miks, testid ütlevad, kas see on ohutu, ja tegevused annavad kontrolli sulle tagasi.

Edastatud elementMida see sisaldab
Muudatuste diffIga lisatud, muudetud või kustutatud rida, failide kaupa
Täitmise logiKõik sammud: loetud failid, käivitatud käsud, agendi arutluskäik
Testi tulemusedKui teste on olemas, käivitab Codex need, et veenduda, et midagi ei ole katki
Saadaolevad tegevusedHeaks kiita, muuta, luua PR või käivitada uuesti erinevate juhenditega

Algajad jätavad sageli täitmise logi tähelepanuta, ometi on see element, mis õpetab sind oma ülesandeid formuleerima. Nähes, milliseid faile Codex enne otsuse tegemist avas, saad teada, mida see otsis, kuid ei leidnud – sageli on tegu konventsiooniga, mis oleks pidanud olema failis AGENTS.md.

Heade juhendite kirjutamine

Tulemuse kvaliteet sõltub otseselt juhendite kvaliteedist ja lõhe allpool toodud kahe sõnastuse vahel on palju suurem kui lõhe kahe mudeli vahel.

"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."

Teine versioon toimib, sest see vastab neljale küsimusele, mille agent niigi endale esitab. See täpsustab kaasatud faile, säästes seda uurimast ja valesse kohta sihtimast. See määratleb oodatava tulemuse – käitumise, liidese, vormingu –, et teada, millal lõpetada. See seab piirangud, siin avaliku liidese säilitamise, mis takistab sellel asju „parandada“, rikkudes kutsujaid; mujal võib see olla „ära riku teste“. Ja kui panused seda õigustavad, lisab see ärikonteksti: täpsustamine „see on maksevorm, turvalisus on kriitiline“ muudab tõeliselt selle kompromisse.

Et seda omaks teha, võta olemasolev projekt ja ahelda kokku kolm erinevat laadi ülesannet: analüüs ilma muutmata, „Loetle kõik TypeScripti failid, millel puuduvad seotud testid“; sihipärane genereerimine, „Genereeri sellele failile ühiktest“; piiratud ulatusega parandus, „Paranda ESLinti hoiatused kataloogis src/utils/“. Igaühe puhul pane kirja, mida oleksid pidanud alguses täpsustama: see kahetsuste nimekiri on sinu AGENTS.mdi esimene mustand.

Peamised punktid

  • Käivita oma esimesed ülesanded lihtsate ja sihipäraste päringutega
  • Codex pakub iga ülesande kohta täielikku täitmise logi
  • Tulemuse kvaliteet sõltub sinu juhendite täpsusest
  • Sa säilitad alati kontrolli: kiida heaks, muuda või lükka tagasi
  • Alusta väikese riskiga ülesannetest enne kriitiliste muudatuste juurde liikumist