Pierwsze kroki z Codex

Właśnie uzyskałeś dostęp do Codex. Otworzyłeś tryb Codex w aplikacji desktopowej ChatGPT, wpatrujesz się w pustą listę wątków i zastanawiasz się: gdzie pasuje CLI? A co z rozszerzeniem VS Code? I czym w ogóle jest “wątek w chmurze”?

Przepaść między “Codex jest dostępny” a “Codex dostarcza za mnie kod” jest realna. Ta sekcja szybkiego startu ją zamyka.

Co wyniesiesz z tego przewodnika

• Wszystkie cztery powierzchnie Codex zainstalowane i uwierzytelnione w mniej niż 15 minut
• Plik config.toml dostrojony do twojego poziomu komfortu zatwierdzania i preferowanego modelu
• Plik AGENTS.md dający Codex realny kontekst o konwencjach twojego projektu
• Przynajmniej jeden serwer MCP podłączony i działający
• Repozytorium GitHub połączone dla workflow-ów PR i wzmianek @codex
• Ukończone zadanie od początku do końca: prompt, wykonanie, przegląd i merge
• Mentalny model na wypadek awarii i sposobów odzyskiwania

Cztery powierzchnie w skrócie

Zanim zanurzysz się głębiej, zrozum do czego każda powierzchnia jest przeznaczona, abyś wybrał właściwą we właściwym momencie.

ChatGPT Desktop

Tryb Codex w aplikacji desktopowej ChatGPT na macOS i Windows to twoje centrum dowodzenia. Uruchamia wiele wątków równolegle, izoluje zmiany w worktree Git, ma wbudowany przegląd diff-ów i narzędzia commitowania, obsługuje automatyzacje według harmonogramu i wysyła powiadomienia, gdy zadania w tle się zakończą. Traktuj ją jako menedżera projektów dla pracy z Codex.

Najlepsza do: Uruchamiania 3-5 równoległych zadań, przeglądania diff-ów, commitowania i pushowania, automatyzacji, dyktowania głosowego.

CLI

Open-source CLI (polecenie codex) jest zbudowane w Rust i działa na macOS, Linux i Windows. Oferuje interaktywne TUI do pracy konwersacyjnej oraz nieinteraktywny tryb codex exec do skryptowania. Tryby zatwierdzania, wejście obrazów, wyszukiwanie w sieci i lokalny przegląd kodu są wbudowane.

Najlepsze do: Workflow-ów opartych o terminal, skryptowania i potoków, integracji CI/CD, bezobsługowej automatyzacji, sesji zdalnych/SSH.

Rozszerzenie IDE

Rozszerzenie OpenAI dla VS Code i zgodnych forków, takich jak Cursor oraz Windsurf, działa w panelu bocznym. JetBrains AI i Xcode 26.3+ udostępniają Codex przez osobne natywne integracje. Te powierzchnie mogą czytać pliki, uruchamiać polecenia i zapisywać zmiany zgodnie ze swoimi uprawnieniami.

Najlepsze do: Pozostawania w edytorze, korzystania z kontekstu plików i odwołań @file, szybkich zadań inline, delegacji do Cloud.

Cloud

Codex Cloud działa pod adresem chatgpt.com/codex. Uruchamia środowisko z twojego repozytorium GitHub, wykonuje zadania w tle i tworzy diff, który możesz zmergować jako PR. Możesz go też wyzwolić przez wzmiankowanie @codex w komentarzach do issues lub PR-ów na GitHub.

Najlepszy do: Długotrwałych zadań, pracy w tle, workflow-ów opartych o PR, zadań gdy jesteś z dala od komputera.

Ścieżka szybkiego startu

Ta sekcja przeprowadza cię przez dziewięć skoncentrowanych przewodników w kolejności, w jakiej powinieneś je wykonać. Każdy buduje na poprzednim, ale doświadczeni deweloperzy mogą przeskoczyć do dowolnego tematu.

1. Instalacja — Zainstaluj ChatGPT desktop, CLI samodzielnym instalatorem i rozszerzenie rodziny VS Code; poznaj osobne opcje JetBrains/Xcode.

2. Uwierzytelnianie — Zaloguj się subskrypcją ChatGPT lub skonfiguruj klucz API OpenAI. Zrozum kompromisy między subskrypcją a rozliczaniem API.

3. Konfiguracja — Ustaw domyślny model, politykę zatwierdzania, tryb sandbox i preferencje wyszukiwania w sieci w config.toml. Poznaj kolejność priorytetów między ustawieniami użytkownika, projektu i nadpisaniami CLI.

4. Konfiguracja AGENTS.md — Napisz globalne i projektowe pliki AGENTS.md, które dają Codex realny kontekst o konwencjach twojego kodu, poleceniach testowych i wytycznych przeglądu.

5. Konfiguracja MCP — Podłącz swój pierwszy serwer MCP (Context7 do dokumentacji, Playwright do testów przeglądarki lub GitHub do zarządzania PR). Skonfiguruj przez CLI lub config.toml.

6. Integracja z GitHub — Połącz repozytorium z Codex Cloud, włącz @codex review na PR-ach, skonfiguruj automatyczne przeglądy i wyzwalaj zadania w chmurze z komentarzy do issues.

7. Pierwsze zadanie — Uruchom prawdziwe zadanie na wszystkich czterech powierzchniach: poproś Codex o znalezienie i naprawienie buga, dodanie funkcji lub refaktoryzację modułu. Zobacz jak każda powierzchnia inaczej obsługuje ten sam prompt.

8. Workflow przeglądu — Przeglądaj zmiany Codex używając panelu diff aplikacji, komentarzy inline, stagowania i cofania. Zrozum przełączniki zakresu (niezacommitowane, branch, ostatnia tura) i częściowe stagowanie.

9. Odzyskiwanie po błędach — Obsługuj błędy uprawnień sandbox, timeouty poleceń, przepełnienie kontekstu, edycje w złym kierunku i błędy sieci. Zbuduj pamięć mięśniową odzyskiwania.

Notatka

Lokalne klienty OpenAI współdzielą config.toml i lokalne warstwy instrukcji, gdy używają tego samego CODEX_HOME. Codex Cloud korzysta z osobno skonfigurowanych środowisk i polityki workspace’u; nie dziedziczy automatycznie lokalnych plików.

Wymagania wstępne

Zanim zaczniesz, upewnij się że masz:

• Plan ChatGPT z dostępem do Codex lub klucz API OpenAI z aktywnym rozliczaniem API

• Brak wymaganego runtime dla samodzielnego instalatora CLI; Node.js 16+ jest potrzebny tylko dla opcjonalnego wrappera npm

• macOS (Apple Silicon lub Intel) albo Windows — dla natywnej aplikacji. CLI i IDE działają na macOS, Linux i Windows

• VS Code, Cursor lub Windsurf dla rozszerzenia OpenAI; JetBrains 2025.3+ i Xcode 26.3+ używają osobnych integracji

• Git skonfigurowany w systemie

• Prawdziwy projekt do pracy — Codex jest marnowany na repozytoriach hello-world

Wskazówka

Prompt do sprawdzenia wymagań wstępnych:

Wklej to do terminala, aby zweryfikować Node.js, Git i powłokę:

node --version && git --version && echo "Ready for Codex"

Wybór głównej powierzchni

Nie musisz używać wszystkich czterech powierzchni. Większość deweloperów ustala jedną lub dwie jako główne, a pozostałych używa sytuacyjnie.

Twój workflow	Zacznij od	Dodaj później
Terminal-first, skrypty i CI	CLI	Cloud do zadań w tle
IDE-centryczny, wizualne diff-y	Rozszerzenie IDE	Aplikacja do równoległych wątków
Wielozadaniowy, równoległe funkcje	Aplikacja	CLI do skryptowania
Zdalny zespół, asynchroniczne przeglądy PR	Cloud	Rozszerzenie IDE do kontynuacji

Wybierz powierzchnię najbliższą temu jak już pracujesz, a następnie rozszerzaj w miarę odkrywania zastosowań dla pozostałych.

Co dalej

Zacznij od instalacji. Cała sekcja szybkiego startu jest zaprojektowana do ukończenia w jedno popołudnie, a każdy przewodnik zajmuje 10-20 minut.

Zainstaluj Codex Skonfiguruj aplikację, CLI i rozszerzenie IDE na swoim komputerze