Codex CLI na VPS-ie

Serwer to dobre miejsce dla Codex CLI od OpenAI. Pracuje, gdy laptop jest zamknięty, przetrwa zerwane połączenie, a jeśli coś pójdzie nie tak, możesz postawić maszynę od nowa. Na świeżym VPS-ie z Linuksem ludzie potykają się o dwie rzeczy. Po pierwsze, zwykłe codex login czeka na przekierowanie z przeglądarki, które nigdy nie dotrze do serwera. Po drugie, sandbox wymaga pakietu, którego większość minimalnych obrazów nie zawiera. Ten poradnik rozwiązuje oba problemy, a potem opisuje podtrzymywanie sesji i sposoby dostępu do nich z telefonu.

Wymagania

• Serwer z Linuksem, x86-64 lub arm64. OpenAI publikuje pliki binarne dla obu, działa też macOS. Debian lub Ubuntu to najprostsza droga.
• Konto. Plan ChatGPT albo klucz API OpenAI. Według cennika Codexa od OpenAI Codex wchodzi w skład ChatGPT Free, Go, Plus, Pro, Business, Edu i Enterprise. Limity różnią się w zależności od planu, a lokalne użycie CLI dzieli pulę z czatami w chmurze. Użycie z kluczem API jest zamiast tego rozliczane według stawek API.
• Pamięć. CLI to skompilowany plik binarny i sam potrzebuje niewiele pamięci. RAM zużywają buildy i testy Twojego projektu. 2 GB wystarczą do lekkiej pracy, 4 GB to komfort. Dobór rozmiaru i aktualne ceny znajdziesz w poradniku zakupowym VPS.
• Użytkownik inny niż root. Utwórz go przed instalacją czegokolwiek (adduser dev, potem skopiuj klucz SSH). Nasz poradnik Claude Code na VPS opisuje to i utwardzanie SSH; kroki są takie same dla Codexa.

Instalacja Codexa

Samodzielny instalator nie wymaga Node.js:

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

Jeśli już zarządzasz narzędziami przez npm, to polecenie instaluje to samo CLI:

npm install -g @openai/codex

Uważaj na zakres: pakiet to @openai/codex. Pakiet codex bez zakresu w npm nie ma z tym nic wspólnego. Instaluj jako zwykły użytkownik, nie przez sudo. Obie metody są opisane w README openai/codex.

Wymaganie sandboxa na Linuksie

Na Linuksie Codex uruchamia generowane polecenia powłoki w sandboxie zbudowanym na bwrap (bubblewrap) i seccomp. Dokumentacja sandboxa od OpenAI każe najpierw zainstalować bubblewrap:

sudo apt install bubblewrap      # Debian / Ubuntu
sudo dnf install bubblewrap      # Fedora

Bez bwrap Codex korzysta z dołączonego programu pomocniczego, a ten wymaga nieuprzywilejowanych przestrzeni nazw użytkownika. Ubuntu 24.04 ogranicza je przez AppArmor. Udokumentowane rozwiązanie ładuje dodatkowy profil:

sudo apt install apparmor-profiles apparmor-utils
sudo install -m 0644 /usr/share/apparmor/extra-profiles/bwrap-userns-restrict /etc/apparmor.d/bwrap-userns-restrict
sudo apparmor_parser -r /etc/apparmor.d/bwrap-userns-restrict

Dokumentacja podaje też bardziej toporną alternatywę, sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0, która wyłącza to ograniczenie dla całej maszyny. Wybierz profil. Jeśli każde polecenie w sandboxie kończy się błędem przestrzeni nazw, przyczyna jest właśnie tutaj.

Logowanie kodem urządzenia

Uruchom zwykłe codex login na serwerze, a wygląda, jakby się zawiesiło. Dlaczego: uruchamia lokalny serwer callbacku na porcie 1455 i czeka, aż Twoja przeglądarka zostanie przekierowana na localhost. To localhost serwera, do którego Twój telefon ani laptop nie mają dostępu. Zamiast tego użyj logowania kodem urządzenia. Ma jedno wymaganie, o które potyka się niemal każdy:

1. Włącz logowanie kodem urządzenia. Na koncie prywatnym zrób to w ustawieniach bezpieczeństwa ChatGPT. W workspace Business, Edu lub Enterprise włącza je administrator w uprawnieniach workspace'u. Dopóki nie jest włączone, logowanie urządzenia nie zadziała na Twoim koncie.
2. Rozpocznij proces na serwerze:

   codex login --device-auth

3. Dokończ go na dowolnym urządzeniu. Codex wypisuje link i jednorazowy kod. Otwórz link na telefonie lub laptopie, zaloguj się do ChatGPT i wpisz kod.
4. Sprawdź, czy zadziałało:

   codex login status

   Wypisuje aktywny tryb uwierzytelniania i kończy się kodem 0, gdy logowanie jest aktywne, co przydaje się w skryptach.

To z dokumentacji uwierzytelniania OpenAI. Podaje ona dwa rozwiązania zapasowe na wypadek, gdy kod urządzenia nie jest dostępny:

• Przekieruj port callbacku. Połącz się przez ssh -L 1455:localhost:1455 user@your-server, uruchom codex login na serwerze i otwórz wypisany adres w lokalnej przeglądarce. Przekierowanie wraca wtedy przez tunel.
• Skopiuj dane logowania. Zaloguj się na maszynie z przeglądarką, a potem scp ~/.codex/auth.json user@your-server:~/.codex/auth.json.

Klucz API zamiast planu

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

Przekazanie klucza przez stdin trzyma go z dala od historii powłoki. Płacisz za tokeny według cen API zamiast korzystać z planu ChatGPT. To dobre rozwiązanie dla współdzielonej maszyny lub CI, gdzie chcesz twardej granicy rozliczeń.

Utrzymanie w działaniu

Interaktywna sesja codex żyje i umiera razem z terminalem, który ją uruchomił. Zamknij połączenie SSH, a sesja się skończy. Są trzy sposoby, żeby to obejść.

tmux, klasyka:

sudo apt install tmux
tmux new -A -s codex     # create or re-attach
cd ~/src/my-app && codex
# detach: Ctrl-b then d; later: tmux attach -t codex

Jeśli sesja jednak się skończy, codex resume --last podejmuje ostatnią rozmowę w tym katalogu, a codex resume otwiera listę do wyboru. Nasz poradnik o tmux, mosh i Tailscale zawiera konfigurację tmux przyjazną dla telefonu.

Uruchomienia nieinteraktywne. codex exec "…" wykonuje jedno zadanie bez TUI, a codex exec resume --last je kontynuuje. To pasuje do zadań cron i CI, ale nie ma tam nikogo, kto odpowie na prośby o zatwierdzenie, więc poniższe ustawienia sandboxa mają większe znaczenie.

Demon, który jest właścicielem sesji i przetrwa restarty. To właśnie porównuje poradnik o pracy 24/7: jednostki systemd, serwery Remote Control i aplikacje takie jak Maude, które uruchamiają na maszynie własny proces.

Zatwierdzanie i sandbox

Codex ma dwie osobne kontrolki: czego mogą dotykać polecenia (sandbox) i kiedy zatrzymuje się, by Cię zapytać (polityka zatwierdzania). Poniższe wartości pochodzą z dokumentacji zatwierdzania i bezpieczeństwa OpenAI oraz dokumentacji CLI:

--full-auto wciąż pojawia się w starszych poradnikach. To teraz przestarzała flaga zgodności, a dokumentacja każe zamiast niej używać --sandbox workspace-write. Żeby polecenia w sandboxie miały dostęp do sieci, na przykład żeby działało npm install, dodaj to do ~/.codex/config.toml:

sandbox_mode = "workspace-write"
approval_policy = "on-request"

[sandbox_workspace_write]
network_access = true

Uwaga o kontenerach: jeśli Twój „VPS” to w rzeczywistości kontener Docker lub LXC, który blokuje operacje na przestrzeniach nazw, dokumentacja sugeruje --sandbox danger-full-access. Rób to tylko wtedy, gdy sam kontener jest Twoim sandboxem. Kompromisy są takie same jak przy trybie bypass w Claude, opisanym w tekście bezpieczne uruchamianie agentów z pełnymi uprawnieniami.

Opcje dostępu z telefonu

Słowo o Linuksie bez interfejsu i Codex Remote. Dokumentacja CLI opisuje codex remote-control start i codex remote-control pair dla lokalnego app-servera. Przewodnik po połączeniach zdalnych nadal jednak mówi, że hosty uruchamiają aplikację desktopową na macOS lub Windows. Użytkownicy otworzyli zgłoszenia w tej sprawie: #31183 zgłasza, że hostów Linux bez interfejsu nie da się ponownie sparować z obecnymi klientami mobilnymi, a #35928 wskazuje na sprzeczność. Oba były otwarte, gdy sprawdzaliśmy. Jeśli ta ścieżka u Ciebie działa, to jest ona oficjalna. Po prostu nie opieraj jeszcze na niej swojego sposobu pracy.

Sterowanie z telefonu przez Maude

Maude to jeden ze sposobów na sterowanie tym VPS-em z telefonu bez TUI. Dodajesz serwer po adresie lub wklejonym poleceniem ssh, a aplikacja wdraża przez SSH własnego, małego demona. Ten demon instaluje Codexa w przetestowanej, przypiętej wersji, zweryfikowanej sumą kontrolną, więc pomijasz krok instalacji. Do Codexa logujesz się z telefonu kodem urządzenia ChatGPT lub kluczem API. Nadal musisz najpierw włączyć logowanie kodem urządzenia w ChatGPT. Sesje działają dalej na serwerze, gdy aplikacja jest zamknięta, prośby o zatwierdzenie pojawiają się w skrzynce i jako powiadomienia push z Zezwól/Odmów, a ten sam serwer może obok Codexa uruchamiać Claude Code, OpenCode, Grok Build i Antigravity. Szczegóły są na stronie agenta Codex.

Najczęściej zadawane pytania

Co się zmieniło

• 1 października 2026 — Pierwsza publikacja. Instalacja, uwierzytelnianie, sandbox i Remote sprawdzone tego dnia w dokumentacji OpenAI i README openai/codex.