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

Tvůj první úkol pro Codex

Lekce 4 z 20 Aktualizováno 3. listopadu 2026 Vývojář
Na této stránce
  1. Spuštění tvého prvního úkolu
  2. Z Codex Cloud
  3. Z IDE
  4. Z příkazového řádku (CLI)
  5. Anatomie výsledku Codexu
  6. Psaní dobrých pokynů
  7. Klíčové poznatky

Aktualizováno 3. listopadu 2026 na základě reference příkazů Codex (CLI 0.166.0): možnosti --show-diff a --apply neexistují. Lokálně Codex upravuje soubory přímo ve svém sandboxu; změny zkontroluj pomocí /diff nebo git diff. Příkaz rozšíření „Codex: New Task“ byl nahrazen příkazem Codex: Open Codex Sidebar. Zdroje: Příkazy pro vývojáře · Rozšíření Codex pro IDE.

Spuštění tvého prvního úkolu

Máš nastavený účet, připojený GitHub a soubor AGENTS.md je na místě: je čas vidět agenta v akci. Zde je zlaté pravidlo pro každou úroveň dovedností – začni úkolem, u kterého už znáš správnou odpověď. Naučíš se jen málo tím, že budeš sledovat, jak Codex řeší problém, který nedokážeš vyhodnotit, ale naučíš se obrovské množství tím, že ho necháš pracovat na známém území.

Z Codex Cloud

Na webu nebo v desktopové aplikaci zvol Work in › Cloud, vyber publikované prostředí pro svůj repozitář (Lekce 2) a zadej svůj úkol do vstupního pole. Funguje dokonale i něco záměrně skromného.

Task: "Add a .gitignore file suitable for a Node.js/TypeScript 
       project if one doesn't already exist."

Tato formulace obsahuje podmínku – „if one doesn’t already exist“ (pokud ještě neexistuje) – což je přesně to, co činí pozorování zajímavým. V Codex Cloud se úkol spustí v prostředí, které jsi pro tento repozitář publikoval: Codex zkontroluje, zda .gitignore existuje, ověří, zda pokrývá Node.js a TypeScript (pokud ano), vytvoří nebo aktualizuje soubor podle potřeby a následně ti výsledek zobrazí jako diff. Protokol provádění se streamuje v reálném čase: zde uvidíš, zda agent podmínku dodržel, nebo přepsal tvůj existující soubor.

Z IDE

Otevři svůj projekt ve VS Code (nebo Cursor, Windsurf) a spusť Codex přes jeho ikonu nebo Paletu příkazů:

Ctrl+Shift+P → "Codex: Open Codex Sidebar"

Poté formuluj požadavek, který využívá lokální kontext pojmenováním konkrétního souboru:

"Add email validation to the contact form 
 in src/components/ContactForm.tsx"

Rozšíření zobrazí shrnutí a upravené řádky vedle kódu; změny, které chceš, si ponecháš a v rámci stejné konverzace můžeš žádat o doplňující úpravy. Dokumentace doporučuje vytvořit kontrolní bod Gitu před úkolem i po něm, abys mohl v případě potřeby vrátit změny zpět.

Z příkazového řádku (CLI)

# Navigate to the project directory
cd my-project

# Start a session with an initial instruction
codex "Add a README.md with the project description, installation instructions, and available commands"

Lokálně Codex upravuje soubory přímo ve tvém pracovním adresáři, v rámci limitů sandboxu a zásad schvalování: před provedením akcí, které to vyžadují, si vyžádá povolení. Abys před commitováním zkontroloval, co se změnilo, zadej v relaci /diff: příkaz zobrazí Git diff, včetně nesledovaných souborů. Příkaz /review požádá Codex, aby zrecenzoval tvůj pracovní strom samotný. Pro skriptované použití spustí codex exec stejný úkol bez interakce (Lekce 14) – v takovém případě je na Gitu a tvém pipeline, aby rozhodly, co se zachová.

Anatomie výsledku Codexu

Bez ohledu na vstupní bod vždy dokončený úkol vrátí stejné čtyři prvky. Zkontroluj je v tomto pořadí: diff říká, co se změnilo, protokol říká proč, testy říkají, zda je to bezpečné, a akce ti předávají kontrolu zpět.

Doručený prvekCo obsahuje
Diff změnKaždý přidaný, upravený nebo smazaný řádek, soubor po souboru
Protokol prováděníVšechny kroky: čtené soubory, spuštěné příkazy, úvahy agenta
Výsledky testůPokud testy existují, Codex je spustí, aby ověřil, že nic není rozbité
Dostupné akceSchválit, upravit, vytvořit PR nebo znovu spustit s jinými pokyny

Začátečníci často zanedbávají protokol provádění, přestože je to prvek, který tě učí, jak formulovat své úkoly. Tím, že uvidíš, které soubory Codex otevřel před rozhodnutím, zjistíš, co hledal, ale nenašel – často jde o konvenci, která měla být v AGENTS.md.

Psaní dobrých pokynů

Kvalita výsledku přímo závisí na kvalitě pokynů a rozdíl mezi dvěma níže uvedenými formulacemi je mnohem větší než rozdíl mezi dvěma modely.

"Improve the code"
"In src/lib/auth.ts, replace manual JWT handling 
with the jose library. Keep the same public interface 
(signToken, verifyToken). Update the corresponding tests."

Druhá verze funguje, protože odpovídá na čtyři otázky, které si agent stejně klade. Specifikuje涉及的 soubory, čímž šetří čas prozkoumáváním a cílením na špatné místo. Definuje očekávaný výsledek – chování, rozhraní, formát – takže ví, kdy přestat. Stanovuje omezení, zde zachování veřejného rozhraní, což mu brání v „vylepšování“ věcí lámáním volajících funkcí; jinde by to mohlo být „nerozbíjej testy“. A když to rizika ospravedlňují, přidává obchodní kontext: specifikace „toto je platební formulář, bezpečnost je kritická“ skutečně mění jeho kompromisy.

Aby sis to osvojil, vezmi existující projekt a řetězově spoj tři úkoly různé povahy: analýzu bez úprav („Vypiš všechny TypeScript soubory, které nemají přidružené testy“); cílenou generaci („Vygeneruj unit test pro tento soubor“); opravu s omezeným rozsahem („Oprav varování ESLint v src/utils/“). U každého si poznamenej, co jsi měl specifikovat předem: tento seznam litostí je tvým prvním návrhem AGENTS.md.

Klíčové poznatky

  • Spusť své první úkoly s jednoduchými, cílenými požadavky
  • Codex poskytuje úplný protokol provádění pro každý úkol
  • Kvalita výsledku závisí na přesnosti tvých pokynů
  • Vždy si zachováváš kontrolu: schvaluj, upravuj nebo odmítej
  • Začni úkoly s nízkým rizikem, než přejdeš ke kritickým změnám