Instalacja

Wykupiłeś subskrypcję ChatGPT Plus, słyszałeś że Codex może pisać kod na czterech różnych powierzchniach, a teraz wpatrujesz się w stronę pobrań zastanawiając się co zainstalować najpierw. Odpowiedź: wszystkie trzy lokalne powierzchnie zajmują łącznie mniej niż 5 minut, a po skonfigurowaniu współdzielą te same uwierzytelnienie i konfigurację.

Co wyniesiesz z tego przewodnika

Aplikacja Codex zainstalowana na macOS (Apple Silicon)
Codex CLI dostępne globalnie przez polecenie codex
Rozszerzenie Codex IDE działające w VS Code, Cursor lub Windsurf
Wszystkie trzy powierzchnie współdzielące ten sam katalog konfiguracji ~/.codex/
Weryfikacja że każda powierzchnia uruchamia się i uwierzytelnia poprawnie

Instalacja aplikacji Codex (macOS)

Aplikacja Codex to natywna aplikacja macOS dla komputerów Mac z Apple Silicon. Zapewnia najbogatsze doświadczenie: równoległe wątki, izolacja worktree, wbudowane narzędzia Git, automatyzacje i zintegrowany terminal.

Pobierz DMG z persistent.oaistatic.com/codex-app-prod/Codex.dmg.
Otwórz DMG i przeciągnij Codex do folderu Aplikacje.
Uruchom Codex z Aplikacji. macOS może poprosić o potwierdzenie otwarcia aplikacji od zidentyfikowanego dewelopera — kliknij Otwórz.
Zaloguj się kontem ChatGPT lub kluczem API OpenAI gdy zostaniesz poproszony.
Wybierz folder projektu. Codex zapamięta ten projekt na przyszłe sesje.

Prompt do weryfikacji działania aplikacji:

Po wybraniu projektu wpisz to w wątku aplikacji Codex:

Tell me about this project

Codex powinien odczytać strukturę projektu i podać podsumowanie. Jeśli to zrobi, aplikacja jest w pełni sprawna.

Instalacja Codex CLI

CLI jest open-source, zbudowane w Rust i działa na macOS, Linux i Windows. Wybierz preferowanego menedżera pakietów.

npm
Homebrew

npm install -g @openai/codex

Zweryfikuj instalację:

codex --version

Zaktualizuj do najnowszej wersji później:

npm install -g @openai/codex@latest

brew install codex

Zweryfikuj instalację:

codex --version

Zaktualizuj później:

brew upgrade codex

Po zainstalowaniu uruchom codex w terminalu. Przy pierwszym uruchomieniu zostaniesz poproszony o zalogowanie się kontem ChatGPT lub kluczem API.

Prompt do weryfikacji działania CLI:

Przejdź do katalogu projektu i uruchom:

codex "What files are in this project?"

Jeśli Codex wylistuje twoje pliki, uwierzytelnianie i sandboxing działają prawidłowo.

Instalacja rozszerzenia IDE

Rozszerzenie Codex IDE działa z VS Code, Cursor, Windsurf i IDE JetBrains.

Zainstaluj z Visual Studio Code Marketplace lub otwórz VS Code i wyszukaj “Codex” w panelu Rozszerzenia.

Po instalacji ikona Codex pojawi się w lewym panelu bocznym. Kliknij ją, zaloguj się i jesteś gotowy.

Zainstaluj rozszerzenie wyszukując “Codex” w panelu rozszerzeń Cursor lub użyj cursor:extension/openai.chatgpt.

Pasek aktywności w Cursor domyślnie wyświetla się poziomo, co może ukryć ikonę Codex. Jeśli jej nie widzisz, poszukaj zwiniętych elementów lub przypnij rozszerzenie Codex na pasku.

Wyszukaj “Codex” w panelu rozszerzeń Windsurf lub użyj windsurf:extension/openai.chatgpt.

Przenoszenie Codex do prawego panelu bocznego

Większość deweloperów preferuje panel Codex po prawej stronie edytora, zachowując eksplorator plików po lewej.

W VS Code wystarczy przeciągnąć ikonę Codex z lewego panelu bocznego na prawy. W Cursor może być konieczne tymczasowe ustawienie orientacji paska aktywności na vertical w ustawieniach Workbench, restart, przeciągnięcie ikony, a następnie przywrócenie horizontal.

Jak powierzchnie są połączone

Wszystkie trzy lokalne powierzchnie (Aplikacja, CLI, Rozszerzenie IDE) współdzielą tę samą konfigurację i dane uwierzytelniające:

Współdzielony zasób	Lokalizacja
Konfiguracja użytkownika	`~/.codex/config.toml`
Uwierzytelnianie	`~/.codex/auth.json` lub systemowy keyring
Serwery MCP	Zdefiniowane w `config.toml`, współdzielone przez wszystkie powierzchnie
AGENTS.md	Czytany z `~/.codex/AGENTS.md` (globalny) i katalogu głównego projektu (poziom projektu)

Oznacza to, że konfigurujesz tylko raz. Ustaw politykę zatwierdzania w config.toml, a Aplikacja, CLI i rozszerzenie IDE będą ją respektować. Dodaj serwer MCP przez codex mcp add, a pojawi się na wszystkich trzech powierzchniach.

Aplikacja Codex i rozszerzenie IDE również synchronizują się gdy oba są otwarte w tym samym projekcie. Aplikacja śledzi które pliki przeglądasz w edytorze (Auto Context), a wątki rozpoczęte na jednej powierzchni pojawiają się na drugiej.

Gdy coś nie działa

Aplikacja nie otwiera się na macOS: Upewnij się że masz Apple Silicon (M1 lub nowszy). Komputery Mac z Intel nie są obsługiwane. Sprawdź Ustawienia systemowe > Prywatność i bezpieczeństwo jeśli macOS blokuje aplikację.

Instalacja CLI przez npm nie powiodła się: Upewnij się że Node.js 18+ jest zainstalowany (node --version). Jeśli pojawiają się błędy EACCES, nie używaj sudo — zamiast tego uruchom npm config set prefix ~/.npm-global i dodaj ~/.npm-global/bin do PATH.

Rozszerzenie IDE nie jest widoczne: W Cursor rozszerzenie może być ukryte w zwiniętej sekcji poziomego paska aktywności. Poszukaj menu przepełnienia >> na pasku lub tymczasowo przełącz na orientację pionową.

Uwierzytelnianie nie utrzymuje się: Sprawdź czy ~/.codex/auth.json istnieje po zalogowaniu. Jeśli go brak, twój systemowy magazyn poświadczeń może być w użyciu. Zobacz przewodnik uwierzytelniania po konfigurację przechowywania poświadczeń.

“codex: command not found” po instalacji Homebrew: Uruchom brew link codex lub upewnij się że /opt/homebrew/bin jest w twoim PATH.

Co dalej

Skonfiguruj uwierzytelnianie Skonfiguruj dostęp przez subskrypcję ChatGPT lub rozliczanie kluczem API