Instalacja i aktualizacja Codex CLI: Mac, Linux, Windows

Instalacja OpenAI Codex CLI to jedno polecenie na platformę – curl -fsSL https://chatgpt.com/codex/install.sh | sh na macOS i Linuksie, powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" na Windows – z npm i Homebrew jako wspieranymi alternatywami, a aktualizacja to codex update, które rozpoznaje instalacje ze skryptu, npm i Homebrew i uruchamia upgrade właściwy dla danego kanału.¹⁴¹¹ Część, którą większość stron pomija, zaczyna się po pierwszym poleceniu: którą z pięciu ścieżek instalacji wybrać, jak przypiąć wersję, gdy nowe wydanie coś psuje, dlaczego pakiet winget odstaje od npm o siedem wersji pobocznych i co po odinstalowaniu zostaje w ~/.codex. Ta strona jest tym odniesieniem: jedna tabela na zadanie, aktualna na v0.153.4 (4 września 2026).⁹

TL;DR

• Samodzielny instalator to ścieżka, którą OpenAI stawia na pierwszym miejscu zarówno w README, jak i w dokumentacji CLI, a npm i Homebrew są przedstawiane jako alternatywy („you can also install” w dokumentacji CLI, „can also be installed via” w README): skrypt install.sh na macOS i Linuksie, skrypt install.ps1 na Windows. Pobiera skompilowany plik binarny, więc nie potrzebuje Node’a.¹¹¹
• npm i Homebrew to wspierane alternatywy. npm install -g @openai/codex przypina wersję zwykłą specyfikacją pakietu (@<version>); brew install --cask codex było w chwili pisania na tym samym 0.153.4 co npm.¹²¹⁰
• Unikaj winget do instalacji samego Codeksa. OpenAI publikuje pakiet OpenAI.Codex, ale pull requesty z manifestami dla 0.147.0 do 0.152.0 leżą niescalone w microsoft/winget-pkgs od 7 sierpnia 2026, więc najnowsza instalowalna wersja to 0.146.1 wobec 0.153.4 w npm w dniu pisania.³¹⁰
• codex update obejmuje instalacje ze skryptu, npm i Homebrew (v0.128.0 i nowsze): wykorzystuje wykrywanie kanału instalacji, które TUI już ma, i uruchamia pasujący upgrade. Instalacja przez winget nie jest kanałem, który rozpoznaje; tę aktualizuj przez winget upgrade OpenAI.Codex. Ręczne odpowiedniki dla pozostałych to ponowne uruchomienie instalatora, npm install -g @openai/codex@latest albo brew upgrade --cask codex.⁴¹¹
• Przypinaj wersję przez --release <version> w install.sh, $env:CODEX_RELEASE przed linią install.ps1 albo @<version> w npm. Cask Homebrew śledzi jedną bieżącą wersję i nie umie przypinać.²¹²
• Odinstalowanie pakietu nie usuwa Twojego stanu, ale przy instalacji ze skryptu rm -rf ~/.codex usuwa także samo CLI, bo instalator trzyma wydania w ~/.codex/packages/standalone.¹²

Jak zainstalować Codex CLI?

Cztery ścieżki w kolejności, w jakiej przedstawia je własna dokumentacja OpenAI,¹¹¹ plus winget na Windows, którego OpenAI nie dokumentuje:³

# Standalone installer, no Node required (macOS, Linux, WSL) -- the route OpenAI lists first
curl -fsSL https://chatgpt.com/codex/install.sh | sh

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

# npm (needs Node.js 16+; pins with a plain @version spec)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows; lags npm, see the platform section)
winget install OpenAI.Codex

Potem potwierdź, że instalacja się udała, i zaloguj się:

codex --version      # codex-cli 0.153.4
codex login          # ChatGPT account (recommended) or an API key

Przy pierwszej instalacji ze skryptu blok w profilu działa dopiero w nowych powłokach. Jeśli w terminalu, z którego instalowałeś, codex nie jest znajdowany, uruchom tam export PATH="$HOME/.local/bin:$PATH" albo otwórz nowy terminal; instalator wypisuje na koniec te same dwie linie („Current terminal” i „Future terminals”).¹²

Wolisz surowy plik binarny? Każde wydanie na GitHubie zawiera tarballe dla platform (codex-aarch64-apple-darwin.tar.gz, codex-x86_64-apple-darwin.tar.gz, codex-x86_64-unknown-linux-musl.tar.gz, codex-aarch64-unknown-linux-musl.tar.gz), a od v0.106.0 ten sam install.sh jest dołączany do każdego wydania jako zasób. Każde archiwum zawiera jeden wpis z nazwą platformy wpisaną w nazwę pliku, więc po rozpakowaniu zmień jego nazwę na codex.¹⁵

Instalator pobiera z infrastruktury wydań hostowanej przez OpenAI: chatgpt.com/codex/install.sh przekierowuje do releases.openai.com, zmiana, która weszła w v0.146.0, a GitHub Releases pozostaje hostem zapasowym.⁶ W sieci, która blokuje lub dławi hosta artefaktów OpenAI, ale przepuszcza GitHuba, pobierz skrypt z zasobu wydania i każ mu pobrać plik binarny również z GitHuba:¹¹²

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh

Zmienna idzie po stronie sh potoku. Forma VAR=value curl ... | sh stosuje zmienną tylko do curl, więc skrypt nigdy jej nie widzi i po cichu zostaje przy domyślnym ustawieniu. W PowerShellu ustaw $env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM = 'false' przed uruchomieniem linii instalacyjnej.

Którą ścieżkę wybrać?

Które platformy obsługuje Codex?

Na Windows Codex działa natywnie w PowerShellu z piaskownicą Windows, a tryby piaskownicy są dwa. elevated jest preferowany: używa dedykowanych użytkowników piaskownicy o obniżonych uprawnieniach, granic uprawnień systemu plików, reguł zapory i zmian lokalnych zasad, i wymaga konfiguracji zatwierdzonej przez administratora. unelevated to tryb zapasowy: uruchamia polecenia z ograniczonym tokenem Windows wyprowadzonym z Twojego użytkownika i granicami systemu plików opartymi na ACL.⁸ Tryb wybierasz w config.toml:

[windows]
sandbox = "elevated"   # or "unelevated"

Wytyczne OpenAI mówią, by domyślnie używać natywnej piaskownicy, a WSL wybierać, gdy potrzebujesz narzędzi natywnych dla Linuksa, gdy Twój przepływ pracy i tak żyje w WSL2 albo gdy żaden z natywnych trybów piaskownicy Windows nie spełnia Twoich potrzeb.⁸ Jedna rzecz do rozróżnienia: konfiguracja Windows zakłada obecność winget na maszynie na potrzeby własnych kroków konfiguracyjnych; to coś innego niż instalowanie Codeksa przez winget. OpenAI publikuje ten pakiet – przepływ wydań ma zadanie winget, które otwiera pull request z manifestem w microsoft/winget-pkgs dla wydań stabilnych – ale te zgłoszenia leżą niescalone, odkąd 7 sierpnia 2026 scalono manifest 0.146.1; wnioski dla 0.147.0 do 0.152.0 były w chwili pisania wciąż otwarte, a dla 0.153.0 do 0.153.4 nie istnieje żaden wniosek. Z CLI nic się nie zepsuło; to indeks pakietów jest w tyle.³⁸

Node.js jest wymagany tylko na ścieżce npm. Skrypty instalacyjne pobierają skompilowany plik binarny, a cask Homebrew nie deklaruje żadnych zależności.¹²

Jak zaktualizować Codex CLI?

Codex nie aktualizuje się sam. TUI zauważa nowsze wydanie i proponuje polecenie dla Twojego kanału instalacji; uruchomienie należy do Ciebie, a wbudowane polecenie obejmuje instalacje ze skryptu, npm i Homebrew.⁴ Samo sprawdzanie przy starcie to klucz konfiguracji: check_for_update_on_startup = false w config.toml, który dokumentacja opisuje jako „Check for Codex updates on startup (set to false only when updates are centrally managed)”; floty zarządzające aktualizacjami centralnie ustawiają features.in_app_updates = false w requirements.toml.¹⁶

codex --version                      # what you run now
npm view @openai/codex version       # newest published

codex update                         # built-in, v0.128.0+; detects your install channel

codex update pojawiło się w v0.128.0 30 kwietnia 2026; pull request, który je dodał, wykorzystał wykrywanie kanału instalacji i mechanizm uruchamiania aktualizacji, których TUI już używało do podpowiedzi o aktualizacjach. Mapa kanałów obejmuje npm (plus warianty bun, pnpm i Vite+), Homebrew oraz samodzielny instalator na Uniksie i Windows; instalacji przez winget w niej nie ma, więc Codex zainstalowany przez winget aktualizuje się wyłącznie przez winget upgrade OpenAI.Codex.⁴ Ręczne odpowiedniki, jeśli je wolisz albo skryptujesz obraz maszyny:

curl -fsSL https://chatgpt.com/codex/install.sh | sh   # standalone: re-run the installer
npm install -g @openai/codex@latest                    # npm
brew upgrade --cask codex                              # Homebrew
winget upgrade OpenAI.Codex                            # winget (to whatever winget has)

irm https://chatgpt.com/codex/install.ps1 | iex           # standalone on Windows: re-run the installer

Wydania spływają szybką linią stabilną – 0.150.0 do 0.153.4 wyszły między 26 sierpnia a 4 września 2026 – więc odstęp między „tym, co mam” a „najnowszym” to często tydzień, nie kwartał.⁹

Jak zainstalować konkretną wersję?

npm i skrypt instalacyjny przypinają po wersji; Homebrew nie:²¹²

npm install -g @openai/[email protected]                                          # npm: exact version
curl -fsSL https://chatgpt.com/codex/install.sh | sh -s -- --release 0.152.1  # script: --release flag
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_RELEASE=0.152.1 sh    # script: env var, on the sh side
winget install OpenAI.Codex --version 0.146.1                                 # winget: only what it has
codex --version                                                               # verify the rollback took

Uważaj na położenie w formie ze zmienną środowiskową: CODEX_RELEASE=0.152.1 musi stać przed sh, po potoku. Napisane przed curl dotyczy tylko curl, a skrypt instaluje latest, podczas gdy Ty sądzisz, że przypiąłeś wersję.¹² Na Windows skrypt PowerShell deklaruje $Release = $env:CODEX_RELEASE jako swój jedyny parametr i wraca do latest, gdy jest pusty, więc przypięciem jest ta zmienna, ustawiona w tej samej sesji:¹⁷

$env:CODEX_RELEASE = '0.152.1'; irm https://chatgpt.com/codex/install.ps1 | iex

Przypinanie to właściwy ruch, gdy wydanie coś Ci psuje: zgłoś issue, przypnij ostatnią dobrą wersję, idź dalej. Po każdym przypięciu sprawdź codex --version, bo druga instalacja gdzie indziej na PATH po cichu dalej serwuje własny plik binarny. Skrypt instalacyjny sprawdza dokładnie to: gdy znajdzie na Twoim PATH codex zarządzany przez Homebrew, npm albo bun, ostrzega „Multiple managed Codex installs can be ambiguous because PATH order decides which one runs” i proponuje, że uruchomi za Ciebie pasujące odinstalowanie.¹² codex doctor raportuje ten sam stan po fakcie pod Environment.⁷

Jak odinstalować Codex CLI?

Usuwaj tą ścieżką, którą instalowałeś:

npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

Instalacja ze skryptu nie ma menedżera pakietów, którego można by zapytać. Instalator umieszcza w ~/.local/bin dowiązanie symboliczne codex (nadpisywane przez CODEX_INSTALL_DIR), które wskazuje na plik binarny wewnątrz ~/.codex/packages/standalone/current (current/bin/codex w bieżących wydaniach); current samo jest dowiązaniem do ~/.codex/packages/standalone/releases/, gdzie leży każde pobrane wydanie. Na macOS instalator dodaje obok pierwszego drugie dowiązanie, codex-code-mode-host.¹² Usuń to wszystko:

rm -f ~/.local/bin/codex ~/.local/bin/codex-code-mode-host   # the second link exists on macOS installs only
rm -rf ~/.codex/packages/standalone

Jeśli ~/.local/bin nie było na Twoim PATH w chwili instalacji albo instalator znalazł konkurencyjną instalację Homebrew, npm lub bun i przepisał wpis, skrypt dopisał też oznaczony blok do profilu Twojej powłoki: od # >>> Codex installer >>> do # <<< Codex installer <<< w ~/.zprofile (zsh na macOS), ~/.bash_profile, ~/.zshrc, ~/.bashrc lub ~/.profile. Usuń te trzy linie, żeby skończyć.¹²

Na Windows install.ps1 zachowuje ten sam układ pod %USERPROFILE%\.codex\packages\standalone (albo %CODEX_HOME%\packages\standalone, jeśli ustawiłeś tę zmienną): pobrane wydania w releases\, junction current wskazujący na aktywne. Udostępnia codex.exe przez %LOCALAPPDATA%\Programs\OpenAI\Codex\bin (nadpisywane przez CODEX_INSTALL_DIR), który sam jest junction do current\bin, a zamiast bloku w profilu wpisuje tę ścieżkę bin do Twojego użytkownikowego PATH dla przyszłych sesji PowerShella. Usuń najpierw katalog standalone, potem wiszący już junction bin, a na koniec wyjmij wpis ze zmiennej użytkownika Path w Zmiennych środowiskowych:¹⁷

Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\packages\standalone"   # releases plus the current junction
cmd /c rmdir "$env:LOCALAPPDATA\Programs\OpenAI\Codex\bin"                  # the bin junction; rmdir removes the link, not a target

Powyższe odinstalowania przez menedżery pakietów nie dotykają ~/.codex/. --zap Homebrew w praktyce też nie: jedyna sekcja zap w casku to rmdir: "~/.codex", a Homebrew stosuje rmdir: tylko do katalogów, które są już puste.² Ten katalog trzyma config.toml, Twoje zapisane poświadczenia i każdą sesję, dlatego ponowna instalacja podejmuje logowanie i historię tam, gdzie je zostawiłeś. Usuń go tylko wtedy, gdy naprawdę chcesz czystej karty, i wiedz, co to znaczy przy instalacji ze skryptu:

rm -rf ~/.codex   # discards config.toml, credentials, all sessions -- AND the CLI itself on a script install

Czysta reinstalacja z zachowaniem stanu to w npm jedna linia: npm uninstall -g @openai/codex && npm install -g @openai/codex@latest. Na ścieżce skryptowej ponowne uruchomienie instalatora podmienia wydanie pod ~/.codex/packages/standalone i zostawia Twoją konfigurację w spokoju.¹²

Cały cykl życia w jednej tabeli

Co sprawdza codex doctor?

codex doctor to polecenie do uruchomienia przed zgłoszeniem błędu albo debugowaniem instalacji, która „wczoraj działała”. Na 0.153.4 zbiera siedem sekcji w jednym raporcie – Notes, Environment (spójność środowiska uruchomieniowego i instalacji), Configuration (stan wczytania config.toml, uwierzytelnianie, MCP, polityka piaskownicy), Desktop App (dodana w v0.149.0), Updates, Connectivity i Background Server – z --summary dla zwięzłego widoku, --json dla zredagowanej formy do odczytu maszynowego, --all do rozwinięcia uciętych list i --no-color do logów; codex doctor --help na 0.153.4 wymienia też --ascii.⁷¹³¹⁵ Większość zgłoszeń „Codex jest zepsuty” sprowadza się do czegoś, co wymienia na pierwszym ekranie: nieaktualny tryb uwierzytelniania, config.toml, którego nie udało się sparsować, albo druga instalacja przesłaniająca tę na Twoim PATH. Pełne omówienie sekcja po sekcji jest w przewodniku.

Co zmienia się po instalacji

Pierwszą rzeczą, o którą potyka się świeża instalacja, nie jest plik binarny. Od v0.149.0 CLI odmawia startu przy approval_policy = "untrusted", więc config.toml skopiowany ze starszej maszyny potrzebuje jednej poprawki.¹³ Przechodzisz z Claude Code? Wpis o migracji zestawia obie konfiguracje obok siebie, a wpis o hookach opisuje, co Codex uruchamia wokół modelu. Przewodnik po Codex CLI to pełne odniesienie: tryby piaskownicy i zatwierdzania, AGENTS.md, MCP, skills i zadania w chmurze. A jeśli używasz obu narzędzi, strona instalacji Claude Code jest bliźniaczką tej strony.

Często zadawane pytania

Jak zaktualizować Codex CLI do najnowszej wersji?

Uruchom codex update (v0.128.0 i nowsze); wykrywa, czy instalowałeś przez skrypt, npm czy Homebrew, i uruchamia upgrade właściwy dla tego kanału. Ręczne odpowiedniki to ponowne uruchomienie skryptu instalacyjnego, npm install -g @openai/codex@latest albo brew upgrade --cask codex. Instalacja przez winget nie jest kanałem, który codex update rozpoznaje; do niej użyj winget upgrade OpenAI.Codex.

Czy Codex CLI aktualizuje się automatycznie?

Nie. TUI sprawdza, czy jest nowsze wydanie, i proponuje polecenie aktualizacji pasujące do Twojego kanału instalacji, a codex update (v0.128.0 i nowsze) je uruchamia; nic nie jest pobierane ani stosowane, dopóki tego nie zrobisz.

Jak odinstalować Codex CLI?

Użyj ścieżki, którą instalowałeś: npm uninstall -g @openai/codex, brew uninstall --cask codex albo winget uninstall OpenAI.Codex. Przy instalacji ze skryptu usuń dowiązanie ~/.local/bin/codex (i ~/.local/bin/codex-code-mode-host na macOS) oraz katalog ~/.codex/packages/standalone. Na Windows instalacja ze skryptu to %USERPROFILE%\.codex\packages\standalone, junction %LOCALAPPDATA%\Programs\OpenAI\Codex\bin i wpis w Twoim użytkownikowym PATH; usuń wszystkie trzy. Twoja konfiguracja, poświadczenia i sesje zostają w ~/.codex/, dopóki sam nie usuniesz reszty tego katalogu.

Jak zainstalować Codex CLI na Windows?

Uruchom powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex". CLI działa natywnie w PowerShellu z piaskownicą Windows (elevated preferowany, unelevated jako zapasowy); WSL2 to opcja, gdy potrzebujesz narzędzi linuksowych albo żaden tryb piaskownicy nie pasuje, a nie wymóg. Windows 11 to zalecana baza. winget install OpenAI.Codex też działa, ale odstaje od linii stabilnej.

Czy do instalacji Codeksa potrzebuję Node.js?

Tylko na ścieżce npm, a pakiet wymaga Node’a 16 lub nowszego. Skrypt instalacyjny, skrypt PowerShell i cask Homebrew dostarczają skompilowany plik binarny codex, więc maszyna bez Node’a może uruchamiać Codeksa.

Jak sprawdzić, którą wersję Codeksa mam?

codex --version ją wypisuje (na przykład codex-cli 0.153.4). npm view @openai/codex version pokazuje najnowszą opublikowaną wersję, a codex doctor raportuje ścieżkę instalacji i to, czy inna kopia na Twoim PATH ją przesłania.