# Codex URL: https://developertoolkit.ai/pl/codex/ Description: OpenAI Codex dla programistów i tech leadów: pierwsza zweryfikowana zmiana, wybór sandboxa i polityki akceptacji, dowód jakości i mapa przewodnika. **Sprawdzono w Codex CLI 0.157.1** Zweryfikowano 26 września 2026 r. poleceniami `codex --help`, `codex exec --help` i `codex review --help`. Od CLI 0.159.1 (2026-09-29, sprawdzone 2026-10-12; wcześniej GPT-6 Astra) domyślnym modelem wbudowanym w Codex jest GPT-6.1 Sol; dla zalogowanych kont serwer może to ustawienie nadpisać. Jeśli którejś flagi poniżej brakuje, uruchom `codex --version` i zajrzyj do [changelogu](/pl/codex/reference/changelog/). Codex to agent programistyczny OpenAI: czyta repozytorium, uruchamia polecenia w sandboxie, edytuje pliki i recenzuje diffy z poziomu CLI, aplikacji desktopowej, rozszerzeń IDE i Codex cloud. Domyślnym modelem wbudowanym w Codex jest GPT-6.1 Sol. O tym, czy wynikom można ufać, decydują sandbox, polityka akceptacji i bramki jakości repozytorium, a nie model. Ten przegląd jest dla programistów, którzy zaczynają pracę z Codeksem, i tech leadów, którzy standaryzują go w zespole. Typowy punkt wyjścia: Codex kończy zadanie, ale skrypt wciąż przekazuje usuniętą flagę `--full-auto`, `AGENTS.md` nie podaje komendy testów, a ty czytasz każdy diff, żeby sprawdzić, czy coś się nie zepsuło. ## Co daje ten przewodnik po Codeksie - Pierwszą zmianę przeprowadzoną od planu tylko do odczytu do zrecenzowanego diffu. - Ustawienie uprawnień dla każdego rodzaju sesji, od planowania po CI. - Warstwy weryfikacji, dzięki którym zatwierdzasz dowody, a nie linie kodu. ## Od której powierzchni Codeksa zacząć? Lokalne powierzchnie współdzielą `~/.codex/config.toml`, `AGENTS.md`, skills i serwery MCP; Codex cloud ma własne środowiska. | Powierzchnia | Jak uruchomić | Kiedy po nią sięgnąć | | --- | --- | --- | | CLI (TUI) | `codex` w katalogu głównym repozytorium | Potrzebujesz trybu planowania (`/plan`), worktree i wszystkich flag | | CLI nieinteraktywne | `codex exec "…"` | Skrypty i CI potrzebują zdarzeń JSONL (`--json`) albo odpowiedzi zgodnej ze schematem (`--output-schema`) | | Aplikacja desktopowa | `codex app` (macOS i Windows) | Równoległe wątki, każdy we własnym worktree | | Rozszerzenie IDE | VS Code, Cursor i Windsurf (dziś Devin Desktop) według README OpenAI | Chcesz mieć agenta obok edytowanego pliku | | Codex cloud | chatgpt.com/codex albo `codex cloud` (eksperymentalne) | Długie zadania w tle albo `@codex review` w pull requeście | [Instalacja](/pl/codex/quick-start/installation/) opisuje każdą powierzchnię, łącznie z JetBrains i Xcode. Wybór modelu i ceny znajdziesz na [stronie modeli](/pl/ecosystem/models/). ## Jak dowieźć pierwszą zweryfikowaną zmianę w Codeksie? Potrzebujesz repozytorium Git z czystym working tree i krótką specyfikacją zacommitowaną jako `docs/specs/login-rate-limit.md`. 1. Zainstaluj Codex, zaloguj się i sprawdź instalację (terminal): ```bash npm install -g @openai/codex codex login codex doctor ``` 2. Uruchom `codex` w katalogu głównym repozytorium, zaakceptuj pytanie o zaufanie i wpisz `/init`, żeby wygenerować `AGENTS.md`. Edytuj plik, aż będzie podawał dokładne komendy typecheck, lint i testów. 3. Wklej poniższy prompt planistyczny (zaczyna się od `/plan`), zanim agent zacznie turę, i zaakceptuj plan. Skopiuj zaakceptowany plan do `docs/plans/login-rate-limit.md` samodzielnie (tryb planowania nie edytuje żadnych plików), a potem zacommituj go razem z `AGENTS.md`. 4. Uruchom sesję w zarządzanym worktree Git poleceniem `codex --worktree` i wklej prompt implementacyjny. 5. Sprawdź zgłoszone komendy i kody wyjścia, a potem z wnętrza worktree zleć review diffu: ```bash codex review --uncommitted ``` Otwórz pull request; merge blokują wymagane kontrole CI i wskazany z imienia recenzent. **Prompt do skopiowania: plan przed jakąkolwiek edycją** ```text /plan Read AGENTS.md and docs/specs/login-rate-limit.md, then inspect the code that handles POST /api/login. Propose an implementation plan: the files you will change, the tests you will write first, the commands that prove the change (typecheck, lint, unit, integration), the risks, and how to roll back. Do not edit any file. ``` **Prompt do skopiowania: zbuduj jeden etap (milestone) i zgłoś dowody** ```text Read docs/plans/login-rate-limit.md and AGENTS.md. Implement milestone 1 and nothing else. Write the failing tests first, then the code. Run every typecheck, lint and test command AGENTS.md lists. If a check fails, fix the implementation; never delete, skip or loosen a test. Finish with: files changed, each command you ran with its exit status, and the risks you did not cover. ``` ## Jaki sandbox i jaką politykę akceptacji ustawić dla sesji Codeksa? Codex oddziela to, czego polecenie może dotknąć (sandbox), od tego, kiedy najpierw pyta ciebie (polityka akceptacji). W 0.157.1 `-a` przyjmuje tylko `on-request` (domyślnie) i `never`. OpenAI zaleca profile uprawnień (beta, CLI 0.138.0 lub nowsze), wybierane przez `-c default_permissions=""` albo w `config.toml`. Starsza flaga `--sandbox` nadal działa, ale oba mechanizmy się nie łączą, więc w jednej sesji wybierz jeden ([przewodnik po konfiguracji](/pl/codex/quick-start/configuration/)). | Sesja | Ustawienie | Na co uważać | | --- | --- | --- | | Planowanie i review | `/plan`; albo profil `:read-only` (`-c default_permissions=":read-only"`), albo starsze `--sandbox read-only` | Wpisz `/plan` przed turą, nie w trakcie pracy | | Interaktywna implementacja w worktree | Profil `:workspace` (`-c default_permissions=":workspace"`) albo starsze `--sandbox workspace-write`, z akceptacjami `on-request` | Zatwierdzanie bez czytania | | Długi przebieg lokalny bez nadzoru | `--approve-for-me` (model recenzujący akceptuje w ramach `workspace-write`) | Ocenia wyjścia poza sandbox, nie poprawność | | Job CI | `codex exec -c default_permissions=":read-only"` (albo starsze `--sandbox read-only`) do review; `:workspace` lub `workspace-write` do poprawek | `codex exec` i tak działa z akceptacją `never` i nie ma `-a` | | Pełny dostęp | `--dangerously-bypass-approvals-and-sandbox` | Tylko jednorazowe runnery z ograniczoną siecią | ## Skąd wiesz, że wynik Codeksa jest poprawny, bez czytania każdej linii? Każda warstwa wymusza to, o co warstwa wyżej tylko prosi: - **`AGENTS.md` nazywa bramki**, ale niczego nie wymusza ([AGENTS.md w Codeksie](/pl/codex/quick-start/agents-md/)). - **Hooki i reguły wymuszają.** Zaufane hooki z `.codex/hooks.json` działają niezależnie od promptu; pliki `.rules` decydują, które polecenia mogą wyjść poza sandbox. - **`codex review` ponownie czyta diff** (`--uncommitted`, `--base` albo `--commit`). - **CI ponownie uruchamia bramki**, a review tylko do odczytu dokłada drugą opinię w formacie maszynowym: ```bash codex exec -c default_permissions=":read-only" \ --output-schema .github/codex/schemas/findings.json \ "Review the diff between origin/main and HEAD against docs/specs/login-rate-limit.md. Report only blocking findings, each with file, line, and the behaviour that fails." ``` Schemat znalezisk znajdziesz w [Codex w CI/CD](/pl/codex/ship/ci-cd/#zablokuj-build-przy-znaleziskach-p0-dzięki-ustrukturyzowanemu-wynikowi). - **Człowiek zatwierdza [pakiet dowodów](/pl/workflows/ship/evidence-bundle/)**, a nie każdą linię ([dlaczego dowody wygrywają z diffami](/pl/ladder/evidence-not-diffs/)). **Niezaufane pull requesty w CI** Nigdy nie uruchamiaj kodu kontrybutora, gdy w środowisku jest sekret. Gdy zadanie z sekretem recenzuje pull request kontrybutora, uruchamiaj Codex z checkoutu własnej gałęzi domyślnej, commit kontrybutora umieść w osobnym katalogu, który agent tylko czyta, nie wczytuj z niego `AGENTS.md`, hooków ani konfiguracji projektu, zostań przy trybie tylko do odczytu i nigdy nie przekazuj `--dangerously-bypass-hook-trust`. [Codex w CI/CD](/pl/codex/ship/ci-cd/) pokazuje konfigurację `openai/codex-action@v1`. ## Co psuje się najpierw, gdy wdrażasz Codex? - **„unexpected argument”.** 0.157.1 odrzuca `codex exec -a never …`. Usuń flagę: `codex exec` i tak działa z akceptacją `never`, a prefiks `codex -a … exec` tego nie zmienia. - **Skrypty przekazują `--full-auto`.** W 0.157.1 tej flagi nie ma. Użyj profilu uprawnień (`-c default_permissions=":workspace"`), `--approve-for-me` albo `--sandbox workspace-write`. - **Codex ignoruje `AGENTS.md`.** Niezaufane projekty go nie dostarczają (od CLI 0.150.0); oznacz projekt jako zaufany, ale tylko checkout napisany przez ciebie lub twój zespół, nigdy gałąź kontrybutora w CI. - **Równoległe sesje wchodzą sobie w drogę.** `codex --worktree` izoluje pliki, ale nie porty ani bazy danych ([worktree](/pl/codex/automate/worktrees/)). ## Dokąd dalej z Codeksem - **Programiści:** [instalacja](/pl/codex/quick-start/installation/), [przewodnik po aplikacji desktopowej](/pl/codex/build/app-mastery/) i [zarządzanie kosztami](/pl/codex/operate/cost-management/). - **Tech leadzi:** [przepływy pracy zespołu](/pl/codex/team/team-workflows/), [zarządzanie w firmie](/pl/codex/team/enterprise-governance/) i [ścieżka dla tech leada](/pl/start/tech-lead/). - **Cykl życia i inne narzędzia:** [AI-native SDLC](/pl/method/lifecycle/), [mapa narzędzi](/pl/method/lifecycle/tool-map/) oraz [Codex kontra Cursor i Claude Code](/pl/comparison/vs-codex/).