Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Környezet beállítása és az AGENTS.md fájl

3. lecke 20 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Projekt előkészítése a Codex számára
  2. 1. lépés: A Codex-hozzáférésed
  3. 2. lépés: A szerkesztőbővítmény telepítése
  4. 3. lépés: A CLI telepítése
  5. Az AGENTS.md fájl – a projekted útmutatója
  6. Legjobb gyakorlatok az AGENTS.md-hez
  7. Főbb megállapítások

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-cli csomag és a codex auth login parancs nem létezik (használd az npm install -g @openai/codex és a codex login parancsokat); a bővítmény azonosítója openai.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:

  1. Globális szint: A Codex mappádban (~/.codex, hacsak a CODEX_HOME felül nem írja), a Codex beolvassa az AGENTS.override.md fájlt, ha létezik, egyébként az AGENTS.md-t.
  2. 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, az AGENTS.md-t.
  3. 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