Ensimmäinen Codex-tehtäväsi
Tällä sivulla
Päivitetty 3. marraskuuta 2026 Codex-komentoviiteristön (CLI 0.166.0) perusteella: valinnat
--show-diffja--applyeivät ole olemassa. Paikallisesti Codex muokkaa tiedostoja suoraan hiekkalaatikossaan; tarkista muutokset käyttämällä komentoja/difftaigit diff. “Codex: New Task” -laajennuskomento on korvattu komennolla Codex: Open Codex Sidebar. Lähteet: Developer commands · Codex IDE extension.
Käynnistä ensimmäinen tehtäväsi
Tilisi on asetettu, GitHub on yhdistetty ja AGENTS.md on paikallaan: on aika nähdä agentti toiminnassa. Tässä on nyrkkisääntö kaikille taitotasoille – aloita tehtävällä, jossa tiedät jo oikean vastauksen. Et opi paljoa katsellessasi Codexin ratkaisevan ongelmaa, jota et pysty itse arvioimaan, mutta opaat valtavasti seuraamalla sen toimintaa tutulla maaperällä.
Codex Cloudista
Verkkoselaimessa tai työpöytäsovelluksessa valitse Work in › Cloud, valitse julkaistu ympäristö tietovarastollesi (oppitunti 2) ja kirjoita tehtäväsi syöttökenttään. Tarkoituksellisen vaatimaton pyyntö toimii erinomaisesti.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Tämä muotoilu sisältää ehdon – “jos sellaista ei jo ole olemassa” – mikä tekee siitä juuri niin mielenkiintoisen tarkkailtavan. Codex Cloudissa tehtävä suoritetaan tälle tietovarastolle julkaisemassasi ympäristössä: Codex tarkistaa, onko .gitignore olemassa, varmistaa, että se kattaa Node.js:n ja TypeScriptin jos se on olemassa, luo tai päivittää tiedoston tarpeen mukaan ja näyttää sitten tuloksen diffinä. Suoritusloki virtaa reaaliajassa: tästä näet, kunnioittiko agentti ehtoa vai kirjoittiko se olemassa olevan tiedostosi yli.
IDE:stä
Avaa projektisi VS Code:ssa (tai Cursorissa, Windsurfissa) ja käynnistä Codex sen kuvakkeesta tai komentopaletista:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Muotoile sitten pyyntö, joka hyödyntää paikallista kontekstia nimeämällä tietyn tiedoston:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
Laajennus näyttää yhteenvedon ja muokatut rivit koodin vieressä; pidät haluamasi muutokset ja voit pyytää jatkoa samassa keskustelussa. Dokumentaatio suosittelee Git-tarkistuspisteen luomista ennen tehtävää ja sen jälkeen, jotta voit palata taaksepäin tarvittaessa.
Komentoriviltä (CLI)
# Siirry projektihakemistoon
cd my-project
# Aloita istunto alkuperäisellä ohjeella
codex "Add a README.md with the project description, installation instructions, and available commands"
Paikallisesti Codex muokkaa tiedostoja suoraan työhakemistossasi hiekkalaatikon ja hyväksymiskäytännön rajoissa: se pyytää lupaa ennen toimia, jotka sitä vaativat. Tarkistaaksesi mitä muuttui ennen commitointia, kirjoita /diff istunnossa: komento näyttää Git-diffin, mukaan lukien seuraamattomat tiedostot. /review pyytää Codexia tarkistamaan oman työpuidesi. Skriptattua käyttöä varten codex exec suorittaa saman tehtävän ilman vuorovaikutusta (oppitunti 14) – siinä tapauksessa Git ja putkesi päättävät, mitä säilytetään.
Codex-tuloksen anatomia
Sisääntulopisteestä riippumatta suoritettu tehtävä palauttaa aina samat neljä elementtiä. Tarkista ne tässä järjestyksessä: diff kertoo mitä muuttui, loki kertoo miksi, testit kertovat onko se turvallista, ja toiminnot antavat kontrollin takaisin sinulle.
| Toimitettu elementti | Mitä se sisältää |
|---|---|
| Muutosdiff | Jokainen lisätty, muokattu tai poistettu rivi, tiedosto kerrallaan |
| Suoritusloki | Kaikki vaiheet: luetut tiedostot, suoritetut komennot, agentin päättely |
| Testitulokset | Jos testejä on olemassa, Codex ajaa ne varmistaakseen, ettei mikään ole rikki |
| Käytettävissä olevat toiminnot | Hyväksy, muokkaa, luo PR tai suorita uudelleen eri ohjeilla |
Aloittelijat jättävät usein suorituslokin huomiotta, vaikka se on elementti, joka opettaa sinua muotoilemaan tehtäväsi. Näkemällä, mitkä tiedostot Codex avasi ennen päätöksen tekemistä, huomaat mitä se etsi mutta ei löytänyt – usein kyseessä on käytäntö, jonka olisi pitänyt olla kohdassa AGENTS.md.
Hyvien ohjeiden kirjoittaminen
Tuloksen laatu riippuu suoraan ohjeiden laadusta, ja alla olevien kahden muotoilun välinen kuilu on paljon suurempi kuin kahden mallin välinen kuilu.
"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."
Toinen versio toimii, koska se vastaa neljään kysymykseen, jotka agentti kysyy itseltään joka tapauksessa. Se määrittää mukana olevat tiedostot, säästäen sitä tutkimiselta ja väärään sijaintiin osumiselta. Se määrittelee odotetun lopputuloksen – käyttäytyminen, rajapinta, formaatti – jotta se tietää milloin lopettaa. Se asettaa rajoitteita, tässä tapauksessa säilyttäen julkisen rajapinnan, mikä estää sitä “parantamasta” asioita rikkomalla kutsujia; muualla tämä voisi olla “älä riko testejä”. Ja kun panokset sitä perustelevat, se lisää liiketoimintakontekstia: määrittämällä “tämä on maksulomake, turvallisuus on kriittistä” muutat aidosti sen kompromisseja.
Tehdäksesi tästä omasi, ota olemassa oleva projekti ja ketjuta yhteen kolme erityyppistä tehtävää: analyysi ilman muokkausta, “Listaa kaikki TypeScript-tiedostot, joilta puuttuvat niihin liittyvät testit”; kohdennettu generointi, “Generoi yksikkötesti tälle tiedostolle”; rajoitetun laajuuden korjaus, “Korjaa ESLint-varoitukset hakemistossa src/utils/”. Jokaisen kohdalla merkitse muistiin, mitä sinun olisi pitänyt määrittää etukäteen: tämä katumuslista on ensimmäinen luonnoksesi tiedostolle AGENTS.md.
Keskeiset asiat
- Käynnistä ensimmäiset tehtäväsi yksinkertaisilla, kohdennetuilla pyynnöillä
- Codex tarjoaa täydellisen suorituslokin jokaiselle tehtävälle
- Tuloksen laatu riippuu ohjeidesi tarkkuudesta
- Säilytät aina kontrollin: hyväksy, muokkaa tai hylkää
- Aloita pieniriskisillä tehtävillä ennen siirtymistä kriittisiin muutoksiin