Nastavení prostředí a souboru AGENTS.md
Na této stránce
Aktualizováno 3. listopadu 2026 na základě dokumentace Codex (Codex CLI, Authentication, Codex IDE extension, Custom instructions with AGENTS.md): balíček
@openai/codex-clia příkazcodex auth loginneexistují (použijnpm install -g @openai/codexacodex login); identifikátor rozšíření jeopenai.chatgpt; adresa codex.openai.com a plány „Team, Enterprise nebo API“ jsou nahrazeny aktuálními způsoby přístupu; a pořadí čtení AGENTS.md je upřesněno (kořen projektu → aktuální adresář). Zdroje: Codex CLI · Authentication · AGENTS.md · Pricing.
Připrav svůj projekt pro Codex
Než začneš první úkol, musíš mít hotové dvě věci: přístup k Codexu – tedy svůj účet a propojení s GitHubem – a samotný projekt definovaný prostřednictvím souboru AGENTS.md, který bude agenta řídit. První část zabere asi 15 minut a je to jednorázové nastavení. To druhé určuje kvalitu všeho, co z Codexu dostaneš, a odděluje týmy, které jsou s Codexem spokojené, od těch, které ho považují za zklamání.
Krok 1: Tvůj přístup k Codexu
Codex můžeš používat s účtem ChatGPT nebo s API klíčem. Plány Free a Go poskytují přístup, v závislosti na aktuálním nasazení, k modelu GPT-6 Luna v desktopové aplikaci. Od plánu Plus výše je Codex dostupný na webu, v CLI, v rozšíření pro editor a na iOS, včetně cloudových integrací, jako je automatizovaná kontrola kódu. API klíč funguje pro automatizaci ve sdílených prostředích, jako je CI, pomocí CLI, SDK nebo rozšíření – některé funkce však nemusí být dostupné. Podrobnosti a limity využití najdeš na stránce s cenami Codexu.
Abych mohl pracovat v cloudu se svými repozitáři, připoj GitHub při vytváření svého prvního prostředí Codex Cloud (Lekce 2). Při udělování oprávnění postupuj minimalisticky: omez přístup pouze na repozitáře, které skutečně potřebuješ.
Krok 2: Instalace rozšíření pro editor
Ve VS Code a jeho derivátech (Cursor, Windsurf) nainstaluj rozšíření Codex z marketplace – jeho identifikátor je openai.chatgpt:
code --install-extension openai.chatgpt
Poté otevři Codex přes jeho ikonu nebo prostřednictvím palety příkazů pomocí Codex: Open Codex Sidebar a přihlas se. Xcode a JetBrains IDE mají vlastní integrace: v JetBrains otevři AI Chat a vyber Codex.
Krok 3: Instalace CLI
# Instalace (macOS a Linux), nebo npm install -g @openai/codex
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# Ověření instalace
codex --version
# Přihlášení (prohlížeč), nebo kontrola stavu připojení
codex login
codex login status
codex login otevře přihlašovací proces v tvém prohlížeči. Pro API klíč jej předej přes standardní vstup (printenv OPENAI_API_KEY | codex login --with-api-key). Codex ukládá pověření buď do textového souboru ~/.codex/auth.json, nebo do systémového klíčenky, v závislosti na nastavení cli_auth_credentials_store (file, keyring, auto nebo ephemeral). Pokud se používá soubor, zacházej s ním jako s heslem: obsahuje přístupové tokeny, takže jej nikdy necommituj. CLI a rozšíření sdílejí tuto mezipaměť.
Soubor AGENTS.md – tvůj průvodce projektem
AGENTS.md je klíčový pro efektivní používání Codexu. Je to jednoduchý Markdown soubor umístěný v kořeni tvého repozitáře, který shromažďuje pokyny, konvence a příkazy specifické pro tvůj projekt. Když Codex naklonuje repozitář, přečte si tento soubor jako první: ber to jako automatické zaškolení pro agenta, přesně to, co bys ústně vysvětlil novému členovi týmu.
Dopad je okamžitý. Bez AGENTS.md, pokud požádáš o unit test v projektu používajícím Vitest, je velká šance, že ti Codex dodá Jest, protože je to v ekosystému nejčastější volba. Jediný řádek s konvencí stačí k tomu, aby byl Vitest správně nastaven napoprvé, což tě ušetří stokrát opakovaných oprav. Zde je struktura základního souboru pro projekt správy fakturace SaaS.
# AGENTS.md
## Project context
SaaS invoice management application.
Stack: Next.js 15, TypeScript, Prisma, PostgreSQL.
## Code conventions
- Use React functional components (no classes)
- Name files in kebab-case
- TypeScript types in separate .types.ts files
- Tests with Vitest, .test.ts files next to code
## Useful commands
- `npm run dev` — development server
- `npm run test` — run tests
- `npm run lint` — check linting
- `npm run build` — production build
## Project structure
src/
app/ → Next.js pages (App Router)
components/ → Reusable React components
lib/ → Business logic and utilities
prisma/ → DB schema and migrations
## Strict rules
- NEVER modify Prisma schema without a migration
- NEVER commit .env files
- Always use Server Actions for mutations
Jak Codex nachází soubory AGENTS.md
Jediný soubor v kořeni se rychle stane příliš obecným. Codex ti umožňuje vrstvit pokyny v přesném pořadí, které musíš znát:
- Globální úroveň: Ve své složce Codex (
~/.codex, pokud není přepsáno proměnnouCODEX_HOME) si Codex přečteAGENTS.override.md, pokud existuje, jinakAGENTS.md. - Úroveň projektu: Počínaje kořenem projektu (obvykle kořen Gitu) Codex sestupuje do aktuálního adresáře a v každé procházené složce čte
AGENTS.override.md, nebo pokud chybí,AGENTS.md. - Slučování: Soubory jsou řazeny za sebe od kořene dolů k aktuálnímu adresáři; ty, které jsou nejblíže aktuálnímu adresáři, jsou poslední, a proto přepisují obecnější pokyny.
my-project/
AGENTS.md → Pokyny pro projekt
src/
api/
AGENTS.md → „API routy používají Zod pro validaci“
Praktický důsledek: src/api/AGENTS.md se načte pouze tehdy, pokud Codex pracuje z src/api nebo některého z jeho podadresářů, nikoliv při spuštění z kořene. Prázdné soubory se ignorují a zřetězení se ve výchozím nastavení zastaví na 32 KiB (project_doc_max_bytes). Pokud tvůj repozitář již používá jiný název, jako je TEAM_GUIDE.md, přidej jej do project_doc_fallback_filenames v souboru ~/.codex/config.toml.
Chceš-li ověřit, co Codex skutečně načetl, stačí se zeptat: codex --ask-for-approval never "Summarize the current instructions.". Codex přestavuje řetězec pokynů při každém spuštění: pokud si nejsi jistý, restartuj jej ve správném adresáři.
Osvědčené postupy pro AGENTS.md
Řídícím principem je explicitnost. „Používej Vitest, ne Jest“ je lepší než „Používej náš testovací framework“, což předpokládá znalosti, které agent nemá. Vždy zahrň příkazy: bez nich Codex nebude vědět, jak spustit tvé testy, linter nebo build, a dodá kód, který nemohl ověřit. Zdokumentuj strukturu jako strom adresářů, což zabrání tomu, aby blindně prozkoumával a vytvářel soubory na špatných místech.
Nakonec vypiš zákazy. Pravidla formulovaná jako „NIKDY“ jsou v souboru nejefektivnější, protože blokují nákladné chyby, které se těžko opravují: commitnutí souboru .env, úprava schématu bez migrace. Nejtěžší disciplínou je udržovat soubor aktuální. AGENTS.md, který popisuje projekt z loňského roku, aktivně směruje Codex k opuštěným konvencím – což je mnohem horší, než nemít soubor žádný, protože se chyba stává systematickou.
Klíčové poznatky
- Počáteční nastavení vyžaduje účet OpenAI a připojení GitHub
- Rozšíření pro IDE a CLI se nainstalují během několika minut
- AGENTS.md je nejdůležitější soubor pro efektivní používání Codexu
- Obsahuje konvence, příkazy a pravidla specifická pro tvůj projekt
- Soubory AGENTS.md v podadresářích umožňují kontextové pokyny