Tvůj první úkol pro Codex
Na této stránce
Aktualizováno 3. listopadu 2026 na základě reference příkazů Codex (CLI 0.166.0): možnosti
--show-diffa--applyneexistují. Lokálně Codex upravuje soubory přímo ve svém sandboxu; změny zkontroluj pomocí/diffnebogit 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ý prvek | Co obsahuje |
|---|---|
| Diff změn | Kaž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é akce | Schvá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