# Codex – szybki start: od instalacji do sprawdzonego pierwszego zadania

URL: https://developertoolkit.ai/pl/codex/quick-start/
Description: Szybki start z Codex dla programistów: wybór środowiska pracy, instalacja, logowanie, konfiguracja i pierwsze zadanie sprawdzone testami i code review.

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.

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](/pl/codex/quick-start/installation/)**: aplikację desktopową, CLI lub rozszerzenie IDE.

2. **[Zaloguj się](/pl/codex/quick-start/authentication/)** planem ChatGPT albo kluczem API.

3. **[Skonfiguruj `config.toml`](/pl/codex/quick-start/configuration/)**: model, zatwierdzanie, piaskownica (sandbox).

4. **[Wykonaj pierwsze zadanie](/pl/codex/quick-start/first-task/)**: małe zadanie z kryteriami akceptacji i wynikiem testów.

5. **[Napisz `AGENTS.md`](/pl/codex/quick-start/agents-md/)** z poleceniami budowania i testów.

6. **[Podłącz GitHub](/pl/codex/quick-start/github-integration/)** do zadań w chmurze i `@codex review`.

7. **[Przeglądaj zmiany Codex](/pl/codex/quick-start/review-workflow/)**: `codex review`, `/review` i `@codex review`.

8. **[Dodaj serwer MCP](/pl/codex/quick-start/mcp-setup/)** przez `codex mcp add` albo `config.toml`.

9. **[Napraw typowe błędy](/pl/codex/quick-start/error-recovery/)**: 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:

```bash
codex --version        # codex-cli 0.157.1 on 2026-09-26
codex login status     # which account or API key is active
codex doctor           # installation, config, auth, and runtime checks
```

Codex startuje na wbudowanym modelu domyślnym, GPT-6.1 Sol (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](/pl/ecosystem/models/).

## 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](/pl/ladder/evidence-not-diffs/).

**Prompt do skopiowania: orientacja Codex w nowym repozytorium**

```text
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**

```text
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](/pl/codex/quick-start/configuration/) |
| 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](/pl/codex/quick-start/configuration/). Nigdy `--dangerously-bypass-approvals-and-sandbox` poza jednorazowym sandboksem z ograniczoną siecią |
| Zadanie w chmurze nie widzi twojej lokalnej konfiguracji | Chmura czyta tylko repozytorium | Skonfiguruj [środowisko w chmurze](/pl/codex/automate/cloud-environments/) |

Więcej przypadków, z promptami, opisuje przewodnik [naprawa błędów](/pl/codex/quick-start/error-recovery/).

## Dokąd iść po szybkim starcie z Codex

- [Polecenia CLI Codex](/pl/codex/build/cli-commands/) i [uruchomienia nieinteraktywne](/pl/codex/automate/non-interactive/).
- [Uprawnienia i sandbox w różnych narzędziach](/pl/workflows/harness/permissions-and-sandboxing/) przed każdym uruchomieniem bez nadzoru.
- Inne narzędzia: [szybki start z Claude Code](/pl/claude-code/quick-start/) i [szybki start z Cursorem](/pl/cursor-ide/quick-start/).
- [Zainstaluj Codex](/pl/codex/quick-start/installation/) — Skonfiguruj aplikację desktopową, CLI i rozszerzenie IDE