Przejdź do głównej zawartości

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.

  • 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

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.

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.

  1. Instalacja — Zainstaluj aplikację (macOS), CLI (npm lub Homebrew) i rozszerzenie IDE (VS Code Marketplace). Zajmuje 5 minut.

  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.

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

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 workflowZacznij odDodaj później
Terminal-first, skrypty i CICLICloud do zadań w tle
IDE-centryczny, wizualne diff-yRozszerzenie IDEAplikacja do równoległych wątków
Wielozadaniowy, równoległe funkcjeAplikacjaCLI do skryptowania
Zdalny zespół, asynchroniczne przeglądy PRCloudRozszerzenie IDE do kontynuacji

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

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.