Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Nastavení prostředí a souboru AGENTS.md

Lekce 3 z 20 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Připrav svůj projekt pro Codex
  2. Krok 1: Tvůj přístup k Codexu
  3. Krok 2: Instalace rozšíření pro editor
  4. Krok 3: Instalace CLI
  5. Soubor AGENTS.md – tvůj průvodce projektem
  6. Osvědčené postupy pro AGENTS.md
  7. Klíčové poznatky

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-cli a příkaz codex auth login neexistují (použij npm install -g @openai/codex a codex login); identifikátor rozšíření je openai.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:

  1. Globální úroveň: Ve své složce Codex (~/.codex, pokud není přepsáno proměnnou CODEX_HOME) si Codex přečte AGENTS.override.md, pokud existuje, jinak AGENTS.md.
  2. Ú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.
  3. 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