Instalacja Codex: CLI, aplikacja desktopowa i rozszerzenie IDE

Instalacja Codex zaczyna się od otwartoźródłowego Codex CLI (skrypt instalacyjny, npm albo Homebrew). Potem, w miarę potrzeby, dochodzą aplikacja desktopowa na macOS lub Windows i rozszerzenie IDE dla VS Code oraz jego forków. Lokalne aplikacje klienckie współdzielą jeden katalog CODEX_HOME (domyślnie ~/.codex/), więc logowanie, config.toml i serwery MCP przechodzą między nimi. Wynik sprawdza codex doctor.

Ta strona jest dla programisty, który stawia Codex na służbowym komputerze, i dla tech leada, który musi sprawić, żeby ta instalacja była powtarzalna w całym zespole. Typowy obraz: ktoś zainstalował Codex przez npm wiosną, ktoś inny przez Homebrew, trzecia osoba ma tylko aplikację desktopową i nikt nie wie, która wersja działa ani dlaczego panel w IDE nie chce się zalogować. Przemyślana, sprawdzona instalacja kosztuje mniej niż późniejsze szukanie, czemu instalacje się różnią.

Co daje sprawdzona instalacja Codex

• Jedno Codex CLI w PATH, zainstalowane metodą, którą codex update potrafi rozpoznać i zaktualizować.
• Zalogowaną sesję potwierdzoną przez codex login status, zapisaną tam, gdzie zdecydujesz.
• Raport codex doctor, który możesz zachować jako dowód, że instalacja, konfiguracja, uwierzytelnianie i środowisko działają.
• Smoke test (szybki test tylko do odczytu), którego wynik porównasz z repozytorium w niecałą minutę.
• Aplikację desktopową i rozszerzenie IDE czytające tę samą konfigurację ~/.codex/ co CLI.
• Skrypt kontrolny, który tech lead może przekazać każdej nowej osobie w zespole.

Od której powierzchni Codex zacząć instalację?

Najpierw zainstaluj CLI, nawet jeśli na co dzień chcesz pracować w aplikacji desktopowej albo w edytorze. CLI ma polecenia diagnostyczne (codex doctor, codex login status, codex update), a na macOS i Windows codex app uruchamia aplikację desktopową albo otwiera jej instalator, jeśli jej brakuje.

Powierzchnia	Działa na	Zainstaluj, gdy	Uwagi
Codex CLI	macOS, Linux, Windows	Zawsze, jako pierwsze	Interfejs terminalowy oraz codex exec do skryptów i CI
Aplikacja desktopowa	macOS, Windows	Wolisz klienta graficznego od terminala	Uruchamiasz ją przez codex app; nie ma wersji na Linuksa
Rozszerzenie IDE	VS Code i forki, np. Cursor	Chcesz mieć Codex obok edytora	Współdzieli ~/.codex/ z CLI
JetBrains, Xcode	Własne IDE	Zespół pracuje w tych IDE	Konfiguracja wewnątrz IDE, nie przez rozszerzenie VS Code

Zainstaluj Codex CLI

CLI to natywny plik binarny napisany w Rust. Samodzielny instalator jest pierwszą metodą na liście OpenAI i nie wymaga Node.js. Notatki instalacyjne OpenAI wymieniają jako obsługiwane systemy macOS 12+, Ubuntu 20.04+ lub Debian 10+ oraz Windows 11 przez WSL2; minimum to 4 GB RAM, zalecane 8 GB. README udostępnia też natywny instalator dla Windows (install.ps1), ale tabela wymagań w docs/install.md nadal wymienia Windows tylko przez WSL2.

macOS / Linux

Uruchom w terminalu:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Później aktualizujesz przez codex update, które ponownie uruchamia ten sam instalator.

Windows

Uruchom w PowerShellu:

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Przy linuksowych narzędziach zainstaluj Codex w WSL2 poleceniem z zakładki macOS / Linux. Wybierz jedną z tych dwóch dróg na komputer, żeby terminal i edytor uruchamiały ten sam codex.

npm

Wymaga Node.js 16 lub nowszego (pole engines pakietu w npm, wersja 0.157.1):

npm install -g @openai/codex

Później aktualizujesz przez codex update, które samo uruchamia npm install -g @openai/codex.

Homebrew

Codex jest w Homebrew caskiem, nie formułą:

brew install --cask codex

Później aktualizujesz przez codex update, które uruchamia brew upgrade --cask codex.

Jedna metoda instalacji na komputer

Dwie instalacje (na przykład stary globalny pakiet npm i nowy samodzielny plik binarny) zostawiają w PATH dwa pliki codex. Który wygra, zależy od kolejności w PATH, więc terminal i IDE mogą uruchamiać różne wersje. Uruchom which -a codex i usuń wszystkie kopie poza tą, którą chcesz zostawić.

Zaloguj się i udowodnij, że instalacja działa

Numer wersji dowodzi tylko tego, że plik binarny istnieje. Poniższe kroki dowodzą, że Codex się loguje, czyta twoją konfigurację i potrafi wykonać turę agenta na prawdziwym repozytorium, niczego w nim nie zmieniając.

1. Sprawdź plik binarny i jego wersję. 26 września 2026 roku bieżące wydanie to codex-cli 0.157.1.

   codex --version

2. Zaloguj się. Uruchom codex i wybierz Sign in with ChatGPT (Codex jest w planach Plus, Pro, Business, Edu i Enterprise) albo przekaż klucz API ze zmiennej środowiskowej:

   printenv OPENAI_API_KEY | codex login --with-api-key

   Na komputerze bez przeglądarki codex login --device-auth uruchamia logowanie kodem urządzenia. Plany, rozliczenie przez API i maszyny bez interfejsu opisuje przewodnik po uwierzytelnianiu.

3. Sprawdź, czy logowanie się utrzymało:

   codex login status

4. Uruchom wbudowaną diagnostykę. codex doctor sprawdza instalację, konfigurację, uwierzytelnianie i stan środowiska; --summary wypisuje tylko pogrupowane wiersze i końcowe podsumowanie:

   codex doctor --summary

   Gdy potrzebujesz dowodu do zgłoszenia w supporcie albo listy onboardingowej, zapisz wersję maszynową z ukrytymi danymi wrażliwymi: codex doctor --json > codex-doctor.json.

5. W katalogu głównym repozytorium Git uruchom smoke test tylko do odczytu. --sandbox read-only nie pozwala agentowi zapisywać plików, więc test jest bezpieczny w każdym repozytorium:

   codex exec --sandbox read-only "List the commands this repository uses to install dependencies, run tests, and lint. Cite the file each one comes from."

   Otwórz plik wskazany w odpowiedzi i porównaj. Jeśli polecenia się zgadzają, działają wywołanie modelu, sandbox i dostęp do repozytorium.

   --sandbox to starszy mechanizm kontroli; OpenAI zaleca teraz profile uprawnień (beta, CLI 0.138.0 lub nowsze), na przykład -c default_permissions=":read-only". Używaj jednego albo drugiego, bo te dwa systemy się nie łączą. Profile opisuje przewodnik po konfiguracji.

Po zalogowaniu Codex używa wbudowanego modelu domyślnego, czyli GPT-6 Astra od CLI 0.153.4 (4 września 2026 roku). Kopia starsza niż 0.153.0 nie obsłuży GPT-6 Astra, co jest kolejnym powodem, żeby przed pracą uruchomić codex update. Wybór modelu i ceny opisuje przegląd modeli.

Prompt do skopiowania: sprawdzenie repozytorium w pierwszej sesji

Do not edit source files; build caches and test artefacts are fine.
Read this repository and report, as a table:
the command to install dependencies, run the unit tests, run the linter,
and run the type checker. For each one give the exact command, the file
and line where you found it, and whether you actually ran it. Run only
the test and lint commands, and report their exit codes. If a command is
missing or ambiguous, write "not found" instead of guessing.

Prompt wymaga wskazania pliku i linii oraz kodów wyjścia, więc odpowiedź weryfikujesz, sprawdzając kilka wskazanych linii, a nie czytając wszystkiego, co przeczytał Codex. Zmyślone polecenie nie ma linii, którą dałoby się wskazać. Niezerowy kod wyjścia na czystym checkoucie mówi, że na komputerze brakuje narzędzi, zanim agent zacznie prawdziwą pracę.

Prompt do skopiowania: raport gotowości komputera do pracy z Codex

Check whether this machine is ready for agent work on this repository.
Without installing anything or changing files, run: git --version,
git status --short, and the runtime version command this project needs
(for example node --version or python3 --version). Compare each version
with what the repository declares (engines field, .nvmrc, .node-version,
.python-version, or pyproject.toml). Output a table with the columns
check, expected, found, and ok/not-ok, then one line on what to fix first.

Zainstaluj aplikację desktopową Codex na macOS lub Windows

Aplikacja desktopowa to graficzny klient tego samego agenta, a polecenie /app w CLI przenosi do niej bieżącą sesję z terminala. Jeśli masz już CLI, do aplikacji prowadzi jedno polecenie:

codex app

codex app uruchamia aplikację desktopową i otwiera instalator, jeśli aplikacji brakuje. Bez CLI zacznij od strony aplikacji Codex, do której odsyła README OpenAI. Zaloguj się tym samym kontem ChatGPT co w CLI.

Aplikacja Codex jest teraz częścią aplikacji desktopowej ChatGPT jako tryb Codex obok Chat i Work; Neowin (źródło wtórne) datuje tę zmianę na 9 lipca 2026 roku. Na macOS CLI rozpoznaje zarówno ChatGPT.app, jak i Codex.app, więc starsza samodzielna instalacja Codex nadal działa z codex app.

Aplikacja nie ma wersji na Linuksa: linuksowe CLI nie ma podpolecenia app (sprawdzone w codex-cli 0.157.1). Na Linuksie używaj CLI i rozszerzenia IDE. Gdy aplikacja już działa, pełne opanowanie aplikacji desktopowej Codex opisuje wątki, worktree i przegląd zmian.

Zainstaluj rozszerzenie Codex do IDE

README OpenAI wymienia VS Code, Cursor i Windsurf jako edytory obsługiwane przez rozszerzenie (w czerwcu 2026 roku Windsurf zmienił nazwę na Devin Desktop; źródło wtórne: Creeta). Zainstaluj je z panelu rozszerzeń edytora: wyszukaj Codex i wybierz rozszerzenie wydane przez OpenAI. Potem kliknij ikonę Codex na pasku aktywności i się zaloguj.

VS Code

Otwórz Extensions, wyszukaj Codex i zainstaluj rozszerzenie OpenAI. Żeby eksplorator plików został po lewej, przeciągnij ikonę Codex na pomocniczy pasek boczny po prawej stronie.

Cursor

Zainstaluj rozszerzenie z panelu rozszerzeń Cursora tak samo. Pasek aktywności Cursora jest domyślnie poziomy, więc ikona Codex może trafić do menu przepełnienia. Żeby przenieść panel, ustaw w ustawieniach obszaru roboczego (Workbench) pionową orientację paska aktywności, przeciągnij ikonę i przywróć orientację poziomą.

JetBrains i Xcode

Te IDE nie uruchamiają rozszerzenia VS Code. Według Neowin (źródło wtórne) IDE JetBrains od wersji 2025.3 i Xcode 26.3 mają własne integracje z Codex, konfigurowane wewnątrz IDE. Mają też własne ustawienia, więc twój ~/.codex/config.toml ich nie dotyczy.

W CLI polecenie /ide pobiera z IDE bieżące zaznaczenie, otwarte pliki i inny kontekst. Dzięki temu sesja w terminalu i w edytorze widzą to samo.

Prompt do skopiowania: dowód, że rozszerzenie widzi edytor

Using only my current selection and the files I have open, explain in
three sentences what the selected function does. Then name the test file
that covers it, with the test name. If no test covers it, say "no test
found" and list the files you searched.

Przed wysłaniem zaznacz funkcję, którą dobrze znasz. Poprawne streszczenie dowodzi, że rozszerzenie czyta kontekst edytora; gałąź „no test found” pokazuje, czy odpowiedź opiera się na dowodach, czy na zgadywaniu.

Co współdzielą lokalne klienty Codex

CLI, aplikacja desktopowa i rozszerzenie IDE czytają ten sam katalog domowy Codex. Domyślnie to ~/.codex/; zmienna CODEX_HOME go przenosi. Ustaw ją tak samo dla każdego klienta, inaczej przestaną współdzielić konfigurację.

Współdzielony zasób	Gdzie jest
Konfiguracja użytkownika	~/.codex/config.toml
Logowanie	Domyślnie ~/.codex/auth.json; ustaw cli_auth_credentials_store na keyring lub auto, żeby używać systemowego pęku kluczy
Serwery MCP	Tabele [mcp_servers.<name>] w config.toml, zarządzane przez codex mcp
Profile	$CODEX_HOME/<name>.config.toml, nakładane przez codex --profile <name>
Instrukcje	~/.codex/AGENTS.md dla ciebie, AGENTS.md w repozytorium dla projektu

Nic z tego nie trafia do środowisk chmurowych Codex, JetBrains ani Xcode; te konfigurujesz w ich własnych ustawieniach. Klucze config.toml i profile uprawnień opisuje przewodnik po konfiguracji, a pliki instrukcji — AGENTS.md w Codex.

Powtarzalna instalacja Codex w zespole

Tech lead nie przypilnuje instalacji u ośmiu osób. Zamiast tego dodaj do repozytorium skrypt kontrolny i proś o jego wynik w zgłoszeniu onboardingowym. Każde polecenie w skrypcie to udokumentowane podpolecenie Codex 0.157.1 i żadne nie zapisuje niczego w repozytorium.

#!/usr/bin/env sh
# scripts/check-codex.sh: run from the repository root
set -e
echo "== codex binaries on PATH =="; which -a codex
echo "== version =="; codex --version
echo "== sign-in =="; codex login status
echo "== doctor =="; codex doctor --summary
echo "== read-only smoke test =="
codex exec --sandbox read-only --ephemeral \
  "Name the test command for this repository and the file it comes from. Do not modify files."

Przegląd wyniku zajmuje kilka sekund: jedna ścieżka w which -a, wersja uzgodniona w zespole, status zalogowania, podsumowanie codex doctor bez błędów i odpowiedź smoke testu wskazująca właściwy plik. --ephemeral sprawia, że test nie trafia do zapisanej historii sesji. Gdy wszyscy mają tę samą instalację, następnym krokiem jest przewodnik po uprawnieniach i sandboxie.

Gdy instalacja Codex się psuje

codex: command not found po instalacji. Katalog instalacji nie jest w PATH tej powłoki. Najpierw otwórz nowy terminal. Przy Homebrew uruchom brew list --cask codex, żeby potwierdzić, że cask jest zainstalowany. Przy npm dodaj do PATH katalog wypisany przez npm prefix -g (na macOS i Linuksie z dopiskiem /bin).

npm kończy się błędem EACCES. Nie ponawiaj z sudo: zostawia to pliki należące do roota, które psują późniejsze aktualizacje. Użyj samodzielnego instalatora albo ustaw prefiks npm należący do użytkownika i zainstaluj ponownie.

codex update zgłasza „Could not detect the Codex installation method”. Plik binarny zainstalowano ręcznie, na przykład z archiwum w GitHub Releases. Zainstaluj Codex jedną z czterech metod powyżej, a potem usuń ręczną kopię, którą pokazuje which -a codex.

Terminal i IDE pokazują różne wersje. Na komputerze są dwie instalacje albo IDE startuje z innym PATH. Uruchom which -a codex, zostaw jedną kopię i zrestartuj edytor.

Instalator nie może niczego pobrać w sieci firmowej. Samodzielny instalator pobiera pliki z releases.openai.com, a w razie problemu przełącza się na GitHub Releases. Żeby wymusić GitHub Releases, uruchom curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh.

Nie ma polecenia codex app. Pracujesz na Linuksie, gdzie CLI nie ma podpolecenia aplikacji desktopowej. Używaj CLI albo rozszerzenia IDE.

Logowanie się nie utrzymuje. Sprawdź, czy istnieje ~/.codex/auth.json. Jeśli go nie ma, a ustawiłeś cli_auth_credentials_store = "keyring", dane logowania są w systemowym pęku kluczy, do którego sesja bez interfejsu graficznego lub przez SSH może nie mieć dostępu; przełącz na auto albo file. Potem ponownie uruchom codex login status.

Codex ignoruje AGENTS.md projektu. Od CLI 0.150.0 (26 sierpnia 2026 roku) niezaufany projekt nie dostarcza swojego AGENTS.md. Oznacz projekt jako zaufany, gdy Codex zapyta o to przy pierwszym uruchomieniu.

W Cursorze brakuje ikony Codex. Jest w menu przepełnienia (>>) poziomego paska aktywności. Przypnij ją albo przełącz pasek na pionowy, jak opisano wyżej.

Błędy, które pojawiają się już po instalacji, podczas pracy Codex, opisuje odzyskiwanie po błędach w Codex.

Co dalej po instalacji Codex

Skonfiguruj uwierzytelnianie Codex Logowanie planem ChatGPT, rozliczanie kluczem API, maszyny bez interfejsu i przechowywanie danych logowania.

Skonfiguruj Codex config.toml, profile, profile uprawnień i ustawienia domyślne, które warto zmienić pierwszego dnia.

Uruchom pierwsze zadanie w Codex Pierwsza prawdziwa zmiana: od promptu do przejrzanego diffa.

Instalujesz też innego agenta? Zobacz instalację Claude Code oraz instalację i konfigurację Cursora.