Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Nastavenie prostredia a súboru AGENTS.md

Lekcia 3 z 20 Aktualizované 3. novembra 2026 Vývojár
Na tejto strane
  1. Príprava projektu pre Codex
  2. Krok 1: Tvoj prístup k Codexu
  3. Krok 2: Inštalácia rozšírenia pre editor
  4. Krok 3: Inštalácia CLI
  5. Súbor AGENTS.md – sprievodca tvojím projektom
  6. Najlepšie postupy pre AGENTS.md
  7. Kľúčové poznatky

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-cli a príkaz codex auth login neexistujú (použi npm install -g @openai/codex a codex login); identifikátor rozšírenia je openai.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ť:

  1. Globálna úroveň: V tvojom priečinku Codex (~/.codex, pokiaľ CODEX_HOME neurčuje inak) si Codex prečíta AGENTS.override.md, ak existuje, inak AGENTS.md.
  2. Ú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.md alebo, ak chýba, AGENTS.md.
  3. 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