Codex – szybki start: od instalacji do sprawdzonego pierwszego zadania

Szybki start z Codex to ścieżka dziewięciu przewodników dla programistów, która prowadzi agenta kodującego OpenAI od instalacji do pierwszej zmiany scalonej z główną gałęzią. Obejmuje cztery wersje Codex (aplikację desktopową, CLI, rozszerzenie IDE i chmurę), logowanie, config.toml, AGENTS.md, GitHub i MCP. Metą jest zadanie, którego wynik sprawdzają testy i drugi przegląd (review).

Zacznij od niewłaściwej wersji, a popołudnie zejdzie na konfiguracji. Ta strona pomaga wybrać pierwszą wersję Codex, ustala kolejność przewodników i pokazuje, jak zaufać pierwszemu zadaniu bez czytania każdej linii.

Co masz po szybkim starcie z Codex

• Jedną wersję Codex zainstalowaną, zalogowaną i przechodzącą codex doctor
• Świadomie napisane config.toml i AGENTS.md
• Pierwsze zadanie zatwierdzone na podstawie testów i przebiegu codex review, a nie czytania linia po linii
• Gotowy sposób naprawy każdej typowej awarii konfiguracji

Od której wersji Codex zacząć?

We wszystkich czterech wersjach działa ten sam agent; różnią się tym, gdzie wykonuje pracę i jak ją przeglądasz.

Aplikacja desktopowa

Aplikacja desktopowa Codex działa na macOS i Windows; z terminala uruchamia ją codex app. O jej włączeniu do aplikacji desktopowej ChatGPT jako trybu Codex 2026-07-09 wiemy tylko z drugiej ręki (źródło wtórne: Neowin).

Zacznij tutaj, jeśli wolisz graficznego klienta od terminala.

CLI

Otwartoźródłowe CLI codex działa na macOS, Linuksie i Windows. Ma interaktywny interfejs terminalowy oraz codex exec do uruchomień nieinteraktywnych w skryptach i CI. Przy zadaniach równoległych uruchom sesję we własnym worktree Git przez --worktree albo /worktree (obsługa worktree jest domyślnie włączona od 0.156.0).

Zacznij tutaj, jeśli pracujesz głównie w terminalu albo w CI.

Rozszerzenie IDE

Rozszerzenie OpenAI działa w VS Code i jego forkach, takich jak Cursor. IDE JetBrains i Xcode mają osobne integracje (źródło wtórne: Neowin).

Zacznij tutaj, jeśli chcesz robić małe zadania bez wychodzenia z edytora.

Chmura

Codex w chmurze wykonuje zadania w środowisku zbudowanym z twojego repozytorium GitHub i zwraca diff, który możesz otworzyć jako pull request.

Zacznij tutaj, jeśli długie zadania mają działać, gdy twój komputer jest wyłączony.

Notatka

CLI czyta config.toml i dane logowania z CODEX_HOME, domyślnie ~/.codex. Codex w chmurze ignoruje pliki lokalne; jego środowiska konfigurujesz osobno.

Przejdź ścieżkę szybkiego startu Codex po kolei

Każdy przewodnik zakłada, że masz za sobą poprzedni. Jeśli Codex jest już zainstalowany, zacznij od kroku 3.

1. Zainstaluj Codex: aplikację desktopową, CLI lub rozszerzenie IDE.

2. Zaloguj się planem ChatGPT albo kluczem API.

3. Skonfiguruj config.toml: model, zatwierdzanie, piaskownica (sandbox).

4. Wykonaj pierwsze zadanie: małe zadanie z kryteriami akceptacji i wynikiem testów.

5. Napisz AGENTS.md z poleceniami budowania i testów.

6. Podłącz GitHub do zadań w chmurze i @codex review.

7. Przeglądaj zmiany Codex: codex review, /review i @codex review.

8. Dodaj serwer MCP przez codex mcp add albo config.toml.

9. Napraw typowe błędy: objawy, przyczyny i prompty naprawcze.

Czego potrzebujesz przed startem

• Planu ChatGPT z Codex (README OpenAI wymienia Plus, Pro, Business, Edu i Enterprise) albo klucza API OpenAI z włączonym rozliczaniem.
• Gita i prawdziwego repozytorium z poleceniem uruchamiającym testy: repozytorium demonstracyjne nie daje niczego do weryfikacji.
• Node.js 16 lub nowszego tylko wtedy, gdy instalujesz CLI przez npm (@openai/codex 0.157.1 deklaruje node >=16). Samodzielny instalator i Homebrew nie potrzebują Node.js.

Po krokach 1 i 2 sprawdź konfigurację w terminalu:

codex --version        # codex-cli 0.157.1 na dzień 2026-09-26
codex login status     # które konto lub klucz API jest aktywne
codex doctor           # kontrola instalacji, konfiguracji, logowania i środowiska

Codex startuje na wbudowanym modelu domyślnym, GPT-6 Astra (dla zalogowanych kont serwer może go zmienić); zanim cokolwiek dostroisz, sprawdź w statusie sesji, który model jest aktywny. Dostrój poziom rozumowania (effort), zanim zmienisz model. Aktualne modele i ceny znajdziesz w przeglądzie modeli.

Jak sprawdzić pierwsze zadanie bez czytania każdej linii

Traktuj pierwsze zadanie jako test twojej konfiguracji. Zażądaj dowodów z góry, a potem je sprawdź:

1. Zadanie określa kryteria akceptacji, zanim zmieni się jakikolwiek kod.
2. Codex uruchamia testy i linter projektu oraz raportuje polecenia i wyniki.
3. Uruchamiasz te polecenia sam. Zielony wynik, którego nie widziałeś, to deklaracja, a nie dowód.
4. Drugi przegląd sprawdza diff: codex review --uncommitted w terminalu albo /review w interfejsie terminalowym.
5. Na pull requeście uruchamia się CI. Zatwierdzasz zmianę na podstawie testów, uwag z review i CI, a czytasz tylko to, co wskazały.

Dlaczego to działa: dowody zamiast diffów.

Prompt do skopiowania: orientacja Codex w nowym repozytorium

Before changing anything, map this repository for me. Read the README,
the package or build manifest, and the CI workflow. Report:
1. The exact commands to install, build, run tests, and lint, and
   whether each one passes right now (run them).
2. The five directories that matter most and what each owns.
3. Anything in CI that a local run would miss.
Then draft an AGENTS.md from what you found. Do not edit other files.

Prompt do skopiowania: pierwsze zadanie z własnymi dowodami

Fix the failing test in the smallest module that has one. If nothing
fails, add a missing test for an untested branch in a utility function.
Before you edit, write 2-3 acceptance criteria as a checklist.
After you edit, run the full test suite and the linter, and paste the
commands and their final output. List every file you changed and why.
Stop and ask if the fix needs more than 50 changed lines.

Co psuje się w pierwszej godzinie pracy z Codex?

Objaw	Prawdopodobna przyczyna	Co zrobić
Użycie trafia na rachunek API albo limity wyglądają źle	Logowanie niewłaściwą metodą (klucz API lub plan ChatGPT)	Sprawdź codex login status; codex logout i zaloguj się ponownie
Codex ignoruje twój AGENTS.md	Niezaufane projekty nie dostarczają AGENTS.md (od CLI 0.150.0)	Oznacz projekt jako zaufany, gdy Codex zapyta, i zrestartuj sesję
CLI ignoruje twoje ustawienia	CODEX_HOME wskazuje inny katalog niż ten, w którym edytujesz plik	Sprawdź CODEX_HOME; uruchom ponownie codex doctor
codex -a on-failure albo --full-auto kończy się błędem	Obie opcje są nieprawidłowe w CLI 0.157.1 (sprawdzone 2026-09-26)	Użyj -a on-request albo -a never; uruchomienia bez nadzoru opisuje konfiguracja
Testy padają tylko wewnątrz Codex	Sandbox blokuje sieć albo zapis poza katalogiem roboczym	Zapis: --add-dir <DIR>. Sieć: zatwierdź polecenie albo włącz dostęp do sieci w konfiguracji. Nigdy --dangerously-bypass-approvals-and-sandbox poza zewnętrznym sandboxem
Zadanie w chmurze nie widzi twojej lokalnej konfiguracji	Chmura czyta tylko repozytorium	Skonfiguruj środowisko w chmurze

Więcej przypadków, z promptami, opisuje przewodnik naprawa błędów.

Dokąd iść po szybkim starcie z Codex

• Polecenia CLI Codex i uruchomienia nieinteraktywne.
• Uprawnienia i sandbox w różnych narzędziach przed każdym uruchomieniem bez nadzoru.
• Inne narzędzia: szybki start z Claude Code i szybki start z Cursorem.

Zainstaluj Codex Skonfiguruj aplikację desktopową, CLI i rozszerzenie IDE