Pierwsze kroki z Codex
Właśnie uzyskałeś dostęp do Codex. Otworzyłeś aplikację, wpatrujesz się w pustą listę wątków i zastanawiasz się: czy mam tu wpisać to samo co w ChatGPT? 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
Dział zatytułowany „Co wyniesiesz z tego przewodnika”- Wszystkie cztery powierzchnie Codex zainstalowane i uwierzytelnione w mniej niż 15 minut
- Plik
config.tomldostrojony do twojego poziomu komfortu zatwierdzania i preferowanego modelu - Plik
AGENTS.mddają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
Dział zatytułowany „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.
Natywna aplikacja desktopowa 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.
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 Codex dla VS Code, Cursor, Windsurf i IDE JetBrains mieszka w twoim panelu bocznym. Domyślnie startuje w trybie Agent, czyta pliki, uruchamia polecenia i zapisuje zmiany w katalogu projektu. Możesz delegować zadania do Cloud bez opuszczania edytora.
Najlepsze do: Pozostawania w edytorze, korzystania z kontekstu plików i odwołań @file, szybkich zadań inline, delegacji do 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
Dział zatytułowany „Ścieżka szybkiego startu”Ta sekcja przeprowadza cię przez dziesięć 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.
-
Instalacja — Zainstaluj aplikację (macOS), CLI (npm lub Homebrew) i rozszerzenie IDE (VS Code Marketplace). Zajmuje 5 minut.
-
Uwierzytelnianie — Zaloguj się subskrypcją ChatGPT lub skonfiguruj klucz API OpenAI. Zrozum kompromisy między subskrypcją a rozliczaniem API.
-
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. -
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.
-
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. -
Integracja z GitHub — Połącz repozytorium z Codex Cloud, włącz
@codex reviewna PR-ach, skonfiguruj automatyczne przeglądy i wyzwalaj zadania w chmurze z komentarzy do issues. -
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.
-
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.
-
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.
Wymagania wstępne
Dział zatytułowany „Wymagania wstępne”Zanim zaczniesz, upewnij się że masz:
- Subskrypcję ChatGPT (Plus, Pro, Business, Edu lub Enterprise) lub klucz API OpenAI ze środkami
- Node.js 18+ zainstalowany (dla CLI przez npm) lub Homebrew (dla CLI przez brew)
- macOS Apple Silicon (dla natywnej aplikacji — CLI i IDE działają na macOS, Linux i Windows)
- VS Code, Cursor lub Windsurf (dla rozszerzenia IDE)
- Git skonfigurowany w systemie
- Prawdziwy projekt do pracy — Codex jest marnowany na repozytoriach hello-world
Wybór głównej powierzchni
Dział zatytułowany „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
Dział zatytułowany „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.