Nastavenie prostredia a súboru AGENTS.md
Na tejto strane
Aktualizované 3. novembra 2026 na základe dokumentácie Codex (Codex CLI, Overenie totožnosti, Rozšírenie Codex pre IDE, Vlastné inštrukcie s AGENTS.md): balík
@openai/codex-clia príkazcodex auth loginneexistujú (použinpm install -g @openai/codexacodex login); identifikátor rozšírenia jeopenai.chatgpt; adresa codex.openai.com a plány „Team, Enterprise alebo API“ sú nahradené aktuálnymi spôsobmi prístupu a poradie čítania AGENTS.md je spresnené (koreň projektu → aktuálny adresár). Zdroje: Codex CLI · Authentication · AGENTS.md · Pricing.
Príprava projektu pre Codex
Pred prvou úlohou musia byť splnené dve podmienky: tvoj prístup k Codexu – teda účet a prepojenie s GitHubom – a samotný projekt definovaný prostredníctvom súboru AGENTS.md, ktorý bude agenta viesť. Prvá časť trvá približne 15 minút a ide o jednorazové nastavenie. Druhá časť určuje kvalitu všetkého, čo z Codexu získáš, a oddeľuje tímy, ktoré sú s Codexom spokojné, od tých, ktoré ho považujú za sklamanie.
Krok 1: Tvoj prístup k Codexu
Codex môžeš používať s účtom ChatGPT alebo s API kľúčom. Plány Free a Go poskytujú prístup (v závislosti od aktuálneho nasadenia) k modelu GPT-6 Luna v desktopovej aplikácii. Od úrovne Plus je Codex dostupný na webe, v CLI, v rozšírení pre editor a na iOS, vrátane cloudových integrácií, ako je automatizovaná kontrola kódu. API kľúč funguje pre automatizáciu v zdieľaných prostrediach, ako je CI, pričom využíva CLI, SDK alebo rozšírenie – hoci niektoré funkcia nemusia byť dostupné. Podrobnosti a obmedzenia využitia nájdeš na stránke s cenami Codexu.
Ak chceš pracovať v cloude so svojimi repozitármi, pripoj GitHub pri vytváraní svojho prvého prostredia Codex Cloud (Lekcia 2). Pri udeľovaní povolení buď čo najúspornejší: obmedz prístup len na repozitáre, ktoré skutočne potrebuješ.
Krok 2: Inštalácia rozšírenia pre editor
Vo VS Code a jeho derivátoch (Cursor, Windsurf) nainštaluj rozšírenie Codex z marketplace – jeho identifikátor je openai.chatgpt:
code --install-extension openai.chatgpt
Následne otvor Codex cez jeho ikonu alebo cez paletu príkazov pomocou Codex: Open Codex Sidebar a prihlás sa. Xcode a JetBrains IDE majú vlastné integrácie: v JetBrains otvor AI Chat a vyber Codex.
Krok 3: Inštalácia CLI
# Inštalácia (macOS a Linux), alebo npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Overenie inštalácie
codex --version
# Prihlásenie (prehliadač), alebo kontrola stavu pripojenia
codex login
codex login status
Príkaz codex login otvorí prihlasovací tok v tvojom prehliadači. Pre API kľúč ho odovzdaj cez štandardný vstup (printenv OPENAI_API_KEY | codex login --with-api-key). Codex ukladá poverenia do cache buď v textovom súbore ~/.codex/auth.json, alebo v systémovom zväzku kľúčov (keychain), v závislosti od nastavenia cli_auth_credentials_store (file, keyring, auto alebo ephemeral). Ak sa používa súbor, zaobchádzaj s ním ako s heslom: obsahuje prístupové tokeny, takže ho nikdy neodosielaj do repozitára. CLI a rozšírenie zdieľajú túto cache.
Súbor AGENTS.md – sprievodca tvojím projektom
Súbor AGENTS.md je kľúčový pre efektívne využívanie Codexu. Ide o jednoduchý Markdown súbor umiestnený v koreni tvojho repozitára, ktorý zhromažďuje inštrukcie, konvencie a príkazy špecifické pre tvoj projekt. Keď Codex naklonuje repozitár, tento súbor si prečíta ako prvý: ber ho ako automatické zaškolenie agenta, presne to, čo by si ústne vysvetlil novému členovi tímu.
Dopad je okamžitý. Bez AGENTS.md, ak požiadaš o unit test pre projekt využívajúci Vitest, je veľká šanca, že ti Codex vráti Jest, pretože ide o najbežnejšiu voľbu v ekosystéme. Jediný riadok s konvenciou stačí na to, aby bol Vitest správny hneď na prvýkrát, čo ťa ušetrí od stonásobného opravovania tej istej chyby. Tu je štruktúra základného súboru pre projekt správy faktúr SaaS.
# AGENTS.md
## Kontext projektu
Aplikácia na správu faktúr SaaS.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.
## Konvencie kódu
- Používaj funkčné komponenty React (žiadne triedy)
- Pomenuj súbory v kebab-case
- Typy TypeScript v samostatných súboroch .types.ts
- Testy s Vitest, súbory .test.ts vedľa kódu
## Užitočné príkazy
- `npm run dev` — vývojový server
- `npm run test` — spustenie testov
- `npm run lint` — kontrola lintingu
- `npm run build` — produkčná zostava
## Štruktúra projektu
src/
app/ → Stránky Next.js (App Router)
components/ → Opakovateľné komponenty React
lib/ → Obchodná logika a utility
prisma/ → Schéma DB a migrácie
## Prísne pravidlá
- NIKDY neupravuj schému Prisma bez migrácie
- NIKDY neodosielaj súbory .env
- Vždy používaj Server Actions pre mutácie
Ako Codex vyhľadáva súbory AGENTS.md
Jediný súbor v koreni sa rýchlo stane príliš všeobecným. Codex ti umožňuje vrstviť inštrukcie v presnom poradí, ktoré musíš poznať:
- Globálna úroveň: V tvojom priečinku Codex (
~/.codex, pokiaľCODEX_HOMEneurčuje inak) si Codex prečítaAGENTS.override.md, ak existuje, inakAGENTS.md. - Úroveň projektu: Od koreňa projektu (zvyčajne koreň Git) Codex zostupuje do aktuálneho adresára a v každom prechádzanom priečinku číta
AGENTS.override.mdalebo, ak chýba,AGENTS.md. - Zlučovanie: Súbory sa spájajú od koreňa smerom nadol k aktuálnemu adresáru; tie, ktoré sú najbližšie k aktuálnemu adresáru, sú posledné, a preto prepisujú všeobecnejšie inštrukcie.
my-project/
AGENTS.md → Inštrukcie projektu
src/
api/
AGENTS.md → „Trasy API používajú Zod na validáciu“
Praktický dôsledok: src/api/AGENTS.md sa prečíta iba vtedy, ak Codex pracuje z src/api alebo niektorého z jeho podadresárov, nie keď je spustený z koreňa. Prázdne súbory sa ignorujú a spájanie sa zastaví pri 32 KiB predvolene (project_doc_max_bytes). Ak tvoj repozitár už používa iný názov, napríklad TEAM_GUIDE.md, pridaj ho do project_doc_fallback_filenames v súbore ~/.codex/config.toml.
Ak chceš overiť, čo presne Codex načítal, stačí sa opýtať: codex --ask-for-approval never "Summarize the current instructions.". Codex prestavuje reťazec inštrukcií pri každom spustení: ak máš pochybnosti, reštartuj ho v správnom adresári.
Najlepšie postupy pre AGENTS.md
Základným princípom je explicitnosť. „Použi Vitest, nie Jest“ je lepšie ako „Použi náš testovací framework“, čo predpokladá znalosti, ktoré agent nemá. Vždy zahrň príkazy: bez nich Codex nebude vedieť, ako spustiť tvoje testy, linter alebo zostavu, a dodá kód, ktorý nemohol overiť. Zdokumentuj štruktúru ako strom adresárov, čo zabráni slepému preskúmavaniu a vytváraniu súborov na nesprávnych miestach.
Nakoniec vymenuj zákazy. Pravidlá napísané ako „NIKDY“ sú v súbore najvýhodnejšie, pretože blokujú nákladné chyby, ktoré sa ťažko opravujú: odoslanie súboru .env, úprava schémy bez migrácie. Najnáročnejšou disciplínou je udržiavať súbor aktuálny. AGENTS.md, ktorý opisuje projekt z minulého roka, aktívne nasmeruje Codex k opusteným konvenciám – čo je oveľa horšie, než keď súbor chýba úplne, pretože chyba sa potom stane systematickou.
Kľúčové poznatky
- Počiatočné nastavenie vyžaduje účet OpenAI a prepojenie s GitHubom
- Rozšírenie pre IDE a CLI sa nainštalujú za pár minút
- AGENTS.md je najdôležitejším súborom pre efektívne využívanie Codexu
- Obsahuje konvencie, príkazy a pravidlá špecifické pre tvoj projekt
- Súbory AGENTS.md v podadresároch umožňujú kontextové inštrukcie