Környezet beállítása és az AGENTS.md fájl
Ezen az oldalon
Frissítve: 2026. november 3. a Codex dokumentációja alapján (Codex CLI, Hitelesítés, Codex IDE bővítmény, Egyéni utasítások az AGENTS.md fájllal): az
@openai/codex-clicsomag és acodex auth loginparancs nem létezik (használd aznpm install -g @openai/codexés acodex loginparancsokat); a bővítmény azonosítójaopenai.chatgpt; a codex.openai.com cím és a „Team, Enterprise vagy API“ csomagokat leváltották a jelenlegi hozzáférési módszerek; és az AGENTS.md olvasási sorrendje tisztázásra került (projekt gyökérkönyvtár → aktuális könyvtár). Források: Codex CLI · Hitelesítés · AGENTS.md · Árazás.
Projekt előkészítése a Codex számára
Két dolognak kell helyén lennie az első feladat előtt: a Codex-hozzáférésed – a fiókod és a GitHub-kapcsolatod –, valamint maga a projekt, amelyet az ügynököt irányító AGENTS.md fájl definiál. Az első rész körülbelül 15 percet vesz igénybe, és egyszeri beállítás. A második határozza meg mindannak a minőségét, amit a Codexből kihozol; ez választja el azokat a csapatokat, amelyek elégedettek a Codexszel, azoktól, amelyek csalódnak benne.
1. lépés: A Codex-hozzáférésed
A Codexet használhatod ChatGPT-fiókkal vagy API-kulccsal. Az Ingyenes és a Go csomagok hozzáférést biztosítanak – az aktuális telepítéstől függően – a GPT-6 Luna modellhez az asztali alkalmazásban. A Plus csomagtól kezdve a Codex elérhető weben, CLI-ben, szerkesztőbővítményben és iOS-en, felhőalapú integrációkkal, mint például az automatizált kódellenőrzés. Az API-kulcs alkalmas automatizálásra megosztott környezetekben, például CI-ben, a CLI, az SDK vagy a bővítmény használatával – bár egyes funkciók nem feltétlenül érhetők el. A részletek és a használati korlátok a Codex árazási oldalán találhatók.
Ha felhőalapú környezetben szeretnél dolgozni a tárhelyeiden, csatlakoztasd a GitHubot, amikor létrehozod az első Codex Cloud környezetedet (2. lecke). A jogosultságok megadásakor légy minimalista: csak azokhoz a tárhelyekhez korlátozd a hozzáférést, amelyekre valóban szükséged van.
2. lépés: A szerkesztőbővítmény telepítése
A VS Code-ban és annak származékaiban (Cursor, Windsurf) telepítsd a Codex bővítményt a piactérről – az azonosítója: openai.chatgpt:
code --install-extension openai.chatgpt
Ezután nyisd meg a Codexet az ikonján keresztül, vagy a parancspalettán a Codex: Open Codex Sidebar paranccsal, és jelentkezz be. Az Xcode-nak és a JetBrains IDE-knek saját integrációik vannak: a JetBrains termékekben nyisd meg az AI Chat ablakot, és válaszd a Codexet.
3. lépés: A CLI telepítése
# Telepítés (macOS és Linux), vagy npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Telepítés ellenőrzése
codex --version
# Bejelentkezés (böngészőben), vagy kapcsolati állapot ellenőrzése
codex login
codex login status
A codex login parancs megnyitja a bejelentkezési folyamatot a böngésződben. API-kulcs használata esetén add át azt szabványos bemeneten keresztül (printenv OPENAI_API_KEY | codex login --with-api-key). A Codex a hitelesítő adatokat vagy egy egyszerű szöveges fájlban (~/.codex/auth.json), vagy a rendszer kulcstartójában gyorsítótárazza, a cli_auth_credentials_store beállítástól függően (file, keyring, auto vagy ephemeral). Ha fájlt használ, kezeld jelszóként: hozzáférési tokeneket tartalmaz, ezért soha ne commitold. A CLI és a bővítmény közös gyorsítótárat használ.
Az AGENTS.md fájl – a projekted útmutatója
Az AGENTS.md központi szerepet játszik a Codex hatékony használatában. Ez egy egyszerű Markdown fájl, amelyet a tárhely gyökérkönyvtárába helyezel el, és amely összegyűjti a projektedre vonatkozó utasításokat, konvenciókat és parancsokat. Amikor a Codex klónozza a tárhelyet, először ezt a fájlt olvassa be: tekints rá úgy, mint az ügynök automatikus beillesztésére, pontosan arra, amit szóban elmagyaráznál egy új csapattagnak.
A hatás azonnali. AGENTS.md nélkül, ha egységtesztet kérsz egy Vitestet használó projekthez, nagy az esélye, hogy a Codex Jestet ad, mert ez a leggyakoribb választás az ökoszisztémában. Egyetlen soros konvenció is elég ahhoz, hogy elsőre helyesen kapd meg a Vitestet, így megspórolod ugyanannak a javításnak a százszori elvégzését. Íme egy alapvető fájl szerkezete egy SaaS számlakezelő projekthez.
# AGENTS.md
## Projekt kontextus
SaaS számlakezelő alkalmazás.
Verem: Next.js 15, TypeScript, Prisma, PostgreSQL.
## Kódolási konvenciók
- React funkcionális komponensek használata (osztályok nélkül)
- Fájlok elnevezése kebab-case-ben
- TypeScript típusok külön .types.ts fájlokban
- Tesztek Vitesttel, .test.ts fájlok a kód mellett
## Hasznos parancsok
- `npm run dev` — fejlesztői szerver
- `npm run test` — tesztek futtatása
- `npm run lint` — lint ellenőrzés
- `npm run build` — éles build
## Projektfelépítés
src/
app/ → Next.js oldalak (App Router)
components/ → Újrahasználható React komponensek
lib/ → Üzleti logika és segédprogramok
prisma/ → Adatbázis séma és migrációk
## Szigorú szabályok
- SOHA ne módosítsd a Prisma sémát migráció nélkül
- SOHA ne commitolj .env fájlokat
- Mindig Server Actionöket használj módosításokhoz
Hogyan találja meg a Codex az AGENTS.md fájlokat
Egyetlen gyökérfájl gyorsan túl általánossá válik. A Codex lehetővé teszi az utasítások rétegezését egy pontos sorrendben, amelyet ismerned kell:
- Globális szint: A Codex mappádban (
~/.codex, hacsak aCODEX_HOMEfelül nem írja), a Codex beolvassa azAGENTS.override.mdfájlt, ha létezik, egyébként azAGENTS.md-t. - Projektszint: A projekt gyökérkönyvtárából (általában a Git gyökéréből) indulva a Codex lefelé halad az aktuális könyvtárig, és minden érintett mappában beolvassa az
AGENTS.override.md-t, vagy ha az nincs, azAGENTS.md-t. - Egyesítés: A fájlok a gyökértől az aktuális könyvtárig összefűzésre kerülnek; az aktuális könyvtárhoz legközelebb esők kerülnek végére, így felülírják az általánosabb utasításokat.
my-project/
AGENTS.md → Projekt utasítások
src/
api/
AGENTS.md → „Az API útvonalak Zodot használnak validáláshoz“
Gyakorlati következmény: a src/api/AGENTS.md csak akkor olvasódik be, ha a Codex a src/api könyvtárból vagy annak valamelyik alkönyvtárából dolgozik, nem pedig akkor, ha a gyökérből indítják. Az üres fájlokat figyelmen kívül hagyja, és az összefűzés alapértelmezés szerint 32 KiB-nál megáll (project_doc_max_bytes). Ha a tárhelyed már másik nevet használ, például TEAM_GUIDE.md, add hozzá a project_doc_fallback_filenames listához a ~/.codex/config.toml fájlban.
Annak ellenőrzésére, hogy a Codex valójában mit töltött be, egyszerűen kérdezd meg: codex --ask-for-approval never "Summarize the current instructions.". A Codex minden indításkor újraépíti az utasítási láncot: ha bizonytalan vagy, indítsd újra a megfelelő könyvtárból.
Legjobb gyakorlatok az AGENTS.md-hez
Az irányelv az egyértelműség. A „Használj Vitestet, ne Jestet“ jobb, mint a „Használd a teszt keretrendszerünket“, amely olyan tudást feltételez, amellyel az ügynök nem rendelkezik. Mindig tüntesd fel a parancsokat: nélkülük a Codex nem tudja, hogyan futtassa a teszteket, a lintert vagy a buildet, és olyan kódot szállít, amelyet nem tudott ellenőrizni. Dokumentáld a struktúrát könyvtárfa formájában; ez megakadályozza, hogy vakon böngésszen, és rossz helyre hozzon létre fájlokat.
Végül sorold fel a tiltásokat. A „SOHA“ alakban megfogalmazott szabályok a legköltséghatékonyabbak a fájlban, mert megakadályozzák a drága, nehezen javítható hibákat: .env fájl commitolása, séma módosítása migráció nélkül. A legnehezebb fegyelem a fájl naprakészen tartása. Egy olyan AGENTS.md, amely a tavalyi projektet írja le, aktívan félrevezeti a Codexet elhagyott konvenciók felé – ez sokkal rosszabb, mint ha nincs is fájl, mivel a hiba ekkor szisztematikussá válik.
Főbb megállapítások
- A kezdeti beállítás OpenAI-fiókot és GitHub-kapcsolatot igényel
- Az IDE-bővítmény és a CLI percek alatt telepíthető
- Az AGENTS.md a legfontosabb fájl a Codex hatékony használatához
- Konvenciókat, parancsokat és projektspecifikus szabályokat tartalmaz
- Az alkönyvtárakban lévő AGENTS.md fájlok lehetővé teszik a kontextuális utasításokat