Budowanie z Codexem: kontekst, izolacja i bramki

Budowanie z Codexem działa, gdy przed napisaniem pierwszej linijki kodu ustalone są trzy rzeczy: AGENTS.md i skille niosą zasady projektu, każde zadanie działa we własnym worktree Gita, a o zakończeniu zadania decyduje polecenie wybrane z góry. Podsumowanie od Codexa to twierdzenie do sprawdzenia, a nie dowód.

Ten przegląd jest dla programistów, którzy używają Codexa na co dzień, i tech leadów ustalających domyślne ustawienia zespołu. Strony poniżej pokazują, jak izolować pracę i jak sprawić, by każdy wynik sam się bronił. Polecenia sprawdzono na Codex CLI 0.157.1.

Która strona o budowaniu z Codexem odpowiada na twoje pytanie?

Twoje pytanie	Strona
Jak sprawić, by AGENTS.md i skille się ładowały, i to udowodnić?	Optymalizacja AGENTS.md i skilli w Codexie
Jak sformułować zadanie, żeby Codex trafił za pierwszym razem?	Efektywne promptowanie i strategie AGENTS.md
Jak powstrzymać dryf długich sesji i przekazywać pracę między wątkami?	Zarządzanie kontekstem na powierzchniach Codexa
Których poleceń i skrótów warto się nauczyć?	Komendy CLI Codexa, komendy slash i skróty
Jak prowadzić równoległe wątki w aplikacji desktopowej?	Aplikacja desktopowa Codexa: równoległe wątki, worktrees i review
Jak sprawić, by każda sesja startowała szybciej?	Triki na wydajność w Codexie
Jak zbudować endpoint, któremu ufam bez czytania handlera?	API z Codexem: najpierw kontrakt
Jak udowodnić, że zmiana schematu albo migracja jest bezpieczna?	Praca z bazą danych w Codexie
Jak bezpiecznie zrefaktoryzować setki plików?	Refaktoryzacja na dużą skalę z worktree
Jak wprowadzić jedną zmianę w wielu pakietach lub repozytoriach?	Operacje masowe w Codexie
Jak falami zmigrować kod legacy?	Modernizacja legacy z Codexem
Jak utrzymać dokumentację i changelog w zgodzie z kodem?	Generowanie i utrzymanie dokumentacji z Codexem

Przed tym etapem: szybki start z Codexem i planowanie z Codexem. Powiązane: przepływy wieloagentowe i przepływy budowania dla każdego narzędzia.

W jakiej kolejności prowadzić zadanie budowania w Codexie?

Każdy krok zamyka jedną drogę, którą zadanie wyglądające na skończone może okazać się błędne. Polecenia poniżej dotyczą CLI.

1. Sprawdź, co Codex faktycznie ładuje. W katalogu głównym repozytorium zrzuć do pliku dokładnie to, co trafia do modelu:

   codex debug prompt-input > /tmp/codex-input.json

   Od wersji 0.150.0 niezaufany projekt nie dostarcza swojego projektowego AGENTS.md (globalny ~/.codex/AGENTS.md nadal się ładuje). Oznacz repozytorium jako zaufane, akceptując pytanie, które Codex wyświetla przy pierwszym otwarciu w nim sesji, a potem sprawdź zrzut. Zrzut jest w formacie JSON, więc cudzysłowy, ukośniki wsteczne i znaki nowej linii z AGENTS.md pojawiają się w nim w postaci escapowanej: szukaj krótkiej frazy z jednej linii bez tych znaków albo dodaj do AGENTS.md unikalne słowo-znacznik i szukaj właśnie jego. Wynik większy od zera oznacza, że twoje zasady się załadowały:

   grep -c "<krótka fraza lub znacznik z AGENTS.md>" /tmp/codex-input.json

2. Planuj w trybie read-only. Uruchom sesję przez codex -s read-only albo użyj /plan i poproś o plan oraz kryteria akceptacji, zanim Codex cokolwiek zmieni w plikach.

3. Buduj w worktree. Zaczynaj od codex --worktree albo /worktree w sesji, żeby równoległe zadania nigdy nie dzieliły katalogu roboczego.

4. O wyniku decydują twoje polecenia, nie raport Codexa. Testy, sprawdzenie typów i lint wskazane w AGENTS.md rozstrzygają, kiedy zadanie jest skończone; sprawdź ich kody wyjścia.

5. Przejrzyj zmiany przed commitem. Uruchom codex review --uncommitted w worktree i popraw każde zgłoszenie, które zablokowałoby pull request (poprawność, bezpieczeństwo, utrata danych), zanim gałąź do niego trafi.

Zostań przy domyślnym modelu, GPT-6 Astra, i zanim zmienisz model, podnieś poziom rozumowania (reasoning effort). Codex domyślnie uruchamia Astrę na poziomie low; podniesiesz go w danej sesji przez /model. Dla zalogowanych kont serwer może ustawić inny model domyślny, więc sprawdź w /model, na czym faktycznie pracujesz. Aktualny zestaw modeli jest w przeglądzie modeli.

Prompt do skopiowania: plan funkcji z kryteriami akceptacji

Read AGENTS.md and the modules this feature touches. Do not edit any files.
Feature: let users export their invoices as CSV from the billing page.
Write a plan with:
1. The files you will change or create, and why each one.
2. Acceptance checks as commands I can run (test names, a curl call, a typecheck),
   each with the result that proves the check passed.
3. The existing tests that must stay green, and any test you will add first so it
   fails before the change.
4. Anything in the plan that touches authentication, billing totals or a migration.
Stop after the plan and wait for my approval.

Prompt do skopiowania: zakończ zadanie w worktree z dowodami

You are done implementing. Before you report back:
1. Run the test, typecheck and lint commands from AGENTS.md. Report each command
   and its exit code. Do not claim a result you did not run.
2. List every file you changed. Flag any change to a test, a fixture, CI config or
   a shared utility outside the feature's directory, with the reason.
3. Say which acceptance check from the plan each change satisfies, and which check
   is not covered by an automated test yet.
End with one line: DONE, or NOT DONE and what is missing.

Skąd wiesz, że praca Codexa jest poprawna, bez czytania każdej linijki?

Codex nie kontroluje żadnego z tych dowodów. Najpierw przeczytaj dowód, a diff otwieraj tylko tam, gdzie on wskazuje.

Dowód	Co udowadnia	Kto za niego odpowiada
Wynik codex debug prompt-input zawiera twoje zasady	Codex pracował zgodnie z waszymi konwencjami	Opiekun AGENTS.md
Nowy test nie przechodził przed zmianą, a po niej przechodzi	Zmiana robi to, co obiecywał plan	Programista
Cały zestaw testów, sprawdzenie typów i lint kończą się kodem 0	Dotychczasowe zachowanie nadal działa	CI
codex review --uncommitted nie zgłasza niczego, co zablokowałoby pull request	Brak znanych defektów według waszych własnych zasad review	Programista
Brak niewyjaśnionych zmian w testach, CI i kodzie współdzielonym	Codex nie zmienił reguł w trakcie gry	Tech lead przez CODEOWNERS

Co się psuje, gdy Codex buduje funkcje?

Objaw	Przyczyna	Jak naprawić
Codex ignoruje zasadę zapisaną w AGENTS.md	Niezaufany projekt albo plik poza ładowanym łańcuchem	Krok 1, a potem przenieś długie procedury do skilla
Jeden wątek nadpisuje edycję drugiego	Oba działały w głównym checkoucie	Krok 3
Codex melduje „all tests pass”, a CI pada	Codex uruchomił tylko część testów albo inne polecenie	Wpisz dokładne polecenia do AGENTS.md; wymagaj kodów wyjścia w raporcie
Poprawka działa, bo osłabiono test	Agent może edytować własne kontrole	Oznaczaj zmiany w testach w prompcie końcowym; obejmij ścieżki testów plikiem CODEOWNERS
Długa sesja zaczyna przeczyć wcześniejszym decyzjom	Kontekst został skompresowany (compaction) i szczegóły przepadły	Zapisz plik przekazania i kontynuuj w nowym wątku

Dokąd dalej z budowaniem w Codexie

Udowodnij testami

Testowanie i debugowanie z Codexem

Wdróż

Code review i wdrożenie z Codexem

Używasz też innego agenta? Ten sam etap opisują strony budowanie z Claude Code i budowanie z Cursorem.