Codex CLI pro začátečníky: instalace, základy a první projekt

Codex CLI je AI coding agent od OpenAI, který funguje přímo v terminálu a umí pracovat se soubory a kódem v existujícím projektu. Na rozdíl od běžného chatu neodpovídá jen na otázky — dokáže projít repozitář, navrhnout změny, upravit soubory a spustit testy nebo build.

Tento článek vychází z krátkého video návodu a doplňuje praktický rámec pro firmy i developery, kteří chtějí AI agenta používat bezpečně při reálném vývoji webů, aplikací nebo interních nástrojů.

Co je Codex CLI

Codex CLI je command-line rozhraní pro AI coding agenta. Spouští se v terminálu v konkrétní složce projektu. Díky tomu má kontext z reálných souborů — package.json, rout, komponent, testů, konfigurací i dokumentace v repozitáři.

Typická použití:

• vysvětlení struktury existujícího projektu,
• nalezení konkrétní části kódu,
• příprava menší úpravy nebo refaktoringu,
• psaní testů,
• oprava build nebo lint chyb,
• přehled změn před commitem.

Codex CLI je nejpraktičtější u projektů, které už mají Git, package scripts a alespoň základní ověření přes testy nebo build.

Codex CLI vs. ChatGPT vs. Claude Code

ChatGPT je výborný na vysvětlování, návrhy a práci s úryvky kódu. Codex CLI je vhodnější tehdy, když agent potřebuje pracovat s celým projektem a nástroji v terminálu.

Claude Code a podobné nástroje řeší podobný problém: agentický vývoj přímo nad repozitářem. Rozdíly jsou v modelu, workflow, integracích a práci s nástroji. Důležitější než název nástroje je však proces: agent má nejdřív projekt prozkoumat, navrhnout plán, udělat malou změnu a tu následně ověřit.

Instalace a první spuštění

Ve videu probíhá instalace přes PowerShell na Windows. Na macOS nebo Linuxu je princip stejný: otevřít terminál, nainstalovat CLI podle aktuální dokumentace a přihlásit se přes ChatGPT nebo OpenAI účet.

Základní postup:

1. Otevřete terminál nebo PowerShell.
2. Nainstalujte Codex CLI podle aktuálního návodu.
3. Přihlaste se přes ChatGPT účet.
4. Přejděte do složky projektu.
5. Spusťte Codex CLI až z kořene repozitáře.

Klíčové je spustit agenta ve správné složce. Pokud ho otevřete mimo projekt, nebude mít kontext a bude hádat.

První projekt v Codex CLI

Po spuštění ve složce projektu nezačínejte hned pokynem „uprav mi stránku“. Lepší první prompt je diagnostický:

Projdi si projekt, vysvětli jeho strukturu a navrhni, kde by se měla udělat změna pro novou blog stránku.

Až potom zadejte konkrétní cíl:

Přidej novou sekci do existující landing page. Zachovej vizuální styl, po změně spusť lint a build a ukaž diff.

Takový postup snižuje riziko, že agent upraví špatný soubor nebo vytvoří paralelní systém místo použití existujících komponent.

Jak zadávat dobré úkoly

Codex CLI funguje nejlépe, když má jasný cíl a hranice:

• uveďte přesnou URL, komponentu nebo soubor, kterého se změna týká,
• řekněte, co se nemá měnit,
• chtějte nejdřív plán nebo stručné shrnutí existujícího stavu,
• trvejte na ověření přes npm run build, testy nebo lint,
• před commitem si projděte diff.

Příklad dobrého zadání:

Na stránce /webove-aplikacie-na-mieru doplň FAQ sekci o ceně vývoje. Nepřepisuj layout ani navigaci. Použij existující styl, spusť build a připrav krátké shrnutí změn.

Bezpečnost a kontrola změn

AI coding agent je silný nástroj, ale neměl by mít nekontrolovaný přístup k produkci. U firemního projektu doporučujeme:

• pracovat vždy v Gitu a na samostatné větvi,
• nepouštět agenta přímo na produkční server bez review,
• neukládat API klíče do promptů ani do repozitáře,
• kontrolovat každý diff před commitem,
• deployovat až po úspěšném buildu nebo testu.

AI coding agent je užitečný hlavně tehdy, když mu dáte jasný cíl, necháte ho nejdřív prozkoumat projekt a každou změnu před nasazením ověříte.

Video návod

Podívat se na video návod na YouTube

Kdy se Codex CLI vyplatí ve firmě

Codex CLI dává smysl při údržbě webů, menších produktových změnách, refaktoringu, přípravě testů a rychlém vysvětlení staršího kódu. Nenahrazuje senior developera ani code review, ale výrazně zkracuje čas mezi nápadem a ověřenou změnou.

Pokud řešíte vývoj webové aplikace nebo interního systému, AI coding agent může být součástí workflow — ale stále musí být napojený na Git, testy a kontrolovaný deploy.