Az első Codex-feladatod
Ezen az oldalon
Frissítve: 2026. november 3. a Codex parancshivatkozója (CLI 0.166.0) alapján: a
--show-diffés--applykapcsolók nem léteznek. Helyileg a Codex közvetlenül módosítja a fájlokat a saját homokozójában; a változtatásokat a/diffvagygit diffparancsokkal tekintheted át. A „Codex: New Task“ bővítményparancsot felváltotta a Codex: Open Codex Sidebar. Források: Developer commands · Codex IDE extension.
Indítsd el az első feladatodat
A fiókod be van állítva, a GitHub csatlakoztatva, és az AGENTS.md is a helyén van: itt az idő, hogy lásd az ügynököt munka közben. Íme egy aranyszabály minden szinten: kezdj olyan feladattal, ahol már tudod a helyes választ. Nem tanulsz sokat abból, ha azt nézed, ahogy a Codex egy olyan problémát old meg, amit te magad sem tudsz kiértékelni, de rengeteget tanulhatsz abból, ha megfigyeled, ahogy ismerős terepen dolgozik.
A Codex Cloudból
A webes felületen vagy az asztali alkalmazásban válaszd a Work in › Cloud lehetőséget, jelöld ki a tárolódhoz közzétett környezetet (2. lecke), és írd be a feladatot a beviteli mezőbe. Egy szándékosan szerény kérés is tökéletesen megfelel.
Task: "Add a .gitignore file suitable for a Node.js/TypeScript
project if one doesn't already exist."
Ez a megfogalmazás tartalmaz egy feltételt – „ha még nem létezik“ –, és pontosan ez teszi érdekessé a megfigyelést. A Codex Cloudban a feladat abban a környezetben fut, amelyet ehhez a tárolóhoz tettél közzé: a Codex ellenőrzi, létezik-e .gitignore fájl, ha igen, meggyőződik arról, hogy lefedi-e a Node.js és TypeScript projekteket, szükség esetén létrehozza vagy frissíti a fájlt, majd diff formájában mutatja meg az eredményt. A végrehajtási napló valós időben streamelődik: itt láthatod, hogy az ügynök tiszteletben tartotta-e a feltételt, vagy felülírta-e a meglévő fájlt.
Az IDE-ből
Nyisd meg a projektedet VS Code-ban (vagy Cursorban, Windsurfben), és indítsd el a Codexet az ikonján vagy a Parancspalettán keresztül:
Ctrl+Shift+P → "Codex: Open Codex Sidebar"
Ezután fogalmazz meg egy kérést, amely kihasználja a helyi kontextust a konkrét fájl megnevezésével:
"Add email validation to the contact form
in src/components/ContactForm.tsx"
A bővítmény összefoglalót jelenít meg, és a módosított sorokat a kód mellett láthatod; megtartod a kívánt változtatásokat, és ugyanabban a beszélgetésben kérhetsz utólagos módosításokat. A dokumentáció azt javasolja, hogy a feladat előtt és után is készíts egy Git ellenőrzőpontot (checkpoint), hogy szükség esetén vissza tudj lépni.
A CLI-ből
# Navigálj a projekt könyvtárába
cd my-project
# Indíts egy munkamenetet egy kezdeti utasítással
codex "Add a README.md with the project description, installation instructions, and available commands"
Helyileg a Codex közvetlenül módosítja a fájlokat a munkakönyvtáradban, a homokozó és a jóváhagyási házirend korlátain belül: engedélyt kér olyan műveletek előtt, amelyekhez ez szükséges. Mielőtt commitolnál, a /diff parancs begépelésével áttekintheted, mi változott: a parancs kiírja a Git diffet, beleértve a nem követett (untracked) fájlokat is. A /review parancs arra kéri a Codexet, hogy vizsgálja felül a saját munkakönyvtáradat. Szkriptelt használathoz a codex exec parancs futtatja ugyanazt a feladatot interakció nélkül (14. lecke) – ilyen esetben a Gitre és a pipeline-odra hárul a döntés, hogy mi marad meg.
Egy Codex-eredmény felépítése
A belépési ponttól függetlenül egy befejezett feladat mindig ugyanazt a négy elemet adja vissza. Ezeket ebben a sorrendben tekintsd át: a diff megmondja, mi változott, a napló azt, hogy miért, a tesztek azt, hogy biztonságos-e, a műveletek pedig visszaadják neked az irányítást.
| Kézbesített elem | Tartalom |
|---|---|
| Változás diff | Minden hozzáadott, módosított vagy törölt sor, fájlonként |
| Végrehajtási napló | Minden lépés: olvasott fájlok, futtatott parancsok, az ügynök következtetései |
| Teszteredmények | Ha léteznek tesztek, a Codex lefuttatja őket, hogy ellenőrizze: semmi sem tört el |
| Elérhető műveletek | Jóváhagyás, módosítás, PR létrehozása vagy újrafuttatás eltérő utasításokkal |
A kezdők gyakran elhanyagolják a végrehajtási naplót, pedig ez az az elem, amelyből megtanulhatod, hogyan fogalmazd meg a feladataidat. Ha látod, mely fájlokat nyitotta meg a Codex a döntés meghozatala előtt, rájöhetsz, mit keresett, de nem talált meg – gyakran olyan konvenciókról van szó, amelyeknek az AGENTS.md fájlban kellett volna szerepelniük.
Jó utasítások írása
Az eredmény minősége közvetlenül függ az utasítások minőségétől, és a különbség az alábbi két megfogalmazás között jóval nagyobb, mint két modell közötti különbség.
"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."
A második verzió azért működik, mert megválaszol négy kérdést, amelyet az ügynök amúgy is feltesz magának. Megnevezi az érintett fájlokat, így megspórolja a keresgélést és a rossz helycélzást. Meghatározza a várt kimenetelt – viselkedés, interfész, formátum –, így tudja, mikor álljon le. Korlátokat szab, itt például a nyilvános interfész megőrzését, ami megakadályozza, hogy a hívó kódok „tökéletesítése“ közben tönkretegye azokat; máshol ez lehet „ne törj el teszteket“. És amikor a tét indokolja, üzleti kontextust is ad: ha megadod, hogy „ez egy fizetési űrlap, a biztonság kritikus“, az valóban megváltoztatja az általa meghozott kompromisszumokat.
Hogy ezt a sajátoddá tedd, végy egy meglévő projektet, és láncolj össze három különböző jellegű feladatot: egy elemzést módosítás nélkül („Sorold fel az összes TypeScript fájlt, amelyhez nem tartozik teszt“); egy célzott generálást („Generálj egységtesztet ehhez a fájlhoz“); egy korlátozott hatókörű javítást („Javítsd ki az ESLint figyelmeztetéseket a src/utils/ könyvtárban“). Minden egyes esetben jegyezd fel, mit kellett volna előre specifikálnod: ez a sajnálatok listája lesz az AGENTS.md első piszkozata.
Főbb megállapítások
- Az első feladataidat egyszerű, célzott kérésekkel indítsd
- A Codex minden feladathoz teljes végrehajtási naplót biztosít
- Az eredmény minősége az utasításaid pontosságától függ
- Mindig nálad marad az irányítás: jóváhagyhatod, módosíthatod vagy elutasíthatod
- Kezdj alacsony kockázatú feladatokkal, mielőtt kritikus változtatásokra térnél rá