Instalacja

Wykupiles subskrypcje ChatGPT Plus, slyszales ze Codex moze pisac kod na czterech roznych powierzchniach, a teraz wpatrujesz sie w strone pobran zastanawiajac sie co zainstalowac najpierw. Odpowiedz: wszystkie trzy lokalne powierzchnie zajmuja lacznie mniej niz 5 minut, a po skonfigurowaniu wspoldziela te same uwierzytelnienie i konfiguracje.

Co wyniesiesz z tego przewodnika

Aplikacja Codex zainstalowana na macOS (Apple Silicon)
Codex CLI dostepne globalnie przez polecenie codex
Rozszerzenie Codex IDE dzialajace w VS Code, Cursor lub Windsurf
Wszystkie trzy powierzchnie wspoldzielace ten sam katalog konfiguracji ~/.codex/
Weryfikacja ze kazda powierzchnia uruchamia sie i uwierzytelnia poprawnie

Instalacja aplikacji Codex (macOS)

Aplikacja Codex to natywna aplikacja macOS dla komputerow Mac z Apple Silicon. Zapewnia najbogatsze doswiadczenie: rownolegle watki, izolacja worktree, wbudowane narzedzia Git, automatyzacje i zintegrowany terminal.

Pobierz DMG z persistent.oaistatic.com/codex-app-prod/Codex.dmg.
Otworz DMG i przeciagnij Codex do folderu Aplikacje.
Uruchom Codex z Aplikacji. macOS moze poprosic o potwierdzenie otwarcia aplikacji od zidentyfikowanego dewelopera — kliknij Otworz.
Zaloguj sie kontem ChatGPT lub kluczem API OpenAI gdy zostaniesz poproszony.
Wybierz folder projektu. Codex zapamięta ten projekt na przyszle sesje.

Prompt do weryfikacji dzialania aplikacji:

Po wybraniu projektu wpisz to w watku aplikacji Codex:

Tell me about this project

Codex powinien odczytac strukture projektu i podac podsumowanie. Jesli to zrobi, aplikacja jest w pelni sprawna.

Instalacja Codex CLI

CLI jest open-source, zbudowane w Rust i dziala na macOS, Linux i Windows. Wybierz preferowanego menedzera pakietow.

npm
Homebrew

npm install -g @openai/codex

Zweryfikuj instalacje:

codex --version

Zaktualizuj do najnowszej wersji pozniej:

npm install -g @openai/codex@latest

brew install codex

Zweryfikuj instalacje:

codex --version

Zaktualizuj pozniej:

brew upgrade codex

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

Prompt do weryfikacji dzialania CLI:

Przejdz do katalogu projektu i uruchom:

codex "What files are in this project?"

Jesli Codex wylistuje twoje pliki, uwierzytelnianie i sandboxing dzialaja prawidlowo.

Instalacja rozszerzenia IDE

Rozszerzenie Codex IDE dziala z VS Code, Cursor, Windsurf i IDE JetBrains.

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

Po instalacji ikona Codex pojawi sie w lewym panelu bocznym. Kliknij ja, zaloguj sie i jestes gotowy.

Zainstaluj rozszerzenie wyszukujac “Codex” w panelu rozszerzen Cursor lub uzyj cursor:extension/openai.chatgpt.

Pasek aktywnosci w Cursor domyslnie wyswietla sie poziomo, co moze ukryc ikone Codex. Jesli jej nie widzisz, poszukaj zwiniętych elementow lub przypnij rozszerzenie Codex na pasku.

Wyszukaj “Codex” w panelu rozszerzen Windsurf lub uzyj windsurf:extension/openai.chatgpt.

Przenoszenie Codex do prawego panelu bocznego

Wiekszosc deweloperow preferuje panel Codex po prawej stronie edytora, zachowujac eksplorator plikow po lewej.

W VS Code wystarczy przeciagnac ikone Codex z lewego panelu bocznego na prawy. W Cursor moze byc konieczne tymczasowe ustawienie orientacji paska aktywnosci na vertical w ustawieniach Workbench, restart, przeciagniecie ikony, a nastepnie przywrocenie horizontal.

Jak powierzchnie sa polaczone

Wszystkie trzy lokalne powierzchnie (Aplikacja, CLI, Rozszerzenie IDE) wspoldziela te sama konfiguracje i dane uwierzytelniajace:

Wspoldzielony zasob	Lokalizacja
Konfiguracja uzytkownika	`~/.codex/config.toml`
Uwierzytelnianie	`~/.codex/auth.json` lub systemowy keyring
Serwery MCP	Zdefiniowane w `config.toml`, wspoldzielone przez wszystkie powierzchnie
AGENTS.md	Czytany z `~/.codex/AGENTS.md` (globalny) i katalogu glownego projektu (poziom projektu)

Oznacza to, ze konfigurujesz tylko raz. Ustaw polityke zatwierdzania w config.toml, a Aplikacja, CLI i rozszerzenie IDE beda ja respektowac. Dodaj serwer MCP przez codex mcp add, a pojawi sie na wszystkich trzech powierzchniach.

Aplikacja Codex i rozszerzenie IDE rowniez synchronizuja sie gdy oba sa otwarte w tym samym projekcie. Aplikacja slledzi ktore pliki przegladasz w edytorze (Auto Context), a watki rozpoczete na jednej powierzchni pojawiaja sie na drugiej.

Gdy cos nie dziala

Aplikacja nie otwiera sie na macOS: Upewnij sie ze masz Apple Silicon (M1 lub nowszy). Komputery Mac z Intel nie sa obslugiwane. Sprawdz Ustawienia systemowe > Prywatnosc i bezpieczenstwo jesli macOS blokuje aplikacje.

Instalacja CLI przez npm nie powiodla sie: Upewnij sie ze Node.js 18+ jest zainstalowany (node --version). Jesli pojawia sie bledy EACCES, nie uzywaj 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 moze byc ukryte w zwiniętej sekcji poziomego paska aktywnosci. Poszukaj menu przepelnienia >> na pasku lub tymczasowo przelacz na orientacje pionowa.

Uwierzytelnianie nie utrzymuje sie: Sprawdz czy ~/.codex/auth.json istnieje po zalogowaniu. Jesli go brak, twoj systemowy magazyn poswiadczen moze byc w uzyciu. Zobacz przewodnik uwierzytelniania po konfiguracje przechowywania poswiadczen.

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

Co dalej

Skonfiguruj uwierzytelnianie Skonfiguruj dostep przez subskrypcje ChatGPT lub rozliczanie kluczem API