OpenAI Codex: instalace, první kroky a regionální přístup

Slovo „Codex“ ve výsledcích vyhledávání označuje tři různé věci a lidé, kteří ho hledají poprvé, obvykle nechápou, co našli. Existoval model Codex — v roce 2023 byl ukončen; dnes toto jméno patří agentnímu programu a do toho se míchá další tucet produktů se stejným názvem.

Věnuji se pouze jednomu Codexu: programátorskému agentovi OpenAI. Co dělá, kde běží, kolik stojí, jak ho nainstalovat za pět minut a co OpenAI říká o jednotlivých zemích. Všechno vychází z oficiální dokumentace a odkazy ke každému údaji najdete na konci.

Další materiály k nastavení nástrojů najdete v dokumentaci Ailoot.

Co je OpenAI Codex?#

Porovnejte ho s běžným chatem. V chatu zkopírujete kus kódu, vložíte ho, dostanete odpověď a pak ji zkopírujete zpět. Agent pracuje jinak: popíšete úkol běžným jazykem a on otevře příslušné soubory ve složce projektu, provede změny, spustí kontroly a ukáže vám výsledek.

OpenAI ho ve svém repozitáři popisuje jednou větou:

Lokálně znamená, že je program stažený do vašeho počítače, kde vidí vaše soubory a může spouštět příkazy ve vaší složce. Do cloudu se odesílá pouze požadavek pro model.

Zdrojový kód s otevřenou licencí je na GitHubu pod licencí Apache-2.0. K 1. srpnu 2026 má repozitář 103 000 hvězdiček a nejnovější verze 0.146.0 byla vydána 29. července. Aktualizace vycházejí téměř každý den, takže vaše verze už bude nejspíš jiná.

V čem se Codex v roce 2026 liší od starého Codexu, který byl ukončen?#

Lidé si je často pletou, protože oba produkty jsou oficiální a oba pocházejí od OpenAI. Rozlišují je data.

První byla sada modelů: code-davinci-001, code-davinci-002, code-cushman-001, code-cushman-002. Dělaly jedinou věc — doplňovaly za vás kód — a poháněly první GitHub Copilot. V seznamu ukončených modelů OpenAI jsou všechny čtyři uvedené na jednom řádku: oznámeny 20. března 2023, ukončeny 23. března, s gpt-4o jako doporučenou náhradou.

Druhý je program nainstalovaný ve vašem počítači. Balíček @openai/codex se objevil v registru npm 16. dubna 2025. Model uvnitř se časem nahrazuje novějším, zatímco samotný program zůstává stejný.

Jakékoli pokyny o Codexu z doby před dubnem 2025 popisují ukončený produkt. Pokud najdete materiál, který označuje Codex za model a radí volat ho přes code-davinci-002, zavřete ho.

Kde Codex funguje: v terminálu, editoru, prohlížeči, nebo aplikaci?#

Nemusíte si mezi nimi vybírat. Přihlášení je stejné a účet také. Liší se pouze tím, kde se vám pohodlněji pracuje.

Rozšíření funguje v Xcode a JetBrains jinak než v ostatních editorech:

Cloud funguje jinak než zbývající čtyři možnosti. Úkol se odešle do kontejneru OpenAI, kde se z GitHubu stáhne kopie repozitáře. Agent pracuje bez vašeho počítače a vy si později výsledek prohlédnete a rozhodnete, zda změny přenesete do své kopie. Nastavení má tři kroky: připojit GitHub, vytvořit prostředí s potřebnými závislostmi a zadat úkol.

Pokud se přihlásíte pomocí klíče API, funguje terminál, editor i aplikace. Cloud s klíčem dostupný není, stejně jako funkce, které jsou s ním spojené, například automatická kontrola kódu a spouštění úkolů ze Slacku. K tomu se musíte přihlásit účtem ChatGPT.

Který model běží uvnitř Codexu?#

OpenAI to shrnuje jednou větou:

Vedle modelu je druhé nastavení: úroveň uvažování. Má čtyři možnosti: Low (v aplikaci a editoru se nazývá Light), Medium, High a Extra High. OpenAI doporučuje použít nejnižší úroveň, která přinese potřebný výsledek, a zvýšit ji, když úkol vyžaduje plánování.

Nad tím jsou ještě dva režimy. Max dává modelu na úkol více času. Ultra rozdělí práci na části a souběžně je přidělí podagentům. Dokumentace výslovně uvádí, že většina úkolů nepotřebuje ani jeden z nich.

K dispozici je také samostatná varianta gpt-5.3-codex-spark — výzkumná verze pro rychlé iterace, dostupná pouze v tarifu Pro.

Výběr modelu a úrovně uvažování už představuje kontextové inženýrství: rozhodujete, jak moc má agent přemýšlet a co si k úkolu přinese. Tato kombinace má tři pilíře: AI klon (vaše metodika uvnitř agenta), Druhý mozek (struktura znalostí o projektu) a kontextové inženýrství. Bez této kombinace si AI agent začne vymýšlet.

Kolik Codex stojí a co je součástí tarifů?#

Ceny jsem ověřil na oficiální stránce s cenami 1. srpna 2026.

Business stojí při měsíční fakturaci $25 za místo místo $20.

A teď k limitům. OpenAI neuvádí jedno pevné číslo:

Místo jednoho čísla OpenAI zveřejňuje rozmezí: kolik zpráv můžete odeslat během pěti hodin při práci na vlastním počítači. Údaje jsou pro Plus a Business stejné:

V tarifu Pro za $100 se všechny hodnoty násobí pěti; v tarifu Pro za $200 dvaceti. OpenAI kromě pětihodinového okna zmiňuje také týdenní limity, ale nezveřejňuje jejich konkrétní hodnoty.

Desetinásobné rozpětí u jediného modelu má jednoduché vysvětlení. Jedna zpráva může spotřebovat jedno nebo deset procent vašeho denního limitu, protože rozhoduje množství odvedené práce, zatímco počet požadavků má malý vliv. Podrobně jsem vysvětlil, jak se tokeny v praxi spotřebovávají, na příkladu Claude v článku Limity Claude Pro a Max — mechanismus je úplně stejný.

Když limit vyčerpáte, máte tři možnosti: koupit si další kredity bez změny tarifu, přejít na lehčí model nebo zahájit relaci s klíčem API a platit za tokeny podle skutečného využití.

Jaká regionální omezení pro Codex platí?#

OpenAI veřejně zveřejňuje svůj oficiální seznam podporovaných zemí a území. Bělorusko na něm není. Kazachstán, Arménie, Gruzie, Turecko, Srbsko a Ukrajina na něm jsou.

Znění na téže stránce:

Instalace a spuštění programu jsou jedna věc; přístup k modelu je druhá. Kontrola země se aktivuje při přihlášení: přihlášení přes ChatGPT i pomocí klíče API vede k účtu OpenAI.

Příspěvky na GitHubu ukazují, jak vypadá zamítnutí související se zemí. V lednu 2026 vývojář z Venezuely napsal, že používal Codex 0.88.0 v PowerShellu a při každém pokusu dostal totéž:

{
  "error": {
    "code": "unsupported_country_region_territory",
    "message": "Country, region, or territory not supported",
    "type": "request_forbidden"
  }
}

Kód unsupported_country_region_territory a stav 403 označují zamítnutí související se zemí. Pokud to uvidíte, znamená to, že jste při instalaci nic nepokazili a Node s tím nemá nic společného.

Existuje ještě druhá překážka, kterou dokumentace vůbec nezmiňuje, ale v praxi se objevuje častěji. Jde o ověření telefonního čísla. Hlášení „Ověření telefonního čísla nefunguje“ má 206 komentářů; druhé hlášení, o starém čísle, ke kterému už není přístup a které nelze změnit, je otevřené od června 2026 a má 71 komentářů. Opakuje se stejný příběh: ChatGPT v prohlížeči na stejném účtu funguje, ale Codex žádá ověření telefonu a neexistuje způsob, jak ho obejít. OpenAI nezveřejňuje seznam zemí, jejichž telefonní čísla přijímá, takže si předem nemůžete ověřit, zda přijme to vaše.

Obcházením se nezabývám; tento článek popisuje, jak nástroj funguje.

Anthropic rovněž zveřejňuje seznam podporovaných zemí a funguje to stejně. Materiály, které jeden nástroj označují za „povolený“ a druhý za „blokovaný“, čtenáře pouze klamou — formálně jsou na tom stejně. Oba seznamy se mění, proto kontrolujte jejich aktuální verze.

Jak nainstalovat Codex: krok za krokem#

Tady začíná technická část pro ty, kteří už mají aktivní účet OpenAI.

1. Nainstalujte program

   Zvolte způsob pro svůj systém. Stejný způsob později použijte k aktualizaci programu na nejnovější verzi.

2. Otevřete složku projektu

   Agent pracuje ve složce, ze které jste ho spustili. Před zadáním prvního příkazu do ní přejděte.

3. Přihlaste se ke svému účtu

   Při prvním spuštění codex vám nabídne přihlášení. Otevře se prohlížeč a po přihlášení se ovládání vrátí do terminálu.

4. Zadejte první úkol

   Popište, co potřebujete, běžným jazykem. Začněte něčím neškodným, například požádejte agenta, aby popsal projekt.

Instalační příkaz pro macOS a Linux:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Ve Windows použijte stejný instalátor přes PowerShell:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Pokud už máte Node, můžete ho nainstalovat přes npm:

npm install -g @openai/codex

Na macOS funguje Homebrew. Použijte --cask; bez něj nainstalujete nesprávnou věc:

brew install --cask codex

V Linuxu a WSL2 je sandbox postavený na bubblewrap, který musíte nainstalovat předem:

sudo apt install bubblewrap

Ve Fedoře a příbuzných systémech použijte sudo dnf install bubblewrap. WSL verze 1 byla podporována do verze 0.114; od verze 0.115 se sandbox přesunul na bubblewrap a WSL1 přestal fungovat. Ve Windows ale všechno funguje i bez WSL, s vlastním vestavěným sandboxem.

Co udělat při prvním spuštění?#

Začněte tím, že přejdete do složky projektu a zadáte codex; otevře se relace. Pak běžným jazykem popište úkol, bez zvláštní syntaxe.

Pět příkazů pro prvních pár minut:

1. /status – model, zásady schvalování a složky, které agent považuje za svůj pracovní prostor.
2. /permissions – aktuální režim přístupu a způsob přepínání mezi režimy.
3. /model – změna modelu a úrovně uvažování.
4. /init – vytvoří soubor AGENTS.md popisující projekt; více v další části.
5. /review – samostatná kontrola změn bez úprav souborů.

Kromě prostého codex jsou užitečné také tři příkazy v terminálu:

codex resume                    # return to the previous conversation in this folder
codex exec "fix the tests"      # one-off run without a dialogue, for scripts
codex --image screenshot.png    # attach an image to the task

V dokumentaci terminálu i rozšíření OpenAI opakuje stejnou radu: před úkolem i po něm vytvořte commit. Agent sám upravuje soubory a hned od prvního dne budete chtít mít možnost změny vrátit jediným příkazem.

Jak Codexu vysvětlit projekt pomocí AGENTS.md?#

Pořadí je přesně dané a dokumentace ho uvádí hned v první větě této části:

Nejprve Codex přečte globální soubor ~/.codex/AGENTS.md, kam zapíšete návyky platné pro všechny vaše projekty. Pak čte soubory přímo v projektu: jeden soubor v každé složce, od kořene repozitáře až po aktuální složku. Spojí je shora dolů a bližší soubor má přednost před vzdálenějším. Pravidlo ve složce services/payments má tedy přednost před obecným pravidlem z kořene.

Jednoduchý soubor vypadá takto:

# AGENTS.md

## Jak pracovat s tímto projektem

- Testy spouštějte pomocí `npm test`; nespouštějte je po jednom souboru.
- Balíčky instalujte pomocí pnpm.
- Před přidáním nové produkční závislosti se mě zeptejte.
- Složky `legacy/` se vůbec nedotýkejte.

Souhrnný limit souborů je 32 kilobajtů. Po jeho překročení se další soubory jednoduše přestanou přidávat, aniž by vás někdo upozornil. Příliš velký soubor AGENTS.md navíc při každém spuštění spotřebovává limit, protože se celý přidává do kontextu.

Pokud znáte CLAUDE.md, bude vám tento způsob práce povědomý: jde o stejnou techniku pod jiným názvem. Soubor s projektovými pravidly tvoří základ Druhého mozku: agent se o vaší práci dozví ještě předtím, než ji stihnete vysvětlit. O používání obou souborů v jednom projektu píšu v článku AGENTS.md a CLAUDE.md společně.

Co Codex dělá sám a co vyžaduje schválení?#

Tato dvě nastavení se často zaměňují, proto OpenAI jejich rozdíl vysvětluje jednou větou:

Přepnutí kontroly na automatickou ponechá hranice pracovní složky stejné. Automatizace pouze odstraní klikání; oprávnění agenta nemění.

Aplikace a editor mají tři režimy přístupu. Ask for approval je vždy dostupný a doporučuje se jako výchozí. Režimy Approve for me a Full access je nejprve nutné povolit v nastavení.

Terminál má vlastní pravidla: program zkontroluje složku a navrhne vhodnou sadu oprávnění.

V místním režimu je přístup k síti ve výchozím nastavení vypnutý. Agent sám spouští příkazy, které navrhl, a nikdo by mu ve výchozím nastavení nepovolil přístup k internetu.

I v pracovní složce může agent v každém režimu číst jen některá místa: .git, .agents a .codex. Příkazem /status zjistíte, které složky agent právě považuje za svůj pracovní prostor.

Existuje také režim plného přístupu — příznak --dangerously-bypass-approvals-and-sandbox. Dokumentace ho označuje za rizikovější a uvádí „nedoporučuje se“. Název příznaku mluví sám za sebe; není co dodat.

Codex, nebo Claude Code: který si vybrat?#

Rozdíl mezi nástroji je menší, než byste usoudili z internetových debat. Oba čtou váš projekt a samy upravují soubory; u obou je před prací mimo složku nutné schválení.

Na začátku se nejsnáze podíváte na to, za co už platíte. Pokud máte předplatné ChatGPT, Codex už je v něm zahrnutý; nemusíte platit zvlášť. Podrobné srovnání s měřeními jsem připravil v samostatném článku o Codexu a Claude Code, a pokud chcete převést svá pracovní nastavení z jednoho nástroje do druhého, je tu průvodce migrací.

Co se nejčastěji pokazí při prvním spuštění?#

Seznam vychází z hlášení v repozitáři projektu. Nic si nedomýšlím; každá položka popisuje problém, na který někdo skutečně narazil.

1. Nainstaloval se nesprávný balíček. Příkaz npm install -g codex bez prefixu nainstaluje generátor statických webů z roku 2011. Správný balíček je @openai/codex.
2. Chybí bubblewrap. Bez něj se v Linuxu a WSL2 sandbox nespustí. Codex přejde na vestavěnou náhradní variantu a při spuštění zobrazí upozornění. Nainstalujte ho jedním příkazem.
3. Přístup odepřen kvůli zemi. Kód unsupported_country_region_territory a stav 403 se objeví při přihlášení. S instalací to nijak nesouvisí.
4. Je vyžadováno ověření telefonu. Netýká se to každého a dokumentace o tom nic neříká. Neexistuje oficiální způsob, jak nahradit číslo, k němuž už nemáte přístup; hlášení je otevřené od června 2026.
5. Limity používání vyčerpáte dříve, než čekáte. Hlášení „Tokeny se spotřebovávají velmi rychle“ je nejdiskutovanější v celém repozitáři, má 627 komentářů. Pomoci může přechod na lehčí model a snížení úrovně uvažování.

Jazyk rozhraní nemá na práci agenta vliv: jazyk úkolu se nemusí shodovat s jazykem rozhraní.

Co dál?#

První hodina s agentem vždy slouží stejnému účelu: zjistit, jak daleko může zajít sám. To se naučíte jen na vlastním projektu; příklad v dokumentaci vám to neukáže.

Doporučuji začít v tomto pořadí:

1. Nainstalujte program a přihlaste se k aktivnímu účtu OpenAI.
2. Otevřete skutečnou složku projektu a spusťte codex.
3. Projděte /status a /permissions, pro pouhou prohlídku výslovně zvolte přístup jen pro čtení a aktivní režim ověřte před dotazem na uspořádání projektu.
4. Vytvořte commit a zadejte agentovi první úkol s úpravou souborů.
5. Napište třířádkový soubor AGENTS.md a porovnejte odpovědi agenta před jeho přidáním a po něm.

AI klon + Druhý mozek + kontextové inženýrství — další materiály k práci s nástroji najdete v dokumentaci Ailoot.