Codex CLI: kompletny przewodnik techniczny

TL;DR: Codex to agent programistyczny dostępny w wielu środowiskach: odczytuje bazę kodu, uruchamia polecenia w piaskownicy na poziomie systemu operacyjnego, modyfikuje pliki i deleguje zadania do chmury. Opanowanie pięciu systemów — config.toml, modelu piaskownicy i zatwierdzania, AGENTS.md, MCP oraz skills — pozwala zwielokrotnić efektywność pracy. Który model wybrać: dokumentacja modeli OpenAI wskazuje obecnie GPT-6.1 Sol (gpt-6.1-sol, domyślny model dołączany do CLI od v0.159.1) do złożonych zadań programistycznych i pracy agentowej, GPT-6-Astra do najtrudniejszych zadań realizowanych od początku do końca, a GPT-6 Luna do ściśle określonych, powtarzalnych zadań. Dostępność zależy od planu, klienta i ustawień obszaru roboczego; GPT-6 Sol i modele GPT-5.6 pozostają na liście wyboru, a 14 października 2026 model GPT-5.5 zostaje wycofany z Codex dla osób logujących się przez ChatGPT.^146171178 Na początek warto przejść bezpośrednio do instalacji i szybkiego startu. Dla osób śledzących wydania: najnowsza stabilna wersja to v0.164.0 (23 października 2026). Wprowadza dziesięć miejsc w /presets na prompty wielokrotnego użytku, argumenty podawane bezpośrednio przy /model i /permissions, podglądy obrazów w pełnoekranowym zapisie sesji, zarządzane przez organizację logowanie do MCP oraz domyślnie włączony kreator konfiguracji Bedrock; sekcja najważniejszych zmian w wydaniach zaczyna się od podsumowania bieżącego stanu (co jest domyślnie włączone, a co nadal eksperymentalne), po czym omawia poszczególne wersje, natomiast historia zmian zawiera wszystkie aktualizacje przewodnika.^116178182183

Codex działa jako agent programistyczny dostępny w wielu środowiskach, a nie chatbot piszący kod. CLI odczytuje bazę kodu, wykonuje polecenia w piaskownicy, modyfikuje pliki, łączy się z usługami zewnętrznymi przez MCP i deleguje długotrwałe zadania do chmury. Działa lokalnie, ale myśli globalnie; ta sama inteligencja napędza pięć różnych środowisk pracy, zależnie od sposobu korzystania z narzędzia. Jednym z nich jest rozszerzenie do przeglądarki (Chrome, Edge, Brave, Opera i Vivaldi), które uruchamia Codex w przeglądarce bez przejmowania nad nią kontroli.⁹⁰¹²⁷

Różnica między okazjonalnym a efektywnym korzystaniem z Codex sprowadza się do pięciu podstawowych systemów. Ich opanowanie pozwala zwielokrotnić efektywność pracy z Codex:

1. System konfiguracji: steruje zachowaniem za pomocą config.toml
2. Model piaskownicy i zatwierdzania: określa, co Codex może robić
3. AGENTS.md: definiuje zasady działania na poziomie projektu
4. Protokół MCP: rozszerza możliwości o usługi zewnętrzne
5. System skills: udostępnia wiedzę dziedzinową w pakietach wielokrotnego użytku

Przez wiele miesięcy korzystałem z Codex równolegle z Claude Code w produkcyjnych bazach kodu, potokach CI/CD i procesach pracy zespołowej. Ten przewodnik zbiera te doświadczenia w kompletną dokumentację, jakiej brakowało mi na początku. Przy każdej funkcji podaję rzeczywistą składnię, praktyczne przykłady konfiguracji i przypadki brzegowe, które sprawiają trudność nawet doświadczonym użytkownikom.

Najważniejsze informacje

• Pięć interfejsów, jeden mózg: CLI, aplikacja desktopowa, rozszerzenie IDE, zadania w chmurze oraz rozszerzenie przeglądarki (Chrome, Edge, Brave, Opera i Vivaldi) korzystają z tej samej rodziny modeli, dlatego warto wybrać interfejs najlepiej dopasowany do danego przepływu pracy.⁹⁰
• Sandboxing na poziomie systemu operacyjnego: Codex egzekwuje ograniczenia systemu plików i sieci na poziomie jądra systemu (Seatbelt w systemie macOS, bubblewrap + seccomp w systemie Linux), a nie wewnątrz kontenerów.
• AGENTS.md działa w wielu narzędziach: Instrukcje projektu działają w Codex, Cursor, Copilot, Amp, Jules, Gemini CLI, Windsurf, Cline, Aider, Zed oraz ponad 60 000 projektów open source. Wystarczy napisać je raz, by korzystać z nich wszędzie.
• Profile ograniczają narzut związany z przełączaniem kontekstu: Można zdefiniować nazwane zestawy ustawień (fast, careful, auto) i przełączać się między nimi za pomocą --profile.
• Zarządzanie kontekstem ma znaczenie: katalog modeli dostarczany z Codex udostępnia modelom GPT-6.1 Sol, GPT-6 Astra, Sol i Luna oraz rodzinie GPT-5.6 okno kontekstu o rozmiarze 272K (w API modele GPT-6.1 Sol, GPT-6 Sol i Luna mają okno 1,05M); GPT-5.5 oferuje w Codex okno 400K do czasu wycofania go z tej usługi 14 października 2026 roku. Aby aktywnie zarządzać budżetami tokenów, warto korzystać z /compact, precyzyjnych promptów i odwołań @file.^83112178

Jak korzystać z tego przewodnika

To dokumentacja licząca ponad 3 300 wierszy — najlepiej zacząć od miejsca odpowiadającego poziomowi doświadczenia:

Karta podręczna na końcu zawiera łatwe do przejrzenia podsumowanie wszystkich najważniejszych poleceń.

Najważniejsze zmiany w wydaniach: co nowego

Historia kolejnych wersji, od najnowszej, dla osób śledzących rozwój Codex. Pierwszy kontakt z narzędziem? Można przejść od razu do sekcji Szybki start; poniższe informacje nie są potrzebne do rozpoczęcia pracy. Szczegóły weryfikacji (porównania, listy commitów, kontrole dokumentacji) znajdują się w przypisach.

Stan obecny

Codex CLI — stan na 23 października 2026

• Wersja stabilna: v0.164.0 (23 października, npm latest), utworzona na bazie 0.164.0-alpha.11 z jednym dodatkowym commitem wydania (alpha.12 zawierała dziewięć commitów nieobecnych w wersji stabilnej), obejmująca 330 commitów od v0.163.0: dziesięć numerowanych miejsc w /presets na prompty wielokrotnego użytku i slash commands, bezpośrednie polecenia /model [model] --reasoning <level> --speed <tier> i /permissions <profile-id>, podgląd obrazów w pełnoekranowym zapisie rozmowy w terminalach obsługujących Kitty lub Sixel, zarządzana przez organizację autoryzacja połączeń MCP, maskowanie danych uwierzytelniających w obsługiwanych zdalnych poleceniach Bash (za flagą credential_masking) oraz domyślnie włączony kreator konfiguracji Amazon Bedrock. Poprzednia wersja: v0.163.0 (15 października), która wprowadziła panel /config z wyszukiwaniem, klawisz inicjujący sekwencje skrótów oraz domyślnie włączony Daybreak.
• Wersja alpha: npm alpha to 0.165.0-alpha.1 (23 października, kilka godzin po wersji stabilnej). W tym tagu reasoning_effort_override jest stabilna i włączona, a nowe flagi guardianv3, guardian_recorded_items i tui_multi_backend są wyłączone. Linia 0.164 obejmowała wydania od alpha.1 (16 października) do alpha.12 (22 października), a równolegle ukazały się dodatkowe kompilacje 0.163.0-alpha.11.1 i 11.2 (21–22 października) oraz 0.164.0-alpha.11.1 (23 października).
• Model domyślny od v0.159.1: GPT-6.1 Sol, zastępujący GPT-6-Astra, także w Amazon Bedrock. Aby zachować inny model, należy ustawić model w config.toml. Katalog dołączony do v0.164.0 jest identyczny bajt po bajcie z katalogami z v0.162.1 i v0.163.0 oraz zawiera te same modele co v0.159.1.
• Domyślnie włączone od v0.164.0: kreator konfiguracji Amazon Bedrock (bedrock_setup_wizard, stabilny; wyłącza go bedrock_setup_wizard = false w [features]), przyrostowe aktualizacje narzędzi (incremental_tools, stabilne) oraz koordynacja odświeżania OAuth dla MCP (mcp_oauth_refresh_coordination, stabilna). Zarządzane worktrees i rozmowy w czasie rzeczywistym są włączone na stałe: ich flagi oznaczono jako usunięte, pozostawiając funkcje włączone.
• Domyślnie włączone od v0.163.0: Daybreak (cli_daybreak, obecnie stabilny; cli_daybreak = false w [features] ukrywa jego elementy sterujące) oraz przerywanie trybu kodu (code_mode_interrupt, stabilne), dzięki czemu kolejna wiadomość zatrzymuje również działającą komórkę Code Mode; sesje z kluczem API domyślnie otrzymują programy dostępu Cyber (api_key_cyber_access_programs). Usunięto: shell_zsh_fork i unified_exec_zsh_fork — są ignorowane, z wyświetleniem komunikatu o migracji.
• Domyślnie włączone od v0.162.0: instant_interrupt, dzięki czemu nowa wiadomość przerywa odpowiedź modelu (instant_interrupt = false w [features] wyłącza tę funkcję); flaga nadal jest oznaczona jako rozwijana.
• Domyślnie włączone od v0.161.0: wykrywanie modeli dla klucza API (api_key_model_discovery = false w [features] wyłącza tę funkcję).
• Domyślnie włączone od v0.158.0: zatwierdzanie danych wejściowych przekazywanych do terminali z podwyższonymi uprawnieniami (write_stdin_approval = false w [features] wyłącza tę funkcję), a także kopiowanie po zaznaczeniu i wklejanie prawym przyciskiem myszy w pełnoekranowym TUI (copy_on_select = "never", right_click_paste = "off" w [tui]). Kontekst wątku Guardian jest zawsze włączony; thread_context jest ignorowane.
• Domyślnie włączone od v0.157.0: pełnoekranowy zapis rozmowy (fullscreen_transcript = false w [tui]) oraz automatyczne uruchamianie serwera w tle (daemon_auto_start = false w [features] lub --no-daemon).
• Domyślnie włączone od v0.156.0: /voice, zarządzane worktrees, ponowne wykorzystywanie przez Guardian wyników kompakcji wątku nadrzędnego.
• Wymagające włączenia lub eksperymentalne: Codex Cloud, tryb kodu i jego wyszukiwanie narzędzi z rankingiem wyników (code_mode_tool_search, v0.162.0), pobieranie historii przez Guardian (guardian_conversation_history_tools, v0.160.0) oraz rozwijane flagi, które w v0.164.0 są domyślnie wyłączone (od v0.163.0: async_compaction, credential_masking, output_token_replay, retain_client_tool_outputs, subagent_default_context_limits, code_mode_host_grpc, code_mode_tool_description_first, guardian_trust_orchestrator_connectors; nowe w v0.164.0: app_server_websocket_compression, executor_capability_discovery_v2, mcp_tool_list_changed, multi_env_copy_file, runtime_agent_instances, subagent_thread_environments, wake_on_agent_messages). Eksperymentalne zarządzanie kontekstem jest obecnie niedostępne.
• Modele: GPT-6.1 Sol do złożonych zadań programistycznych, GPT-6-Astra do najtrudniejszych prac, GPT-6 Luna do zadań powtarzalnych. GPT-6 Sol i Luna uruchamiają się w trybie Fast (2,5-krotne zużycie kredytów); GPT-6.1 Sol nie. GPT-5.5 opuszcza Codex 14 października 2026.
• Przypięcie wersji: npm install -g @openai/codex@0.164.0, a następnie codex --version.^{176178186187188189192193194195}

v0.164.0 (23 października 2026)

Stabilne wydanie linii 0.164 powstało na bazie jej własnej wersji alpha. v0.164.0 opublikowano 23 października (04:48 UTC; npm latest o 04:52 UTC) na bazie 0.164.0-alpha.11 z jednym dodatkowym commitem wydania; alpha.12 (22 października) zawierała o dziewięć commitów więcej niż ta baza, a dodatkowa kompilacja 0.164.0-alpha.11.1 (23 października, 01:58 UTC) dodała cztery commity do bazy alpha.11. Porównanie z v0.163.0 obejmuje 330 commitów. Trzy flagi zostały włączone i oznaczone jako stabilne: bedrock_setup_wizard (kreator konfiguracji Amazon Bedrock, w którym po wykryciu danych uwierzytelniających wprowadzanie klucza API jest zgrupowane z pozostałymi metodami logowania do AWS), incremental_tools oraz mcp_oauth_refresh_coordination. Flagi worktrees i realtime_conversation oznaczono jako usunięte, pozostawiając ich funkcje włączone, więc zarządzanych worktrees i rozmów w czasie rzeczywistym nie można już wyłączać; usunięto także stable_environment_tools i transcript_v2. Dodano siedem rozwijanych flag, wszystkie wyłączone. Dołączony katalog modeli to ten sam obiekt blob, który dostarczono w v0.162.1.¹⁹⁴¹⁹⁵

Nowości w TUI. /presets zapisuje prompty wielokrotnego użytku i slash commands w dziesięciu numerowanych miejscach z menu obsługiwanym z klawiatury; ustawienie wstępne można utworzyć z tekstu w polu wiadomości albo z bieżącego modelu, poziomu rozumowania i szybkości, a ustawienia te są zapisywane w tui.presets w aktywnej konfiguracji użytkownika (#54380, #54381). /model [model] --reasoning <level> --speed <tier> ustawia model, poziom rozumowania i szybkość dla bieżącej sesji bez zmiany zapisanych wartości domyślnych; wartości flag można oddzielać spacją lub znakiem =. Pominięcie modelu powoduje zastosowanie ustawień do bieżącego modelu, a samo /model nadal otwiera listę wyboru (#54378). /permissions <profile-id> bezpośrednio wybiera wbudowany lub niestandardowy profil uprawnień, na przykład /permissions :read-only, z aliasami :ask-for-approval i :approve-for-me (#54383). W terminalach obsługujących grafikę Kitty lub Sixel pełnoekranowy zapis rozmowy wyświetla podgląd przeglądanych i wygenerowanych obrazów jako miniatury o ograniczonych wymiarach; w zdalnych obszarach roboczych, nieobsługiwanych terminalach i przypadku zbyt dużych obrazów pozostaje wpis tekstowy (#54216).¹⁹⁴

Połączenia i dane uwierzytelniające. Bezpośrednio skonfigurowane serwery MCP mogą uwierzytelniać się za pomocą uprawnień przyznanych przez organizację, przypisanych do konta i przechowywanych w systemowym magazynie kluczy, lub przez osobne logowanie; obejmuje to także klientów OAuth wymagających sekretów. Rozszerzenie autoryzacji zarządzanej przez organizację jest negocjowane w ramach protokołu 2026-07-28, a autoryzacja zostaje cofnięta po zmianie właściciela konta lub zastąpieniu przyznanego uprawnienia logowaniem organizacyjnym (#55334, #55859, #56001). Maskowanie danych uwierzytelniających obejmuje obsługiwane zdalne polecenia Bash i sesje oparte na migawkach zsh, w tym dane od niestandardowych dostawców: polecenie widzi symbole zastępcze, a lokalny serwer proxy po stronie wykonawcy wstawia rzeczywiste dane uwierzytelniające dla pasujących adresów docelowych. Tam, gdzie maskowanie jest niedostępne, wykonanie odbywa się bez maskowania, z ostrzeżeniem; w tym tagu flaga credential_masking pozostaje domyślnie wyłączona (#54309, #54432, #56049).¹⁹⁴¹⁹⁵

Poprawki i porządki. Nieudana kompakcja nie pozostawia już częściowych podsumowań w historii rozmowy, a błąd kompakcji w tle uruchamia mechanizm zastępczy bez błędu typu panic (#53932, #55581). Wznowienie sesji odnajduje skompresowane historie i przywraca zapisane ustawienia wątku, zamiast zastępować je globalnymi wartościami domyślnymi (#54008, #55923). W systemie Windows połączenia HTTPS i WebSocket odpowiadają na żądania uwierzytelnienia serwera proxy przy użyciu danych Negotiate lub NTLM zalogowanego użytkownika (#55994, #56000). Użycie -c lub --config na kilku poziomach podpoleceń zachowuje wszystkie nadpisania (#56022); prompty w kolejce czekają na zakończenie trwającego wyboru uprawnień (#55682); a piaskownica sprawdza ścieżki metadanych różniące się wielkością liter w macOS oraz dowiązania symboliczne używane do lokalizowania plików wykonywalnych, które można podmienić (#54273, #55384). Zmniejszono zużycie miejsca na dysku: nieużywane instalacje są usuwane (zachowywane są bieżąca i poprzednia wersja wybrana dla demona), porzucone kopie robocze repozytoriów marketplace są czyszczone, a rozmiar logów demona jest ograniczony (#53827, #55149, #55689, #55690, #55856); wbudowane środowisko uruchomieniowe JavaScript zyskało kontrole bezpieczeństwa dla zoptymalizowanego Array.sort (#54519).¹⁹⁴ Zalecane działanie: zaktualizować. Nie zmienia się żadne ustawienie domyślne, którego zmianę można by zauważyć, chyba że rozpoczyna się konfigurację w Bedrock — kreator uruchamia się teraz automatycznie (bedrock_setup_wizard = false w sekcji [features] wyłącza tę funkcję). Jeśli w sekcji [features] ustawiono worktrees lub realtime_conversation, te klucze są teraz ignorowane.¹⁹⁴¹⁹⁵

v0.163.0 (15 października 2026)

Linia 0.163 doczekała się stabilnego wydania z gałęzi rozwijanej poza głównym cyklem. Wersję v0.163.0 opublikowano 15 października (o 21:30 UTC; oznaczenie npm latest nadano o 21:37 UTC). Powstała na podstawie 0.163.0-alpha.10.2, kompilacji przygotowanej poza głównym cyklem na bazie alpha.10, z jednym dodatkowym commitem wydaniowym. Wersja alpha.11 z głównej linii (14 października) zawierała 23 commity, których nie ma w wydaniu stabilnym — powtórzył się schemat z 0.158. Porównanie z v0.162.1 obejmuje 232 commity. Dwie flagi funkcji zostają włączone i obie otrzymują status stabilnych: cli_daybreak (elementy sterowania Daybreak, przełącznik /daybreak i automatyczne kierowanie kwalifikujących się kont OpenAI do programu dostępu Cyber; codex exec może wybrać ten tryb przy użyciu klucza API OpenAI, gdy serwer udostępnia dostęp) oraz code_mode_interrupt (przerwanie tury zatrzymuje także aktywne komórki Code Mode i zagnieżdżone w nich wywołania narzędzi). Włączona zostaje też flaga api_key_cyber_access_programs, która już wcześniej miała status stabilnej. instant_interrupt pozostaje włączona i nadal ma status funkcji w fazie rozwoju.¹⁹²¹⁹³

Nowości w TUI. /config otwiera panel preferencji z wyszukiwaniem, podzielony na karty Wygląd, Powiadomienia, Wprowadzanie danych, Sesje i Zaznaczanie tekstu; obsługiwane zmiany są stosowane natychmiast, panel wskazuje te wymagające ponownego uruchomienia, a zmiany są zapisywane w wybranym lokalnym pliku konfiguracyjnym (#52990, #53429). /keymap umożliwia skonfigurowanie klawisza prefiksowego: domyślna wartość tui.keymap.global.leader to ctrl-x, po którym następują przypisania takie jak leader c; podpowiedzi skrótów pozostają otwarte do momentu wyboru lub anulowania, a skrót wyciszania głosu zmienia się z Ctrl+X na F9 (#52273). /daemon może ponownie uruchomić zarządzany serwer działający w tle, ostrzegając o zadaniach, które restart może przerwać, a następnie ponownie nawiązując połączenie (#53173). Codex równolegle uruchamia niezależne narzędzia tylko do odczytu: wyszukiwanie w skills, pamięci i historii rozmów, wyświetlanie list wtyczek i agentów, sprawdzanie bieżącego czasu i pozostałego kontekstu oraz get_goal (#52245). Wiadomość uzupełniająca wysłana podczas udzielania odpowiedzi przez Codex od razu wpływa na jego dalsze działania (#51812, #51835).¹⁹²

Poprawki i obsługa platform. Wznowienie zapisanego wątku przywraca jego uprawnienia i zgody na dostęp do sieci, z uwzględnieniem jawnych nadpisań i zarządzanej polityki (#53150, #53419, #53424). Serwer proxy sieci sprawdza uprawnienia przed zapytaniem DNS, odrzuca zduplikowane nagłówki Host i uniemożliwia aliasom poświadczeń omijanie hooks odpowiedzialnych za inspekcję (#51650, #52661, #53506). Po przełączeniu wątku /side wraca do istniejącej rozmowy pobocznej, a odpowiedzi na oczekujące pytania trafiają do wątku, z którego pochodziły (#52184, #53436). W systemie Windows Ctrl+V i Shift+Insert wklejają zarówno tekst, jak i obrazy; w WSL kolejne operacje wklejania korzystają ponownie z tego samego mechanizmu odczytu schowka, a próby kopiowania kończą się po przekroczeniu limitu czasu, zamiast zawieszać działanie (#53224, #52967, #53453). Polecenia lokalne kończą się bez zwłoki, gdy proces potomny utrzymuje otwarty potok wyjściowy, polecenia zdalne zachowują spóźnione dane wyjściowe do ostatniego odpytywania, a codex exec nie wyświetla już ponownie różnic w pliku po niezwiązanym z nim poleceniu (#52652, #53331, #53622, #53444).¹⁹²

Usunięto zmodyfikowaną wersję zsh. Codex korzysta ze standardowego mechanizmu wykonywania poleceń powłoki i nie zawiera już zmodyfikowanej wersji zsh; wraz z nią usunięto codex-execve-wrapper i pakiet crate shell-escalation. Flagi shell_zsh_fork i unified_exec_zsh_fork są ignorowane z komunikatem o migracji, a zarządzane wymagania, które nadal je wymieniają, powodują wyświetlenie ostrzeżenia (#52160, #52213). Pakiety dla systemów Linux i macOS są mniejsze dzięki usunięciu symboli z dostarczanych plików binarnych (#52178). Nazwy i README pakietu crate odpowiedzialnego za sandbox w systemie Linux opisują teraz jego dotychczasowe działanie: bubblewrap zapewnia izolację systemu plików i przestrzeni nazw, seccomp filtruje wywołania systemowe, a implementacja Landlock pozostaje jako rozwiązanie starszego typu; sposób egzekwowania ograniczeń się nie zmienił (#52610). Dołączone wskazówki OpenAI Docs obejmują migrację do rodziny GPT-6 (#51768).¹⁹²¹⁹³

Zalecane działanie: zaktualizować. Jeśli w config.toml lub requirements.toml występuje shell_zsh_fork lub unified_exec_zsh_fork, należy usunąć taki wpis. Jeśli Daybreak włączono ręcznie, flaga nie jest już potrzebna. Skrót wyciszania /voice zmienił się z Ctrl+X na F9.¹⁹²

v0.162.1 (9 października 2026)

Dwie poprawki, trzy commity ponad v0.162.0. Naprawiono awarię TUI występującą przy asynchronicznych pytaniach zawierających wiele wierszy, zachowując podziały wierszy i pełne adresy docelowe hiperłączy. Usunięto też błędy uruchamiania, na które trafiali niektórzy użytkownicy v0.162.0, wynikające z różnic między ustawieniami funkcji działającego serwera w tle a wartościami domyślnymi CLI: kontrola zgodności dotyczy teraz wyłącznie jawnych nadpisań funkcji w wierszu poleceń. Nie zmieniają się żadne ustawienia domyślne, klucze konfiguracyjne ani modele.

Zalecane działanie: zaktualizować, zwłaszcza jeśli v0.162.0 nie dawała się uruchomić, gdy w tle działał serwer z wcześniejszej wersji.¹⁸⁸

v0.162.0 (8 października 2026)

instant_interrupt zostaje domyślnie włączona. Flaga wprowadzona w v0.159.0 jako opcjonalna, która pozwala nowym danym wejściowym przerwać odpowiedź modelu lub oddać sterowanie podczas długotrwałego wywołania w trybie kodu, od tego wydania jest włączona dla wszystkich (PR #51812, scalony 7 października); nadal ma status funkcji w fazie rozwoju. Aby przywrócić poprzednie zachowanie, w którym wpisane dane czekają na zakończenie odpowiedzi, należy ustawić instant_interrupt = false w sekcji [features].

Nowości w TUI: narzędzia do tworzenia i wyświetlania list zarządzanych worktrees Git na podstawie zaufanych projektów lokalnych, dostępne po włączeniu funkcji worktrees, dzięki którym model może samodzielnie otworzyć worktree (#50148); przypinanie w Command Center agentów klawiszem p, które zachowuje przypięte zadania we wspólnej grupie Przypięte, jeśli serwer to obsługuje (#51500); /copy umożliwia nawigację po blokach zapisu rozmowy, Ctrl+Insert kopiuje zaznaczenie, a tui.mouse_scroll_speed (skończona liczba dodatnia, domyślnie 1,0) reguluje przewijanie kółkiem myszy (#50434, #50215, #50209); adresy URL można klikać w nagłówkach próśb o zatwierdzenie, pytaniach, monitach MCP, ostrzeżeniach i banerach, także gdy link zajmuje kilka wierszy. Nowe wątki TUI uwzględniają domyślne ustawienia modelu i podsumowania rozumowania z serwera, zachowując jawne nadpisania podane przy uruchomieniu. codex doctor podaje skonfigurowany tryb TUI, a /status ponownie wyświetla adres e-mail konta po jego aktualizacji.

Dostawcy i modele: niestandardowy dostawca zgodny z Responses może zadeklarować external_web_access i remote_compaction w sekcji [model_providers.<name>.capabilities] (#50459). Funkcja ultrafast_mode jest domyślnie włączona, dzięki czemu katalog modeli deklarujący poziom Ultra Fast (modele Astra w Amazon Bedrock, #50472) może oferować go niezależnie od trybu Fast; katalog dołączony do tego tagu nie zawiera takiego poziomu. Tryb kodu zyskuje funkcje pomocnicze JavaScript do strumieniowego przekazywania wyników obietnic oraz opcjonalne wyszukiwanie narzędzi z rankingiem wyników (code_mode_tool_search). apply_patch zawsze zachowuje istniejące zakończenia wierszy CRLF, a flaga apply_patch_preserve_line_endings zostaje usunięta. Błędy Responses i WebSocket kwalifikujące się do ponowienia żądania uwzględniają zalecenie serwera Retry-After.

Sandbox i obsługa platform: naprawiono uruchamianie sandboxa w systemie Linux przy wielu plikach z odmową dostępu, odrzucane są pliki wykonywalne służące do tworzenia sandboxa, do których można zapisywać, a konfiguracja ripgrep nie może już osłabiać masek wykluczających glob; Windows 10 odzyskuje zwykły dostęp do plików przez litery dysków, uprawnienia do katalogu tymczasowego sandboxa odpowiadają uprawnieniom procesu potomnego, weryfikacja sum kontrolnych archiwów działa ze ścieżkami modułów PowerShell 7, a wydania dla Windows zawierają podpisany instalator PowerShell.

Zalecane działanie: zaktualizować; jeśli istotna była możliwość wpisywania kolejnych wiadomości bez przerywania pracy modelu, należy ustawić instant_interrupt = false.¹⁸⁷¹⁸⁹

v0.161.0 (7 października 2026)

Wydanie powstało na podstawie 0.161.0-alpha.13.1 z jednym dodatkowym commitem wydaniowym, 155 commitów po v0.160.1. Informacje o wydaniu wskazują GPT-6.1 Sol jako nowy model domyślny (#49318, #49339), ale są to zmiany katalogu wprowadzone już w v0.159.1: dołączony plik models.json jest w tym tagu identyczny bajt po bajcie z plikiem z v0.160.1, więc dla użytkowników wersji 0.159.1 lub nowszej nic się nie zmienia.

Nowości: /mcp login <name> umożliwia zalogowanie się do serwera MCP z aktywnej sesji terminala (#49290). Wybór urządzeń głosowych: można wybrać mikrofon, głośnik i kanały wejściowe mikrofonu do rozmów /voice, a preferencje są zapisywane lokalnie (#49437, #49836). Wykrywanie modeli przy użyciu klucza API jest domyślnie włączone (api_key_model_discovery, ze statusem podniesionym do stabilnego, #49807): po zalogowaniu przy użyciu klucza API OpenAI do punktu końcowego obsługującego tę funkcję Codex odświeża katalog modeli na podstawie API, zamiast polegać wyłącznie na dołączonej liście; api_key_model_discovery = false w sekcji [features] wyłącza tę funkcję, a zmiana zaczyna obowiązywać w nowej sesji. Amazon Bedrock obsługuje tryb wieloagentowy V2 i poziom rozumowania Ultra w zgodnych modelach, a Bedrock Mantle akceptuje regiony AWS GovCloud (#49345, #49813). Daybreak (włączany opcjonalnie). Nowa flaga cli_daybreak, domyślnie wyłączona i nadal rozwijana, dodaje do CLI elementy sterowania Daybreak: przełącznik /daybreak, wskaźniki i automatyczny routing do programu dostępu Cyber. Funkcje te są dostępne po zalogowaniu przez ChatGPT u dostawcy OpenAI, jeśli konto i katalog modeli deklarują ich obsługę. Aby je włączyć, należy użyć --enable cli_daybreak lub ustawić cli_daybreak = true w sekcji [features]; sama zapisana preferencja daybreak = true nie daje żadnego efektu. Niezależnie od tego codex exec --cyber-access-program <standard|daybreak_blue|daybreak_red> (oraz cyberAccessProgram w TypeScript SDK) żąda użycia programu dostępu Cyber na jedną turę, z włączoną flagą lub bez niej, pozostawiając zapisany wybór bez zmian (#49856 do #49861, #49939, #51207). Dołączony katalog zawiera już ukryte wpisy gpt-daybreak-blue-latest i gpt-daybreak-red-latest. Od wersji v0.163.0 funkcja jest domyślnie włączona i oznaczona jako stabilna.¹⁹³

Poprawki: zatwierdzone rozszerzenie uprawnień do systemu plików może przyznać szerszy dostęp do zapisu przy zachowaniu zakazów odczytu i ograniczeń sieciowych, a zadania w tle zachowują uprawnienia tury, w której zostały uruchomione; jawnie określone uprawnienia uruchamiania są zachowywane po ponownym połączeniu terminala; sesje terminala Windows z podwyższonymi uprawnieniami mogą uruchamiać się z wbudowanym serwerem; Enter wysyła buforowane dane wejściowe po upływie okresu wykrywania wklejania, również w trybie wstawiania Vim; wznowienie wątku obejmuje najnowszą utrwaloną historię, a podczas uruchamiania wcześniej wykrywane są uszkodzenia SQLite, które można naprawić, przy czym uszkodzone bazy są zachowywane jako kopie zapasowe; ponowienia żądań Responses i awaryjne przejście z WebSocket na HTTP uwzględniają wytyczne serwera dotyczące ponowień. Dokumentacja uwierzytelniania informuje teraz, że dane uwierzytelniające mogą znajdować się w systemowym magazynie kluczy, a nie zawsze w auth.json.

Zalecane działanie: zaktualizować. Żadna z tych zmian nie wpływa na domyślne zachowanie w zauważalny sposób, chyba że logowanie odbywa się przy użyciu klucza API — w takim przypadku należy sprawdzić wykryty katalog za pomocą /model.¹⁸⁶¹⁸⁹

v0.160.1 (5 października 2026)

Poprawka dla zdalnych serwerów MCP w Windows. Gdy Codex na hoście macOS lub Linux uruchamia serwer stdio MCP w zdalnym środowisku wykonawczym Windows, a konfiguracja tego serwera jawnie określa zdalne zmienne środowiskowe, Codex przekazuje teraz również SYSTEMROOT, TEMP i TMP, dzięki czemu proces Windows zachowuje środowisko potrzebne do uruchomienia. Zmienne, których nie zażądano, w tym sekrety, nadal nie są przekazywane. Wydanie zawiera jedną poprawkę przeniesioną do v0.160.0 i nie zmienia ustawień domyślnych, kluczy konfiguracyjnych ani modeli.

Zalecane działanie: zaktualizować, jeśli z hosta uniksowego uruchamiane są zdalne serwery stdio MCP w środowisku wykonawczym Windows.¹⁸³

v0.160.0 (1 października 2026)

Stabilne wydanie linii 0.160, przygotowane na podstawie 0.160.0-alpha.6.1 z jedną przeniesioną poprawką. Bez zmian ustawień domyślnych. Dołączony katalog modeli w tym tagu jest identyczny bajt po bajcie z katalogami v0.159.1 i v0.159.2, więc GPT-6.1 Sol pozostaje modelem domyślnym, a dwie nowe flagi funkcji są wyłączone. Przeniesiona poprawka (#49763) dostosowała zamrożoną wersję kandydującą 0.160, której gałąź utworzono przed v0.159.1, do linii poprawek 0.159: dodała GPT-6.1 Sol do katalogu dołączonego do programu i katalogów Amazon Bedrock oraz przypomnienia o zabezpieczeniach konta z v0.159.3. Bez niej wersja 0.160 zostałaby wydana bez GPT-6.1 Sol.

Opcjonalne rozszerzenia Guardian (oba nadal rozwijane i domyślnie wyłączone):

• Guardian może odczytywać wcześniejsze wiadomości użytkownika. Należy ustawić guardian_conversation_history_tools = true w sekcji [features]. Gdy Apps są włączone, komponent weryfikujący otrzymuje dostęp do user_message.search_messages i user_message.read_messages przez połączenie Apps sesji nadrzędnej, dzięki czemu przed zatwierdzeniem działania wywołującego skutki uboczne może sprawdzić wcześniejsze instrukcje, ograniczenia i cofnięte uprawnienia. Każde wywołanie ponownie sprawdza bieżące zasady sesji nadrzędnej dotyczące aplikacji i narzędzi. Domyślny limit odpowiedzi wynosi szacunkowo 4 000 tokenów (auto_review.conversation_history_max_output_tokens), a auto_review.experimental_conversation_history_prompt zastępuje wbudowane instrukcje pobierania danych.
• Kontekst agenta głównego uwzględniający przekazywanie zadań (guardian_root_handoff_context): gdy Guardian weryfikuje działanie agenta wykonawczego, wybiera trzy wiadomości z sesji agenta głównego poprzedzające każde przekazanie zadania temu agentowi lub jego przodkom oraz trzy najnowsze wiadomości z tej sesji, dzięki czemu niedawne anulowanie pozostaje widoczne.

Zawsze włączone: zaszyfrowane wiadomości agentów pojawiają się teraz w transkrypcjach Guardian we właściwej kolejności, zamiast być pomijane.

Zmiany w TUI: w folderze bez konfiguracji projektu i bez zapisanej decyzji o zaufaniu nowa sesja może rozpocząć się z uprawnieniami workspace-write i szczegółowymi zatwierdzeniami, ale tylko wtedy, gdy zezwalają na to wykonanie lokalne, konfiguracja użytkownika i zarządzana polityka. Wznawiane sesje przywracają zapisane uprawnienia, o ile nie zostaną one nadpisane, a /cd może poprosić o uznanie folderu za zaufany, udostępniając opcję „Zachowaj bieżący katalog”. Centrum zarządzania agentami zyskuje wiersz „Pokaż więcej”, który ładuje starsze zadania po dziesięć. W lokalnych terminalach Linux X11 (z wyłączeniem Wayland, SSH, tmux, WSL i VS Code) zaznaczenia w pełnoekranowym widoku transkrypcji trafiają do schowka zaznaczenia podstawowego, a kliknięcie środkowym przyciskiem myszy wkleja je do pola wiadomości. Pełnoekranowy wiersz stanu wyświetla Plan mode (shift+tab to cycle), gdy jest na to miejsce. Poziomy Pro są teraz oznaczone jako „Pro 100”, „Pro 200” i „Pro 500” w /status oraz analityce. Wskazówki wyświetlane przy uruchamianiu kierują do aplikacji komputerowej dla danej platformy zamiast promować plany lub tryb Fast, a wiadomości w kolejce, które nigdy nie zostały wysłane, są przywracane po ponownym połączeniu bez duplikatów.

Dostawcy i połączenia: TUI zachowuje ustawienia dostawcy, podsumowania rozumowania i szczegółowości odpowiedzi serwera aplikacji, pokazuje właściwe sesje w historii wznawiania i tworzenia odgałęzień oraz ukrywa ustawienia podsumowania rozumowania w /status dla połączeń z serwerem. Dostawca z jawnie określonym katalogiem modeli (model_catalog_url) otrzymuje teraz wyłącznie ten katalog: modele dołączone do programu nie są z nim łączone, metadane odpowiadają dokładnemu identyfikatorowi modelu, nieudane odświeżenie usuwa wpisy z pamięci podręcznej zamiast używać ich ponownie, a uruchomienie bez dostępnego modelu zgłasza błąd konfiguracji, chyba że ustawiono model. Gdy filtr treści zatrzyma odpowiedź, przy ponowieniu model otrzymuje polecenie wyjaśnienia ograniczenia, zaproponowania dozwolonej alternatywy i kontynuowania pozostałych prac.

Poprawki: awaryjne mechanizmy PowerShell w piaskownicy Windows, naprawa ACL dla długich ścieżek środowiska wykonawczego i brak okien konsoli otwieranych przez procesy pomocnicze w tle; podagenci zachowują środowiska, które są jeszcze uruchamiane; SQLite nie blokuje się już podczas nawiązywania połączenia i zgłasza błędy inicjalizacji zamiast przekroczeń limitu czasu. Baza logów odzyskuje nieużywane miejsce w tle, a mechanizm ładowania wtyczek przechowuje sparsowane manifesty w pamięci podręcznej i ponownie wykorzystuje połączenia HTTP. Dokumentacja dostawców informuje teraz, że dane uwierzytelniające requires_openai_auth korzystają z mechanizmu przechowywania wybranego przez cli_auth_credentials_store, a env_key wskazuje nazwę zmiennej środowiskowej zawierającej klucz API.

Zalecane działanie: zaktualizować. Jeśli niestandardowy dostawca ustawia model_catalog_url, należy upewnić się, że jego katalog zawiera każdy wybierany model.¹⁸²

v0.159.3 (30 września 2026)

Opcjonalne przypomnienia o zabezpieczeniach konta. Lokalne sesje TUI zalogowane przez ChatGPT u dostawcy OpenAI mogą wyświetlać baner z możliwością zamknięcia, proszący o dokończenie konfiguracji zabezpieczeń konta, z przyciskiem otwierającym chatgpt.com. To serwer decyduje, komu go wyświetlić; CLI pobiera powiadomienie w tle bez blokowania tury, nie pokazuje niczego, gdy stan jest nieznany, pomija zdalne obszary robocze i konta FedRAMP oraz zapamiętuje zamknięcie banera między wątkami i po ponownych połączeniach. Banery dotyczące wykorzystania mają pierwszeństwo. Jest to jedyna zmiana w tym wydaniu, a v0.160.0 zawiera ten sam kod.

Zalecane działanie: żadne. Przypomnienie jest opcjonalne.¹⁸⁴

v0.159.2 (29 września 2026)

Poprawka migających okien konsoli w Windows. W Windows Codex nie otwiera już okna konsoli przy każdym uruchomieniu procesu w tle. Dotyczy to poleceń narzędzia powłoki, hooks, wywołań Git i npm, odświeżania danych uwierzytelniających Amazon Bedrock bez terminala, kontroli diagnostycznych doctor, odświeżania konfiguracji piaskownicy oraz poleceń w starszej piaskownicy Windows. Polecenia wymagające terminala nadal dziedziczą jego konsolę. Wydanie przenosi dwie poprawki z gałęzi main jako jedną zmianę i zostało opublikowane około trzech i pół godziny po v0.159.1. Nie zmienia ustawień domyślnych, kluczy konfiguracyjnych ani modeli, a nowy mechanizm pomocniczy uruchamiania zachowuje się w macOS i Linux tak jak wcześniej.

Zalecane działanie: w Windows zaktualizować, jeśli podczas pracy Codex migają okna konsoli, zwłaszcza gdy zainstalowany jest serwer działający w tle.¹⁸⁰

v0.159.1 (29 września 2026)

GPT-6.1 Sol staje się modelem domyślnym. Gdy w config.toml nie określono modelu, CLI uruchamia się teraz z GPT-6.1 Sol (gpt-6.1-sol) zamiast GPT-6-Astra, a GPT-6.1 Sol zastępuje GPT-6 Sol jako model domyślny w katalogach Amazon Bedrock Mantle i Runtime. Selektor /model wyświetla go jako pierwszy z opisem „Najnowszy wszechstronny model do programowania i codziennej pracy”, a następnie GPT-6-Astra, GPT-6 Sol (teraz „Wszechstronny model poprzedniej generacji”), GPT-6 Luna i starsze modele. Zapisane wybory nie są migrowane: konfiguracja wskazująca gpt-6-sol lub gpt-6-astra zachowuje ten model, a komunikaty proponujące migrację ze starszych modeli GPT-5 nadal wskazują GPT-6 Sol lub GPT-6 Luna. Dokumentacja OpenAI została uzupełniona o ten model tego samego dnia i obecnie zaleca go do złożonych zadań programistycznych oraz pracy z agentami: „wydajność zbliżona do Astra w złożonych zadaniach, przy niższym koszcie niż Astra”. Koszt wynosi 50 kredytów za 1 mln tokenów wejściowych (2,5 za tokeny z pamięci podręcznej, 250 za tokeny wyjściowe), a zakres dla planu Plus to 15–160 wiadomości. Dwa szczegóły katalogowe różnią go od GPT-6 Sol: nie ma domyślnego poziomu usługi, więc sesja rozpoczyna się z prędkością Standard zamiast Fast, a domyślny poziom wysiłku rozumowania to low zamiast medium. Wdrożenie obejmuje plany Plus, Pro, Business, Enterprise i Edu; w Enterprise i Edu model pozostaje wyłączony, dopóki nie włączy go administrator, a plany Free i Go nie są objęte premierowym wdrożeniem.

Co zrobić: zaktualizować oprogramowanie, a następnie sprawdzić model w /status. Jeśli na koncie nie ma jeszcze GPT-6.1 Sol, należy ustawić na stałe jeden z dostępnych modeli za pomocą model w config.toml lub -m.¹⁷⁸

v0.159.0 (29 września 2026)

Wydanie przygotowane na podstawie 0.159.0-alpha.13, około 27 godzin po v0.158.0. Kilka pozycji z informacji o tym wydaniu trafiło już wcześniej do v0.158.0 jako poprawki przeniesione do wcześniejszej wersji: poprawki okna konsoli i programu uruchamiającego w Windows, kopiowanie z zachowaniem Markdown, ekran powitalny i wskazówki dotyczące tur oraz poprawki logowania. Ustawienie tui.prompt_suggestions, wymienione w informacjach jako usunięte, nigdy nie pojawiło się w stabilnym wydaniu.

Nowości w tym wydaniu:

• instant_interrupt (włączane opcjonalnie, w trakcie rozwoju): nowe dane wejściowe przerywają odpowiedź modelu lub powodują oddanie sterowania przez długotrwałe wywołanie w trybie kodu. Aby wypróbować tę funkcję, należy ustawić instant_interrupt = true w sekcji [features]. Od v0.162.0 jest domyślnie włączona.
• Przeglądarka ostrzeżeń po zamknięciu usuwa z widoku obejrzane ostrzeżenia; naciśnięcie k pozwala zachować wybrane ostrzeżenie na później.
• Podczas podejmowania decyzji o wdrożeniu planu można przewijać zapis rozmowy.
• Renderowanie Mermaid obsługuje więcej krawędzi schematów blokowych, etykiet i grup węzłów.
• Puste sesje zachowują wersje robocze przy przełączaniu zadań, a wątki można archiwizować przed pierwszą turą.
• /status wyświetla się bez obramowania i zawija długie wartości.
• Klienty app-server mogą pobierać historię wątku stronami, począwszy od określonego elementu.

Zmiany w piaskownicy: zatwierdzone polecenia nadal podlegają jawnym zakazom dostępu do systemu plików, katalogi .aws wewnątrz katalogów głównych z prawem zapisu są domyślnie chronione (jawne reguły nadal mają pierwszeństwo), piaskownice macOS z włączonym dostępem do sieci pozwalają na weryfikację zaufania TLS, a środowiska wykonawcze wymagające serwera proxy teraz go otrzymują. Dołączony element skills plugin-creator został usunięty.

Co zrobić: jeśli zadanie uruchomione w piaskownicy zapisuje dane w .aws, należy spodziewać się blokady, chyba że zostanie dodana jawna reguła.¹⁷⁷

v0.158.0 (28 września 2026)

Stabilne wydanie linii 0.158, przygotowane na podstawie 0.158.0-alpha.15.4: alpha.15 plus szesnaście poprawek przeniesionych do wcześniejszej wersji, w tym cztery poprawki dla Windows z v0.157.1. Obejmuje o 207 commitów więcej niż v0.157.0.

Zmiany ustawień domyślnych:

• Zatwierdzanie danych wejściowych terminala jest włączone. Gdy Codex wysyła dane wejściowe do działającego polecenia z podwyższonymi uprawnieniami (dodatkowo przyznanymi uprawnieniami, pominięciem piaskownicy lub zasadami zmienionymi od momentu uruchomienia polecenia), dane te wymagają uprzedniego zatwierdzenia. Uprawnienia przyznawane wyłącznie na czas działania, takie jak te używane przez wtyczki do obsługi metryk, nie uruchamiają już weryfikacji. Aby wyłączyć tę funkcję, należy ustawić write_stdin_approval = false w sekcji [features].
• Kopiowanie przy zaznaczaniu w pełnoekranowym zapisie rozmowy: tekst zaznaczony myszą jest kopiowany po zwolnieniu przycisku. Wartość domyślna, auto, pomija bezpośrednie terminale przekazujące własny skrót kopiowania (Ghostty 1.2+, Kitty w macOS, Windows Terminal i VS Code w Windows). Kopiowanie zachowuje formatowanie Markdown. W sekcji [tui] można ustawić copy_on_select = "never" (lub "always").
• Wklejanie prawym przyciskiem myszy w pełnoekranowym TUI w Windows, WSL i Linux. W sekcji [tui] można ustawić right_click_paste = "off" lub "on", aby objąć tą funkcją także macOS.
• Kontekst wątku Guardian jest zawsze włączony. Przełącznik wyłączający z v0.157.0 został usunięty: thread_context w sekcji [features.guardianv2] jest ignorowane, również w profilach, a Codex wyświetla komunikat z prośbą o usunięcie tego ustawienia.

Modele i plany: GPT-5.4 znika z katalogu dołączonego do aplikacji oraz z katalogów Bedrock, a zapisany wybór GPT-5.4 nadal wywołuje propozycję migracji do GPT-6 Sol. Codex rozpoznaje plan Pro Max i oznacza warianty Pro jako „Pro”, „Pro (More)” i „Pro (Max)”. Skróty do zmiany poziomu rozumowania pozwalają wybrać Max.

Inne nowości: serwery MCP wymagające wcześniej zarejestrowanego sekretu klienta OAuth (codex mcp add --oauth-client-secret), tokeny bearer dla połączeń WebSocket z exec-server, przezroczyste tła generowanych obrazów oraz wielowierszowe podglądy poleceń w /ps. Poprawki obejmują błędy piaskownicy Windows (zwykłe ścieżki Windows 10, odrzucane zapisane dane uwierzytelniające, rozbudowane zasady uprawnień), uruchamianie piaskownicy Linux z zagnieżdżonymi katalogami głównymi z prawem zapisu, ochronę metadanych Git we wszystkich katalogach głównych z prawem zapisu, aliasy ścieżek macOS przy zatwierdzaniu poprawek oraz weryfikacje Guardian, które są teraz ponawiane zamiast przerywane po wysłaniu wiadomości w trakcie weryfikacji.

Co zrobić: jeśli automatyzacja wysyła naciśnięcia klawiszy do poleceń z podwyższonymi uprawnieniami, należy spodziewać się próśb o zatwierdzenie lub wyłączyć tę funkcję, a także usunąć thread_context z konfiguracji.¹⁷⁶

v0.157.1 (26 września 2026)

Wydanie poprawkowe dla Windows zawierające cztery poprawki przeniesione z głównej gałęzi. Codex nie otwiera już okna konsoli podczas uruchamiania hosta trybu kodu ani lokalnego serwera MCP korzystającego ze stdio. Serwer działający w tle może się uruchomić, gdy Windows pozostawia proces wewnątrz zewnętrznego obiektu zadania, a odłączony serwer działający w tle nie utrzymuje już otwartych potoków wyjściowych programu uruchamiającego, co mogło powodować oczekiwanie polecenia wywołującego po zakończeniu programu uruchamiającego. Informacje o wydaniu w GitHub i wpis w dzienniku zmian mówią jedynie, że najważniejszych zmian „nie udało się ustalić”; powyższa lista pochodzi z commitów tego wydania.

Co zrobić: zaktualizować oprogramowanie, jeśli Codex jest używany w Windows. Wszystkie cztery poprawki dotyczą wyłącznie Windows.¹⁷⁴

v0.157.0 (25 września 2026)

Wydanie zmieniające trzy kolejne ustawienia domyślne.

• Pełnoekranowy zapis rozmowy jest domyślnie włączony. Pełnoekranowy interfejs, który v0.156.0 udostępniało przez /tui, jest teraz domyślnym widokiem otwieranej sesji, również wtedy, gdy konfiguracja nie zawiera sekcji [tui]. Aby zachować historię przewijania terminala, należy wybrać Scrollback w /tui lub ustawić fullscreen_transcript = false w sekcji [tui]; --no-alt-screen i tui.alternate_screen = "never" nadal mają pierwszeństwo. Kliknięcie z przytrzymanym klawiszem Shift rozszerza teraz zaznaczenie w zapisie rozmowy.
• Serwer działający w tle uruchamia się automatycznie przy uruchomieniach interaktywnych spełniających wymagania, a opcja znika z /experimental. Uruchomienia z --no-daemon, --oss, --profile lub większością nadpisań przez -c nie korzystają z niego. Jeśli ustawienia działającego serwera nie pasują do sesji, Codex proponuje uruchomienie bez niego, ponowne uruchomienie serwera z wymaganymi ustawieniami lub anulowanie (opcja domyślna). Aby wyłączyć automatyczne uruchamianie, należy ustawić daemon_auto_start = false w sekcji [features].
• Kontekst wątku Guardian jest domyślnie włączony dla weryfikacji synchronicznych i asynchronicznych, niezależnie od przełącznika enabled w Guardian v2. Aby go wyłączyć, należy ustawić thread_context = false w sekcji [features.guardianv2].

Modele: GPT-6 Sol i Luna, wprowadzone po raz pierwszy w v0.156.1, są również dostępne w tym wydaniu, a katalogi Amazon Bedrock teraz także je zawierają; GPT-6 Sol zastępuje GPT-5.6 Sol jako domyślny model Bedrock. GPT-5.6 Sol traci poziom usługi ultrafast, pozostaje Fast. Dołączony katalog nie oznacza już GPT-6-Astra jako modelu obsługującego eksperymentalne zarządzanie kontekstem (zob. Zarządzanie kontekstem).

Inne nowości: skrót f tworzy odgałęzienie rozmowy otwartej w innej aplikacji, zachowując wersje robocze i prompty w kolejce; /import działa w sesjach zdalnych i sesjach korzystających z serwera działającego w tle; terminal renderuje punktory Unicode, pola wyboru i wyrównane równania. Poprawki zapewniają ciągłość rozmów głosowych przy przełączaniu wątków, przywracają niewysłane odpowiedzi po zakończeniu tury, respektują ustawienia myszy w tmux, kierują połączenia czasu rzeczywistego i samodzielne wyszukiwanie w internecie przez skonfigurowane serwery proxy, ponawiają przesyłanie plików po przejściowych błędach z pięciominutowym limitem czasu oraz egzekwują ograniczenia sieciowe przy przekierowaniach i w otwartych połączeniach HTTP oraz WebSocket. W Windows dostęp do obiektów piaskownicy jest ograniczony do sesji logowania procesu wykonawczego.¹⁷⁴

v0.156.1 (23 września 2026)

Wydanie poprawkowe z jedną zmianą, wprowadzające GPT-6 Sol i GPT-6 Luna do stabilnej wersji CLI. Oba modele pojawiają się teraz na liście wyboru /model poniżej GPT-6-Astra, który pozostaje pierwszy i nadal jest domyślnym modelem dołączonym do aplikacji, gdy w config.toml nie ustawiono żadnego modelu. Lista wyboru oznacza rodzinę GPT-5.6 jako starsze modele (opis GPT-5.6 Sol brzmi „Starszy model programistyczny do złożonych zadań”), a GPT-5.5 jako „Model programistyczny poprzedniej generacji”. Przy zbliżaniu się do limitu zapytań propozycja zmiany modelu wskazuje teraz gpt-6-luna zamiast gpt-5.6-luna.

Jeśli konfiguracja wskazuje starszy model, należy spodziewać się jednorazowej propozycji migracji: zapisane wybory gpt-5.6-sol, gpt-5.6-terra, gpt-5.5 i gpt-5.4 wskazują GPT-6 Sol, a gpt-5.6-luna i gpt-5.4-mini — GPT-6 Luna. Katalogi Amazon Bedrock nie zmieniają się w tym wydaniu: nie zawierają GPT-6 Sol ani Luna, a GPT-5.6 Sol pozostaje domyślnym modelem Bedrock.

Jeden szczegół dotyczący kosztów, o którym dokumentacja nie wspomina: dołączony katalog ustawia Fast (priority) jako domyślny poziom usługi dla GPT-6 Sol i Luna, więc sesja TUI bez ustawionego service_tier może rozpocząć się w trybie Fast, który przy logowaniu przez ChatGPT zużywa 2,5 raza więcej kredytów niż Standard. Można to sprawdzić za pomocą /fast status; /fast off przełącza na Standard. Co zrobić: zaktualizować oprogramowanie, a następnie wypróbować codex -m gpt-6-sol na znanym zadaniu. Dostępność zależy od planu, ustawień obszaru roboczego i etapu wdrażania; administratorzy Enterprise muszą najpierw włączyć nowe modele.¹⁷¹

v0.156.0 (22 września 2026)

Wydanie, które zmienia jednocześnie trzy ustawienia domyślne; pierwsze dwa ogłoszono tego samego dnia w dzienniku zmian dokumentacji.

• Tryb głosowy jest domyślnie włączony. /voice rozpoczyna rozmowę na żywo w obsługiwanych kompilacjach bez konieczności przechodzenia do /experimental. Towarzyszą mu nowe funkcje: konfigurowalny przełącznik F8, wybór głosu do przyszłych rozmów przez /voice settings, dołączone środowiska wykonawcze obsługi głosu dla systemów Linux i Windows oraz obsługa ograniczenia animacji.
• Zarządzane worktrees są domyślnie włączone. --worktree i /worktree nie wymagają już flagi funkcji. Sesje worktree mogą łączyć się z istniejącym lokalnym demonem i można je tworzyć z poziomu przeglądu agentów.
• Ponowne wykorzystanie skompaktowanego kontekstu wątku nadrzędnego przez Guardian jest domyślnie włączone: gdy Guardian ponownie uruchamia sesję przeglądu, może wykorzystać zaszyfrowany, skompaktowany kontekst wątku nadrzędnego.

Sposoby wyłączenia tych funkcji opisano w wierszach /voice i /worktree tabeli slash commands oraz w sekcji dotyczącej Guardian.

Pozostałe nowości: opcjonalny pełnoekranowy TUI, wybierany przez /tui, z wyszukiwaniem w transkrypcji, zaznaczaniem i kopiowaniem myszą, kopiowaniem prawym przyciskiem myszy, klikalnymi linkami i przeglądarką ostrzeżeń; sześć wbudowanych motywów w menu /theme; panel analityczny /usage; diagramy Mermaid i wzory matematyczne TeX renderowane w terminalu, każde z osobnym przełącznikiem; menu /daemon i flaga --no-daemon; a także domyślnie wyłączone podsumowania rozumowania w nowych wątkach TUI. Poprawki bezpieczeństwa usuwają luki w piaskownicy dotyczące ruchu przychodzącego w Windows, uprzywilejowanych gniazd i uchwytów plików tylko do odczytu, a codex doctor nie ujawnia już wartości konfiguracji w komunikatach błędów. Poprawki błędów zachowują odpowiedzi przesyłane strumieniowo po nieudanych lub przerwanych turach, naprawiają przekazywanie zawartości schowka w tmux i SSH, przywracają tryb Plan przy wznawianiu sesji oraz umożliwiają przywrócenie logowania przez systemowe serwery proxy.¹⁶⁹

v0.155.1 (18 września 2026)

Wydanie awaryjne z jedną poprawką. W wersji 0.155.0 nowy lokalny wątek TUI bez klucza model_reasoning_summary w konfiguracji żądał podsumowań detailed, a dostawcy nieobsługujący podsumowań rozumowania odrzucali całe żądanie. Wersja 0.155.1 przywraca none jako wartość zastępczą, więc nieustawiony klucz oznacza brak żądania podsumowań. Jawne ustawienia auto, concise i detailed były i nadal są respektowane. Ta sama jednoliniowa zmiana trafiła również do gałęzi main i została wydana w wersji 0.156.0.

Co zrobić: jeśli nowe sesje TUI w wersji 0.155.0 nie działały z dostawcą innym niż OpenAI lub hostowanym samodzielnie, należy zaktualizować oprogramowanie. Aby korzystać z podsumowań, należy jawnie ustawić klucz (zob. opis konfiguracji).¹⁵⁸

v0.155.0 (17 września 2026)

Tryb głosowy trafił do stabilnego TUI jako eksperymentalna funkcja wymagająca włączenia: /voice otwierało rozmowę na żywo z transkrypcją przesyłaną strumieniowo i sterowaniem mikrofonem. Funkcję można było włączyć przez /experimental w obsługiwanych kompilacjach; oferowała konfigurowalny skrót wyciszania oraz podpisane zasoby głosowe w pakietach dla macOS. Pięć dni później wersja v0.156.0 włączyła ją domyślnie. Zarządzane worktrees pozostawały w tym wydaniu domyślnie wyłączone.

Ponadto w wersji 0.155.0:

• Weryfikacja użytkownika MCP: weryfikacja żądań MCP przez Touch ID, podpisywana przez Secure Enclave, w lokalnych sesjach TUI na obsługiwanych komputerach Mac, z ograniczeniem tożsamości na poziomie obszaru roboczego i natywną weryfikacją podczas kontynuacji wywołań narzędzi MCP.
• Usunięto polecenie /sandbox-add-read-dir z kategorii slash commands w Windows.
• Zarządzanie worktrees: ukrywanie, archiwizowanie i usuwanie sesji worktree w przeglądzie agentów, wyświetlanie szczegółów własności oraz potwierdzanie usunięcia zarządzanego worktree bez zmian.
• Podsumowania rozumowania na żywo są przesyłane strumieniowo w wierszu stanu TUI, a ukończone zadania otrzymują znaczniki czasu zakończenia.
• Demon: konfigurowalne harmonogramy aktualizacji, polecenie codex app-server daemon update i odzyskiwanie wątków po ponownym uruchomieniu demona.
• Polecenia obsługi poświadczeń AWS dla Amazon Bedrock oraz publikowanie Python SDK zsynchronizowane ze stabilnymi wydaniami CLI.

Poprawki bezpieczeństwa eliminują możliwość wydostania się z piaskownicy przez mechanizmy interoperacyjności WSL oraz ujawnianie poświadczeń w migawkach powłoki. Memory v2 wprowadza jedynie podstawy przechowywania i konsolidacji danych, a nie funkcję gotową do użycia.¹⁵⁶

v0.154.0 (9 września 2026)

To wydanie przygotowano mniej więcej na etapie 0.154.0-alpha.6, więc wszystko, co pojawiło się po raz pierwszy w alpha.7 (rozmowy głosowe na żywo w TUI, weryfikacja użytkownika MCP, Memory v2, konfiguracja automatycznych aktualizacji demona, przypinanie poziomu wysiłku rozumowania), musiało poczekać na wersję 0.155.

Usunięto: codex mcp-server oraz samodzielny plik binarny codex-mcp-server. Integracje należy przenieść na protokół app-server lub wtyczkę Codex dla Claude Code; zmiana nie dotyczy codex mcp, które łączy Codex z zewnętrznymi serwerami MCP (zob. Uruchamianie Codex JAKO serwera MCP). Usunięto również starsze ścieżki przeglądu zatwierdzeń w Guardian, a zatwierdzenia są teraz odrzucane, gdy nowe instrukcje użytkownika je unieważniają.

Nowości:

• Eksperymentalne zarządzane worktrees dostępne przez --worktree lub /worktree, z obsługą codex exec i przeglądarką worktrees w TUI.
• Asynchroniczne wiadomości użytkownika: można odpowiadać na pytania bezpośrednio w rozmowie, podczas gdy Codex kontynuuje pracę, bez utraty wersji roboczej wiadomości.
• Obsługa usług Windows: przygotowywanie piaskownicy, demon app-server w Windows i zarządzane aktualizacje demona.
• Zdalne profile uprawnień, wykrywane na serwerze aplikacji i wybierane według nazwy w TUI.
• Tryb zastępowania R w Vim, bieżący stan kompaktowania kontekstu oraz eksperymentalne zarządzanie kontekstem, którego dostępność jest uzależniona od możliwości modelu przy uruchamianiu sesji.

Bezpieczeństwo: programy pomocnicze PATH nie uruchamiają się już przed potwierdzeniem zaufania do obszaru roboczego, a piaskownicę macOS wzmocniono przed wstrzykiwaniem danych wejściowych do terminala. Połączenia MCP koordynują odświeżanie tokenów OAuth, zdalne wznawianie i tworzenie odgałęzień zachowują zapisane uprawnienia, a wznowienie rozmowy otwartej w innej aplikacji wyświetla transkrypcję tylko do odczytu. Obsługę głosu dostarczono wyłącznie jako infrastrukturę wykonawczą, a pierwsze odniesienia do Daybreak pojawiły się w kodzie bez publicznej dokumentacji.¹⁵²¹⁵³

v0.153.3 i v0.153.4 (4 września 2026)

Poprawki wydane tego samego dnia, które wprowadziły GPT-6-Astra do CLI. Wersja v0.153.3 dodała Astra do katalogów Amazon Bedrock (GPT-5.6 Sol pozostał modelem domyślnym w Bedrock) i poprawiła wskazówki dotyczące asynchronicznych pytań doprecyzowujących dla Astra. Wersja v0.153.4 umieściła Astra na liście wyboru modeli, ustawiła go jako wbudowany model domyślny, gdy nie skonfigurowano żadnego modelu, i uzależniła wskazówki dotyczące pytań asynchronicznych od dostępności narzędzi.

Co zrobić: Astra działa z -m gpt-6-astra od wersji v0.153.1 i pojawia się na liście wyboru od v0.153.4; nie udokumentowano minimalnej wersji CLI, więc należy traktować te wersje jako minimalne. Jeśli konto nie ma dostępu do modelu wybranego przez wbudowane ustawienie domyślne, należy jawnie ustawić model w config.toml, zamiast polegać na wartości domyślnej.^145146147148

v0.153.1 i v0.153.2 (3 września 2026)

Wersja v0.153.1 dostosowuje ocenianie działań związanych z obsługą komputera przez Guardian do wymagań modelu: ocenianie ograniczone do obsługi komputera oraz szybkie decyzje o zatwierdzeniu działają tylko wtedy, gdy metadane aktywnego modelu ustawiają node_repl_auto_review_required. Przełączenie na model pomijający ocenianie unieważnia wcześniejsze lub trwające oceny, więc powrót do poprzedniego modelu nie może przywrócić nieaktualnego zatwierdzenia. Opis wydania wymienia jedynie przeniesiony do tej wersji wpis katalogowy GPT-6-Astra, konfigurowalny przez API; lista wyboru i model domyślny zmieniły się dopiero w v0.153.4. Wersja v0.153.2 poprawia opis wariantu Fast modelu Astra z „1,5x” na „2x większa szybkość, zwiększone zużycie” (wyłącznie tekst wyświetlany w interfejsie).¹⁴²¹⁴³

v0.153.0 (3 września 2026)

• Cofanie i ponawianie w Vim: u i Ctrl+R przywracają pełne wersje robocze wiadomości w edytorze, w tym wklejoną treść i załączniki graficzne; vim_normal.redo to konfigurowalna akcja mapowania klawiszy.
• Zdalne katalogi wtyczek: CLI do obsługi wtyczek umożliwia wyświetlanie, instalowanie i usuwanie zdalnych wtyczek, a codex plugin list pokazuje źródło, wersję, zasady instalacji i zasady uwierzytelniania.
• tui.auto_recap = false wyłącza automatyczne podsumowania; ręczne /recap nadal działa.
• Wcześniejsze ostrzeżenia o limitach użycia dla Plus i Team, gdy w oknie trwającym około pięciu godzin pozostaje mniej niż połowa przydziału; w pozostałych planach zachowano progi 75/90/95%.
• Zakres działania Guardian zależy od trybu zatwierdzania: Full Access pomija przeglądy Guardian dla działań wymagających jedynie potwierdzenia, a tryb zatwierdzania User pomija ocenianie w tle i wstępne przygotowanie.
• features.context_management.experimental_mode (domyślnie wyłączone) włącza kontekst budżetu tokenów, notatki historii i narzędzie new_context w kwalifikujących się sesjach Plus, Pro i Pro Lite korzystających z zaplecza Codex.
• tui.disable_paste_burst zastępuje klucz najwyższego poziomu, który nadal działa jako ustawienie zastępcze.

Poprawki: sesje TUI ponownie łączą się po zerwaniu połączenia z app-server, zachowując wersje robocze; historia przeglądów Guardian pozostaje dostępna po kompaktowaniu, ponownych uruchomieniach i tworzeniu odgałęzień; zapamiętane zatwierdzenia MCP są ograniczone do wybranego konta.¹⁴⁰

v0.152.0 i v0.152.1 (1 września 2026)

update_plan wymaga teraz jawnego włączenia: tools.update_plan.enabled ma domyślnie wartość false, a gdy ta opcja jest wyłączona, dołączone instrukcje dotyczące update_plan są usuwane z promptów modelu, trybu współpracy, obsługi wielu agentów, kompaktowania, wstępnego przygotowania i kontynuacji realizacji celu (zob. Tryb planowania i współpraca). Pozostałe nowości: wyszukiwanie w stylu Vim za pomocą / i ? oraz n/N, które można łączyć z operatorami, z nowymi szkicami rozpoczynającymi się w trybie wstawiania; banery limitów użycia ze wskazówkami dalszego działania; informacje o postępie odświeżania danych uwierzytelniających, w tym ponownego uwierzytelniania w Amazon Bedrock; nazwy serwerów MCP w formacie nazw pakietów (dozwolone są :, @, / i .); żądania formularzy MCP openai/elicitation; osobny output_token_limit dla każdego narzędzia MCP; dane uwierzytelniające zadań w chmurze ograniczone do zaufanych źródeł; konfigurowalne limity czasu thread/shellCommand; oraz domyślnie włączone budżetowanie tokenów na podstawie metadanych modelu. W v0.152.1 mechanizm przeglądu zatwierdzeń Guardian może pobierać zasady Node REPL z metadanych modelu.¹³⁸¹³⁹

v0.151.0 (29 sierpnia 2026)

• /recap podsumowuje rozmowę na żądanie, a Codex automatycznie podsumowuje kwalifikujące się bezczynne rozmowy, które nie są aktualnie wybrane.
• Hosty trybu kodu rezygnują z transportu WebSocket (pozostają tylko stdio i gRPC).
• Trwale przechowywane wątki domyślnie korzystają ze stronicowanej historii, jeśli magazyn danych ją obsługuje.
• Pojawia się poziom wysiłku rozumowania persistent wraz z narzędziami zegara i dołączonymi wskazówkami dotyczącymi proaktywności.
• Guardian v2 domyślnie przeprowadza przeglądy operacji obsługi komputera z wykorzystaniem obrazów.
• Vim zyskuje ruchy wyszukiwania znaku i przechodzenia do pozycji przed nim: f/F/t/T, a także gg/G.
• Przekazywanie danych wejściowych do terminali z podwyższonymi uprawnieniami może wymagać ponownego zatwierdzenia (write_stdin_approval, domyślnie wyłączone).
• Konfigurowalny okres oczekiwania na opcjonalne serwery MCP (mcp_optional_startup_grace_ms, domyślnie 1 000 ms) oraz możliwość sprawdzania lub zastępowania wyników narzędzi MCP przez rozszerzenia.

Poprawki uniemożliwiają osłabianie ograniczeń piaskownicy przez /cd oraz autoryzowanie działań na podstawie nieaktualnych klasyfikacji Guardian po zmianie uprawnień. Opis wydania wymienia tylko kilka ostatnich PR; pełny zestaw zmian znajduje się w porównaniu wersji.¹³⁴¹³⁵

v0.150.0 i v0.150.1 (26–27 sierpnia 2026)

Mechanizm hooks zyskuje zdarzenie Interrupt, uruchamiane po przerwaniu aktywnej tury najwyższego poziomu (domyślny limit czasu: 1 sekunda, maksymalny: 3 sekundy; nigdy dla subagentów). /copy otwiera menu wyboru całej odpowiedzi, poszczególnych bloków kodu lub cytatów blokowych. Do zadań można odwoływać się za pomocą wzmianek @, agenci mogą odczytywać i tworzyć zadania oraz wysyłać do nich wiadomości, a /rename sugeruje tytuł, który można edytować. Linki Markdown są wyświetlane jako klikalne etykiety, skróty umożliwiają przełączanie trybów uprawnień, Vim zyskuje powtarzanie za pomocą ., a instrukcje AGENTS.md z poziomu niezaufanych projektów nie są już uwzględniane. Pojawiają się konfigurowalne, domyślnie wyłączone opcje features.network_proxy.credential_broker oraz review_scope.computer_use_only w Guardian v2. W v0.150.1 zachowane obrazy są wliczane do budżetu tokenów zdalnego kompaktowania.¹³²¹³³

v0.149.0 i v0.149.1 (20–24 sierpnia 2026)

Polityka zatwierdzania untrusted zostaje wycofana; w konfiguracjach, które jej używają, należy przejść na on-request. Nowości: interaktywny panel codex agents, /cd, /pwd i /cwd, codex queue do wysyłania wiadomości do istniejących sesji lokalnych lub zdalnych, kolejne ruchy zmiany tekstu w stylu Vim, rozszerzony codex doctor (ochrona punktów końcowych, awarie sieci i proxy, stan aplikacji desktopowej, łączność na potrzeby aktualizacji) oraz poziomy wysiłku rozumowania max/ultra w SDK. Wznawiane i rozwidlane wątki przywracają swój profil uprawnień. v0.149.1 dodaje codex exec --thread-source <SOURCE> (user, subagent, memory_consolidation lub nazwa funkcji; threadSource w TypeScript SDK).

Zmiany cen w tym samym okresie: OpenAI obniżyło ceny GPT-5.6 Sol o ponad 20% na trzy miesiące od 21 sierpnia (co najmniej do 21 listopada 2026), a stawka kredytów Codex dla Sol spadła ze 125/12,5/750 do 100/10/500 kredytów za 1 mln tokenów odpowiednio wejściowych, z pamięci podręcznej i wyjściowych.^120121126

v0.147.0 i v0.148.0 (7–18 sierpnia 2026)

v0.147.0 usuwa codex exec --full-auto (oznaczone jako przestarzałe od v0.128); należy używać --sandbox workspace-write wraz z flagą zatwierdzania lub profilem. Dodaje także --approve-for-me, przenośne Agent Plugins z wyszukiwaniem w wielu katalogach, opcjonalny protokół MCP 2026-07-28 oraz sekcje rozmów. v0.148.0 dodaje eksport do Markdown za pomocą /export, codex exec fork, szacowaną liczbę kredytów lub koszt w /status, Amazon Bedrock Runtime jako wbudowanego dostawcę, asynchroniczne hooks oraz hooks wywołujące MCP, a także ograniczenia piaskownicy, które blokują operację w przypadku odmowy dostępu do ścieżek lub braku możliwości ich odczytu.¹¹⁶¹¹⁸

Wcześniejsze wydania (maj–lipiec 2026)

• v0.146.0 i v0.146.1 (29 lipca, 5 sierpnia): skonfigurowane proxy obejmują wszystkie transporty; manifesty Agent Plugins oraz katalogi marketplace Amazon Bedrock i Claude Code; nadawanie nazw sesjom z przypinaniem wątków; skills dostarczane przez wykonawcę; zaostrzone domyślne ustawienia automatycznego przeglądu dla modeli o zdolnościach w zakresie cyberbezpieczeństwa.¹¹⁴¹¹⁵
• v0.145.0 (21 lipca): /import z Cursor oraz Claude Code; obsługa głosu powraca w postaci strumieniowych rozmów w czasie rzeczywistym V3; ustabilizowana opcjonalna obsługa wielu agentów v2; eksperymentalna stronicowana historia wątków i logowanie do Amazon Bedrock; dołączone ustawienia wyboru GPT-5.4 przechodzą na GPT-5.6 Terra i Luna. v0.144.6 ustawiło okna kontekstu GPT-5.6 na 272 000 tokenów.¹¹¹¹¹²
• v0.140.0 (15 czerwca): /usage, codex delete i /delete, /import z Claude Code, ujednolicone menu wzmianek @, uwierzytelnianie Amazon Bedrock za pomocą klucza API oraz szyfrowane lokalne przechowywanie danych uwierzytelniających CLI i MCP OAuth; usunięto stare elementy sterowania głosem /realtime.¹⁰²
• v0.139.0 (9 czerwca): tryb kodu może bezpośrednio wywoływać wyszukiwanie w sieci, schematy narzędzi zachowują oneOf/allOf, codex doctor podaje szczegóły dotyczące edytora i programu do stronicowania tekstu, a źródła marketplace pojawiają się w danych wyjściowych JSON.¹⁶⁵
• v0.138.0 (8 czerwca): /app przekazuje sesję CLI do aplikacji desktopowej, a tekst zadań przekazywany od agenta nadrzędnego do subagenta jest szyfrowany w obsłudze wielu agentów v2.¹⁶⁶¹⁰⁸
• v0.137.0 (4 czerwca): obsługa wielu agentów v2, skróty klawiszowe F13–F24 w TUI oraz rozszerzenie skills v1.¹⁶⁷
• v0.132.0–v0.135.0 (20–28 maja): wyszukiwanie w lokalnej historii rozmów, --profile jako podstawowy sposób wyboru profilu, domyślnie włączone cele, dziedziczenie profili uprawnień i zarządzany requirements.toml, uruchamianie i zatrzymywanie codex remote-control, rozszerzone codex doctor i /status, obiekty tekstowe Vim, nazwane profile uprawnień w /permissions, uwierzytelnianie Python SDK i predefiniowane ustawienia Sandbox oraz codex exec resume --output-schema. Aktualizacja aplikacji z 21 maja dodała Appshots, ogólną dostępność trybu celów oraz opcjonalny tryb Computer Use z blokadą.^{96979899100101196}

Starsza opcja --full-auto została usunięta w v0.147.0, a js_repl pozostaje usunięte.^86878991116

Uwaga dotycząca stabilności: Stabilne, udokumentowane elementy: podstawowe CLI i TUI, izolacja w piaskownicy i zasady zatwierdzania, config.toml, AGENTS.md, skills, hooks, wtyczki, narzędzia wieloagentowe, cele, profile uprawnień, /voice i zarządzane worktrees (domyślnie od v0.156.0), pełnoekranowy zapis rozmowy i automatyczne uruchamianie serwera w tle (domyślnie od v0.157.0), zatwierdzanie danych wejściowych terminala, kopiowanie po zaznaczeniu i wklejanie prawym przyciskiem myszy (domyślnie od v0.158.0), natychmiastowe przerywanie (domyślnie od v0.162.0, nadal oznaczone jako rozwijane), Daybreak i przerywanie w trybie kodu (cli_daybreak, code_mode_interrupt; stabilne i włączone od v0.163.0), a także kreator konfiguracji Bedrock, przyrostowe aktualizacje narzędzi i koordynacja odświeżania MCP OAuth (stabilne i włączone od v0.164.0). Zarządzane worktrees i rozmowa w czasie rzeczywistym są dostępne na stałe od v0.164.0: ich flagi oznaczono jako usunięte, pozostawiając same funkcje włączone. Browser, Computer Use i Appshots to udokumentowane funkcje dostępne dla użytkowników, których dostępność zależy od platformy i planu. Funkcje eksperymentalne lub w trakcie rozwoju: Codex Cloud, tryb kodu i wyszukiwanie narzędzi w trybie kodu, Memory v2, lokalna tablica wiadomości agentów, flagi historii Guardian i kontekstu przekazania (v0.160.0) oraz wszystko, co w tym przewodniku oznaczono jako [EXPERIMENTAL] lub wymieniono w /experimental; mogą się one zmieniać między wydaniami. Eksperymentalne zarządzanie kontekstem jest, zgodnie z dokumentacją konfiguracji, „obecnie niedostępne”. Usunięto: --full-auto (v0.147.0), zasadę zatwierdzania untrusted (v0.149.0), codex mcp-server (v0.154.0), możliwość wyłączenia thread_context w Guardian (v0.158.0), flagi shell_zsh_fork i unified_exec_zsh_fork wraz ze zmodyfikowaną wersją samego zsh (v0.163.0) oraz js_repl.

Kanał alpha: kompilacje alpha są publikowane kilka razy dziennie, opisy wydań z linii alpha są szczątkowe, a poza głównym cyklem regularnie pojawiają się kompilacje oparte na starszych wersjach bazowych. Co najmniej dwukrotnie tag npm alpha wskazywał jedną z nich, przez co @alpha instalował kompilację starszą niż latest. Linia 0.158 obejmowała wersje od 0.158.0-alpha.2 (23 września) do alpha.15 (25 września); jej stabilne wydanie, v0.158.0 (28 września), powstało na podstawie kompilacji 0.158.0-alpha.15.4 spoza głównego cyklu, czyli alpha.15 z szesnastoma zmianami przeniesionymi z nowszej linii, i miało tag npm latest do czasu publikacji v0.159.0, 27 godzin później. Linia 0.159 obejmowała wersje od alpha.1 (25 września) do alpha.13 (28 września), a na podstawie alpha.13 opublikowano v0.159.0. Linia 0.160 doszła do 0.160.0-alpha.6 (29 września) i na tym się zatrzymała; 0.161.0-alpha.1 to alpha.6 ze zmienionym jedynie numerem wersji. 30 września wersja 0.160.0-alpha.6.1 uzupełniła alpha.6 o jedną brakującą poprawkę konsoli Windows z v0.159.2. Tego samego dnia w linii 0.159 ukazało się jeszcze jedno wydanie poprawkowe, v0.159.3. Następnie linia 0.160 otrzymała stabilne wydania v0.160.0 (1 października), utworzone na podstawie alpha.6.1 z jedną zmianą przeniesioną z nowszej linii, oraz v0.160.1 (5 października). W linii 0.161 pojawiały się wydania alpha i kompilacje ze zmianami przeniesionymi z nowszej linii poza głównym cyklem, ostatnio 0.161.0-alpha.13.1 (6 października), ale nie było wydania stabilnego; nie uznaje się tej linii za pominiętą, ponieważ żadna wyższa wersja nie otrzymała jeszcze stabilnego wydania. alpha wskazuje teraz 0.162.0-alpha.16. W przypadku korzystania z wydań alpha należy sprawdzać npm view @openai/codex dist-tags i instalować konkretną wersję zamiast @alpha.^176179181185 Historię przechodzenia ostatnich linii alpha w wydania stabilne, wraz z datami, przedstawiono w ¹⁷³. Linia 0.161 ukazała się jako v0.161.0 7 października na podstawie 0.161.0-alpha.13.1 (z jednym dodatkowym commitem wydaniowym); następnie 8 października ukazało się v0.162.0 na podstawie 0.162.0-alpha.18.1, podczas gdy 0.162.0-alpha.20 wyprzedzało podstawę tego stabilnego wydania o 52 commity; v0.162.1 dodało trzy commity 9 października; 10 października tag alpha wskazywał 0.163.0-alpha.5, 13 października przechodził kolejno przez alpha.8, alpha.9 i alpha.10, a 14 października wskazywał 0.163.0-alpha.11. Linia 0.163 doczekała się stabilnego wydania 15 października: v0.163.0 utworzono na podstawie 0.163.0-alpha.10.2 spoza głównego cyklu (z jednym dodatkowym commitem wydaniowym), podczas gdy alpha.11 wyprzedzało tę podstawę o 23 commity. Linia 0.164 rozpoczęła się 16 października wydaniami alpha.1 i alpha.2, do 17 października osiągnęła 0.164.0-alpha.3, a do 22 października — alpha.12; równolegle pojawiły się kompilacje spoza głównego cyklu: 0.163.0-alpha.11.1 i 11.2 (21–22 października) oraz 0.164.0-alpha.11.1 (23 października). Stabilne wydanie linii 0.164 ukazało się 23 października jako v0.164.0, utworzone na podstawie alpha.11 z jednym dodatkowym commitem wydaniowym (alpha.12 wyprzedzało tę podstawę o dziewięć commitów), a tag alpha tego samego dnia przesunięto na 0.165.0-alpha.1.^{189190191193195}

Jak działa Codex: model mentalny

Przed omówieniem poszczególnych funkcji warto zrozumieć, jak architektura Codex wpływa na wszystkie wykonywane za jego pomocą działania. System obejmuje pięć interfejsów opartych na wspólnej warstwie inteligencji:

┌─────────────────────────────────────────────────────────┐
│                    CODEX SURFACES                       │
├─────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────┐   │
│  │   CLI    │  │ Desktop  │  │   IDE    │  │ Cloud  │   │
│  │ Terminal │  │   App    │  │Extension │  │  Tasks │   │
│  └──────────┘  └──────────┘  └──────────┘  └────────┘   │
│  Local exec     Multi-task    Editor-native  Async      │
│  + scripting    + worktrees   + inline edits detached   │
│  ┌──────────┐                                           │
│  │ Browser  │  Signed-in browser workflows              │
│  │Extension │  (launched May 2026)                      │
│  └──────────┘                                           │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                        │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐     │
│  │   MCP   │  │ Skills  │  │  Apps   │  │  Search │     │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘     │
│  External tools, reusable expertise, ChatGPT            │
│  connectors, web search (cached + live)                 │
├─────────────────────────────────────────────────────────┤
│  SECURITY LAYER                                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │    Sandbox (Seatbelt / bubblewrap / seccomp)    │    │
│  │    + Approval Policy (on-request → never)       │    │
│  └─────────────────────────────────────────────────┘    │
│  OS-level filesystem + network restrictions             │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                             │
│  ┌─────────────────────────────────────────────────┐    │
│  │         GPT-5.x-Codex Intelligence              │    │
│  │   Tools: Shell, Patch, Read, Web Search         │    │
│  │   (legacy artifact, read_file, grep_files       │    │
│  │    removed in v0.117.0)                         │    │
│  └─────────────────────────────────────────────────┘    │
│  Shared model across all surfaces; costs tokens         │
└─────────────────────────────────────────────────────────┘

Warstwa podstawowa: Za działanie całego systemu odpowiada rodzina modeli GPT. Według stanu na 29 września 2026 r. obecną generacją jest GPT-6: gpt-6.1-sol do złożonych zadań programistycznych i pracy agentowej (dołączony domyślny model CLI, gdy nie skonfigurowano żadnego modelu, począwszy od wersji v0.159.1), gpt-6-astra do najtrudniejszych kompleksowych zadań, gpt-6-luna do ukierunkowanych zadań wykonywanych na dużą skalę oraz model poprzedniej generacji gpt-6-sol. Modele GPT-5.6 (Sol, Terra, Luna) pozostają dostępne podczas wdrażania nowej generacji; gpt-5.5 (kontekst 400K w Codex, 1M w API) zostanie wycofany z Codex w przypadku logowania przez ChatGPT 14 października 2026 r., natomiast gpt-5.4 wycofano z Codex 31 sierpnia 2026 r.^{83117146148149171178} Warstwa ta odczytuje pliki, zapisuje poprawki, wykonuje polecenia powłoki i analizuje bazę kodu. Gdy kontekst się zapełnia, Codex kompresuje rozmowę, aby zwolnić miejsce. Korzystanie z tej warstwy zużywa tokeny.

Warstwa zabezpieczeń: Każde polecenie wykonywane przez Codex przechodzi przez sandbox działający na poziomie systemu operacyjnego. W systemie macOS ograniczenia na poziomie jądra wymusza framework Seatbelt firmy Apple. W systemie Linux Bubblewrap izoluje system plików i przestrzenie nazw, a seccomp filtruje wywołania systemowe; starsza implementacja Landlock została zachowana jako rozwiązanie starszego typu. Sandbox działa na poziomie jądra, a nie wewnątrz kontenerów. Następnie approval policy określa, kiedy należy poprosić człowieka o potwierdzenie.

Warstwa rozszerzeń: MCP łączy usługi zewnętrzne (GitHub, Figma, Sentry). Skills zawierają przepływy pracy wielokrotnego użytku, które Codex wczytuje na żądanie. Apps zapewniają połączenie z konektorami ChatGPT. Wyszukiwanie w internecie dostarcza aktualnego kontekstu z sieci.

Warstwa interfejsów: CLI jest przeznaczony dla zaawansowanych użytkowników terminala i automatyzacji. Aplikacja komputerowa służy do wielowątkowego zarządzania projektami. Rozszerzenie IDE wspiera cykle edycji, kompilowania i testowania. Cloud umożliwia wykonywanie niezależnych zadań asynchronicznych.

Najważniejszy wniosek: Większość użytkowników korzysta tylko z jednego interfejsu. Zaawansowani użytkownicy korzystają ze wszystkich pięciu: Cloud do długotrwałych zadań, CLI do deterministycznych operacji na repozytorium, rozszerzenia IDE do krótkich cykli programistycznych, aplikacji komputerowej do planowania i koordynacji oraz rozszerzenia przeglądarki do przepływów pracy w przeglądarce wymagających zalogowania.

Spis treści

1. Jak zainstalować Codex?
2. Szybki start: pierwsza sesja
3. Główne interfejsy interakcji
4. Szczegółowe omówienie systemu konfiguracji
5. Który model wybrać?
6. Ile kosztuje Codex?
7. Schematy podejmowania decyzji
8. Jak działa system sandbox i zatwierdzania?
9. Jak działa AGENTS.md?
10. Hooks
11. Czym jest MCP (Model Context Protocol)?
12. Tryb Code Mode
13. Środowisko REPL JavaScript
14. Czym są skills?
15. Plugins
16. Tryb Plan Mode i współpraca
17. System pamięci
18. Zarządzanie sesjami
19. Tryb nieinteraktywny (codex exec)
20. Codex Cloud i zadania w tle
21. Aplikacja komputerowa Codex
22. GitHub Action i CI/CD
23. Codex SDK
24. Optymalizacja wydajności
25. Jak diagnozować problemy? — w tym codex doctor
26. Wdrożenie w przedsiębiorstwie
27. Najlepsze praktyki i antywzorce
28. Przepisy na przepływy pracy
29. Przewodnik po migracji
30. Podręczna karta referencyjna
31. Historia zmian
32. Materiały źródłowe

Jak zainstalować Codex?

Menedżery pakietów

# npm (recommended)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows)
winget install OpenAI.Codex

# Upgrade to latest
npm install -g @openai/codex@latest

Jak zaktualizować, przywrócić starszą wersję lub odinstalować Codex CLI?

Od wersji v0.128.0 Codex udostępnia polecenie samodzielnej aktualizacji; pozostałe operacje wykonuje się za pomocą menedżera pakietów użytego do instalacji.⁸⁶ Od wersji v0.146.0 artefakty wydań, metadane kanałów i aliasy instalatorów są udostępniane przez infrastrukturę wydań hostowaną przez OpenAI, z GitHub jako źródłem zapasowym.¹¹⁴ Jeśli sieć dopuszcza dostęp do GitHub na potrzeby instalacji i aktualizacji Codex, należy dodać do listy dozwolonych adresów również hosta wydań OpenAI — mechanizm zapasowy sprawia, że brak wpisu na liście nie powoduje wyraźnego błędu, lecz niezauważalne przełączenie na źródło zapasowe.

# Check what you are running
codex --version                          # -> codex-cli 0.164.0
npm view @openai/codex version           # Latest published version

# Update
codex update                             # Built-in self-update (v0.128.0+)
npm install -g @openai/codex@latest      # Or update via npm
brew upgrade --cask codex                # Or via Homebrew

# Pin or downgrade to an exact version
npm install -g @openai/codex@0.144.6

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

Gdy nowe wydanie powoduje problemy, warto przypiąć konkretną wersję. Stabilne wydania Codex pojawiają się często, dlatego instalacja konkretnej wersji to najszybszy sposób przywrócenia działającego środowiska — wystarczy zgłosić problem, przypiąć wersję i kontynuować pracę. Należy sprawdzić za pomocą codex --version, czy przywrócenie poprzedniej wersji się powiodło, ponieważ druga instalacja, mająca pierwszeństwo w PATH, może bez ostrzeżenia nadal uruchamiać stary plik binarny (codex doctor wskazuje właśnie ten problem w sekcji Środowisko).

Odinstalowanie pakietu nie usuwa zapisanych danych. Dane uwierzytelniania, konfiguracja i historia sesji znajdują się w ~/.codex/. Pozostawienie tego katalogu pozwala zachować logowanie i historię po ponownej instalacji; należy go usunąć tylko wtedy, gdy celem jest rozpoczęcie całkowicie od nowa — rm -rf ~/.codex usuwa również config.toml, auth.json i wszystkie zapisane sesje.

Skrypt bezpośredniej instalacji (v0.106.0+)

Dla macOS i Linux dostępny jest jednowierszowy skrypt instalacyjny jako zasób wydania w GitHub:⁶⁰

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

Skrypt automatycznie wykrywa platformę i architekturę, pobiera odpowiedni plik binarny i umieszcza go w lokalizacji dostępnej przez PATH.

Pobieranie plików binarnych

W środowiskach bez npm lub Homebrew należy pobrać pliki binarne odpowiednie dla danej platformy z GitHub Releases¹:

Wymagania systemowe

• macOS: Apple Silicon lub Intel (pełna obsługa środowiska izolowanego za pomocą Seatbelt)
• Linux: x86_64 lub arm64 (środowisko izolowane za pomocą bubblewrap + seccomp)
• Windows: Natywne środowisko izolowane z ograniczonymi tokenami (od v0.100.0 nie jest już eksperymentalne). Obsługiwany jest również WSL²

Uwierzytelnianie

codex login                  # Interactive OAuth (recommended)
codex login --device-auth    # OAuth device code flow (headless)
codex login --with-api-key   # API key from stdin
codex login status           # Check auth state (exit 0 = logged in)
codex logout                 # Clear stored credentials

Dwie metody uwierzytelniania:

1. Konto ChatGPT (zalecane): Można zalogować się przy użyciu istniejącej subskrypcji Plus, Pro, Team, Business, Edu lub Enterprise. Pełny dostęp do funkcji, w tym zadań w chmurze.
2. Klucz API: Można ustawić go za pomocą zmiennej środowiskowej CODEX_API_KEY lub polecenia codex login --with-api-key. Niektóre funkcje (wątki w chmurze) mogą być niedostępne.

Wskazówka dla zaawansowanych: Sposób przechowywania danych uwierzytelniających można skonfigurować za pomocą cli_auth_credentials_store w config.toml. Opcje: file (domyślnie), keyring (systemowy pęk kluczy) lub auto (pęk kluczy, jeśli jest dostępny, a w przeciwnym razie plik).

Logowanie do Amazon Bedrock (v0.145.0, eksperymentalne): Zespoły korzystające z modeli za pośrednictwem Amazon Bedrock otrzymują eksperymentalną metodę logowania z obsługą niestandardowego punktu końcowego i uwierzytelniania, obok istniejącego zarządzanego uwierzytelniania kluczem API (v0.140.0+) oraz łańcucha dostawców danych uwierzytelniających AWS (zob. Niestandardowi dostawcy modeli). Domyślnym modelem Bedrock jest GPT-5.6 Sol.¹¹² Wersja v0.150.0 naprawia kompaktowanie rozmów i zgodność z pracą wielu agentów dla modeli Amazon Bedrock.¹³² Wersja v0.151.0 dodaje opcję Amazon Bedrock kontrolowaną flagą funkcji w obsługujących ją procesach logowania w TUI: konfiguracja początkowa wykrywa istniejące profile AWS i dane uwierzytelniające w środowisku, umożliwia ręczne skonfigurowanie profili, kluczy dostępu, zmiennych środowiskowych i kluczy API Bedrock, prosi o podanie regionu AWS, maskuje poufne dane podczas wpisywania i ponownie uruchamia wbudowany serwer po zmianie dostawcy.¹³⁵ Wersja v0.152.0 udostępnia informacje o postępie odświeżania danych uwierzytelniających: TUI i codex exec pokazują postęp, gdy dostawca modelu odświeża wygasłe dane uwierzytelniające, również podczas ponownego uwierzytelniania sesji Amazon Bedrock, korzystając ze stabilnych powiadomień app-server modelProvider/authRecoveryStarted i modelProvider/authRecoveryCompleted, które zawierają informacje o wątku, turze i dostawcy oraz komunikat dla użytkownika.¹³⁸

Uzupełnianie poleceń w powłoce

# Generate completions for your shell
codex completion bash > /etc/bash_completion.d/codex
codex completion zsh > ~/.zsh/completions/_codex
codex completion fish > ~/.config/fish/completions/codex.fish

Sprawdzenie instalacji

codex --version
# codex-cli 0.164.0

Szybki start: pierwsza sesja

Od zera do efektywnej pracy w 5 minut.

1. Instalacja i uwierzytelnianie:

npm i -g @openai/codex          # Install
codex login                      # Log in with your OpenAI account

2. Przejście do katalogu projektu:

cd ~/my-project                  # Any git repo works

3. Uruchomienie Codex:

codex

Pojawi się interaktywny TUI. Codex automatycznie odczytuje strukturę projektu.

4. Zadanie pytania:

> What does this project do? Summarize the architecture.

Codex odczytuje kluczowe pliki i objaśnia kod projektu. Takie pytanie nie powoduje żadnych zmian — Codex modyfikuje pliki tylko na wyraźną prośbę o zmianę, a środowisko izolowane i zasady zatwierdzania określają, kiedy musi najpierw poprosić o zgodę.

5. Wprowadzenie zmiany:

> Add input validation to the login endpoint

Codex przedstawia proponowane zmiany w postaci różnic. Należy je przejrzeć i zatwierdzić za pomocą y lub odrzucić za pomocą n.

6. Użycie polecenia z grupy slash commands:

> /plan Refactor the database layer to use connection pooling

Codex tworzy plan bez wykonywania działań. Należy przejrzeć plan, a następnie go zatwierdzić, aby rozpocząć realizację.

7. Sprawdzenie efektów pracy:

> /diff

Można zobaczyć wszystkie zmiany wprowadzone przez Codex w bieżącej sesji.

Co dalej: - Przygotować AGENTS.md z instrukcjami dotyczącymi projektu (zob. Jak działa AGENTS.md?) - Skonfigurować profil dopasowany do sposobu pracy (zob. Profile) - Wypróbować codex exec do automatyzacji bez interakcji z użytkownikiem (zob. Tryb nieinteraktywny)

Główne interfejsy interakcji

Codex udostępnia pięć odrębnych interfejsów opartych na tej samej inteligencji. Każdy z nich jest dostosowany do innego sposobu pracy.

1. Interaktywny CLI (interfejs terminalowy)

codex                        # Launch TUI
codex "fix the failing tests" # Launch with initial prompt
codex -m gpt-6-sol          # Specify model
codex --sandbox workspace-write --ask-for-approval on-request

Interfejs terminalowy to aplikacja pełnoekranowa, która zawiera:

• Pole wprowadzania: Wpisywanie promptów, dołączanie plików za pomocą @, uruchamianie poleceń powłoki z prefiksem !
• Panel wyników: Strumieniowane odpowiedzi modelu, wywołania narzędzi i wyniki poleceń
• Pasek stanu: Model, zużycie tokenów, gałąź git, tryb piaskownicy

Najważniejsze skróty TUI:

Zmiana wiersza stanu (v0.121.0): Dotychczasowy miernik okna kontekstu w wierszu stanu zastąpiono procentowym wskaźnikiem wykorzystania kontekstu, który pokazuje stopień zapełnienia okna kontekstu. Jeśli skrypty lub hooks analizują wiersz stanu, należy uwzględnić tę zmianę formatu.⁸² Gdy pojawi się nowa wersja, Codex wyświetli również powiadomienie o aktualizacji w CLI.

Slash commands dostępne w TUI:

Przeprojektowane okno wyboru sposobu pracy (v0.129.0): Wznawianie i rozgałęzianie rozmów są teraz łatwiej dostępne w przeprojektowanym oknie wyboru, a nowy surowy tryb historii przewijania umożliwia przeglądanie niewyrenderowanej transkrypcji, gdy trzeba skopiować polecenia lub odpowiedzi modelu w dokładnej postaci. Przydaje się podczas analizy długiej sesji debugowania lub przekazywania wyników potokiem do innego narzędzia.⁸⁹

Ujednolicone menu wzmianek @ (v0.140.0): Wpisanie @ w polu wprowadzania domyślnie otwiera teraz jedno menu wzmianek obejmujące pliki, wtyczki i skills, zastępując mechanizm dołączania wyłącznie plików — jedno naciśnięcie klawisza wystarcza, aby odwołać się do dowolnego zasobu projektu.¹⁰²

2. Codex Desktop App (macOS + Windows)

codex app                    # Launch desktop app (auto-installs if missing)

Aplikacja desktopowa dodaje możliwości niedostępne w CLI:

• Wielozadaniowość: Jednoczesne uruchamianie wielu agentów pracujących równolegle nad różnymi projektami
• Izolacja przez git worktree: Każdy wątek pracuje na odizolowanej kopii repozytorium
• Przegląd różnic bezpośrednio w aplikacji: Dodawanie zmian do indeksu, ich cofanie i tworzenie commitów bez opuszczania aplikacji
• Zintegrowany terminal: Osobny terminal w każdym wątku do uruchamiania poleceń
• Rozgałęzianie rozmów: Tworzenie odgałęzień rozmów w celu sprawdzania alternatywnych rozwiązań
• Pływające okna: Odłączanie rozmów do osobnych okien, które można swobodnie przenosić
• Automatyzacje: Planowanie zadań cyklicznych (klasyfikacja zgłoszeń, monitorowanie CI, reagowanie na alerty)
• Appshots: Dołączanie do wątku okna aplikacji na pierwszym planie na Macu wraz ze zrzutem ekranu i dostępnym tekstem
• Komentarze w przeglądarce wbudowanej w aplikację: Podgląd stron lokalnych lub publicznych, dodawanie komentarzy do elementów lub obszarów oraz zlecanie Codex wprowadzania zmian na podstawie precyzyjnych uwag wizualnych
• Computer Use: Umożliwienie Codex obsługi dozwolonych aplikacji na Macu w ramach określonych zadań w interfejsie graficznym; korzystanie przy zablokowanym komputerze wymaga włączenia dla kwalifikujących się zdalnych tur Mac Computer Use

ChatGPT Voice, oparte na GPT-Live (wersja desktopowa 26.715, 23 lipca 2026): Aplikacją desktopową można teraz sterować głosem — omawiać pracę i koordynować zadania w Chat, Work i Codex bez pisania. W macOS włączenie kontekstu ekranu udostępnia w rozmowie appshot okna na pierwszym planie, dzięki czemu można pytać o to, co widać, zamiast to opisywać. Funkcja jest dostępna w planach Plus, Pro, Business, Edu i Enterprise, w aplikacji desktopowej oraz przez Remote w iOS. Jest to obsługa głosu w interfejsie desktopowym. CLI ma własne, odrębne funkcje głosowe: rozmowy na żywo /voice w TUI (domyślnie włączone od v0.156.0) oraz dyktowanie za pomocą spacji (dodane eksperymentalnie w v0.105.0).¹¹³¹⁶⁹

Udostępniane migawki wątków (20 sierpnia 2026): We wszystkich planach Codex aplikacja desktopowa na macOS umożliwia udostępnienie migawki lokalnego wątku Codex tylko do odczytu. Migawka nie aktualizuje się po zmianach w oryginalnym wątku; linki z kont osobistych są dostępne dla każdego, kto ma link, a linki z kont obszaru roboczego — tylko dla członków obszaru, z którego pochodzą. Przed udostępnieniem Codex ukrywa dane pasujące do znanych wzorców sekretów, ale OpenAI zaleca sprawdzenie udostępnianej treści, ponieważ mogą w niej pozostać informacje poufne. Linki można przeglądać i unieważniać w ustawieniach kontroli danych ChatGPT, w sekcji udostępnionych linków.¹²⁸

Kiedy używać aplikacji, a kiedy CLI: Aplikacja desktopowa sprawdza się przy koordynowaniu wielu równoległych zadań lub wizualnym przeglądzie różnic. CLI warto wybrać, gdy potrzebne jest łączenie narzędzi terminalowych, tworzenie skryptów lub integracja z CI/CD.

3. Rozszerzenie IDE (VS Code, Cursor, Windsurf)

Rozszerzenie Codex do IDE integruje się bezpośrednio z edytorem:

• Domyślny tryb agenta: Odczytywanie plików, wprowadzanie zmian i uruchamianie poleceń
• Edycja bezpośrednio w plikach: Sugestie uwzględniające kontekst aktywnych plików
• Współdzielone sesje: Synchronizacja sesji między CLI a rozszerzeniem IDE
• To samo uwierzytelnianie: Logowanie za pomocą konta ChatGPT lub klucza API

Instalacja jest dostępna w VS Code Marketplace lub sklepach z rozszerzeniami Cursor/Windsurf.³

4. Codex Cloud [EXPERIMENTAL]

Zadania w chmurze działają asynchronicznie w środowiskach zarządzanych przez OpenAI:

• Uruchomienie bez nadzoru: Kolejkowanie zadań działających niezależnie od lokalnego komputera
• Wykonywanie równoległe: Jednoczesne uruchamianie wielu zadań w chmurze
• Tworzenie PR: Codex tworzy pull requesty na podstawie ukończonej pracy
• Lokalne zastosowanie zmian: Pobieranie wyników z chmury do lokalnego repozytorium za pomocą codex apply <TASK_ID>

codex cloud list             # List recent cloud tasks
codex apply <TASK_ID>        # Apply diff from a specific cloud task

Zadania w chmurze są również dostępne pod adresem chatgpt.com/codex.⁴

5. Rozszerzenie przeglądarki (Chrome, Edge, Brave, Opera, Vivaldi)

Codex jest dostępny jako rozszerzenie przeglądarek Google Chrome, Microsoft Edge, Brave, Opera i Vivaldi, stanowiąc piąty interfejs obok CLI, aplikacji desktopowej, rozszerzenia IDE i chmury. Rozszerzenie dla Chrome udostępniono w maju 2026; dziennik zmian z 25 sierpnia 2026 dodał pozostałe cztery przeglądarki, konfigurowane w Ustawienia > Computer Use w aplikacji desktopowej ChatGPT. Wszystkie pięć obsługuje wzmianki o kartach i sterowanie przeglądarką; Opera nie obsługuje czatu bocznego, dlatego zadania należy w niej rozpoczynać z aplikacji desktopowej. Rozszerzenie zaprojektowano tak, aby towarzyszyło zwykłemu przeglądaniu stron, zamiast je przejmować: Codex pracuje równolegle na kartach w tle, a użytkownik zachowuje kontrolę nad tym, z którymi witrynami może wchodzić w interakcje.⁹⁰¹²⁷

• Równoległa praca na kartach: Codex działa na wielu kartach jednocześnie bez blokowania karty na pierwszym planie.
• Kontrola dostępu do poszczególnych witryn: Użytkownik określa listę witryn, z którymi Codex może wchodzić w interakcje; domyślnie nie ma dostępu do żadnej.
• Przeglądarka jako środowisko pracy: Rozszerzenie najlepiej sprawdza się w pracy z aplikacjami i witrynami, w której to strona jest źródłem prawdy — konsolami administracyjnymi, wewnętrznymi panelami, interfejsami zarządzania treścią i systemami zgłoszeń — i nie zastępuje CLI w pracy z lokalnymi repozytoriami.
• Ta sama inteligencja: rozszerzenie przeglądarki korzysta z tej samej inteligencji GPT-5.x-Codex co pozostałe interfejsy, więc konfiguracja AGENTS.md lub skills działająca w CLI przenosi te same konwencje do pracy wykonywanej przez przeglądarkę.

Instalacja jest dostępna na stronie dokumentacji rozszerzenia przeglądarki, wcześniej zatytułowanej Codex for Chrome.¹²⁷

Szczegółowy opis systemu konfiguracji

Codex używa formatu TOML do konfiguracji. Zrozumienie hierarchii pierwszeństwa ma kluczowe znaczenie, ponieważ określa ona, które ustawienia mają pierwszeństwo w przypadku konfliktu.

Kolejność pierwszeństwa (od najwyższego do najniższego)

1. Ustawienia zastępujące dla sesji (najwyższe): flagi CLI (--model, --sandbox, --ask-for-approval, --search, --enable/--disable, --profile) oraz ustawienia zastępujące -c key=value
2. Konfiguracja projektu (.codex/config.toml, wykrywana od CWD w górę aż do katalogu głównego projektu; wygrywa najbliższy katalog)
3. Konfiguracja użytkownika ($CODEX_HOME/config.toml, domyślnie ~/.codex/config.toml)
4. Konfiguracja systemowa (/etc/codex/config.toml w systemach Unix)
5. Wbudowane wartości domyślne (najniższe)

requirements.toml pełni funkcję warstwy ograniczeń zasad, która po standardowym scaleniu konfiguracji ogranicza wartości dostępne dla użytkowników. Więcej informacji zawiera sekcja Wdrożenie korporacyjne.

Lokalizacje plików konfiguracyjnych

Wskazówka ekspercka: Zmienna środowiskowa CODEX_HOME zastępuje domyślny katalog ~/.codex. Jest to przydatne w środowiskach CI/CD lub konfiguracjach z wieloma kontami.

Projekty wielofolderowe w aplikacji desktopowej (26.715, 23 lipca 2026): Lokalny projekt w aplikacji desktopowej ChatGPT może obecnie obejmować kilka powiązanych folderów, z których jeden jest oznaczony jako folder główny (menu projektu → Edytuj projekt). Automatyczne wykrywanie pliku config.toml odbywa się wyłącznie względem folderu głównego; foldery dodatkowe pozostają dostępne na potrzeby wyszukiwania, odczytywania i edytowania plików, lecz nie wnoszą żadnej konfiguracji. Plik .codex/config.toml znajdujący się w folderze dodatkowym jest plikiem, który Codex może odczytać, a nie wczytywaną konfiguracją. Jest to sposób określania zakresu projektu w aplikacji desktopowej, a nie zmiana opisanych powyżej reguł pierwszeństwa — CLI nadal rozpoznaje konfigurację projektu, przechodząc w górę od bieżącego katalogu roboczego.¹¹³

Pełna dokumentacja konfiguracji

# ~/.codex/config.toml — annotated reference

# ─── Model Selection ───────────────────────────────────
model = "gpt-6.1-sol"                  # Docs' example; unset = bundled default (gpt-6.1-sol since v0.159.1)
model_provider = "openai"               # Provider (openai, oss, or custom provider id)
model_context_window = 272000           # Token count available to active model (override)
model_auto_compact_token_limit = 200000 # Threshold triggering automatic history compaction
model_reasoning_effort = "medium"       # minimal|low|medium|high|xhigh (model-dependent)
model_reasoning_summary = "auto"        # auto|concise|detailed|none
model_verbosity = "medium"              # low|medium|high
personality = "pragmatic"               # none|friendly|pragmatic
review_model = "gpt-6-sol"             # Optional model for /review command
service_tier = "fast"                  # Preferred service tier for new turns
oss_provider = "lmstudio"              # lmstudio|ollama (used with --oss)

# ─── Sandbox & Approval ───────────────────────────────
sandbox_mode = "workspace-write"        # read-only|workspace-write|danger-full-access
approval_policy = "on-request"          # on-request|never (untrusted retired in v0.149.0)

[sandbox_workspace_write]
writable_roots = []                     # Additional writable paths
network_access = false                  # Allow outbound network
exclude_tmpdir_env_var = false          # Exclude $TMPDIR from sandbox
exclude_slash_tmp = false               # Exclude /tmp from sandbox

# ─── Web Search ────────────────────────────────────────
web_search = "live"                     # Web search mode (constrained by allowed modes)

# ─── Tools ─────────────────────────────────────────────
tools.update_plan.enabled = false       # Planning tool opt-in (v0.152.0); exposes update_plan when true

# ─── Instructions ──────────────────────────────────────
developer_instructions = ""             # Additional injected instructions
model_instructions_file = ""            # Custom instructions file path
compact_prompt = ""                     # Custom history compaction prompt

# ─── Shell Environment ─────────────────────────────────
allow_login_shell = false               # Allow login shell semantics (loads .profile/.zprofile)

[shell_environment_policy]
inherit = "all"                         # all|core|none
ignore_default_excludes = false         # Set true to keep KEY/SECRET/TOKEN vars
exclude = []                            # Glob patterns to exclude
set = {}                                # Explicit overrides
include_only = []                       # Whitelist patterns

# ─── Authentication ────────────────────────────────────
cli_auth_credentials_store = "file"     # file|keyring|auto
forced_login_method = "chatgpt"         # chatgpt|api
mcp_oauth_callback_port = 0            # Fixed port for MCP OAuth callback (0 = random)
mcp_oauth_credentials_store = "auto"   # auto|file|keyring

# ─── History & Storage ─────────────────────────────────
[history]
persistence = "save-all"                # save-all|none
max_bytes = 0                           # Cap size (0 = unlimited)

tool_output_token_limit = 10000         # Max tokens per tool output (global; per-tool MCP overrides in v0.152.0)
log_dir = ""                            # Custom log directory
sqlite_home = ""                        # Override SQLite-backed resumable state location

# ─── UI & Display ──────────────────────────────────────
file_opener = "vscode"                  # vscode|vscode-insiders|windsurf|cursor|none
hide_agent_reasoning = false
show_raw_agent_reasoning = false
check_for_update_on_startup = true

[tui]
notifications = false                   # Enable notifications
notification_method = "auto"            # auto|osc9|bel
animations = true
show_tooltips = true
alternate_screen = "auto"               # auto|always|never
status_line = ["model", "context-remaining", "git-branch"]
mouse_scroll_speed = 1.0                # Mouse-wheel scroll multiplier, a finite positive number (v0.162.0)

# ─── Project Trust ─────────────────────────────────────
project_doc_max_bytes = 32768           # Max AGENTS.md size (32 KiB)
project_doc_fallback_filenames = []     # Alternative instruction filenames
project_root_markers = [".git"]         # Project root detection

# ─── Feature Flags ─────────────────────────────────────
# Use `codex features list` for current names/stages/defaults.
[features]
shell_tool = true                       # Shell command execution (stable)
unified_exec = true                     # PTY-backed exec (stable)
shell_snapshot = true                   # Shell env snapshots (stable)
enable_request_compression = true       # zstd request compression where supported (stable)
fast_mode = true                        # Service-tier selection and Fast-tier commands (stable)
instant_interrupt = true                # New input preempts the model's response; on by default since v0.162.0 (under development)
api_key_model_discovery = true          # Fetch the model catalog when signed in with an OpenAI API key; on by default since v0.161.0 (stable)
goals = true                            # Goal mode; stable and on by default in v0.133.0+
hooks = true                            # Lifecycle hooks (stable)
multi_agent = true                      # Enable multi-agent collaboration tools (stable)
personality = true                      # Personality selection (stable)
plugins = true                          # Plugin system (stable)
plugin_hooks = true                     # Plugin-bundled hooks (stable)
plugin_sharing = true                   # Workspace plugin sharing (stable)
browser_use = true                      # In-app browser automation (stable)
browser_use_external = true             # Browser-extension browser use (stable)
computer_use = true                     # macOS Computer Use (stable, plan/region gated)
in_app_browser = true                   # Shared rendered-page preview (stable)
image_generation = true                 # Image-generation tool (stable)
guardian_approval = true                # Auto-review approval path (stable)
skill_mcp_dependency_install = true     # Prompt/install missing skill MCP deps (stable)
tool_suggest = true                     # Tool/plugin suggestion surface (stable)
workspace_dependencies = true           # Workspace dependency discovery (stable)
memories = true                         # Memories (experimental)
network_proxy = false                   # Sandboxed-command network proxy (experimental); boolean or table, see below
prevent_idle_sleep = true               # Keep machine awake during active turns (experimental)
terminal_resize_reflow = true           # Terminal reflow improvements (experimental)
guardian_conversation_history_tools = false  # Guardian reads earlier user messages (under development, v0.160.0)

# Removed or deprecated feature names still appear in `codex features list`
# for migration diagnostics. Do not set removed flags such as
# `collaboration_modes`, `request_rule`, `codex_git_commit`,
# `apply_patch_freeform`, `search_tool`, or `js_repl` in new configs.

# ─── Guardian Auto-Review (v0.160.0 history keys) ─────
[auto_review]
conversation_history_max_output_tokens = 4000   # Per history-tool response, estimated tokens (default 4,000)
experimental_conversation_history_prompt = ""   # Blank = built-in retrieval instructions

# ─── Multi-Agent Roles (v0.102.0+) ───────────────────
[agents]
max_threads = 4                         # Maximum concurrent agent threads

[agents.explorer]
description = "Read-only codebase navigator"
config_file = "~/.codex/profiles/explorer.toml"

# ─── Notifications ────────────────────────────────────
notify = ["terminal-notifier", "-title", "Codex"]  # Command for notifications

# ─── Per-Project Overrides ────────────────────────────
[projects."/absolute/path/to/repo"]
trust_level = "trusted"                 # Per-project trust override

features.network_proxy ma typ boolean | table. Forma logiczna jedynie uruchamia lub zatrzymuje proxy; forma tabeli zawiera zasady. To właśnie proxy egzekwuje reguły domen profilu uprawnień dla poleceń uruchamianych w sandboxie: gdy jest wyłączone, reguły domen [permissions.<name>.network] nie są egzekwowane, a dostęp poleceń do sieci jest bezpośredni. Nie filtruje ono wyszukiwania w internecie, aplikacji, serwerów MCP ani innych narzędzi hostowanych.¹³⁰

[features.network_proxy]
enabled = true
allow_local_binding = false
proxy_url = "http://127.0.0.1:3128"

[features.network_proxy.domains]
"api.github.com" = "allow"
"*.npmjs.org" = "allow"          # subdomains only
"**.example.com" = "deny"        # apex plus subdomains; deny wins on conflicts

Zarządzane przez administratora wymagania experimental_network w pliku requirements.toml mogą uruchomić proxy bez features.network_proxy.¹³⁰

Profile

Nazwane zestawy ustawień konfiguracyjnych przeznaczone do różnych trybów pracy. Od wersji Codex 0.134.0 każdy profil ma własny plik — ~/.codex/<name>.config.toml, zawierający wyłącznie klucze najwyższego poziomu — a --profile <name> nakłada ten plik na ~/.codex/config.toml. Starsze tabele [profiles.<name>] wewnątrz pliku config.toml oraz selektor najwyższego poziomu profile = "<name>" nie są już odczytywane; pozostawiona tabela [profiles.<name>] sprawia, że --profile <name> odmawia uruchomienia do czasu przeniesienia jej kluczy do pliku profilu.¹²²

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
personality = "pragmatic"

# ~/.codex/careful.config.toml
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0
sandbox_mode = "read-only"

# ~/.codex/auto.config.toml
model = "gpt-6.1-sol"
# GPT-6.1 Sol starts at Standard speed; /fast toggles Fast (2.5x credits)
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "workspace-write"

Plik profilu stanowi warstwę ponad bazową konfiguracją użytkownika, a poniżej konfiguracji projektu i CLI, dlatego powinien zawierać wyłącznie wartości różniące się od konfiguracji bazowej.¹²²

Aby aktywować profil:

codex --profile fast "quick refactor"
codex --profile careful "security audit"
codex -p auto "fix CI"

Wskazówka ekspercka: Domyślny profil można ustawić za pomocą profile = "fast" na najwyższym poziomie konfiguracji. Dla pojedynczej sesji można go zastąpić opcją --profile.

Niestandardowi dostawcy modeli

Aby połączyć się z Azure, AWS Bedrock, modelami lokalnymi lub usługami proxy:

[model_providers.azure]
name = "Azure OpenAI"
base_url = "https://YOUR_PROJECT.openai.azure.com/openai"
wire_api = "responses"
query_params = { api-version = "2025-04-01-preview" }
env_key = "AZURE_OPENAI_API_KEY"

# Built-in amazon-bedrock provider (v0.123.0+, first-class in v0.124.0+)
# AWS SigV4 signing + credential-based auth; AWS profile selectable via the
# nested `aws.profile` field (NOT a top-level `aws_profile` key).
# v0.130.0+ also accepts credentials from `aws login` (the AWS console-login
# flow) — Codex resolves the cached console-login session for the chosen
# profile if static keys are absent.
# v0.140.0+ adds managed Amazon Bedrock API-key authentication, and stores
# CLI and MCP OAuth credentials in encrypted local storage.[^184]
[model_providers.amazon-bedrock]
name = "Amazon Bedrock"

[model_providers.amazon-bedrock.aws]
profile = "default"                   # any profile from ~/.aws/credentials
# Region/credential resolution otherwise follows the standard AWS chain;
# v0.130.0 added support for `aws login` console-login profiles in addition
# to static access keys and IAM role assumption.[^168]

[model_providers.ollama]
name = "Ollama (Local)"
base_url = "http://localhost:11434/v1"
wire_api = "chat"

env_key określa nazwę zmiennej środowiskowej zawierającej klucz API dostawcy; sam klucz nigdy nie trafia do pliku config.toml. Dostawca z ustawieniem requires_openai_auth = true wyświetla ekran logowania przy pierwszym uruchomieniu i zapisuje dane uwierzytelniające w mechanizmie wybranym przez cli_auth_credentials_store (file, keyring lub auto), a niekoniecznie w pliku auth.json. Od wersji v0.160.0 dostawca, który ustawia model_catalog_url, otrzymuje wyłącznie modele z tego katalogu, bez łączenia ich z modelami dołączonymi do aplikacji, a nieudane odświeżenie katalogu powoduje odrzucenie wpisów z pamięci podręcznej zamiast ponownego użycia nieaktualnych danych.¹⁸² Od wersji v0.162.0 niestandardowy dostawca zgodny z Responses może również zadeklarować obsługiwane funkcje w sekcji [model_providers.<name>.capabilities]: external_web_access = false wyłącza dostęp hostowanego wyszukiwania internetowego do sieci publicznej u tego dostawcy, natomiast remote_compaction = "v2" włącza protokół Responses compaction_trigger, który w przeciwnym razie jest dostępny wyłącznie dla dostawców OpenAI i Azure Responses ("unsupported" pozostawia kompakcję lokalnie).¹⁸⁷

Ostrzeżenie: Interfejs przewodowy chat/completions API (wire_api = "chat") został uznany za przestarzały w przypadku modeli hostowanych przez OpenAI, a OpenAI zapowiedziało jego usunięcie w lutym 2026 roku.³⁴ Lokalni dostawcy (Ollama, LM Studio) mogą nadal obsługiwać ten format. W przypadku punktów końcowych OpenAI należy zamiast niego używać wire_api = "responses".

Aby korzystać z modeli lokalnych, należy użyć flagi --oss:

codex --oss "explain this function"               # Uses default OSS provider
codex --oss --local-provider lmstudio "explain"   # Explicit LM Studio
codex --oss --local-provider ollama "explain"      # Explicit Ollama

Można również ustawić tę opcję w konfiguracji:

model_provider = "oss"
oss_provider = "lmstudio"   # or "ollama"

Ustawienia zastępujące konfigurację w wierszu poleceń

Aby zastąpić dowolną wartość konfiguracyjną z poziomu wiersza poleceń:

codex -c model="gpt-5.5" "refactor the API"
codex -c 'sandbox_workspace_write.network_access=true' "install dependencies"
codex -c model_reasoning_effort="xhigh" "debug the race condition"

Który model wybrać?

Dostępne modele (wrzesień 2026)

GPT-5.5 (23 kwietnia 2026) był w chwili premiery wyborem zalecanym przez OpenAI do większości zadań Codex: złożonego programowania, obsługi komputera, pracy opartej na wiedzy i badawczych przepływów pracy. Dostępny 23 kwietnia w Codex CLI / web / desktop dla planów ChatGPT Plus / Pro / Business / Enterprise / Edu / Go, a 24 kwietnia w OpenAI API. Okno kontekstu: 400K w Codex, 1M w API — Codex ogranicza okno do 400K, aby zrównoważyć przepustowość i koszt między poziomami subskrypcji; API udostępnia pełne 1M. Cennik (API): 5 USD za wejściowy / 30 USD za wyjściowy MTok (2 razy więcej niż stawka GPT-5.4; OpenAI podaje ok. 20% efektywnego wzrostu po uwzględnieniu poprawy wydajności tokenów). Wyniki testów: 82,7% Terminal-Bench 2.0 (ówczesny najlepszy wynik wśród publicznie dostępnych modeli), 84,9% GDPval (44 zawody), 78,7% OSWorld-Verified, 98,0% Tau2-bench Telecom (bez dostrajania promptu). Przed premierą OpenAI wykorzystało wewnętrznie GPT-5.5 + Codex do przepisania infrastruktury obsługującej modele — uzyskano 20-procentowy wzrost szybkości generowania tokenów.⁸³

GPT-5.5 zostanie wycofany z Codex przy logowaniu przez ChatGPT 14 października 2026 — dokumentacja modeli ogranicza zakres wycofania do ChatGPT, ChatGPT Work i Codex we wszystkich planach (w tym konsumenckich, Business, Enterprise i Edu) oraz stwierdza, że nie dotyczy ono OpenAI API.¹⁵⁵ Zalecenia dotyczące zamienników zmieniły się wraz z premierą GPT-6: w planach Plus, Pro, Business, Enterprise i Edu należy wybrać gpt-6-sol; w planach Free i Go — gpt-6-luna w aplikacji desktopowej, w obu przypadkach „gdy jest dostępny”. Należy zastąpić gpt-5.5 w domyślnych ustawieniach obszarów roboczych, zapisanych ustawieniach modeli, konfiguracjach zarządzanych, agentach niestandardowych, zaplanowanych zadaniach i skryptach.¹⁷¹

GPT-5.4 i GPT-5.4 mini wycofano z Codex przy logowaniu przez ChatGPT 31 sierpnia 2026.¹¹⁷ Dokumentacja modeli wskazuje obecnie gpt-6-sol i gpt-6-luna jako ich zamienniki (w Enterprise i Edu administrator musi najpierw włączyć Luna); użycie klucza API pozostaje bez zmian.⁶⁴¹⁷¹ Dokładna lista modeli zależy od konta i etapu wdrożenia. Lokalną pamięć podręczną można sprawdzić w pliku: ~/.codex/models_cache.json.

Uwaga o wycofaniu (11 marca 2026): modele GPT-5.1 nie są już dostępne w ChatGPT. Istniejące rozmowy są automatycznie kontynuowane przy użyciu GPT-5.3 Instant, GPT-5.4 Thinking lub GPT-5.4 Pro. GPT-5.1-Codex-Mini pozostawał dostępny przez API i CLI do wyłączenia 23 lipca 2026.⁷¹⁸⁸

Uwaga dotycząca planu bezpłatnego (5 maja 2026): GPT-5.5 Instant udostępniono 5 maja 2026 w bezpłatnym planie ChatGPT. Poszerza to grono odbiorców rodziny GPT-5.5 poza płatne plany, choć dostęp do Codex CLI nadal wymaga odpowiedniej subskrypcji Plus / Pro / Business / Enterprise / Edu / Go albo klucza API.⁹²

GPT-5.4 mini (17 marca 2026): mniejszy i szybszy wariant GPT-5.4 z kontekstem 400K w cenie 0,75/4,50 USD za MTok — wykorzystuje zaledwie 30% limitu GPT-5.4. Idealny do delegowania zadań subagentom: GPT-5.4 może odpowiadać za planowanie i koordynację, a subagenty GPT-5.4 mini równolegle wykonywać węższe zadania (przeszukiwanie bazy kodu, przegląd plików, przetwarzanie dokumentów).⁷⁶

Bedrock GPT-5.6 (Sol, Terra, Luna) (v0.143.0, 8 lipca 2026): Codex dodał natywną obsługę trzech wariantów modelu GPT-5.6 hostowanych w Amazon Bedrock, w tym obsługę poziomu rozumowania max. Zespoły korzystające z modeli za pośrednictwem dostawcy Bedrock mogą wybierać je tak samo jak inne modele niestandardowych dostawców (zob. Niestandardowi dostawcy modeli); poziom max jest przeznaczony do najtrudniejszych zadań wymagających rozumowania i pracy agentowej.¹⁰⁶ W v0.144.6 (18 lipca 2026) odświeżono instrukcje zawarte w pakiecie dla Sol, Terra i Luna oraz skorygowano ich okna kontekstu do 272 000 tokenów.¹¹¹ v0.145.0 (21 lipca 2026) dodaje eksperymentalne logowanie do Bedrock z obsługą niestandardowego punktu końcowego i uwierzytelniania, ustawia GPT-5.6 Sol jako domyślny model Bedrock oraz przenosi zawarte w pakiecie wybory modeli GPT-5.4 do odpowiadających im wariantów Terra i Luna.¹¹²

GPT-6-Astra (wprowadzony 3 września 2026; w Codex od v0.153.1 do v0.153.4): chronologia z dokładnymi datami wygląda następująco: 3 września 2026 v0.153.1 wprowadziła w katalogu wpis dostępny wyłącznie przez API; tego samego dnia OpenAI ogłosiło GPT-6-Astra; 4 września v0.153.4 dodała pozycję w selektorze i ustawiła model jako domyślny w CLI zawartym w pakiecie. W ogłoszeniu opisano etapowe wdrożenie, rozpoczynające się od ograniczonej grupy organizacji (najpierw partnerów programu cyberbezpieczeństwa) i rozszerzane „w ciągu najbliższych dni” na ChatGPT Plus, Pro, Business i Enterprise, a także OpenAI API oraz AWS — informacje o wdrożeniu pochodzą z doniesień prasowych (CNBC, Axios, Forbes, Al Jazeera, 9to5Mac).¹⁴⁵ Informacje zaktualizowane 4 września: OpenAI ogłosiło w serwisie X, że GPT-6 Astra „jest już dostępny dla wszystkich użytkowników Pro, Enterprise i Business Premium w ChatGPT Work oraz Codex” i „działa w API”, a dostęp dla Plus i Business był oczekiwany w ciągu kilku dni. Tego samego wieczoru lider Codex Tibo Sottiaux dodał: „Astra jest już wdrożony również dla wszystkich użytkowników Plus i Business”. W praktyce uprawnienia nadal są nierównomierne — zgłoszenia społeczności z 5 września wskazują, że część kont Plus nadal widzi w Codex wyłącznie modele GPT-5.6 — a cytowany niżej zapis o dostępności w dokumentacji modeli pozostał niezmieniony, dlatego nadal stanowi obowiązujące stanowisko z pierwotnego źródła.¹⁴⁹ Dostępna jest oficjalna dokumentacja: strona modelu w API określa gpt-6-astra jako flagowy model, „Nasz model o największych możliwościach, stworzony do najtrudniejszych kompleksowych zadań” — 10 USD/MTok wejścia, 50 USD/MTok wyjścia według standardowych stawek dla krótkiego kontekstu, okno kontekstu 1,05M tokenów z maksymalnie 922 000 tokenów wejściowych, maksymalnie 128K tokenów wyjściowych, graniczna data wiedzy: 30 kwietnia 2026 — z udokumentowaną warstwą długiego kontekstu: prompty przekraczające 272K tokenów wejściowych są rozliczane za całe żądanie według stawki 2 razy wyższej za wejście i 1,5 raza wyższej za wyjście, czyli według strony z cennikiem 20 USD/MTok wejścia i 75 USD/MTok wyjścia. Model znajduje się powyżej GPT-5.6 Terra (zrównoważony) i Luna (budżetowy), a dokumentacja Codex określa Astra jako zalecany model Codex, którego dostępność „zależy od wdrożenia, metody logowania i klienta”, wskazując uprawnienia dla kont Pro, Business (100 USD) i Enterprise. Udokumentowane poziomy rozumowania Astra w Codex to: Low, Medium, High, Extra High, Max, Ultra — strona modeli w dokumentacji oznacza Medium jako poziom domyślny, natomiast katalog dołączony do v0.153.4 ustawia default_reasoning_level na low; efektywne ustawienie domyślne należy więc uznać za zależne od interfejsu i sprawdzić za pomocą /status podczas sesji. Hierarchia nie zmieniła się po ponownym sprawdzeniu 15 września; dodano wówczas opisy poszczególnych poziomów w selektorze (dosłowny opis Ultra: „Maximum reasoning with automatic task delegation”), a poziomy Max i Ultra wymagają potwierdzenia SDK — wydanie Python SDK 0.154.0 (10 września 2026) dodaje wartości poziomu rozumowania max i ultra (#39662).^146148153 W CLI model Astra można konfigurować przez API od v0.153.1 (-m gpt-6-astra), dołącza do katalogów Amazon Bedrock w v0.153.3 (GPT-5.6 Sol pozostał domyślnym modelem Bedrock do czasu, gdy v0.157.0 zmieniła go na GPT-6 Sol¹⁷⁴), a od v0.153.4 znajduje się w selektorze modeli i jest domyślnym modelem w pakiecie, gdy nie skonfigurowano go jawnie — minimalna wersja CLI nie została udokumentowana, dlatego należy traktować te wersje jako faktyczne wartości graniczne. Ta zmiana domyślnego modelu dotyczy katalogu CLI w pakiecie, a nie wszystkich interfejsów — choć luka w chmurze została później zamknięta: sprawdzenia z 4 i 7 września wskazywały, że Astra jest niedostępny w Codex cloud (gdzie dostępny był GPT-5.6 Sol), natomiast ponowne sprawdzenie 15 września pokazało w macierzy dostępności, że Astra jest dostępny również w Codex cloud; na stronie nadal widnieje uwaga: „Obecnie nie można zmienić domyślnego modelu czatów Codex cloud”. Zastrzeżenie dotyczące wdrożenia: uprawnienia różnią się zależnie od konta, a w CLI 0.153.4+ konto nieobjęte wdrożeniem ma w pakiecie model domyślny, którego nie może jeszcze obsłużyć — aby wybór był deterministyczny, należy przypiąć model w config.toml (lub przekazać -m); od v0.156.1 przykład w dokumentacji używa model = "gpt-6-sol". Rozliczanie trybu Fast modelu Astra jest udokumentowane, mimo że strona modeli nie wymienia warstwy Fast: dokumentacja szybkości Codex określa koszt na 2,5 raza więcej kredytów niż Standard przy logowaniu przez ChatGPT („tam, gdzie jest dostępny”), a strona cennika API podaje stawki trybu Fast dokładnie 2 razy wyższe od odpowiednich stawek Standard (20/100 USD za MTok dla krótkiego kontekstu, 40/150 USD dla długiego). Fragment „2x speed” w opisie katalogowym v0.153.2 pozostaje jedynie tekstem wyświetlanym w katalogu — strona szybkości nie podaje mnożnika szybkości dla Astra.^145146147148 Częściowo zaktualizowane 23 września 2026: dokumentacja modeli nie określa już Astra jako zalecanego modelu Codex. Sekcja „Recommended models” rozpoczyna się obecnie od GPT-6 Sol i Luna, rezerwuje Astra do „najtrudniejszych kompleksowych zadań”, oznacza Astra jako niedostępny w Codex cloud i podaje Light (low) jako początkowy poziom rozumowania, zgodnie z katalogiem w pakiecie. Astra pozostaje domyślnym modelem CLI w pakiecie, gdy nie skonfigurowano żadnego modelu.¹⁷¹ Zaktualizowane 29 września 2026: v0.159.1 ustawia GPT-6.1 Sol jako model domyślny w pakiecie i przesuwa Astra na drugie miejsce w selektorze, a dokumentacja modeli zaleca obecnie GPT-6.1 Sol do złożonego programowania, pozostawiając Astra do najtrudniejszych kompleksowych zadań; przykłady konfiguracji w dokumentacji używają teraz gpt-6.1-sol.¹⁷⁸

Presety Power w Astra (dodane do dokumentacji najpóźniej 6 września 2026): fragment dokumentacji modeli Codex dotyczący selektora modeli przypisuje obecnie opcje Power selektora do poziomów rozumowania GPT-6-Astra — jest to pierwsze udokumentowane przypisanie presetów Power do Astra — w akapicie, którego nie było podczas ponownego sprawdzenia ¹⁴⁶ z 5 września, a którego obecność potwierdzono 7 września. Dosłownie: „W przypadku uprawnionych kont Pro, Business (100 USD) i Enterprise wdrożenie Astra aktualizuje opcje Power do Terra Light, Sol Light, Sol Medium, Astra Light, Astra Medium i Astra Extra High. Opcje mogą się różnić zależnie od planu i etapu wdrożenia”. Poprzednie zdanie w dokumentacji zaznacza, że ilustracje selektora nadal przedstawiają elementy sterujące GPT-5.6. W zestawieniu z powyższą tabelą modeli: „Power” oznaczało GPT-5.6 Sol z poziomem rozumowania medium; na uprawnionym koncie ta sama hierarchia presetów obejmuje obecnie Terra, Sol i Astra ze stałymi poziomami rozumowania, a dostępne opcje nadal zależą od planu i etapu wdrożenia. Akapit pozostał dosłownie niezmieniony podczas ponownego sprawdzenia 15 września 2026.¹⁴⁶ Aktualizacja z 23 września 2026: po premierze GPT-6 Sol i Luna dokumentacja wymienia sześć presetów Power: „Luna High, Sol Light (preset początkowy), Sol Medium, Astra Light, Astra Medium i Astra Extra High”, zaznacza, że w niektórych płatnych planach brakuje Astra Extra High, oraz sugeruje rozpoczęcie od Medium dla Sol, High dla Luna i Light (low) dla Astra.¹⁷¹

Eksperymentalne notatki między oknami kontekstu (Astra, opublikowane w dokumentacji, opcjonalne): strona dokumentacji modeli Codex zawiera sekcję „Experimental context management”, w której czytamy: „W obsługiwanych klientach Codex użytkownicy zalogowani przez ChatGPT Plus lub Pro mogą opcjonalnie włączyć eksperymentalne zarządzanie kontekstem. Astra zachowuje notatki między oknami kontekstu i może przeszukiwać wcześniejsze wiadomości oraz wyniki narzędzi z tego samego zadania. Eksperyment jest domyślnie wyłączony i w chwili uruchomienia nie jest dostępny przy logowaniu przez Business, Enterprise ani klucz API”. Mechanizm włączenia opisano następująco: „Aby go włączyć, należy ustawić features.context_management.experimental_mode = true w pliku config.toml, a następnie rozpocząć nowe zadanie”. Jest to ten sam interfejs features.context_management.experimental_mode, który wprowadzono w v0.153.0 (zob. Zarządzanie kontekstem) — strona dokumentacji wiąże go obecnie z nazwą Astra oraz logowaniem przez Plus i Pro, podczas gdy informacje o wydaniu v0.153.0 wskazywały kwalifikujące się sesje Plus, Pro i Pro Lite. v0.154.0 zaostrza ograniczenia po stronie kodu: dostęp do eksperymentu jest obecnie uzależniony podczas uruchamiania sesji od możliwości aktywnego modelu (#43147). Podczas ponownego sprawdzenia 15 września 2026 sekcja dokumentacji pozostała dosłownie niezmieniona. Jest to funkcja eksperymentalna i domyślnie wyłączona; należy oczekiwać zmian w jej działaniu i kryteriach dostępu.^140146152 v0.157.0: katalog modeli w pakiecie nie oznacza już GPT-6-Astra ani żadnego innego modelu w pakiecie jako obsługującego eksperymentalny kontekst (#47397), a CLI włącza eksperyment wyłącznie dla modelu oznaczonego w ten sposób. W przypadku katalogu w pakiecie ustawienie nie przynosi więc efektu; nie udokumentowano, czy katalog udostępniany zalogowanym kontom jest inny. Dokumentacja modeli nadal opisywała tę opcję 26 września 2026.¹⁷⁴ 29 września 2026: strona modeli nie zawiera już tej sekcji, dokumentacja konfiguracji opisuje features.context_management.experimental_mode jako „Eksperymentalne ustawienie zarządzania kontekstem. Funkcja nie jest obecnie dostępna”, a GPT-6.1 Sol również nie jest oznaczony jako obsługujący tę funkcję.¹⁷⁸

Schemat wyboru modelu

Is this a quick fix, extraction, or other well-defined repeatable task?
├─ Yes → gpt-6-luna (most efficient; docs suggest starting at High)
└─ No
   ├─ Do you need real-time pairing speed?
   │  ├─ Yes → gpt-5.3-codex-spark (near-instant, Pro only)
   │  └─ No
   │     ├─ Hardest end-to-end work across many steps and tools?
   │     │  ├─ Yes → gpt-6-astra (strongest; most expensive)
   │     │  └─ No → gpt-6.1-sol (near-Astra at lower cost; default since v0.159.1)
   └─ GPT-6.1 Sol not yet available on your account? → gpt-6-sol, then gpt-5.6-sol

Poziom rozumowania

Można określić, jak długo model ma „myśleć” przed udzieleniem odpowiedzi:

Obsługiwane poziomy zależą od modelu. minimal jest dostępny wyłącznie dla modeli GPT-5. Nie każdy model obsługuje wszystkie poziomy.

Szczegóły dotyczące persistent (v0.151.0): w turach działających z poziomem persistent domyślnie włączone są przypomnienie o bieżącym czasie i przerywalne narzędzie clock.sleep (jawne ustawienia features.current_time_reminder i zarządzane wymagania zostają zachowane); dostępne są również dołączone do pakietu wskazówki dotyczące proaktywności i dalszych działań, które metadane modelu mogą zastąpić lub wyłączyć za pomocą persistent_instructions.¹³⁵

codex -c model_reasoning_effort="xhigh" "find the race condition"

Wskazówka dla ekspertów: poziom rozumowania xhigh może zużywać 3–5 razy więcej tokenów niż medium dla tego samego promptu. Warto zarezerwować go dla naprawdę trudnych problemów, w których dodatkowe rozumowanie przynosi wymierne korzyści.

Szybkie sterowanie poziomem rozumowania w TUI (v0.124.0+).⁸⁵ W interaktywnej sesji TUI skrót Alt+, obniża poziom rozumowania o jeden stopień, a Alt+. podnosi go o jeden stopień — jest to przydatne, gdy trudny problem pojawiający się w trakcie sesji wymaga tymczasowego przejścia medium → high → xhigh bez użycia /effort ani -c. Po zaakceptowaniu zmiany modelu na nowszy w trakcie sesji poziom rozumowania zostaje przywrócony do wartości domyślnej nowego modelu, zamiast zachować poprzedni poziom.

Zmiana modelu

Model można zmienić w trakcie sesji za pomocą slash command /model albo dla pojedynczego uruchomienia przy użyciu --model / -m:

codex -m gpt-5.3-codex-spark "pair with me on this component"

Ile kosztuje Codex?

Zobacz także sekcję Wybór modelu, aby poznać możliwości modeli, oraz Ramy decyzyjne, aby dobrać odpowiedni model do danego zadania.

Dostęp w ramach planów ChatGPT

Dostępność Codex zależy od planu ChatGPT i ustawień organizacji:⁵¹

Aktualizacja cen z kwietnia 2026: roczna cena planu Business spadła z 25 do 20 USD za stanowisko miesięcznie. W obszarach roboczych Business i Enterprise są teraz dostępne stanowiska tylko z Codex w modelu płatności według użycia — bez stałej opłaty za stanowisko, z rozliczeniem na podstawie zużycia tokenów.⁷⁹ Na stronie z cennikiem limity są obecnie publikowane jako przedziały zależne od modelu (zob. tabela powyżej), a nie promocyjne mnożniki 2x z premiery Codex Desktop App w lutym 2026.¹⁶¹⁶²

Zwiększone limity użycia w maju 2026 (oferta wygasła 31 maja 2026): w planie Plus Codex działał z 25-krotnie zwiększonym limitem 5-godzinnym (w porównaniu ze standardowym zwiększeniem 20x), a limit w planie za 100 USD miesięcznie został podwojony na ten sam okres.⁸⁹

Obsługa limitów użycia w TUI (v0.152.0–v0.153.0): osiągnięcie limitu nie oznacza już, że nie można kontynuować pracy. Wersja v0.152.0 wyświetla nad polem tworzenia wiadomości banery limitów użycia z dostępnymi działaniami — sprawdzeniem użycia, zarządzaniem kredytami, resetowaniem limitów, powiadomieniem właściciela obszaru roboczego i zarządzaniem planami — przefiltrowane pod kątem uwierzytelnionego konta i użytkownika. Dane o użyciu są odświeżane po błędach związanych z limitem, a gdy baner zawiera taką instrukcję, Codex przełącza się na pierwszy dostępny model zapasowy bez zmieniania pozostałych ustawień wątku.¹³⁸ Wersja v0.153.0 dodaje wcześniejsze ostrzeżenia dla planów Plus i Team: ostrzeżenie pojawia się, gdy w około 5-godzinnym oknie użycia pozostaje mniej niż połowa przydziału, natomiast w przypadku innych planów i długości okien nadal obowiązują dotychczasowe progi 75%, 90% i 95%.¹⁴⁰

Koszty w kredytach

Operacje Codex zużywają kredyty z przydziału dostępnego w danym planie:

Stawki dotyczą Standardowej szybkości, a strona z cennikiem podaje, że po premierze GPT-6 stawki za GPT-5.6 Sol, Terra i Luna „pozostają bez zmian”. W praktyce „użycie GPT-5.6 kosztuje średnio 5–30 kredytów za wiadomość” (w sierpniu, w momencie udostępnienia, strona podawała 5–40). Tryb Fast kosztuje 2,5 raza więcej niż standardowa stawka kredytowa dla GPT-6.1 Sol oraz GPT-6 Astra, Sol i Luna „tam, gdzie jest dostępny”. Ponadto katalog dołączonych modeli ustawia w TUI Fast jako domyślny poziom dla GPT-6 Sol i Luna (ale nie dla GPT-6.1 Sol), chyba że zostanie ustawione service_tier. Jeśli więc kredyty wyczerpują się szybciej, niż oczekiwano, warto sprawdzić /fast status. Generowanie obrazów zużywa dostępne limity 3–5 razy szybciej niż porównywalne interakcje obejmujące wyłącznie tekst.^162171178

W planach Enterprise i Edu liczba kredytów skaluje się zgodnie z przydziałem określonym w umowie. Bieżące użycie można sprawdzić za pomocą /status w TUI.

Rozliczenia API

Podczas korzystania z Codex za pośrednictwem API OpenAI rozlicza użycie za każdy token według standardowego cennika OpenAI API dla wybranego modelu (z uwzględnieniem ewentualnych rabatów za buforowanie promptów). Aktualne stawki API za 1 mln tokenów: GPT-6.1 Sol — 2 USD za dane wejściowe / 10 USD za dane wyjściowe (0,10 USD za dane wejściowe z pamięci podręcznej), GPT-6 Sol — 2 USD / 10 USD, GPT-6 Luna — 0,10 USD / 0,50 USD, GPT-6 Astra — 10 USD / 50 USD. W przypadku wszystkich 4 modeli prompty przekraczające 272 tys. tokenów wejściowych kosztują dla całego żądania 2 razy więcej za dane wejściowe i 1,5 raza więcej za dane wyjściowe, a tryb Fast kosztuje 2 razy więcej.^146171178 Mnożniki kredytów ChatGPT nie dotyczą logowania za pomocą klucza API. Aktualne stawki można sprawdzić na oficjalnej stronie z cennikiem API.²⁰

Strategie optymalizacji kosztów

1. Korzystanie z profili: utworzyć profil fast z modelem gpt-6-luna i ustawieniem model_reasoning_effort = "low" do rutynowych zadań
2. Rezerwowanie intensywnego rozumowania: używać xhigh wyłącznie do rzeczywiście trudnych problemów, ponieważ zużywa 3–5 razy więcej tokenów
3. Korzystanie z --ephemeral: pominąć zachowywanie sesji w CI/CD, aby ograniczyć narzut
4. Ograniczanie podsumowań rozumowania: ustawić model_reasoning_summary = "none", gdy wyjaśnienia nie są potrzebne
5. Grupowanie zadań w trybie exec: codex exec eliminuje narzut TUI w zautomatyzowanych procesach
6. Monitorowanie użycia: sprawdzać /status w TUI oraz panele rozliczeniowe organizacji — od wersji v0.148.0 polecenie /status, wiersze stanu i tytuły terminali pokazują szacunkową liczbę kredytów lub koszt wątku w kwalifikujących się obszarach roboczych¹¹⁸

Przykładowe koszty w praktyce

Reprezentatywne koszty API typowych zadań (migawka cen gpt-5.3-codex z połowy 2026 przy średnim poziomie rozumowania — względne proporcje są podobne w różnych modelach):

Koszty zależą od poziomu rozumowania, wykorzystania pamięci podręcznej oraz długości rozmowy. Do rutynowych zadań warto używać gpt-5.6-luna, aby znacznie obniżyć związane z nimi wydatki. Tokeny wejściowe z pamięci podręcznej są rozliczane według obniżonej stawki.

Ukryty narzut tokenów

Każde wywołanie narzędzia zużywa dodatkowe tokeny poza tymi wynikającymi z widocznego promptu:

Wskazówka ekspercka: rzeczywiste użycie można monitorować za pomocą /status w TUI. Liczba tokenów obejmuje cały narzut, a nie tylko widoczne wiadomości. Jeśli koszty są zaskakująco wysokie, warto sprawdzić liczbę połączonych serwerów MCP — każdy z nich dodaje definicje narzędzi do każdego wywołania API.

Zarządzanie kosztami zespołu

Strategie kontrolowania kosztów zespołu: - Ustawić limity w requirements.toml, aby wymusić w całej organizacji ograniczenia dotyczące modeli i poziomów rozumowania - Używać gpt-5.6-luna w CI/CD — zautomatyzowane potoki rzadko wymagają maksymalnego poziomu rozumowania - Planowanie budżetu na podstawie profili — zdefiniować profile ci, review i dev z odpowiednimi limitami kosztów - Monitorować za pomocą OpenTelemetry — wdrożenia korporacyjne mogą eksportować telemetrię użycia do istniejących stosów obserwowalności

Ramy decyzyjne

Kiedy korzystać z poszczególnych interfejsów

Kiedy korzystać z poszczególnych trybów sandbox

Kiedy korzystać z poszczególnych poziomów rozumowania

Tryb planowania a bezpośrednie wykonanie

Will Codex need to change more than 3 files?
│
├── YES → Use Plan Mode (/plan)
│         Codex designs the approach BEFORE making changes.
│         You review and approve the plan.
│         Best for: refactors, new features, migrations
│
└── NO → Is the change well-defined?
         │
         ├── YES → Direct execution
         │         Just describe the task. Codex executes immediately.
         │         Best for: bug fixes, small features, test additions
         │
         └── NO → Use Plan Mode (/plan)
                  Let Codex explore and propose an approach first.
                  Best for: unfamiliar codebases, ambiguous requirements

Tryb sterowania: Enter a Tab

Praktyczna zasada: Enter = „zatrzymaj się i posłuchaj tego teraz”. Tab = „po zakończeniu wykonaj również to”.

Aplikacja desktopowa a CLI

How do you prefer to work?
│
├── Terminal-first → Use CLI
│   │
│   ├── Single focused task → codex (interactive TUI)
│   ├── Scripted automation → codex exec (non-interactive)
│   └── Quick one-shot → codex exec "prompt" -o result.txt
│
└── Visual/multi-project → Use Desktop App
    │
    ├── Multiple parallel tasks → Multi-thread with worktree isolation
    ├── Visual diff review → Built-in Git diff viewer
    ├── Scheduled automation → Automations tab
    └── Voice-driven → Ctrl+M for voice dictation

Który profil wybrać?

Należy dopasować zadanie do wstępnie skonfigurowanego profilu:

Pliki profili (po jednym dla każdego ustawienia wstępnego, w ~/.codex/; starszy układ z pojedynczym plikiem profile = "default" i [profiles.*] nie jest odczytywany od wersji 0.134.0¹²²):

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"

# ~/.codex/careful.config.toml
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"

# ~/.codex/pair.config.toml
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"

# ~/.codex/ci.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
sandbox_mode = "workspace-write"

Przełączanie profili dla poszczególnych sesji: codex --profile careful

Jak działa system sandbox i zatwierdzania?

Codex korzysta z dwuwarstwowego modelu bezpieczeństwa, który oddziela to, co jest technicznie możliwe, od sytuacji, w których Codex prosi człowieka o zatwierdzenie. To podejście zasadniczo różni się od systemu uprawnień Claude Code — Codex wymusza ograniczenia na poziomie jądra systemu operacyjnego.⁵ Zobacz także sekcję Wdrożenie korporacyjne, w której opisano ograniczenia requirements.toml wymuszane przez administratorów w całej organizacji.

Wzmocnienie zabezpieczeń w v0.148.0: ograniczenia sandbox działają teraz zgodnie z zasadą fail closed — ścieżka, do której odmówiono dostępu lub której nie można odczytać, jest traktowana jako zablokowana, zamiast być po cichu dopuszczana — zarówno w systemie Linux, jak i Windows.¹¹⁸

Warstwa 1: sandbox (co jest możliwe)

Sandbox kontroluje dostęp do systemu plików i sieci za pomocą natywnych mechanizmów systemu operacyjnego:

Mechanizmy wymuszania zależne od platformy:

• macOS: środowisko Seatbelt firmy Apple za pośrednictwem sandbox-exec, z profilami właściwymi dla poszczególnych trybów, kompilowanymi podczas działania i wymuszanymi przez jądro systemu⁶. Od v0.121.0 profile sandbox w macOS mogą dopuszczać określone gniazda Unix (np. docker.sock oraz gniazda IPC edytora), a prywatne rozpoznawanie DNS nie jest już domyślnie blokowane.⁸²
• Linux: bubblewrap (bwrap) do izolacji systemu plików i przestrzeni nazw oraz seccomp do filtrowania wywołań systemowych, uruchamiane przez samodzielny proces pomocniczy (codex-linux-sandbox); implementacja Landlock pozostaje rozwiązaniem starszego typu, a w v0.163.0 zmieniono nazwy typu polecenia i modułu wywołań systemowych pakietu, które odwoływały się do Landlock, bez zmiany sposobu wymuszania ograniczeń.⁵¹⁹³ Codex wybiera pierwszą instancję bwrap znalezioną w PATH poza katalogiem roboczym, a jeśli jej nie znajdzie, używa dołączonej wersji codex-resources/bwrap (dostarczanej od v0.100.0)⁷. Podczas uruchamiania wyświetla ostrzeżenie, jeśli brakuje bwrap lub nie można utworzyć przestrzeni nazw użytkownika. W v0.117.0 zwiększono niezawodność sandbox w starszych dystrybucjach z przestarzałą konfiguracją jądra.⁷⁵ W v0.129.0 wzmocniono uruchamianie sandbox w systemie Linux i zaktualizowano dołączony Bubblewrap do wersji 0.11.2 z poprawkami bezpieczeństwa z projektu źródłowego; w v0.130.0 dodano kolejne zabezpieczenia procesu uruchamiania.⁸⁹⁹¹
• Windows: natywny sandbox z ograniczonymi tokenami (przeniesiony ze statusu eksperymentalnego w v0.100.0). Obsługiwany jest również WSL (dziedziczy mechanizmy bubblewrap i seccomp z systemu Linux). W v0.117.0 ulepszono sandbox oparty na ograniczonych tokenach, aby zapewnić lepszą izolację procesów.⁷⁵ W v0.130.0 użytkownicy sandbox otrzymali dostęp do pamięci podręcznej plików binarnych środowiska uruchomieniowego aplikacji komputerowej, dzięki czemu sandbox systemu Windows może niezawodnie odnajdywać te pliki dla użytkowników sandbox przestrzeni roboczej.⁹¹

Dlaczego ma to znaczenie: w przeciwieństwie do izolacji opartej na kontenerach (Docker) sandbox na poziomie systemu operacyjnego jest szybszy, lżejszy i trudniej z niego uciec. Jądro wymusza ograniczenia, zanim Codex w ogóle otrzyma wywołanie systemowe.

Poprawki bezpieczeństwa: - Obejście sandbox przez zsh-fork (v0.106.0): naprawiono lukę, przez którą wykonywanie poleceń powłoki za pośrednictwem rozwidlania procesów zsh mogło omijać ograniczenia sandbox.⁶⁰ Jeśli używana jest wcześniejsza wersja, należy ją natychmiast zaktualizować. - Limit rozmiaru danych wejściowych (v0.106.0): Codex egzekwuje teraz limit danych wejściowych wynoszący około 1 miliona znaków, aby zapobiec zawieszaniu się programu wskutek przetwarzania zbyt dużych ładunków.⁶⁰ - Bezpieczny profil devcontainera (v0.121.0): nowy, wzmocniony profil klienta dla devcontainerów Docker używa Bubblewrap do izolacji wewnątrz kontenera. WSL2 jest obsługiwany; WSL1 jest jednoznacznie odrzucany (Bubblewrap nie jest zgodny z warstwą pośrednią jądra WSL1).⁸² - Przegląd Guardian i hooks (v0.121.0): hooks są wyłączone podczas sesji przeglądu Guardian, aby hooks uruchamiane przed użyciem narzędzia i po nim nie mogły wpływać na decyzje subagenta Guardian.⁸² Jeśli hooks służą do rejestrowania lub walidacji, należy pamiętać, że przegląd Guardian je pomija — gdy potrzebna jest pełna ścieżka audytu, należy skorzystać z obserwowalności serwera aplikacji. - System plików /dev w systemie Linux (v0.105.0): polecenia uruchamiane w sandbox w systemie Linux otrzymują teraz minimalny system plików /dev, co zwiększa zgodność z narzędziami oczekującymi węzłów urządzeń.⁶¹

Zasady ReadOnlyAccess (v0.100.0+): konfigurowalna struktura zasad umożliwiająca szczegółową kontrolę dostępu do odczytu. Pozwala ograniczyć katalogi, z których Codex może odczytywać dane, nawet w trybie workspace-write:

[sandbox_workspace_write]
read_only_access = ["/etc", "/usr/local/share"]  # Only these paths readable outside workspace

Warstwa 2: zasady zatwierdzania (kiedy pytać)

Zasady zatwierdzania określają, kiedy Codex wstrzymuje działanie i prosi człowieka o potwierdzenie:

on-failure nadal występuje w niektórych starszych przykładach i ścieżkach zgodności, ale aktualna dokumentacja konfiguracji OpenAI oznacza tę opcję jako przestarzałą. W przypadku sesji interaktywnych należy preferować on-request, a w przypadku sesji nieinteraktywnych, które już mają zewnętrzną granicę bezpieczeństwa — never.⁸⁷

Od v0.150.0 można przypisać skrót klawiaturowy przełączający kolejno tryby uprawnień z poziomu pola wprowadzania — należy skonfigurować go za pomocą /keymap.¹³²

Odrębne identyfikatory zatwierdzeń (v0.104.0+)

Codex przypisuje teraz odrębny identyfikator zatwierdzenia każdemu poleceniu w wieloetapowym wykonaniu powłoki. Dzięki temu zatwierdzanie jest szczegółowe — zatwierdzenie jednego polecenia w sekwencji nie powoduje automatycznego zatwierdzenia kolejnych poleceń w ramach tego samego wywołania powłoki.⁴⁹

Elastyczne mechanizmy zatwierdzania (v0.105.0+)

Proces zatwierdzania obsługuje teraz dodatkowe uprawnienia sandbox i szczegółowe odrzucanie:⁶¹

• Dodatkowe uprawnienia sandbox: gdy polecenie wymaga dostępu wykraczającego poza bieżący tryb sandbox, Codex może poprosić o konkretne dodatkowe uprawnienia zamiast wymagać pełnej zmiany trybu
• Szczegółowe odrzucanie: można odrzucać poszczególne wywołania narzędzi i przekazywać informację zwrotną, aby Codex mógł dostosować swoje podejście zamiast ponownie wykonywać to samo polecenie

Żądania uprawnień podczas działania (v0.113.0+)

Codex zawiera teraz wbudowane narzędzie request_permissions, które pozwala modelowi żądać dodatkowych uprawnień podczas działania.⁶⁹ Gdy model napotka zadanie wymagające rozszerzonego dostępu, może formalnie poprosić o konkretne uprawnienia (do ścieżek systemu plików, sieci itp.) za pośrednictwem procesu zatwierdzania w TUI, zamiast bezgłośnie kończyć się niepowodzeniem lub wymagać ponownego uruchomienia przez użytkownika z innymi flagami.

Tryb zatwierdzania aplikacji writes (v0.144.0+)

Aplikacje i konektory otrzymują pośredni poziom zatwierdzania: tryb zatwierdzania aplikacji writes pozwala wykonywać zadeklarowane przez aplikację operacje tylko do odczytu bez wyświetlania monitu, a jednocześnie nadal wstrzymuje wszystkie operacje zapisujące dane.¹⁰⁷ Wcześniej zatwierdzanie aplikacji było bliższe podejściu „wszystko albo nic”; writes odpowiada modelowi zaufania, którego większość operatorów rzeczywiście oczekuje od integracji — można swobodnie przeglądać, lecz przed wprowadzeniem zmian trzeba zapytać.

Automatycznie weryfikowane zatwierdzenia: --approve-for-me (v0.147.0+)

Nowa flaga CLI --approve-for-me przekształca monity o zatwierdzenie w automatycznie weryfikowane zatwierdzenia: zamiast przerywać pracę, każde żądanie jest rozstrzygane w ramach przeglądu, a następnie zatwierdzane lub odrzucane w imieniu użytkownika.¹¹⁶ Rozwiązanie to mieści się między „zatwierdzaniem wszystkiego” (do czego zachęcała usunięta już konfiguracja --full-auto) a „przerywaniem pracy przy każdej operacji” — monity nadal stanowią punkty decyzyjne, ale odpowiada na nie recenzent. Warto połączyć tę flagę z bezpieczniejszymi domyślnymi ustawieniami automatycznego przeglądu dla modeli obsługujących zadania cyberbezpieczeństwa, wprowadzonymi w v0.146.1, które flaga ta dziedziczy. Należy traktować ją jak każde przekazanie uprawnień: sprawdza się w długich, nienadzorowanych sesjach, w których przerwanie oznacza zastój, ale nie w sesjach dotyczących danych uwierzytelniających lub środowiska produkcyjnego, gdy decyzje powinien podejmować użytkownik.

Zatwierdzanie danych wejściowych wysyłanych do terminala z rozszerzonymi uprawnieniami (v0.151.0; domyślnie włączone od v0.158.0)

Flaga funkcji write_stdin_approval — domyślnie wyłączona, gdy pojawiła się w v0.151.0, i domyślnie włączona od v0.158.0 — wymaga nowego zatwierdzenia przed wysłaniem niepustych danych wejściowych do terminala unified-exec z rozszerzonymi uprawnieniami. Takie przeglądy są przekazywane przez hooks, Guardian, serwer aplikacji i TUI jako zatwierdzenia writeStdin; środowisko terminala, katalog uruchomienia i stan rozszerzonych uprawnień są zachowywane między turami, a tożsamość procesu jest ponownie weryfikowana po zatwierdzeniu, zanim zostanie zapisany choćby jeden bajt. W pełni sformatowana operacja wraz z uzasadnieniem zatwierdzenia musi mieścić się w 8 000 bajtów — zbyt duże lub ucięte operacje są odrzucane, zanim pojawi się prośba o zatwierdzenie lub cokolwiek dotrze do terminala.¹³⁵ W v0.158.0 flaga zostaje włączona (#47799), a nadawane wyłącznie podczas działania uprawnienia — takie jak te używane przez wtyczki do zbierania metryk — przestają wywoływać przegląd; nadal wywołują go natomiast dodatkowe uprawnienia agentów, obejścia sandbox i zmiany zasad wprowadzone po uruchomieniu (#48073). Aby wyłączyć tę funkcję: należy ustawić write_stdin_approval = false w sekcji [features] pliku config.toml.¹⁷⁶

Profile uprawnień (v0.113.0+, rozszerzone w v0.128.0 i v0.133.0)

Profile uprawnień rozdzielają zasady sandbox dotyczące systemu plików i sieci na nazwane sekcje wielokrotnego użytku. W default_permissions należy wskazać profil wbudowany, taki jak :read-only lub :workspace, albo niestandardową tabelę [permissions.<name>].⁸⁷ W v0.133.0 profile stają się zarządzaną powierzchnią konfiguracji: listy APIs udostępniają metadane dostępnych profili, profile mogą dziedziczyć po sobie, zarządzany plik requirements.toml może deklarować wymagania dotyczące uprawnień, aktywne profile są odświeżane podczas działania, a konfiguracja sandbox systemu Windows korzysta teraz z rozstrzygniętego profilu zamiast z odrębnych, doraźnych zasad.⁹⁸

default_permissions = "project-safe"

[permissions.project-safe.filesystem]
"/usr/local" = "read"
glob_scan_max_depth = 3

[permissions.project-safe.filesystem.":project_roots"]
"." = "write"
"**/*.env" = "none"

[permissions.project-safe.network]
enabled = true
mode = "limited"

[permissions.project-safe.network.domains]
"api.github.com" = "allow"
"registry.npmjs.org" = "allow"

W przypadku poufnych plików i wzorców glob, które powinny pozostać nieczytelne nawet wtedy, gdy katalog główny projektu umożliwia zapis, należy użyć none. Dla jednorazowych wyjątków dotyczących poleceń lepiej zastosować reguły niż znacznie rozszerzać profil.⁸⁷

v0.151.0: przywrócone wątki serwera aplikacji zachowują swoje profile uprawnień, zamiast być spłaszczane do starszych, obowiązujących tylko w danej turze nadpisań sandbox — profile pozostają aktywne podczas przekazywania tur i zgodnych zmian katalogu za pomocą /cd, natomiast polecenie /cd, które nie może bezpiecznie odwzorować przywróconego profilu jako starszego trybu sandbox, zostaje odrzucone, zamiast po cichu osłabiać ograniczenia.¹³⁴

Starsze zalecenia dotyczące --full-auto

Starsze poradniki przedstawiały --full-auto jako wygodny alias następujących ustawień:

codex --sandbox workspace-write --ask-for-approval on-request

W informacjach o wydaniu v0.128.0 opcję --full-auto oznaczono jako przestarzałą, a aktualna pomoc CLI nie wymienia jej już dla sesji interaktywnych. Zamiast niej należy używać powyższych jawnych flag lub nazwanego profilu uprawnień.⁸⁶

W v0.147.0 usuwanie zostaje zakończone: opcja codex exec --full-auto już nie istnieje. Skrypt, który nadal przekazuje tę flagę, kończy się teraz błędem zamiast się uruchomić. Migracja jest mechaniczna — należy zastąpić ją flagą --sandbox workspace-write (oraz flagą zatwierdzania lub profilem, jeśli wcześniejsze wywołanie polegało na sposobie zatwierdzania zapewnianym przez --full-auto). Przed aktualizacją warto skontrolować całą automatyzację wywołującą codex exec za pośrednictwem powłoki: problem ujawni się jako uszkodzony pipeline, a nie ostrzeżenie o wycofaniu funkcji.¹¹⁶

Niezawodność sandbox (v0.129.0): wzmocnienie procesu uruchamiania sandbox w systemie Linux ogranicza sytuacje wyścigu na wolnych systemach plików lub w katalogach roboczych korzystających z dowiązań symbolicznych; ulepszenia niezawodności sandbox systemu Windows eliminują kilka awarii w przypadkach brzegowych podczas długotrwałych sesji; ponadto dołączony Bubblewrap zaktualizowano do wersji 0.11.2 z poprawkami bezpieczeństwa z projektu źródłowego. Zmiany konfiguracji nie są wymagane. Aby pobrać te poprawki, należy uruchomić codex update.⁸⁹

Zalecane konfiguracje

Codzienna praca programistyczna (bezpieczne ustawienie domyślne):

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

Użytkownik zaawansowany (pełny dostęp z udziałem człowieka w procesie decyzyjnym):

sandbox_mode = "danger-full-access"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0

Opracowania społeczności polecają to połączenie jako „optymalny kompromis”⁸; przed powieleniem tej porady warto jednak zrozumieć, jak rzeczywiście działa: monity o zatwierdzenie pojawiają się, gdy polecenie musi opuścić sandbox lub uzyskać dostęp do sieci, natomiast danger-full-access usuwa obie te granice, więc on-request niemal nie ma już czego eskalować. Oznacza to maksymalne możliwości przy minimalnej liczbie pytań, a nie maksymalne możliwości z kontrolą człowieka nad każdym poleceniem; jeśli potrzebny jest ten drugi wariant, należy zachować workspace-write i pozwolić, aby to granica sandbox wywoływała monity.¹²³

Automatyzacja CI/CD:

sandbox_mode = "workspace-write"
approval_policy = "never"

Inteligentne zatwierdzanie za pomocą subagenta Guardian (v0.115.0+)

Funkcja Smart Approvals może kierować żądania przeglądu do subagenta Guardian, zamiast wymagać zatwierdzenia przez człowieka dla każdej operacji. Sesja Guardian jest zachowywana między zatwierdzeniami, aby ponownie wykorzystywać pamięć podręczną promptów i unikać narzutu związanego z uruchamianiem. Każdy przegląd otrzymuje czystą historię (wcześniejsze decyzje nie przenikają do kolejnych przeglądów).⁷³

Recenzenta należy skonfigurować w pliku config.toml:

approvals_reviewer = "guardian_subagent"   # "user" (default) or "guardian_subagent"

Jest to szczególnie przydatne w procesach CI/CD, w których potrzebny jest automatyczny przegląd z uzasadnieniem zamiast bezwarunkowego approval_policy = "never".

Odwrócenie ustawień domyślnych Guardian v2 (v0.151.0): Guardian v2 domyślnie przeprowadza teraz przeglądy interakcji z komputerem z użyciem obrazów. Wartość domyślna features.guardianv2.review_scope.computer_use_only to true — aby zachować szerszy zakres przeglądu narzędzi, należy ustawić ją na false — natomiast wartość domyślna features.guardianv2.transcript.include_images to true — aby wykluczyć obrazy z transkrypcji Guardian, należy ustawić ją na false. Obie opcje wprowadzono w v0.150.0 jako konfigurowalne i domyślnie wyłączone; w v0.151.0 zostały domyślnie włączone.¹³⁵

Zakres Guardian zależy od trybu zatwierdzania (v0.153.0): dwa tryby pomijają teraz operacje Guardian, które nie mogą wpłynąć na wynik. W trybie Full Access (który już łączy approvalPolicy: "never" z nieograniczonymi uprawnieniami) żądania Guardian służące wyłącznie do potwierdzania oraz żądania MCP są zatwierdzane bez synchronicznego przeglądu, wstępnego rozgrzewania samplera ani oceny w tle — środowiska oczekujące, niesprawne lub ograniczone nie są traktowane jako Full Access, a aktywny stan uprawnień jest ponownie oceniany w każdej turze, dzięki czemu istniejący wątek może bezpiecznie przechodzić do trybu Full Access i z niego wychodzić. W trybie zatwierdzania przez użytkownika (approvals_reviewer = "user") pomijane są wstępne rozgrzewanie Guardian i asynchroniczna ocena, a zwykłe potwierdzenia wykonania node_repl.js są przyjmowane automatycznie; kontrole operacji wrażliwych i żądania danych wejściowych od użytkownika zachowują dotychczasowe działanie.¹⁴⁰ Zawęża to zakres sytuacji, w których Guardian jest uruchamiany, a nie warstwę zatwierdzania przez człowieka: opisane w tym przewodniku monity dotyczące danger-full-access przy zasadzie on-request wynikają z zasad zatwierdzania, które są odrębnym mechanizmem. Ponadto v0.152.1 pozwala, aby przegląd zatwierdzeń Guardian pobierał zasady Node REPL z metadanych modelu (auto_review.node_repl_policy), a w razie braku tego pola korzystał z dołączonych zasad.¹³⁹

Ocena interakcji z komputerem przez Guardian uwzględnia wymagania modelu (v0.153.1): ocena Guardian ograniczona do interakcji z komputerem oraz szybkie decyzje o zatwierdzeniu są teraz wykonywane wyłącznie wtedy, gdy aktywny model ma w metadanych ustawienie node_repl_auto_review_required. Dotychczasowe lub trwające oceny są unieważniane, jeśli po zmianie modelu ocenianie zostanie pominięte — dzięki temu ponowne przełączenie na model podlegający przeglądowi nie może przywrócić nieaktualnej decyzji o zatwierdzeniu. Jest to główna zmiana w poprawce v0.153.1, choć nie wymieniono jej w treści informacji o wydaniu: #42422 (cherry-pick zmiany 38ba8cdc) można potwierdzić wyłącznie przez porównanie rust-v0.153.0…rust-v0.153.1.¹⁴²

Ponowne wykorzystywanie kompakcji wątku nadrzędnego przez Guardian jest domyślnie włączone (v0.156.0): zmiana #46522 przenosi guardian_reuse_parent_compaction do funkcji stabilnych i domyślnie ją włącza, dzięki czemu Guardian może ponownie wykorzystać zaszyfrowaną kompakcję wątku nadrzędnego podczas ponownego uruchamiania sesji przeglądu. Zgodnie z testami w PR sesje przeglądu zapisane w pamięci podręcznej nadal są unieważniane po zmianie historii wątku nadrzędnego. Aby przywrócić wcześniejsze działanie: należy ustawić guardian_reuse_parent_compaction = false w sekcji [features] pliku config.toml albo uruchomić codex features disable guardian_reuse_parent_compaction.¹⁶⁹¹⁷¹

Kontekst wątku Guardian jest domyślnie włączony (v0.157.0): zmiana #47275 przenosi guardianv2.thread_context do funkcji stabilnych i włącza ją dla synchronicznych oraz asynchronicznych przeglądów Guardian, dzięki czemu przeglądy korzystają z kontekstu należącego do wątku. Funkcja ta jest niezależna od przełącznika Guardian v2 enabled. W v0.157.0 można było ją wyłączyć, ustawiając thread_context = false w sekcji [features.guardianv2]; w v0.158.0 tę opcję usunięto.¹⁷⁴

Kontekst wątku Guardian jest zawsze włączony (v0.158.0): zmiany #47686 i #47689 bezwarunkowo włączają kontekst należący do wątku podczas przechwytywania sesji Guardian i tworzenia rozwidleń historii dla subagentów. Codex ignoruje thread_context w sekcji [features.guardianv2], w tym w nadpisaniach profili i zarządzanych wymaganiach, oraz wyświetla powiadomienie o wycofaniu z prośbą o usunięcie tej opcji z pliku config.toml. Nie ma zastępczego przełącznika pozwalającego ją wyłączyć.¹⁷⁶

Guardian może odczytywać wcześniejsze wiadomości użytkownika (v0.160.0, opcjonalnie): w transkrypcji przeglądanej przez Guardian może brakować wcześniejszej instrukcji, ograniczenia lub cofniętego uprawnienia. Po ustawieniu guardian_conversation_history_tools = true w sekcji [features] i włączeniu Apps recenzent otrzymuje dwa narzędzia: user_message.search_messages oraz user_message.read_messages, udostępniane za pośrednictwem połączenia Apps i tożsamości należących do sesji nadrzędnej. Każde wywołanie ponownie sprawdza aktualne zasady aplikacji i narzędzi wątku nadrzędnego oraz działa zgodnie z zasadą fail closed, jeśli narzędzie jest wyłączone lub wymaga zatwierdzenia. Dwa klucze [auto_review] pozwalają dostroić tę funkcję: conversation_history_max_output_tokens ogranicza każdą odpowiedź (domyślnie do szacowanych 4 000 tokenów; nadal obowiązują bardziej rygorystyczne limity wątku nadrzędnego), a experimental_conversation_history_prompt zastępuje wbudowane instrukcje pobierania (pusta wartość oznacza użycie ustawień domyślnych). Druga opcjonalna flaga, guardian_root_handoff_context, zawęża materiał z rozmowy głównej dostępny podczas przeglądu agenta roboczego do wiadomości otaczających każde przekazanie mu zadania oraz trzech najnowszych wiadomości. Obie flagi są w fazie rozwoju i domyślnie wyłączone; dokumentacja konfiguracji jeszcze ich nie wymienia.¹⁸²

[features]
guardian_conversation_history_tools = true

[auto_review]
conversation_history_max_output_tokens = 4000

Zaostrzenie klasyfikatora PowerShell (v0.142.2): polecenia PowerShell zawierające wykonywalne regiony AST, których klasyfikator bezpieczeństwa nie potrafi sprawdzić, wymagają teraz zatwierdzenia, zamiast przechodzić przez automatyczne zatwierdzanie — zamyka to lukę, przez którą zaciemniony lub tworzony dynamicznie kod PowerShell mógł uniknąć klasyfikacji w systemie Windows.¹⁰⁵

Rozszerzenie wykrywania niebezpiecznych poleceń (v0.144.5): mechanizm wykrywania rozpoznaje teraz więcej wymuszonych wariantów polecenia rm, a odrzucone polecenia zawierają czytelniejsze uzasadnienia odrzucenia zamiast niejasnej odmowy — jest to przydatne podczas dostrajania zasad zatwierdzania, gdy trzeba ustalić, dlaczego polecenie zostało zablokowane.¹¹⁰

Włączanie dostępu do sieci

Codex domyślnie blokuje dostęp do sieci w trybie workspace-write. W razie potrzeby można go włączyć:

# Per-run
codex -c 'sandbox_workspace_write.network_access=true' "install the packages"

# In config.toml
[sandbox_workspace_write]
network_access = true
writable_roots = ["/path/to/extra/dir"]   # Additional writable directories
exclude_slash_tmp = false                  # Prevent /tmp from being writable
exclude_tmpdir_env_var = false             # Prevent $TMPDIR from being writable

Obsługa serwera proxy WebSocket (v0.104.0+)

W środowiskach korporacyjnych, które kierują ruch WebSocket przez serwer proxy, Codex obsługuje teraz zmienne środowiskowe WS_PROXY i WSS_PROXY:⁴⁹

export WSS_PROXY="https://proxy.corp.example.com:8443"
codex "update the README"

Uzupełniają one istniejącą obsługę HTTPS_PROXY i serwerów proxy SOCKS5 (v0.93.0+).

Dopiero w v0.146.0 obsługa „wszystkich warstw transportowych” stała się rzeczywistością. Skonfigurowane serwery proxy są teraz respektowane podczas uwierzytelniania, pobierania wtyczek, autoryzacji MCP, wykonywania zdalnego, połączeń WebSocket, przekierowań HTTP i połączeń z LM Studio — dziennik zmian wymienia siedem ścieżek, które wcześniej ignorowały serwer proxy.¹¹⁴ Jeśli przed v0.146.0 Codex działał za korporacyjnym serwerem proxy, a logowanie lub instalacja wtyczek kończyły się niepowodzeniem mimo prawidłowego działania zwykłych wywołań modelu, prawdopodobną przyczyną była właśnie ta luka.

Systemowy serwer proxy w macOS (v0.142.2+): po włączeniu respect_system_proxy klienci uwierzytelniania w macOS respektują ustawienia systemowego serwera proxy, PAC i WPAD — dzięki temu na firmowych komputerach Mac, na których konfiguracja proxy jest wdrażana za pomocą profili, ruch uwierzytelniający nie wymaga już zmiennych środowiskowych proxy ustawianych osobno w każdej powłoce.¹⁰⁵ Od v0.143.0 obejmuje to również Windows i ruch Responses API: Codex kieruje zarówno uwierzytelnianie, jak i wywołania Responses API przez systemowy serwer proxy w macOS lub Windows, w tym przez automatyczną konfigurację PAC i WPAD, zamykając ostatnią lukę w ściśle zabezpieczonych sieciach korporacyjnych w obu systemach operacyjnych.¹⁰⁶

Testowanie sandbox

Przed uznaniem sandbox za godny zaufania należy zweryfikować jego działanie:

codex sandbox macos --permissions-profile :workspace -- ls /etc/passwd   # macOS test
codex sandbox linux --permissions-profile :workspace -- cat /etc/shadow  # Linux test

Jeśli sandbox działa prawidłowo, w profilu ograniczonym do przestrzeni roboczej oba polecenia powinny zakończyć się błędem odmowy dostępu. Jeżeli którekolwiek z nich zostanie wykonane pomyślnie, konfiguracja sandbox wymaga sprawdzenia.

Jak działa AGENTS.md?

AGENTS.md to system instrukcji projektowych Codex — otwarty standard⁹, którym obecnie zarządza Agentic AI Foundation działająca przy Linux Foundation. Obsługują go Codex, Cursor, Copilot, Amp, Jules (Google), Gemini CLI, Windsurf, Cline, Aider, Zed, Factory, RooCode oraz ponad 60 000 projektów open source. Określa on sposób działania Codex w konkretnym repozytorium lub folderze. Pakiety wiedzy wielokrotnego użytku, które uzupełniają AGENTS.md, opisano w sekcji Skills.

Hierarchia wykrywania

Na początku sesji Codex tworzy łańcuch instrukcji, przechodząc po drzewie folderów:

1. Globalnie (~/.codex/): AGENTS.override.md > AGENTS.md
2. W projekcie (od głównego folderu repozytorium git do bieżącego folderu): Na każdym poziomie sprawdzane są kolejno AGENTS.override.md > AGENTS.md > zastępcze nazwy plików
3. Scalanie: Pliki są łączone od głównego folderu w dół; pliki znajdujące się bliżej bieżącego folderu pojawiają się później w prompcie i zastępują wcześniejsze wytyczne

~/.codex/AGENTS.md                     ← Global defaults
  └─ /repo/AGENTS.md                   ← Project-wide rules
      └─ /repo/services/AGENTS.md      ← Service-specific rules
          └─ /repo/services/payments/
               AGENTS.override.md      ← Overrides everything above for this dir

Niezaufane projekty pomijają projektowy AGENTS.md (v0.150.0): opisane powyżej przechodzenie zakłada, że projekt jest zaufany. Od wersji v0.150.0 „niezaufane projekty nie dostarczają już instrukcji z projektowego pliku AGENTS.md, a zarządzane reguły odmowy odczytu pozostają egzekwowane po zmianach uprawnień” — wykrywanie w zakresie projektu jest pomijane, natomiast instrukcje użytkownika z ~/.codex/AGENTS.md zostają zachowane, dzięki czemu niezaufana kopia robocza nie może wstrzyknąć zasad działania przed oznaczeniem jej jako zaufanej.¹³²

Projekty wielofolderowe w aplikacji desktopowej (26.715, 23 lipca 2026): opisane powyżej przechodzenie dotyczy CLI, który rozpoznaje wszystko względem bieżącego folderu roboczego. Aplikacja desktopowa ChatGPT pozwala teraz, aby lokalny projekt obejmował kilka powiązanych folderów, ale wykrywanie odbywa się względem dokładnie jednego z nich: „Nowe czaty, operacje Git oraz automatyczne wykrywanie AGENTS.md, skills i config.toml korzystają z folderu głównego. Foldery dodatkowe pozostają dostępne na potrzeby wyszukiwania, odczytywania i edytowania plików”. Folder główny można wybrać z menu projektu za pomocą opcji Edytuj projekt.¹¹³

To jedno ustawienie steruje jednocześnie 3 z 5 podstawowych systemów Codex — instrukcje, skills i konfiguracja korzystają z folderu głównego. W praktyce AGENTS.md znajdujący się w folderze dodatkowym jest plikiem, który Codex może otworzyć, a nie wczytywanym zestawem reguł działania. Jeśli repozytorium zawierające reguły zostało dołączone jako drugie, należy wyznaczyć je jako folder główny albo powtórzyć te reguły w pliku AGENTS.md folderu głównego; to samo dotyczy folderów skills w repozytorium, które miały być automatycznie wykrywane. W sposobie przechodzenia po folderach przez CLI nic się nie zmieniło — jest to jedynie określenie zakresu projektu w aplikacji desktopowej.

Co wyróżnia świetny plik AGENTS.md

Na podstawie bezpośrednich wytycznych samego Codex oraz wzorców stosowanych przez społeczność¹⁰:

NALEŻY: - Formułować konkretne instrukcje: "Use rg --files for discovery" jest lepsze niż "search efficiently" - Określić kryteria ukończenia: Co oznacza „gotowe”? (testy przechodzą, lint nie zgłasza błędów itd.) - Podawać polecenia: budowanie, testowanie, lintowanie i formatowanie (dokładne wywołania) - Organizować treść według zadań: sekcje dotyczące kodowania, przeglądu, wydania oraz incydentów/debugowania - Określić zasady eskalacji: Co zrobić w przypadku blokady lub napotkania nieoczekiwanego stanu

NIE NALEŻY: - Umieszczać całych przewodników po stylu bez reguł wykonawczych - Używać niejednoznacznych poleceń („zachowaj ostrożność”, „zoptymalizuj”) - Łączyć sprzecznych priorytetów (szybkość + wyczerpująca weryfikacja + brak budżetu na uruchamianie) - Pisać dokumentacji opisowej (AGENTS.md to zasady operacyjne, a nie README)

Przykład: produkcyjny AGENTS.md

# Repository Guidelines

## Build, Test, and Development Commands
- Run API (dev): `python3 -m uvicorn main:app --reload`
- Install deps: `pip install -r requirements.txt`
- Lint: `python3 -m ruff check .` (auto-fix: `--fix`)
- Format: `python3 -m ruff format .`
- Tests: `python3 -m pytest -v`
- Coverage: `python3 -m pytest --cov=app --cov-report=term-missing`

## Coding Style & Naming Conventions
- Python 3.11+. Type hints on all functions.
- Ruff enforced: 88-char lines, double quotes, spaces for indent.
- Naming: modules `snake_case.py`, classes `PascalCase`, functions `snake_case`.

## Commit & Pull Request Guidelines
- Conventional Commits: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`, `test:`
- Commits should be small and focused.
- PRs must include: description, test plan, and screenshots for UI changes.

## Security
- Never commit secrets. Use `.env` for local config.
- Validate all external API calls with proper error handling.

Obsługa sekretów w sesjach agenta

Historię widoczną dla Codex należy traktować jako powierzchnię ataku, a nie tylko kod źródłowy. Informacje o wydaniach Codex opisują prace nad migawkami powłoki i redagowaniem zmiennych środowiskowych, a system pamięci skanuje zapisywane dane w poszukiwaniu sekretów. Zabezpieczenia te nie sprawiają jednak, że dane wyjściowe poleceń, transkrypcje sesji, migawki powłoki, lokalne logi czy skrypty pomocnicze stają się bezpiecznymi miejscami do wyświetlania danych uwierzytelniających.³⁷⁵⁵⁹⁵

Reguła działania jest prosta: nie należy wyświetlać sekretów, aby model mógł je analizować; dane uwierzytelniające narzędzi pomocniczych trzeba przechowywać w konfiguracji wymaganej przez środowisko; podczas audytów należy rozdzielać wykonywalny kod źródłowy, dokumentację, wygenerowane pamięci podręczne, transkrypcje sesji, migawki powłoki, logi oraz celowo utworzone magazyny sekretów; lokalną historię trzeba redagować po wykryciu wzorca z dużym prawdopodobieństwem wskazującego na sekret; natomiast hooks zapobiegawcze należy wdrażać dopiero po potwierdzeniu skuteczności ręcznych procedur higieny. Publicznie należy udostępniać mapę powierzchni i kryteria akceptacji, a nie prywatne wartości tokenów, dokładne ścieżki czy szczegóły działania detektorów.⁹⁵

Mechanizm zastępowania

AGENTS.override.md na dowolnym poziomie folderów zastępuje standardowy plik AGENTS.md w danym zakresie. Można go używać na potrzeby:

• Zamrożenia wydania: „Bez nowych funkcji, tylko poprawki”
• Trybu incydentu: „Wszystkie zmiany muszą zostać sprawdzone przez osobę pełniącą dyżur”
• Tymczasowego wzmocnienia zabezpieczeń: „W tym sprincie bez aktualizacji zależności”

Konfiguracja

# Custom fallback filenames (in addition to AGENTS.md)
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]

# Increase max size for large instruction files
project_doc_max_bytes = 65536    # 64 KiB (default: 32 KiB)

Generowanie szkieletu

codex                           # Launch TUI
/init                           # Generate AGENTS.md scaffold

Łańcuch instrukcji można również zweryfikować:

codex --ask-for-approval never "Summarize your current instructions"

Hooks

Codex wprowadził hooks w wersjach v0.99.0 i v0.100.0 pod wcześniejszymi nazwami AfterAgent i AfterToolUse, w wersji v0.114.0 dodał eksperymentalny silnik hooks z wydarzeniami SessionStart i Stop,⁷⁰ a w wersji v0.124.0 (23 kwietnia 2026) nadał hooks status stabilny.⁸⁵ Silnik dostarczany w rust-v0.150.0 rejestruje dwanaście wydarzeń (HOOK_EVENT_NAMES w codex-rs/hooks/src/lib.rs) — jedenaście w wersji v0.149.1, a Interrupt dodano jako dwunaste w wersji v0.150.0¹³² — natomiast wcześniejsze nazwy zniknęły z konfigurowalnego interfejsu: AfterToolUse nie występuje już nigdzie w drzewie źródłowym, a AfterAgent zachowano wyłącznie jako wewnętrzną nazwę ładunku wcześniejszego mechanizmu pośredniczącego notify.¹²⁴ Hooks uruchamiają skrypty lub narzędzia MCP podczas pętli agentowej. Uruchamiane są wszystkie pasujące hooks z wielu plików, wiele pasujących hooks poleceń dla jednego wydarzenia jest uruchamianych równolegle, a każdy hook niezarządzany musi przed uruchomieniem zostać sprawdzony i oznaczony jako zaufany.¹²⁴ Wersja v0.148.0 rozszerza silnik: hooks mogą uruchamiać polecenia asynchronicznie i wywoływać narzędzia MCP — ustawienie async = true w procedurze obsługi polecenia pozwala uruchomić ją w tle, podczas gdy Codex kontynuuje pracę, natomiast procedura obsługi mcp_tool umożliwia korzystanie z tych samych serwerów MCP, których używa agent.¹¹⁸¹²⁴

Dostępne wydarzenia hooks

Narzędzia hostowane, takie jak WebSearch, nie przechodzą przez ścieżkę hooks, a niektóre wyspecjalizowane ścieżki narzędzi mogą ją pomijać; według OpenAI jest to „przydatne zabezpieczenie, lecz nie kompletna granica egzekwowania zasad”.¹²⁴

Konfiguracja hooks

Hooks są zorganizowane na trzech poziomach — wydarzenie, grupa dopasowania oraz co najmniej jedna procedura obsługi — i znajdują się w pliku hooks.json (~/.codex/hooks.json, <repo>/.codex/hooks.json albo hooks/hooks.json wtyczki) lub bezpośrednio w config.toml i requirements.toml. Lokalne hooks projektu są wczytywane tylko wtedy, gdy warstwa .codex/ projektu jest zaufana.¹²⁴ Wbudowana forma TOML:

# ~/.codex/config.toml or <repo>/.codex/config.toml
[[hooks.SessionStart]]
matcher = "startup|resume"

[[hooks.SessionStart.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/session_start.py"
additionalContextLimit = 5000

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = '/usr/bin/python3 "$(git rev-parse --show-toplevel)/.codex/hooks/pre_tool_use_policy.py"'
timeout = 30
statusMessage = "Checking Bash command"

[[hooks.PostToolUse]]
matcher = "^Bash$"

[[hooks.PostToolUse.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/post_tool_use_review.py"
async = true
timeout = 120

Pola procedury obsługi: type (command lub mcp_tool; procedury obsługi prompt i agent są analizowane, lecz pomijane), command, timeout w sekundach (domyślnie 600; dla SessionEnd 1 sekunda, maksymalnie 3), statusMessage, additionalContextLimit (określa, jaka część additionalContext trafia do modelu, zanim Codex zapisze pełny tekst na dysku i wyśle podgląd), commandWindows (nadpisanie tylko dla systemu Windows) oraz async. Polecenia są uruchamiane z katalogiem roboczym ustawionym na cwd sesji, dlatego hooks lokalne dla repozytorium powinny wyznaczać ścieżki na podstawie git rev-parse --show-toplevel, zamiast używać względnej ścieżki .codex/hooks/....¹²⁴

Weryfikacja i zaufanie. Codex zapisuje zaufanie względem bieżącego skrótu każdego niezarządzanego hooka; nowe lub zmienione hooks są oznaczane jako wymagające weryfikacji i pomijane do czasu uznania ich za zaufane. Polecenie /hooks pozwala sprawdzić źródła hooks, zweryfikować je, oznaczyć jako zaufane lub wyłączyć pojedyncze hooks; gdy podczas uruchamiania hooks wymagają weryfikacji, Codex wyświetla ostrzeżenie wskazujące /hooks. Zarządzane hooks ze źródeł systemowych, MDM, chmurowych lub requirements.toml są zaufane na mocy zasad i nie można ich wyłączyć w przeglądarce hooks użytkownika. Opcja --dangerously-bypass-hook-trust uruchamia włączone hooks bez trwałego zapisywania zaufania dla pojedynczego wywołania; służy do automatyzacji, która weryfikuje źródła hooks w innym miejscu.¹²⁴

Dane wyjściowe stdout hooka SessionStart trafiają do kontekstu modelu, dzięki czemu hook ten doskonale nadaje się do wstrzykiwania dynamicznych informacji (dat, nazw gałęzi, zmiennych środowiskowych) podczas rozpoczynania sesji.

Odtwarzanie wzorców hooks z Claude Code

Dla zaimplementowanych wydarzeń Codex używa tych samych nazw co Claude Code, dlatego większość konfiguracji hooks można przenieść, umieszczając JSON w hooks.json i oznaczając ją jako zaufaną za pomocą /hooks:

Wskazówka ekspercka: nowe wydarzenia hooks nadal pojawiają się w kolejnych wersjach — w wersji v0.150.0 dodano wydarzenie Interrupt (¹³²) — dlatego aktualną listę należy sprawdzać w HOOK_EVENT_NAMES w codex-rs/hooks/src/lib.rs oraz w dzienniku zmian Codex.

Przeglądarka hooks w TUI (v0.129.0): polecenie /hooks w TUI pozwala odkrywać dostępne hooks, sprawdzać, które są obecnie aktywne, oraz przełączać poszczególne hooks bez edytowania config.toml. Przydaje się to podczas diagnozowania nieprawidłowo działającego hooka dostarczanego z wtyczką albo tymczasowego wyłączania lintera PostToolUse na czas intensywnej sesji edycji.⁸⁹

Czym jest MCP (Model Context Protocol)? [EXPERIMENTAL]

MCP rozszerza możliwości Codeksa, łącząc go z zewnętrznymi narzędziami i usługami. Grupa poleceń codex mcp jest obecnie oznaczona jako eksperymentalna, a same polecenia oraz format konfiguracji mogą się zmieniać między wydaniami. Codex obsługuje dwa typy transportu: STDIO (procesy lokalne) oraz Streamable HTTP (serwery zdalne).¹¹

Zmiany w MCP w v0.121.0: Narzędzia są teraz rejestrowane z przestrzenią nazw, więc na listach pojawiają się jako <server>:<tool>, a nie pod samymi nazwami — warto zaktualizować skrypty i prompty, które przeszukują niekwalifikowane nazwy narzędzi. Do dołączonych MCPs przekazywana jest nowa flaga supports_parallel_tool_calls, umożliwiająca równoległe wykonywanie dla serwerów, które deklarują takie wsparcie. Metadane stanu sandboxa przepływają teraz przez metadane narzędzi MCP, dzięki czemu serwery mogą dostosowywać zachowanie (np. ostrzegać przy pracy w sandboxie read-only). Niestandardowe żądanie codex/sandbox-state zostało usunięte — zamiast niego należy korzystać ze ścieżki metadanych. Tutaj trafia też faza 3 wdrożenia MCP Apps wraz z obsługą wywołań narzędzi; spłaszczone odroczone wywołania narzędzi są już obsługiwane dla serwerów stosujących wzorzec deferred-call.⁸²

Zmiany w MCP w v0.142.2 (25 czerwca 2026): Narzędzia MCP korzystają teraz domyślnie z wyszukiwania narzędzi, jeśli jest obsługiwane — zamiast ładować z góry wszystkie definicje narzędzi, Codex odkrywa je na żądanie, co poprawia wykrywalność w konfiguracjach z dużą liczbą narzędzi, zachowując przy tym zgodność ze starszymi modelami i dostawcami. Zdalne serwery MCP w trybie stdio akceptują również bezwzględne katalogi robocze zapisane w formacie ścieżek platformy zdalnej (ścieżka w stylu Windows przekazana z klienta macOS lub odwrotnie).¹⁰⁵

Zmiany w MCP w v0.147.0 (7 sierpnia 2026): Codex dodaje opcjonalną obsługę rewizji protokołu MCP 2026-07-28 — stronicowane odkrywanie (duże katalogi narzędzi przychodzą stronami zamiast jednej przerośniętej listy), żądania wielorundowe (serwer może prowadzić wieloetapową wymianę w obrębie jednego logicznego żądania) oraz nieblokujący start serwera, gdzie zapamiętane w pamięci podręcznej narzędzia MCP są udostępniane, zanim serwer zakończy uruchamianie, dzięki czemu wolny serwer nie wstrzymuje już startu sesji. Jest to opcja włączana świadomie, więc serwery na starszej rewizji działają bez zmian.¹¹⁶

Zmiany w MCP w v0.151.0 (29 sierpnia 2026): Opcjonalne serwery MCP zyskują konfigurowalny okres karencji przy starcie – mcp_optional_startup_grace_ms (domyślnie 1 000 ms) określa, jak długo przechwytywanie katalogu narzędzi czeka na opcjonalne serwery, wartość 0 wyłącza wspólną karencję, przez co opcjonalne serwery wracają do skonfigurowanego startup_timeout_sec, a zaktualizowane wartości obowiązują w trakcie działania oraz przy odświeżaniu konfiguracji MCP. Rozszerzenia mogą też przeglądać lub podmieniać wyniki narzędzi MCP, zanim dotrą one do modelu: ToolLifecycleContributor::on_mcp_tool_result uruchamia się przed opublikowaniem zakończenia MCP i przed przygotowaniem wyniku dla modelu, zarówno dla wyników pomyślnych, jak i błędnych, również poprzez Code Mode.¹³⁴

Zmiany w MCP w v0.152.0 (1 września 2026): Trzy zmiany o charakterze uzupełniającym. Pojawiają się żądania formularzy openai/elicitation: Codex ogłasza obsługę formularzy, gdy klient deklaruje zdolność form o wartości obiektowej, obsługuje żądania openai/elicitation/create i przekazuje ich metadane oraz nieprzezroczysty schemat przez app server jako openaiForm (zachowując adnotacje x-openai-*); dotychczasowa obsługa openai/form pozostaje niezależna, a TUI automatycznie odrzuca żądania formularzy, których nie potrafi wyrenderować. Limity wyjścia per narzędzie: każdy wpis w konfiguracji tools serwera MCP przyjmuje dodatni output_token_limit (na przykład [mcp_servers.context7.tools.search] z output_token_limit = 2000); przy nakładaniu się polityk wtyczki i użytkownika wygrywa limit najbardziej restrykcyjny, a obowiązujący budżet jest przenoszony w historii rozmowy, dzięki czemu wyjście narzędzia, odpowiedzi hooków post-tool oraz wznowione sesje są przycinane do tego samego limitu – działa to uzupełniająco wobec globalnego tool_output_token_limit. Nazwy serwerów w stylu pakietów: nazwy serwerów MCP mogą teraz zawierać :, @, / i . (więc npm:@modelcontextprotocol/server-sequential.thinking jest poprawną nazwą), zachowywane w mcp add/get/list/remove, w przestrzeniach nazw narzędzi w czasie działania oraz przy wyszukiwaniu poświadczeń OAuth, przy czym nazwy inne niż proste są cytowane w generowanych podpowiedziach naprawczych dla config.toml.¹³⁸

Konfigurowanie serwerów MCP

Serwery STDIO (procesy lokalne):

# In ~/.codex/config.toml or .codex/config.toml

[mcp_servers.context7]
enabled = true
required = true                         # Fail startup if unavailable
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env = { "MY_VAR" = "value" }            # Static env vars
env_vars = ["PATH", "HOME"]             # Forward host env vars
cwd = "/path/to/project"                # Optional working directory
startup_timeout_sec = 10
tool_timeout_sec = 60
enabled_tools = ["search", "summarize"]  # Tool allowlist
disabled_tools = ["slow-tool"]           # Tool denylist

Serwery HTTP (zdalne):

[mcp_servers.figma]
enabled = true
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }
env_http_headers = { "X-Org-Id" = "FIGMA_ORG_ID" }  # Headers from env vars
startup_timeout_sec = 10
tool_timeout_sec = 60

Zarządzanie CLI

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp add context7 --env API_KEY=... -- npx -y @upstash/context7-mcp   # With env vars
codex mcp add figma --url https://mcp.figma.com/mcp --bearer-token-env-var FIGMA_OAUTH_TOKEN
codex mcp list                          # List all configured servers
codex mcp list --json                   # JSON output
codex mcp get context7                  # Show server config
codex mcp get context7 --json           # JSON output
codex mcp login <server>                # OAuth flow for HTTP servers
codex mcp logout <server>               # Remove OAuth credentials
codex mcp remove <server>               # Delete server definition

W trakcie sesji: /mcp pokazuje aktywne serwery i dostępne narzędzia. /mcp verbose (v0.123.0+)⁸⁴ zwraca pełną diagnostykę serwera, zasoby oraz szablony zasobów — przydatne, gdy serwer nie chce się załadować albo narzędzia nie pojawiają się tam, gdzie powinny. Samo /mcp pozostaje szybkie. Od v0.144.0 narzędzia MCP mogą prosić o uwierzytelnienie interaktywnie, bez eksperymentalnej opcji włączanej świadomie — serwer wymagający uwierzytelnienia w trakcie sesji wyświetla monit w normalnym przepływie, zamiast zgłaszać błąd do czasu wcześniejszego uwierzytelnienia poleceniem codex mcp login.¹⁰⁷

Ładowanie MCP z wtyczek (v0.123.0+) akceptuje zarówno standardowy schemat mcpServers, jak i mapy serwerów na najwyższym poziomie w .mcp.json, dzięki czemu wtyczki napisane według dowolnej z tych konwencji ładują się bez problemu.⁸⁴

Weryfikacja użytkownika w MCP (v0.155.0, obsługiwane Maki): lokalne sesje TUI na obsługiwanych Makach mogą weryfikować żądania MCP za pomocą Touch ID, z podpisem Secure Enclave (#43624, #43712, #43715). Tożsamość weryfikacyjna jest ograniczona do przestrzeni roboczej, w której ją zarejestrowano (#43524), a weryfikacja przenosi się natywnie na kontynuacje narzędzi MCP (#44346). Po raz pierwszy obserwowane na liście kontrolnej promocji v2.68, wycięte z 0.154.0 wraz z klastrem alpha.7, wydane w 0.155.0.¹⁵⁶

Uruchamianie Codeksa JAKO serwera MCP

Usunięte (v0.154.0, 9 września 2026). Polecenie codex mcp-server oraz samodzielny plik binarny codex-mcp-server zniknęły w stabilnym wydaniu 0.154.0 (#42993), co domyka deprecjację z 24 sierpnia 2026. Oficjalny changelog (5 września 2026): „Polecenie codex mcp-server i samodzielny plik binarny codex-mcp-server zostały usunięte po ich deprecjacji 24 sierpnia 2026. Przed aktualizacją Codeksa należy zaktualizować integracje, które uruchamiają któreś z tych poleceń.” Integracje powinny celować w protokół app-server, czyli interfejs stojący za rozszerzeniem VS Code i aplikacją desktopową (uwierzytelnianie, historia rozmów, zatwierdzenia, strumieniowane zdarzenia agenta) – który sam wpis o usunięciu określa jako eksperymentalny i „nieobsługiwany w obciążeniach produkcyjnych” – albo, od strony Claude Code, we wtyczkę Codex dla Claude Code: „Używaj Codeksa z poziomu Claude Code do przeglądu kodu lub delegowania zadań.” Łączenie Codeksa DO zewnętrznych serwerów MCP (codex mcp ..., /mcp) pozostaje bez zmian.^125152153

W CLI 0.153.4 i wcześniejszych polecenie nadal istnieje (deprecjonowane od 24 sierpnia 2026; od v0.149.0 wypisuje na stderr warning: `codex mcp-server` is deprecated and will be removed in a future release. i mimo to startuje, PR #39657), więc przypięcie npm install -g @openai/codex@0.153.4 jest rozwiązaniem awaryjnym, jeśli integracji nie da się od razu zmigrować:^12125148152

codex mcp-server                        # REMOVED in 0.154.0; works only on 0.153.x and earlier (deprecated, warns)

W 0.153.x i wcześniejszych serwer udostępnia dwa narzędzia: 1. codex(): Rozpoczyna nową sesję z parametrami promptu, sandboxa, modelu i zatwierdzania 2. codex-reply(): Kontynuuje istniejącą sesję przy użyciu threadId i promptu

Użycie z Agents SDK (Python) – wyłącznie CLI 0.153.4 lub wcześniejszy:

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async with MCPServerStdio(
    name="Codex CLI",
    params={"command": "npx", "args": ["-y", "@openai/codex@0.153.4", "mcp-server"]},  # pin: removed in 0.154.0
    client_session_timeout_seconds=360000,
) as codex_mcp_server:
    agent = Agent(name="Developer", mcp_servers=[codex_mcp_server])
    result = await Runner.run(agent, "Fix the failing tests")

Godne uwagi serwery MCP

Wzorce praktyczne

Wzorzec 1: Programowanie świadome kontekstu — warto połączyć Context7 z dokumentacją własnego frameworka, aby Codex zawsze miał aktualne odniesienia do API:

[mcp_servers.context7]
enabled = true
required = true
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

Wzorzec 2: Limity wyjścia — odpowiedzi narzędzi MCP są domyślnie przycinane do około 25 tys. znaków. W przypadku narzędzi zwracających duże ładunki (zapytania do bazy danych, zrzuty logów) należy użyć enabled_tools, aby ograniczyć się do wybranych narzędzi i utrzymać zwięzłość odpowiedzi.

Wzorzec 2a: Multimodalne wyjście narzędzi (v0.107.0) — niestandardowe narzędzia mogą teraz zwracać wyjście multimodalne (obrazy, bogate treści) obok tekstu. Pozwala to narzędziom tworzącym artefakty wizualne — zrzuty ekranu, diagramy, renderowane wykresy — przekazywać je bezpośrednio do modelu w celu analizy.⁶²

Wzorzec 3: Firmowe zarządzanie MCP — warto ograniczyć, z których serwerów MCP mogą korzystać programiści, za pomocą requirements.toml:

# In /etc/codex/requirements.toml — only approved servers allowed
[mcp_servers.approved-internal]
identity = { command = "npx @company/internal-mcp" }

Każdy serwer, który nie odpowiada tożsamości wskazanej w requirements.toml, zostanie zablokowany przy starcie. Pełną konfigurację polityk opisuje sekcja Wdrożenie w przedsiębiorstwie.

Code Mode [EKSPERYMENTALNY]

Code mode (v0.114.0) zapewnia bardziej odizolowane przepływy pracy programistycznej, ograniczając zakres działania agenta do operacji związanych z kodem.⁷⁰ Po włączeniu agent koncentruje się na odczytywaniu, pisaniu i testowaniu kodu bez szerszych interakcji z systemem.

Od wersji v0.139.0 code mode może wywoływać samodzielne wyszukiwanie w internecie bezpośrednio — również z poziomu zagnieżdżonych wywołań narzędzi JavaScript — i otrzymuje wyniki w postaci zwykłego tekstu, dzięki czemu przepływ pracy w code mode może pobierać aktualne informacje bez opuszczania izolowanego kontekstu programistycznego.¹⁶⁵ Wersja v0.146.0 rozszerza samodzielne wyszukiwanie w internecie na zgodnych niestandardowych dostawców modeli, więc funkcja nie jest już ograniczona do modeli hostowanych przez OpenAI.¹¹⁴

Wersja v0.146.0 umożliwiła app-server łączenie się ze zdalnymi hostami Code Mode, dzięki czemu środowisko wykonawcze code mode nie musi już działać na tym samym urządzeniu co klient — pierwotnie po WebSocket.¹¹⁴ Wersja v0.151.0 usuwa transport WebSocket (#40692): połączenia app server --code-mode-host akceptują wyłącznie punkty końcowe gRPC http:// i https://, a samodzielny host code mode obsługuje tylko odbiorniki stdio i gRPC — w tagu rust-v0.151.0 dokumentacja odbiornika brzmi dosłownie: „Transport endpoint: stdio, stdio://, or grpc://IP:PORT”. WebSocket pozostaje jedynie opcjonalnym punktem końcowym przesyłającym strumieniowo nieprzetworzone partie śladów OTLP na potrzeby śledzenia, a nie transportem sesji.¹³⁵

Ta funkcja jest eksperymentalna. Aktualne informacje należy sprawdzać w informacjach o wydaniach.

Środowisko wykonawcze REPL JavaScript [USUNIĘTE]

W Codex v0.100.0 dodano eksperymentalne środowisko wykonawcze REPL JavaScript (js_repl), a w wersji v0.106.0 udostępniono je za pośrednictwem /experimental.⁶⁰ Te informacje mają już charakter historyczny. W dzienniku zmian wersji v0.128.0 znajduje się wpis „Remove js_repl feature”, a bieżąca lista funkcji oznacza zarówno js_repl, jak i js_repl_tools_only jako usunięte.⁸⁶

Do nowych konfiguracji nie należy dodawać features.js_repl = true. Gdy potrzebna jest powtarzalna logika wykonywalna, należy używać poleceń powłoki, skryptów zapisanych w repozytorium, narzędzi MCP albo skills Codex z folderem scripts/.

Czym są skills?

Skills to wielokrotnego użytku pakiety funkcji przeznaczone do konkretnych zadań, które Codex ładuje na żądanie. Są zgodne z otwartym standardem agent skills.¹³

Struktura skill

my-skill/
  SKILL.md           (required: instructions)
  scripts/           (optional: executable scripts)
  references/        (optional: reference docs)
  assets/            (optional: images, icons)
  agents/openai.yaml (optional: metadata, UI, dependencies)

Lokalizacje wykrywania

Codex przechowuje skills zainstalowane przez użytkownika w $CODEX_HOME/skills (domyślnie: ~/.codex/skills), w tym wbudowane skills systemowe w .system/. Codex obsługuje foldery skills będące dowiązaniami symbolicznymi.

Tworzenie skill

Format SKILL.md:

---
name: security-audit
description: Run a thorough security audit on the codebase.
---

## Security Audit Procedure

1. Scan for hardcoded secrets using `rg -i "(api_key|password|secret|token)\s*=" --type py`
2. Check for SQL injection: look for string interpolation in queries
3. Verify input validation on all API endpoints
4. Check dependency vulnerabilities: `pip audit` or `npm audit`
5. Review authentication and authorization patterns
6. Report findings with severity levels (Critical/High/Medium/Low)

Metadane (agents/openai.yaml):

interface:
  display_name: "Security Audit"
  short_description: "Full codebase security review"
  icon_small: "./assets/shield.svg"
  brand_color: "#DC2626"
  default_prompt: "Run a security audit on this repository"

policy:
  allow_implicit_invocation: false    # Require explicit $skill

dependencies:
  tools:
    - type: "mcp"
      value: "snyk"
      transport: "streamable_http"
      url: "https://mcp.snyk.io/mcp"

Wywoływanie skills

• Jawnie: menu /skills lub wzmianka $skill-name w poleceniu
• Niejawnie: Codex automatycznie wykrywa pasujące skills na podstawie opisu zadania (jeśli allow_implicit_invocation: true)
• Kreator: $skill-creator umożliwia interaktywne utworzenie nowej skill
• Instalator: $skill-installer install <name> umożliwia zainstalowanie skills społeczności
• Udostępniane przez executor (v0.146.0): Codex wykrywa skills oferowane przez executor i odczytuje powiązane z nimi zasoby, w tym skills wybrane jawnie¹¹⁴

Budżety kontekstu powodują skracanie katalogów skills. Wersja v0.146.0 zachowuje więcej dostępnych skills przy ograniczonym kontekście i ostrzega, gdy katalog musi zostać skrócony.¹¹⁴ Wcześniej duża biblioteka skills mogła zostać skrócona bez ostrzeżenia, przez co oczekiwana skill nie była oferowana w bieżącym zakresie. Jeśli korzysta się z niejawnego wywoływania wielu skills, należy zwracać uwagę na to ostrzeżenie.

Włączanie i wyłączanie

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Skills a slash commands

Debugowanie skills

Jeśli skill się nie aktywuje:

1. Sprawdzić wykrywanie: /skills powinno wyświetlać ją w TUI
2. Zweryfikować ścieżkę: upewnić się, że folder skill znajduje się w rozpoznawanej lokalizacji (~/.codex/skills/, katalogu głównym projektu lub /etc/codex/skills/)
3. Sprawdzić enabled: skills z ustawieniem enabled = false w config.toml nie zostaną załadowane
4. Sprawdzić niejawną aktywację: jeśli używane jest automatyczne wykrywanie, upewnić się, że w agents/openai.yaml ustawiono allow_implicit_invocation: true
5. Użyć słów kluczowych: uwzględnić w poleceniu terminy z pola description danej skill, aby zwiększyć skuteczność niejawnego dopasowania

Przykład produkcyjny: skill do wdrażania

Kompletna, wieloplikowa skill pokazująca współdziałanie materiałów referencyjnych i skryptów:

deploy-skill/
  SKILL.md
  references/
    runbook.md
    rollback-checklist.md
  scripts/
    pre-deploy-check.sh
    smoke-test.sh
  agents/openai.yaml

SKILL.md:

---
name: deploy
description: Deploy the application to staging or production. Runs pre-flight checks, executes deployment, and verifies with smoke tests.
---

## Deployment Procedure

### Pre-flight
1. Run `scripts/pre-deploy-check.sh` to verify:
   - All tests pass
   - No uncommitted changes
   - Branch is up to date with remote
2. Review the runbook at `references/runbook.md` for environment-specific steps.

### Deploy
3. Execute the deployment command for the target environment.
4. Monitor logs for errors during rollout.

### Verify
5. Run `scripts/smoke-test.sh <environment-url>` to confirm critical paths.
6. If smoke tests fail, follow `references/rollback-checklist.md`.

Wywołanie: $deploy to staging lub $deploy production with canary rollout

Plugins

Plugins łączą skills, wpisy MCP, hooks i konektory aplikacji w jeden instalowalny pakiet (v0.110.0+).⁶⁵ Od v0.117.0 plugins są pełnoprawnymi elementami produktu: plugins o zakresie produktowym synchronizują się automatycznie podczas uruchamiania, a /plugins udostępnia przeglądarkę w TUI służącą do ich wyszukiwania i zarządzania nimi.⁷⁵ W v0.128.0 rozszerzono przepływy pracy związane z plugins o instalowanie z marketplace, buforowanie zdalnych pakietów, zdalne punkty końcowe odinstalowywania API, hooks dołączane do plugins, stan włączenia hooks oraz import konfiguracji zewnętrznych agentów.⁸⁶ v0.129.0 (7 maja 2026) dodaje udostępnianie plugins w workspace (przekazywanie zestawu plugins członkom zespołu bez ponownego publikowania), kontrolę dostępu do udostępnionych zasobów (włączanie lub wyłączanie dla poszczególnych odbiorców oraz cofanie dostępu), filtrowanie źródeł (ograniczanie marketplace, z których korzysta workspace) oraz operacje marketplace, które można wywoływać bezpośrednio z przeglądarki /plugins zamiast z CLI.⁸⁹ v0.133.0 (21 maja 2026) ułatwia kontrolowanie procesu wyszukiwania plugins: dane wyjściowe listy uwzględniają marketplace, widoczne są zainstalowane wersje i katalogi główne marketplace, a zdalne kolekcje plugins można wyświetlać bez zgadywania, z którego rejestru pochodzi dany wynik.⁹⁸ v0.130.0 (8 maja 2026) zwiększa przejrzystość pakowania plugins i zapewnia większą kontrolę nad przepływem udostępniania:⁹¹

• Hooks dołączone do plugin są widoczne w jego szczegółach. Widok szczegółów /plugins pokazuje teraz każdy hook cyklu życia dołączony do plugin (SessionStart, UserPromptSubmit, Stop itd.). Przed zainstalowaniem plugin można dokładnie sprawdzić, które hooks zarejestruje w sesji — koniec z niespodziewanymi skutkami ubocznymi hooks pochodzących z plugin, któremu zaufano wyłącznie ze względu na jego narzędzia.
• Metadane udostępniania plugin w shareContext. Gdy plugin jest udostępniany z workspace, ładunek odsyłacza do udostępniania ujawnia teraz metadane odsyłacza (twórcę, zakres i aktualność), dzięki czemu sesje odbierające mogą wyświetlić pochodzenie i zdecydować, czy go zaakceptować.
• Kontrola wykrywalności w ustawieniach udostępniania. Ustawienia udostępniania zawierają przełącznik wykrywalności, dzięki któremu zespoły mogą publikować plugins w określonych workspaces lub dla konkretnych list odbiorców, nie udostępniając ich jednocześnie w ogólnych wykazach całej organizacji.

v0.143.0 (8 lipca 2026) domyślnie włącza zdalne plugins. Zdalne plugins są teraz dostępne bez flagi wyrażającej zgodę, katalog /plugins otrzymuje bardziej szczegółowe wiersze (źródła marketplace npm obok git i źródeł lokalnych), a każdy wpis pokazuje zarówno wersję zdalną, jak i zainstalowaną lokalnie, dzięki czemu rozbieżności są widoczne na pierwszy rzut oka.¹⁰⁶ Zespoły standaryzujące wspólny zestaw plugins nie muszą już włączać ich oddzielnie na każdym komputerze, co wcześniej blokowało wdrożenie.

Źródła plugins

Od v0.147.0 wyszukiwanie plugins obejmuje w jednym zapytaniu katalogi lokalne, osobiste, workspace i zdalne — wyszukuje się funkcję, a nie katalog, w którym akurat się ona znajduje. W połączeniu z przenośnymi pakietami Agent Plugins oznacza to, że plugin utworzony w jednym środowisku można bezproblemowo zainstalować w innym, bez przywiązania do komputera lub workspace, w którym powstał.¹¹⁶

Wyszukiwanie plugins

Codex informuje model na początku sesji, które plugins są włączone (v0.111.0), co ułatwia wykrywanie zainstalowanych MCP, aplikacji i skills.⁶⁵ Na podstawie kontekstu zadania model może sugerować podczas sesji odpowiednie plugins. W v0.117.0 plugins o zakresie produktowym są synchronizowane podczas uruchamiania, dzięki czemu najnowszy katalog plugins jest dostępny bez ręcznej ingerencji.⁷⁵ Od v0.142.0 menu /plugins porządkuje zdalne plugins w sekcjach Wyselekcjonowane przez OpenAI, Workspace oraz Udostępnione mi, a w kwalifikujących się turach można bezpośrednio rekomendować i instalować odpowiednie plugins.¹⁰⁴ Od v0.151.0 plugin/list i plugin/installed wczytują obowiązującą konfigurację plugins dla każdego żądanego cwd – lokalne marketplaces są łączone w kolejności żądań, stan instalacji i włączenia jest scalany między repozytoriami, a nieprawidłowe konfiguracje projektu są zgłaszane za pośrednictwem marketplaceLoadErrors bez pomijania prawidłowych katalogów lokalnych ani globalnie włączonych katalogów zdalnych.¹³⁴

Wzmianki @plugin (v0.112.0+)

Do dowolnego zainstalowanego plugin można odwołać się bezpośrednio na czacie za pomocą @plugin-name.⁶⁸ Po wspomnieniu plugin jego kontekst (możliwości, narzędzia i konfiguracja) jest automatycznie dołączany do okna kontekstowego modelu — nie trzeba opisywać jego działania.

@deploy push this branch to staging with canary rollout
@linter check for unused imports in src/

Mechanizm ten działa z każdym zainstalowanym plugin, w tym z niestandardowymi skills, serwerami MCP i konektorami aplikacji.

Marketplace plugins (v0.113.0+)

Marketplace plugins oferuje teraz bogatsze możliwości wyszukiwania dzięki metadanym, kategoriom i ocenom.⁶⁹ Kontrole uwierzytelniania przeprowadzane podczas instalacji sprawdzają, czy plugins wymagające kluczy API lub OAuth mają prawidłowe dane uwierzytelniające. Punkt końcowy odinstalowywania umożliwia prawidłowe usunięcie plugins i powiązanej z nimi konfiguracji.

Dodawanie zewnętrznych marketplaces (v0.121.0+)

Aktualna dokumentacja OpenAI Codex opisuje zarządzanie źródłami marketplace w ramach codex plugin marketplace. Formalizuje to dystrybucję plugins innych firm poza własnym marketplace OpenAI i obsługuje skróconą notację repozytoriów GitHub, adresy URL Git przez HTTP(S), adresy URL SSH oraz lokalne katalogi główne marketplace; opcja --ref pozwala przypiąć konkretny ref Git, natomiast powtarzalnej opcji --sparse PATH należy używać wyłącznie w przypadku repozytoriów marketplace opartych na Git.⁹³

# GitHub repository (shorthand)
codex plugin marketplace add owner/repo

# Arbitrary git URL
codex plugin marketplace add https://git.example.com/team/plugins.git

# SSH Git URL
codex plugin marketplace add git@example.com:team/plugins.git

# Local directory
codex plugin marketplace add /path/to/local/marketplace

# Upgrade or remove a configured marketplace
codex plugin marketplace upgrade <marketplace-name>
codex plugin marketplace remove <marketplace-name>

Po dodaniu plugins z danego marketplace pojawiają się w przeglądarce /plugins obok domyślnych pozycji. Wywołujący serwer aplikacji (integracje IDE/aplikacji desktopowych) mają do dyspozycji równoległy punkt końcowy umożliwiający programowe rejestrowanie marketplaces.⁸²

Kwestia bezpieczeństwa: Marketplaces innych firm uruchamiają dowolny kod plugins z uprawnieniami Codex. Przed dodaniem należy zweryfikować źródła, a przy pierwszych uruchomieniach preferować wykonywanie w sandbox.

Agent Plugins: standard obsługiwany przez różnych dostawców (v0.146.0–v0.147.0)

„Agent Plugins” to nie tylko nazwa funkcji Codex — jest to otwarty, neutralny względem dostawców standard pakowania, opublikowany jako Agent Plugins 1.0.0 6 sierpnia 2026, którego oficjalna strona opisuje go jako „przenośny format pakietów wielokrotnego użytku, które rozszerzają agentów AI”.¹⁶¹ Plugin jest katalogiem z wymaganym manifestem plugin.json (zamkniętym schematem zawierającym dokładnie 10 dozwolonych pól najwyższego poziomu — $schema, name, version, description, author, homepage, repository, license, keywords, extensions — przy czym „klienci MUSZĄ zgłaszać i ignorować każde nieznane pole”), opcjonalnym folderem skills/ (każdy bezpośredni katalog podrzędny zawierający SKILL.md stanowi jedną skill), opcjonalnym plikiem mcp.json deklarującym serwery stdio, Streamable HTTP lub starsze HTTP+SSE oraz opcjonalnymi katalogami przestrzeni nazw klienta w odwrotnej notacji domenowej, które inni klienci „MUSZĄ ignorować”. Jego normatywnym zakresem jest pakowanie: specyfikacja „definiuje kanoniczną specyfikację Agent Plugins v1.0.0 służącą do pakowania komponentów wielokrotnego użytku, które rozszerzają agentów AI, w dystrybuowalne plugins” — Agent Skills i MCP zachowują własne, bazowe specyfikacje.¹⁶¹

Kluczową rolę odgrywa tu model zarządzania. Vercel zainicjował propozycję i opracował specyfikację 1.0 wspólnie z Amazon, Anysphere (Cursor), GitHub, Microsoft i OpenAI; lista opiekunów repozytorium specyfikacji obejmuje przedstawicieli Amazon, Cursor, Microsoft, OpenAI i Vercel, a Google ogłosiło w dniu premiery, że dołącza do grona głównych opiekunów.¹⁶¹ Wśród wymienionych klientów dostępnych w dniu premiery znajdują się ChatGPT, Codex, Cursor, GitHub Copilot, Kiro i VS Code. Zwraca uwagę brak Anthropic, twórcy bazowego formatu Agent Skills i samego MCP, którego nie ma w gronie opiekunów — Claude Code zachowuje własny format plugins, a Codex niweluje tę różnicę po swojej stronie za pomocą źródła marketplace Claude Code (v0.146.0) oraz /import.¹⁶¹

W terminologii Codex: v0.146.0 dodaje manifesty Agent Plugins, publikowanie plugins w workspace oraz 2 dodatkowe marketplaces plugins — Amazon Bedrock i Claude Code¹¹⁴ — natomiast v0.147.0 domyka cały proces, umożliwiając instalowanie przenośnych Agent Plugins oraz wyszukiwanie w katalogach lokalnych, osobistych, workspace i zdalnych.¹¹⁶ Dla zespołów najbardziej praktycznym elementem jest publikowanie w workspace: plugins można publikować we własnym workspace, zamiast uruchamiać publiczny marketplace lub wymagać od każdego dewelopera ręcznego dodania źródła Git.

Informacje o wydaniu zapowiadają interfejsy Codex, lecz nie podają ich kluczy konfiguracyjnych ani składni CLI. Ten wpis dokumentuje udostępnienie funkcji oraz zakres określony przez standard, ale nie sposób korzystania z niej w Codex — przepływ tworzenia manifestu i każde wywołanie codex plugin publish należy traktować jako niezweryfikowane, dopóki nie zostaną opisane w dokumentacji OpenAI.

Zarządzanie plugins

codex plugin marketplace add <src>       # Add a marketplace source
codex plugin marketplace upgrade [name]  # Upgrade one marketplace or all
codex plugin marketplace remove <name>   # Remove a configured marketplace
codex plugin list                        # List plugins; includes remote catalog entries (v0.153.0)
codex plugin list --json                 # JSON adds source, version, install + auth policy (v0.153.0)

v0.153.0 rozszerza CLI plugin z zarządzania marketplace na operacje dotyczące poszczególnych plugins w zdalnych marketplaces: codex plugin list uwzględnia wpisy zdalnego katalogu (wraz z ich źródłem, wersją, zasadami instalacji i zasadami uwierzytelniania w danych wyjściowych JSON), a zdalne plugins można dodawać i usuwać za pomocą istniejącego CLI plugin. Zdalne katalogi są przechowywane w pamięci podręcznej według zakresu i kolekcji – preferowane są aktualne wyniki z pamięci podręcznej, żądanie dodania plugin nieznalezionego w pamięci podręcznej powoduje jednorazowe ponowne pobranie, a lokalny wyselekcjonowany katalog pozostaje dostępny, gdy nie powiedzie się niefiltrowane wyświetlenie zdalnej listy (błędy nadal są zgłaszane w przypadku jawnie wybranych zdalnych marketplaces).¹⁴⁰

W TUI należy użyć /plugins (v0.117.0+), aby interaktywnie przeglądać, instalować i usuwać poszczególne plugins bez opuszczania sesji.⁷⁵

Wskazówka ekspercka: Plugins konsolidują elementy, które wcześniej wymagały oddzielnej konfiguracji MCP, instalacji skills i konfiguracji konektorów aplikacji. Pojedynczy plugin może obejmować wszystkie 3 elementy — przyspieszając wdrażanie członków zespołu i zwiększając przenośność konfiguracji.

Tryb planowania i współpraca

Tryb planowania pozwala Codex opracować podejście przed wprowadzeniem zmian. Jest domyślnie włączony (od wersji v0.94.0).¹⁴ Drzewo decyzyjne „Tryb planowania a bezpośrednie wykonanie” znajduje się w sekcji Ramy podejmowania decyzji.

Tryb planowania a narzędzie update_plan (v0.152.0): są to dwie różne rzeczy, a tylko jedna z nich jest domyślnie włączona. Tryb planowania — opisany w tej sekcji tryb współpracy, w którym Codex przedstawia propozycję przed jej wykonaniem — jest domyślnie włączony od wersji v0.94.0 i pozostaje bez zmian. update_plan to narzędzie do planowania, które model może wywołać, aby utrzymywać uporządkowany plan w ramach jednej tury. W wersji v0.152.0 zostało udostępnione jako funkcja wymagająca samodzielnego włączenia: tools.update_plan.enabled ma domyślnie wartość false, a gdy jest wyłączone, Codex usuwa także dołączone wskazówki dotyczące update_plan ze swoich promptów modelu, trybu współpracy, obsługi wielu agentów, kompakcji, wstępnego przygotowania i kontynuacji celu (niestandardowe instrukcje bazowe, instrukcje katalogu modeli, zasady współpracy oraz treść celu użytkownika pozostają zachowane, nawet jeśli wspominają o planowaniu). Należy je włączyć jawnie za pomocą tools.update_plan.enabled = true w pliku config.toml.¹³⁸

Włączanie trybu planowania

/plan                              # Switch to plan mode
/plan "redesign the API layer"     # Plan mode with initial prompt

W trybie planowania Codex: - Odczytuje pliki i analizuje bazę kodu - Proponuje plan implementacji - Nie wprowadza zmian bez zatwierdzenia - Wyświetla plan na bieżąco w dedykowanym widoku TUI

Tryb sterowania

Tryb sterowania (domyślnie włączony od wersji v0.98.0) pozwala przekazywać nowe instrukcje, gdy Codex aktywnie pracuje, bez przerywania bieżącego zadania.¹⁴

Dostępne są dwie metody przekazywania instrukcji:

Praktyczne przykłady:

# Codex is refactoring the auth module...

[Enter] "Use bcrypt instead of argon2 — we already have it as a dependency"
→ Codex adjusts immediately, mid-turn

[Tab] "Once auth is done, update the migration script too"
→ Codex finishes auth refactor, then starts the migration

Tryb sterowania jest zawsze aktywny w TUI. Aby zaczekać z przekazaniem instrukcji do zakończenia pracy przez Codex, wystarczy wpisać je w zwykły sposób po zakończeniu tury — nie jest potrzebny żaden specjalny tryb.

Ulepszenia TUI (v0.105.0–v0.106.0)

Podświetlanie składni (v0.105.0): TUI podświetla teraz składnię bloków kodu wydzielonych znacznikami oraz różnic bezpośrednio w treści. Schemat kolorów można wybrać za pomocą /theme.⁶¹

Nowe polecenia TUI (v0.105.0+):⁶¹

Transkrypcja głosu (v0.105.0, eksperymentalna): Aby dyktować prompty za pomocą transkrypcji głosu, należy nacisnąć spację. Ta funkcja ma charakter eksperymentalny i może wymagać uprawnień do korzystania z mikrofonu.⁶¹ Od wersji v0.107.0 sesje głosowe w czasie rzeczywistym obsługują wybór mikrofonu i głośnika, co pozwala wskazać konkretne urządzenia wejścia i wyjścia audio.⁶² Usunięto w wersji v0.140.0, przywrócono w wersji v0.145.0: eksperymentalne mechanizmy sterowania głosem /realtime i ich zależności audio usunięto z TUI w wersji v0.140.0 (nie wpłynęło to na transkrypcję głosu uruchamianą spacją).¹⁰² Wersja v0.145.0 przywraca obsługę głosu w nowej formie: wejścia audio i wyniki narzędzi audio w popularnych lokalnych formatach dźwięku, a także strumieniowe rozmowy V3 w czasie rzeczywistym.¹¹² v0.155.0 i v0.156.0: rozmowy głosowe na żywo. W wersji v0.155.0 (17 września 2026) dodano /voice jako eksperymentalną funkcję wymagającą samodzielnego włączenia: rozmowę na żywo ze strumieniową transkrypcją i sterowaniem mikrofonem, włączaną przez /experimental w obsługiwanych kompilacjach (#43581, #43651, #44331), z konfigurowalnym skrótem wyciszania (#43690) oraz podpisanymi zasobami głosowymi w pakietach dla systemu macOS (#43983). W wersji v0.156.0 (22 września 2026) funkcja stała się stabilna i została domyślnie włączona (#44921), a tego samego dnia w dzienniku zmian dokumentacji ogłoszono: „Rozmowy głosowe są domyślnie włączone, z przełącznikiem F8, selektorem /voice settings oraz dołączonymi środowiskami uruchomieniowymi audio dla systemów Linux i Windows”. Aby ją wyłączyć, należy ustawić realtime_conversation = false w sekcji [features] pliku config.toml. Dokumentacja poleceń ukośnikowych CLI nadal nie wymienia /voice, natomiast strona dokumentacji funkcji Voice dotyczy ChatGPT Voice w aplikacji komputerowej, czyli odrębnego interfejsu.¹⁵⁶¹⁶⁹

Pozostałe ulepszenia: - Długie linki pozostają teraz klikalne nawet po zawinięciu do kolejnego wiersza TUI (v0.105.0)⁶¹ - Linki do plików lokalnych są wyświetlane z ulepszonym formatowaniem (v0.106.0)⁶⁰ - Linki internetowe w treści Markdown w TUI pozostają klikalne dzięki metadanym OSC 8, a tabele, które nie mieszczą się w dostępnej przestrzeni, są zastępowane czytelnymi rekordami klucz/wartość bez utraty adresów docelowych linków (v0.136.0)¹⁶⁸ - Linki Markdown są wyświetlane jako klikalne etykiety w obsługiwanych terminalach, a w pozostałych zachowywane są widoczne adresy URL (v0.150.0)¹³² - Poprawiono obsługę Ctrl+C przez subagentów, aby prawidłowo kończyć procesy potomne (v0.106.0)⁶⁰

System pamięci

Codex ma trwały system pamięci (v0.100.0+), który przechowuje fakty, preferencje i kontekst projektu między sesjami.²⁴

Polecenia pamięci

Informacje są przechowywane w plikach Markdown w folderze ~/.codex/memory/. Codex wczytuje je na początku sesji i wykorzystuje do dostosowywania swojego działania we wszystkich przyszłych sesjach.

Co warto przechowywać

Pamięć najlepiej sprawdza się w przypadku trwałych preferencji i faktów dotyczących projektu:

• Konwencje projektu: „W tym projekcie używane są tabulatory, a nie spacje” lub „Odpowiedzi API zawsze zawierają pole meta”
• Preferencje dotyczące narzędzi: „Używaj pnpm zamiast npm” lub „Uruchamiaj testy za pomocą pytest -x --tb=short”
• Decyzje architektoniczne: „Moduł uwierzytelniania znajduje się w src/core/auth/, a nie w src/middleware/”
• Preferencje dotyczące przepływu pracy: „Zawsze uruchamiaj linter przed pokazaniem różnic”

Pamięć w potokach

Podczas uruchamiania codex exec pamięć jest wczytywana automatycznie. Dzięki temu potoki CI/CD i skrypty korzystają z tego samego kontekstu co sesje interaktywne — nie trzeba powtarzać instrukcji przy każdym wywołaniu.

Udoskonalenia pamięci (v0.101.0–v0.107.0)

• Usuwanie danych poufnych: Przed zapisaniem na dysku informacje w pamięci są automatycznie skanowane pod kątem danych poufnych
• Uwzględnianie CWD: Pliki pamięci zawierają teraz kontekst katalogu roboczego, co umożliwia przywoływanie informacji dotyczących konkretnego projektu
• Wykluczanie komunikatów deweloperskich: Komunikaty deweloperskie i systemowe są wykluczane z danych wejściowych pamięci fazy 1, co podnosi jej jakość dzięki skupieniu na interakcjach użytkownika
• Zapominanie na podstawie różnic (v0.106.0): Pamięć wykorzystuje teraz mechanizm zapominania na podstawie różnic do usuwania nieaktualnych faktów, dzięki czemu jej zawartość pozostaje zwięzła i aktualna⁶⁰
• Wybór uwzględniający wykorzystanie (v0.106.0): Pobieranie informacji z pamięci uwzględnia teraz sposób ich wykorzystania, nadając priorytet często przywoływanym i ostatnio istotnym informacjom⁶⁰
• Konfigurowalna pamięć (v0.107.0): Pamięć można teraz w pełni konfigurować. Polecenie codex debug clear-memories pozwala usunąć wszystkie zapisane informacje i zacząć od nowa — jest to przydatne przy przełączaniu się między niepowiązanymi projektami lub gdy stan pamięci przestał odpowiadać bieżącemu kontekstowi⁶²
• Ulepszenie modelu fazy 2 (v0.121.0): Modelem konsolidacji pamięci fazy 2 jest teraz gpt-5.4 (zamiast poprzedniego modelu domyślnego). Potok fazy 2 działa między sesjami, wyodrębniając z transkrypcji fazy 1 trwałe fakty; zmiana modelu poprawia jakość przywoływania przy takim samym koszcie tokenów.⁸²
• Menu pamięci w TUI (v0.121.0): Nowy interfejs dostępny w trakcie sesji udostępnia tryb pamięci, możliwość usuwania poszczególnych informacji oraz przycisk resetowania. Resetowanie pamięci zachowuje teraz wcześniejsze przebiegi, zamiast je unieważniać, dzięki czemu usuwa informacje dostępne do przywołania w przyszłości bez zakłócania odtwarzania sesji.⁸²

Pamięć a AGENTS.md

Wskazówka: /m_update służy do zapisywania faktów, które mają być zachowane bezterminowo. Kontekst dotyczący tylko bieżącej sesji wystarczy przekazać Codex bezpośrednio w rozmowie. Do współdzielenia kontekstu w zespole należy używać AGENTS.md.

Zarządzanie sesjami

Codex zapisuje sesje w ~/.codex/sessions/, umożliwiając ich wznawianie, rozwidlanie oraz pracę wielowątkową w CLI i aplikacji komputerowej.

Wersja v0.146.0 umożliwia bezpośrednie odwoływanie się do wątków. Polecenia /new i /clear przyjmują teraz nazwę sesji, ważne wątki można przypinać, a poboczne rozmowy pozostają otwarte — nie trzeba już zamykać jednej, aby przejść do innej.¹¹⁴ W praktyce długotrwały projekt przestaje być listą znaczników czasu, które trzeba rozpoznawać po dacie. Wersja v0.147.0 dodaje sekcje rozmów: rozmowy można organizować w trwałe sekcje uporządkowane ręcznie, a długie transkrypcje przeglądać stopniowo zamiast wczytywać je w całości.¹¹⁶ Wersja v0.148.0 dodaje /export i rozwidlanie z wiersza poleceń: /export zapisuje całą rozmowę w formacie Markdown (do schowka lub nowego pliku), codex exec fork rozwidla sesję nieinteraktywnie, a selektor wznawiania pozwala archiwizować i przywracać sesje.¹¹⁸ Wersja v0.149.0 dodaje codex queue — wysyłanie wiadomości z wiersza poleceń do istniejących sesji lokalnych lub zdalnych — oraz naprawia przywracanie aktywnego profilu uprawnień we wznowionych i rozwidlonych wątkach.¹²⁰ Wersja v0.150.0 dodaje automatyczne tytuły: nienazwane zadania terminalowe automatycznie otrzymują opisowe tytuły, a /rename proponuje edytowalny tytuł na podstawie rozmowy.¹³² Wersja v0.151.0 dodaje /recap: na żądanie można uzyskać krótkie podsumowanie ostatnich postępów w rozmowie i kolejnych kroków; Codex generuje też takie samo podsumowanie automatycznie dla kwalifikujących się, bezczynnych rozmów, które nie są aktualnie aktywne, i dodaje je do transkrypcji, przy czym żądania są ograniczone i izolowane, a ponowienia następują wyłącznie po niepowodzeniach automatycznych.¹³⁵ Wersja v0.153.0 pozwala wyłączyć automatyczną część tej funkcji: tui.auto_recap = false anuluje zaplanowane automatyczne kontrole podsumowań i odrzuca oczekujące wyniki automatyczne, natomiast ręczne /recap nadal działa.¹⁴⁰

codex agents (v0.149.0) to interaktywny panel wszystkich aktywnych sesji agentów na komputerze: z jednego ekranu można wyszukiwać, uruchamiać, otwierać, zmieniać nazwy i zatrzymywać zadania, korzystając z konfigurowalnych skrótów. W obrębie sesji /agents służy do przełączania się między wszystkimi aktywnymi sesjami agentów, a /subagents — między subagentami bieżącej sesji.¹²⁰¹²⁹ Wersja v0.150.0 umożliwia bezpośrednie odwoływanie się do zadań z poziomu rozmowy: można wskazywać inne zadania Codex za pomocą wzmianek @ oraz prosić agentów z terminala o odczytywanie, tworzenie lub przesyłanie wiadomości do zadań.¹³²

Wznawianie

Kontynuowanie pracy od miejsca jej przerwania:

codex resume                          # Interactive picker (sorted by recency)
codex resume <SESSION_ID>             # Resume a specific session
codex exec resume --last "continue"   # Non-interactive: resume most recent

Polecenie slash /resume w TUI otwiera ten sam interaktywny selektor z funkcją wyszukiwania.

Stronicowana historia wątków (v0.145.0, przeniesiona do funkcji standardowych w v0.151.0): Stronicowana historia wątków usprawnia wznawianie sesji, przeszukiwanie historii, zachowywanie nazw wątków, obsługę subagentów i wspomnień — historia jest wczytywana strona po stronie, a nie od razu w całości, co ma znaczenie w przypadku długo używanych katalogów roboczych zawierających setki sesji. Funkcję wprowadzono jako eksperymentalną w wersji v0.145.0; wersja v0.151.0 przenosi APIs poza obszar funkcji eksperymentalnych (thread/turns/list, thread/items/list i thread/revert nie wymagają już eksperymentalnej funkcji API) oraz ustawia tryb stronicowany jako wynikową wartość domyślną WYŁĄCZNIE dla trwałych wątków, których magazyn obsługuje thread/turns/list i thread/items/list, i tylko wtedy, gdy thread/start pomija historyMode. Wątki tymczasowe oraz wątki korzystające z magazynów bez tych APIs nadal domyślnie używają trybu starszego typu, jawne wybory zachowują swoje działanie, a wyliczenie ThreadHistoryMode na poziomie protokołu nadal domyślnie przyjmuje wartość Legacy w tagu rust-v0.151.0 (protocol.rs:755-758) — jest to wynikowa wartość domyślna dla obsługiwanych trwałych wątków, a nie powszechna zmiana trybu.¹¹²¹³⁵

Rozwidlanie

Rozgałęzienie rozmowy pozwala analizować alternatywne rozwiązania bez utraty dotychczasowych postępów:

/fork                              # Fork current conversation
/fork "try a different approach"   # Fork with new prompt

Rozwidlenia tworzą niezależne wątki współdzielące tę samą historię do punktu rozwidlenia. Od wersji v0.146.0 historia rozwidleń jest stronicowana, a rozwidlenia mogą być tworzone jako tymczasowe — tymczasowe rozwidlenie nie pojawia się na listach wątków, dzięki czemu jednorazowe eksperymenty nie zaśmiecają faktycznie używanej listy.¹¹⁴ Zmiany w jednym rozwidleniu nie wpływają na drugie. Przydaje się to do porównywania podejść (np. „utworzyć rozwidlenie i wypróbować Redis zamiast Memcached”) lub bezpiecznego testowania ryzykownych zmian.

Rozwidlanie wątków do subagentów (v0.107.0): Wątki można teraz rozwidlać do niezależnych subagentów, dzięki czemu rozmowa może uruchamiać równoległe strumienie pracy wykonywane autonomicznie. Rozszerza to dotychczasowy model rozwidleń — zamiast jedynie rozgałęziać rozmowę, rozwidlony wątek staje się subagentem z własnym kontekstem wykonania.⁶² Od wersji v0.117.0 subagenci używają adresów opartych na ścieżkach (np. /root/agent_a) oraz ustrukturyzowanej komunikacji między agentami, co sprawia, że koordynacja wielu agentów jest bardziej przejrzysta i łatwiejsza do debugowania.⁷⁵

Szyfrowane wiadomości między agentami (v0.138.0+): Multi-agent v2 szyfruje teraz treść zadania wysyłaną przez agenta nadrzędnego podczas tworzenia subagenta lub przesyłania mu wiadomości. Parametry wiadomości funkcji spawn_agent, send_message i followup_task są oznaczone jako szyfrowane: API Responses szyfruje ładunek, gdy model nadrzędny emituje wywołanie narzędzia, lokalnie działający Codex przenosi wyłącznie szyfrogram (InterAgentCommunication.encrypted_content, z pustą treścią jawną), a API odszyfrowuje go po stronie serwera podczas przekazywania do modelu odbierającego.¹⁰⁸ Ma to 3 praktyczne konsekwencje:

• Lokalne dzienniki sesji nie zawierają już jawnej treści delegowanych zadań. Można zobaczyć, że agent nadrzędny utworzył subagenta i co otrzymał w odpowiedzi, lecz nie dokładną treść przesłanej instrukcji. W przypadku audytu lub debugowania uruchomień wielu agentów na podstawie historii sesji ten zapis nie jest już dostępny; według stanu na połowę lipca 2026 otwarte zgłoszenie regresji dotyczące tego problemu nie ma powiązanej poprawki.¹⁰⁹ Pozostałymi mechanizmami pozwalającymi odtworzyć przebieg zdarzeń są zdarzenia cyklu życia rozszerzeń (uruchomienie/zatrzymanie subagenta, wykonanie narzędzia, metadane tury — v0.133.0+) oraz obserwowalność app-server.⁹⁸
• Modele niestandardowych dostawców mogą przestać działać. Punkt końcowy modelu, który nie został skonfigurowany do obsługi szyfrowanych wywołań narzędzi, odrzuca zaszyfrowany schemat spawn_agent z błędem 400 ("declares encrypted parameters but is not configured for encrypted tool use"). Jeśli delegowanie do wielu agentów kończy się takim błędem u niestandardowego dostawcy, przyczyną jest zmiana dotycząca szyfrowania, a nie konfiguracja użytkownika.¹⁰⁹
• Powiadomienia generowane przez Codex pozostają czytelne. Powiadomienia o zakończeniu pracy agenta podrzędnego generuje sam Codex, dlatego pozostają one zapisane tekstem jawnym i są teraz renderowane jako elementy typu agent_message, a nie serializowane koperty JSON.¹⁰⁸

OpenAI nie opublikowało modelu zagrożeń stojącego za tą zmianą; PR opisuje przepływ szyfrogramu, lecz nie wskazuje, przed czym ma on chronić.

Ustabilizowany Multi-agent v2 (v0.145.0, funkcja opcjonalna): Środowisko Multi-agent v2, które zadebiutowało w wersji v0.137.0 i otrzymało szyfrowane delegowanie w wersji v0.138.0, zostało teraz ustabilizowane jako funkcja opcjonalna. Wersja v0.145.0 dodaje konfigurowalne modele subagentów, indywidualne poziomy rozumowania dla poszczególnych subagentów, konfigurowalną współbieżność, przywrócone role wielu agentów oraz usprawnioną nawigację między agentami. Jeśli zrezygnowano z v2 podczas początkowych problemów wersji v0.137/v0.138, właśnie w tym wydaniu interfejs konfiguracji się stabilizuje — wybór modelu i poziomu rozumowania subagenta znajduje się teraz w konfiguracji, zamiast być na stałe określany przez środowisko uruchomieniowe.¹¹²

Lista wątków

Wyświetlanie aktywnych sesji i zarządzanie nimi:

/status                            # Current session info and token usage
/ps                                # Show background terminals in session

W aplikacji komputerowej wątki są widoczne na pasku bocznym wraz z pełną historią i podglądami różnic.

Cykl życia sesji

Sesje synchronizują się między CLI a aplikacją komputerową — można rozpocząć pracę w jednym środowisku i kontynuować ją w drugim.

Tryb nieinteraktywny (codex exec)

codex exec uruchamia Codex nieinteraktywnie na potrzeby skryptów, CI/CD i automatyzacji.¹⁵

Podstawowe użycie

codex exec "summarize the repository structure"
codex exec --sandbox workspace-write -c approval_policy=on-request "fix the CI failure"   # exec has no -a flag; set the policy via -c or config
codex exec --json "triage open bugs" -o result.txt

Domyślnie codex exec zapisuje postęp i zdarzenia do stderr, a końcową wiadomość agenta do stdout. Dzięki takiej konstrukcji można go łączyć ze standardowymi potokami Unix.

Archiwizowanie sesji (v0.136.0)

Sesje można archiwizować, aby zachować przejrzystość listy wznawiania i rozwidlania bez usuwania historii. Archiwizację można wykonać w TUI za pomocą /archive albo z poziomu powłoki:¹⁶⁸

codex archive <session-id>     # archive a session
codex unarchive <session-id>   # restore it

Zarchiwizowana sesja jest chroniona przed wznowieniem lub rozwidleniem do czasu cofnięcia archiwizacji — to zabezpieczenie przed przypadkowym kontynuowaniem sesji, która miała zostać wycofana. W tym samym wydaniu: codex app-server --stdio uruchamia app-server w trybie stdio na potrzeby integracji z edytorami i hostami, a /diff nie może już wykonywać dostarczonych przez repozytorium pomocniczych narzędzi Git (poprawka bezpieczeństwa poleceń). W systemie Windows ścieżka aprowizacji w wersji alfa dodaje polecenie codex sandbox setup --elevated przeznaczone dla administratorów.¹⁶⁸

Dane wyjściowe w wierszach JSON

Z opcją --json strumień stdout staje się strumieniem zdarzeń JSONL:

codex exec --json "fix the tests" | jq

Typy zdarzeń: thread.started, turn.started/completed/failed, item.started/completed, error

{"type":"thread.started","thread_id":"019c5c94-..."}
{"type":"turn.started"}
{"type":"item.started","item":{"id":"item_1","type":"command_execution","status":"in_progress"}}
{"type":"item.completed","item":{"id":"item_3","type":"agent_message","text":"..."}}
{"type":"turn.completed","usage":{"input_tokens":24763,"cached_input_tokens":24448,"output_tokens":122}}

Ustrukturyzowane dane wyjściowe

Wymuszanie struktury odpowiedzi za pomocą schematu JSON:

codex exec "Extract project metadata" \
  --output-schema ./schema.json \
  -o ./project-metadata.json

-o / --output-last-message zapisuje końcową wiadomość do pliku.

Wznawianie i przeglądanie sesji

codex exec resume --last "continue where you left off"
codex exec resume <SESSION_ID> "fix the remaining issues"
codex exec review --base main           # Code review against a branch

Najważniejsze flagi

Uwierzytelnianie w CI

codex exec obsługuje CODEX_API_KEY na potrzeby nieinteraktywnego uwierzytelniania w środowiskach automatyzacji.

Baner startowy codex exec (v0.130.0). Baner startowy codex exec nie wyświetla już starszego określenia „research preview”. Jeśli system CI analizuje dane wyjściowe podczas uruchamiania, tekst banera jest teraz krótszy; ustrukturyzowane zdarzenia --json pozostają bez zmian.⁹¹

codex remote-control (v0.130.0+)

codex remote-control to polecenie najwyższego poziomu, które uruchamia app-server bez interfejsu graficznego, przeznaczony do sterowania przez inny proces — rozszerzenia IDE, niestandardowe orkiestratory lub zdalne płaszczyzny sterowania. Zastępuje ono wieloflagowe wywołanie codex app-server, które wielu integratorów składało dotąd ręcznie, i zapewnia narzędziom innych firm jeden stabilny punkt dostępu do tego samego środowiska wykonawczego app-server, które jest dostarczane w aplikacji desktopowej i interfejsach IDE.⁹¹ Wersja v0.133.0 usprawnia sposób działania polecenia: może ono działać jako polecenie pierwszoplanowe, oczekiwać na gotowość, raportować stan maszyny, a jednocześnie udostępniać jawne polecenia start / stop w stylu demona dla długotrwale działających konfiguracji kontrolera.⁹⁸ Wersja v0.143.0 dodaje codex remote-control pair, które generuje kod ręcznego parowania na podstawie działającego demona, dzięki czemu kontroler może nawiązać połączenie bez automatycznego uzgadniania wykrywania — jest to przydatne, gdy proces sterujący działa na innym hoście lub w innym segmencie sieci niż demon.¹⁰⁶

# Start a headless, remotely controllable app-server
codex remote-control

# Generate a manual pairing code for an out-of-band controller (v0.143.0+)
codex remote-control pair

# Same lifecycle as a TUI session: thread store, hooks, plugins, MCP, sandbox
# all initialize from your normal config.toml.

Podczas tworzenia interfejsów, które muszą wyliczać obszerne historie wątków bez jednoczesnego wczytywania do pamięci wszystkich tur, warto połączyć codex remote-control z opisanymi poniżej APIs stronicowania app-server.

Stronicowanie wątków app-server (v0.130.0+)

Klienty app-server mogą teraz stronicować obszerne wątki przy użyciu 3 odrębnych widoków elementów tur:⁹¹

Stronicowanie warto połączyć z interfejsem ThreadStore, wprowadzonym w wersji v0.121.0, aby sprawnie przeglądać długotrwale działające wątki — szczególnie we wdrożeniach remote-control, w których orkiestrator może znajdować się na innej maszynie niż pliki przebiegu.⁸² Wersja v0.143.0 rozszerza zakres danych dostępnych kontrolerowi: klienty app-server mogą teraz wyliczać dostępne środowiska, wyświetlać wątki potomne danego wątku i rozwidlać historię od określonej tury — są to podstawowe mechanizmy potrzebne interfejsowi do utworzenia odgałęzienia przebiegu od wcześniejszego punktu bez ponownego odtwarzania kolejnych kroków.¹⁰⁶ Wersja v0.151.0 przenosi APIs stronicowanej historii wątków poza fazę eksperymentalną i domyślnie stosuje historię stronicowaną do trwałych wątków z obsługującymi ją magazynami, gdy w wywołaniu thread/start pominięto historyMode (wątki efemeryczne i magazyny bez takiej obsługi nadal korzystają ze starszego trybu); wczytywanie pełnej historii jest przestarzałe w przypadku stronicowanych wątków (#40676).¹³⁵

Odświeżanie konfiguracji app-server na żywo (v0.130.0+)

Aktywne wątki app-server uwzględniają teraz zmiany w config.toml bez konieczności ponownego uruchamiania — wystarczy zmodyfikować i zapisać konfigurację, a działający wątek zastosuje nowe wartości podczas następnej tury. Jest to poprawka uzupełniająca codex remote-control: długotrwale działający serwer bez interfejsu graficznego można rekonfigurować na miejscu zamiast go wyłączać.⁹¹

Ustawienia zakresu aktywnej tury (v0.151.0): ustawienia działającej tury można teraz zmieniać w trakcie jej wykonywania. Eksperymentalna metoda app-server turn/settings/update aktualizuje model, effort, summary i serviceTier dla kolejnych kroków określonej aktywnej tury bez zmieniania przyszłych tur oraz informuje, czy aktualizacja została zastosowana, odrzucona, czy też utraciła swój cel; zarządzane ograniczenia są ponownie sprawdzane, a zatwierdzone właściwości dotyczące akceptacji i zabezpieczeń Guardian danej tury zostają zachowane przed opublikowaniem zaktualizowanej migawki ustawień. turn/start przyjmuje również serviceTierForTurn, dzięki czemu jedna nowa tura może zastąpić poziom usługi bez zmiany poziomu zapisanego dla wątku („default” oznacza standardową szybkość; pominięcie wartości lub null powoduje odziedziczenie poziomu wątku).¹³⁵

Szyfrowane zdalne moduły wykonawcze (v0.141.0)

Od wersji v0.141.0 (stabilnej, 18 czerwca 2026) zdalne moduły wykonawcze łączą się przez uwierzytelnione, kompleksowo szyfrowane kanały Noise-relay — płaszczyzna sterowania i moduł wykonawczy nie muszą już ufać przekaźnikowi znajdującemu się między nimi, co ma znaczenie zawsze wtedy, gdy orkiestrator steruje app-server ponad granicą sieci. To samo wydanie sprawiło, że zdalne wykonywanie między różnymi platformami zachowuje natywny katalog roboczy i powłokę modułu wykonawczego, dzięki czemu kontroler działający w jednym systemie operacyjnym i sterujący modułem wykonawczym w innym nie powoduje już niejawnego przepisywania ścieżek ani semantyki powłoki. TLS akceptuje teraz również podpisy certyfikatów P-521, co zapewnia zgodność z firmowymi serwerami proxy.¹⁰³

Codex Cloud i zadania w tle [EXPERIMENTAL]

Obsługa GitLab (beta, 19 sierpnia 2026): Codex Cloud może teraz łączyć się z projektami GitLab we wszystkich planach ChatGPT — można połączyć projekt, tworzyć środowiska, uruchamiać zadania ze zgłoszeń i merge requestów oraz prosić o przeglądy; Self-Managed GitLab wymaga wersji 19.0 lub nowszej.¹¹⁹

Status: Codex Cloud jest funkcją eksperymentalną. Interfejsy, ceny i dostępność mogą ulec zmianie. OpenAI zarządza środowiskami chmurowymi, a użytkownik nie ma kontroli nad infrastrukturą.

Codex Cloud wykonuje zadania asynchronicznie w środowiskach zarządzanych przez OpenAI.⁴ Od wersji CLI v0.150.0 zadania są również dostępne z poziomu konwersacji w terminalu: można odwoływać się do innych zadań Codex za pomocą wzmianek @ oraz prosić agentów o odczytywanie, tworzenie lub przesyłanie wiadomości do zadań.¹³² Informacje o integracji Codex z potokiem CI można znaleźć także w sekcji GitHub Action i CI/CD.

Wzmocnione zabezpieczenia danych uwierzytelniających zadań w chmurze (v0.152.0): żądania zadań w chmurze mogą zawierać zapisane dane uwierzytelniające ChatGPT, dlatego ich miejsce docelowe jest teraz ograniczane jeszcze przed wczytaniem danych uwierzytelniających — wartość CODEX_CLOUD_TASKS_BASE_URL jest sprawdzana pod kątem zgodności z zaufanymi źródłami HTTPS ChatGPT na porcie 443 (adresy URL zawierające informacje o użytkowniku, zapytania lub fragmenty są odrzucane), a przekierowania są wyłączone dla backendu zadań w chmurze oraz klientów wykrywających środowiska, aby dane uwierzytelniające nigdy nie zostały przekazane do miejsca docelowego przekierowania.¹³⁸

Jak to działa

1. Przesłać zadanie (za pośrednictwem chatgpt.com/codex, integracji ze Slack lub CLI)
2. Codex klonuje repozytorium do izolowanego sandboxa w chmurze
3. Agent pracuje niezależnie: odczytuje kod, uruchamia testy i wprowadza zmiany
4. Po zakończeniu Codex tworzy PR lub udostępnia diff do przeglądu
5. Zastosować wyniki lokalnie za pomocą codex apply <TASK_ID>

Dostęp do internetu w chmurze

Dostęp agenta do internetu jest domyślnie wyłączony i konfigurowany osobno dla każdego środowiska:

• Wyłączony: brak dostępu agenta do internetu (ustawienie domyślne)
• Włączony: opcjonalna lista dozwolonych domen oraz ograniczenia metod HTTP

Allowed domains: pypi.org, npmjs.com, github.com
Allowed methods: GET, HEAD, OPTIONS

Skrypty konfiguracyjne mogą nadal korzystać z internetu w celu instalowania zależności, nawet gdy dostęp agenta do internetu jest wyłączony.

Integracja ze Slack

Aby uruchomić zadanie w chmurze, należy wspomnieć @Codex na kanale Slack lub w wątku.

Wymagania wstępne: 1. Kwalifikujący się plan ChatGPT (Plus, Pro, Business, Enterprise lub Edu) 2. Połączone konto GitHub 3. Co najmniej jedno skonfigurowane środowisko chmurowe 4. Aplikacja Slack zainstalowana w obszarze roboczym

Codex odpowiada linkiem do zadania i publikuje wyniki po jego ukończeniu.

CLI w chmurze

codex cloud exec --env <ENV_ID> "Fix failing tests"  # Start a cloud task
codex cloud status <TASK_ID>                          # Check task progress
codex cloud diff <TASK_ID>                            # View task diff
codex cloud list                                      # List recent tasks
codex cloud list --json                               # JSON output
codex cloud apply <TASK_ID>                           # Apply from cloud subcommand
codex apply <TASK_ID>                                 # Apply diff (top-level shortcut)

Aplikacja Codex Desktop App

Aplikacja Codex Desktop App (macOS i Windows) udostępnia interfejs graficzny zoptymalizowany pod kątem zarządzania wieloma projektami.¹⁶ Wersja dla systemu Windows została wydana 4 marca 2026 roku z natywną obsługą PowerShell i natywnym sandboxem systemu Windows.⁶⁶

Instalacja

codex app                      # Auto-downloads and installs on first run

Można również pobrać bezpośrednio: Codex.dmg (macOS) | Dostępna w Microsoft Store (Windows)

Najważniejsze funkcje

Appshots, komentarze w przeglądarce i Computer Use

Aktualizacje aplikacji z 21 maja sprawiają, że aplikacja komputerowa staje się bogatszym źródłem kontekstu, a nie tylko menedżerem wątków. Z funkcji Appshots warto korzystać, gdy Codex przed podjęciem działania potrzebuje informacji o stanie innej aplikacji na komputerze Mac: Codex przechwytuje okno znajdujące się na pierwszym planie oraz dostępny tekst widoczny i znajdujący się poza ekranem, który udostępnia aplikacja, a następnie zapisuje załącznik lokalnie w historii sesji.⁹⁹

Podczas pracy nad stronami internetowymi i frontendem warto najpierw użyć przeglądarki wbudowanej w aplikację, jeśli strona nie wymaga uwierzytelnienia: zapewnia ona użytkownikowi i Codex wspólny podgląd wyrenderowanej strony, obsługuje działania w przeglądarce, takie jak klikanie, wykonywanie zrzutów ekranu, pobieranie zasobów i kontrola JavaScript w trybie tylko do odczytu, a także pozwala oznaczać obszary strony komentarzami, które Codex może uwzględnić w następnej turze.⁹⁹ W przypadku witryn wymagających logowania należy nadal korzystać z rozszerzenia przeglądarki (Chrome, Edge, Brave, Opera lub Vivaldi; Opera nie oferuje czatu bocznego). Narzędzia witryn (WebMCP, 25 sierpnia 2026): w przeglądarce wbudowanej w aplikację komputerową ChatGPT Work i Codex mogą korzystać z narzędzi udostępnianych przez witrynę do pracy ze stroną; należy używać GPT-5.6 Sol lub GPT-5.6 Terra w najnowszej wersji aplikacji komputerowej, ponieważ narzędzia witryn nie są dostępne w GPT-5.6 Luna ani w obszarach roboczych Enterprise lub Edu.¹²⁷

Z funkcji Computer Use należy korzystać tylko wtedy, gdy wykonania zadania nie można zweryfikować za pomocą integracji strukturalnej ani podglądu w przeglądarce. Funkcja ta może sprawdzać i obsługiwać dozwolone aplikacje na komputerze Mac, ale w przypadku edycji plików i poleceń powłoki podlega mechanizmom zatwierdzania i regułom sandboxa Codex, a zakres locked use pozostaje wąski: po zablokowaniu komputera Mac Codex może tymczasowo uzyskiwać dostęp do dozwolonych aplikacji podczas aktywnych, zaufanych tur Computer Use, z zabezpieczeniami ponownego blokowania i wykrywaniem lokalnych działań użytkownika.⁹⁹

Tryby wątków

Każdy wątek działa w jednym z trzech trybów wybieranych podczas jego tworzenia:

Mechanizm izolacji Worktree:

Po uruchomieniu wątku Worktree aplikacja komputerowa: 1. Tworzy nowy Git worktree (git worktree add) w katalogu tymczasowym 2. Przełącza się na nową gałąź utworzoną z bieżącego HEAD 3. Uruchamia agenta w obrębie worktree — wszystkie zmiany plików pozostają odizolowane 4. Po zakończeniu przedstawia różnice do przeglądu — można wybrać zmiany, które mają zostać scalone z powrotem

Dzięki temu w tym samym repozytorium może jednocześnie działać wiele wątków Worktree bez konfliktów. Każdy otrzymuje własną gałąź i katalog roboczy.

Ustawienia Worktree i własność wątków (v0.151.0): zachowanie zarządzanych worktree jest określane na podstawie istniejącej konfiguracji [desktop] przez dedykowany parser ustawień — domyślnym katalogiem głównym worktree jest $CODEX_HOME/worktrees, automatyczne czyszczenie jest domyślnie włączone, a zachowywanych jest 15 worktree; skonfigurowane katalogi główne, flagi czyszczenia i liczby zachowywanych worktree są sprawdzane przed użyciem. Każdy zarządzany, połączony worktree może również zawierać wersjonowany rekord własności codex-thread.json w swoich metadanych Git, który wiąże go z wątkiem: zapisy są atomowe i nie zastępują istniejących danych (ponowne powiązania są idempotentne, a właściciele powodujący konflikt — odrzucani); ponadto podstawowe, zagnieżdżone i niezarządzane kopie robocze są odrzucane przed modyfikacją metadanych własności.¹³⁵

Zarządzane worktree trafiają do CLI w v0.154.0 (funkcja eksperymentalna): --worktree podczas uruchamiania lub /worktree w TUI tworzy odizolowaną kopię roboczą dla nowej lub rozwidlonej sesji, codex exec obsługuje zarządzane worktree na potrzeby automatyzacji, a polecenia sesji TUI wraz z przeglądarką worktree pozwalają wyświetlać, przeglądać i wznawiać sesje worktree (#42196, #42366, #42652, #43069, #43120, #43286). v0.155.0 dodaje powiązane funkcje zarządzania, choć worktree nadal nie są domyślne: w przeglądzie agentów można ukrywać, archiwizować i usuwać sesje worktree, wyświetlane są szczegóły własności, a usunięcie czystego zarządzanego worktree wymaga potwierdzenia (#43942, #44424, #44433). Zmiana włączająca tę funkcję domyślnie (#44870) została scalona 11 września, ale NIE znalazła się w stabilnej wersji 0.155.0, co potwierdzono przez sprawdzenie historii względem tagu rust-v0.155.0.¹⁵²¹⁵⁶

Zarządzane worktree stają się domyślne w v0.156.0: #44870 promuje worktrees do funkcji stabilnej, domyślnie ją włącza i usuwa z /experimental. Wraz z nią wprowadzono następujące zmiany: sesje worktree mogą łączyć się z istniejącym lokalnym daemonem zamiast uruchamiać własny (#46498), a sesje worktree można tworzyć bezpośrednio z poziomu przeglądu agentów (#45276), który otrzymuje również karty filtrowania według stanu (#46839). Jeśli skrypty lub konfiguracje zostały utworzone przy założeniu, że worktree pozostają wyłączone, dopóki nie zostaną jawnie zażądane, wersja 0.156.0 zmienia ich działanie. Aby zrezygnować: należy ustawić worktrees = false w sekcji [features] pliku config.toml (dla pojedynczego uruchomienia: --disable worktrees). Starsze lokalne daemony: jeśli tworzenie worktree lub użycie /cd jest blokowane komunikatem „The local Codex service cannot check background terminals”, należy uruchomić codex app-server daemon update, a następnie ponownie uruchomić Codex.¹⁶⁹¹⁷¹

Narzędzia worktree dla modelu (v0.162.0): w zaufanym projekcie lokalnym z włączoną tą funkcją sam model może tworzyć i wyświetlać zarządzane worktree za pomocą nowych narzędzi (#50148), a prompty dotyczące nowej rozmowy i rozwidlenia objaśniają dostępne opcje worktree (#50416).¹⁸⁷

Automatyzacje

Automatyzacje działają lokalnie w aplikacji, dlatego aplikacja musi być uruchomiona, a projekt dostępny na dysku:

• W repozytoriach Git automatyzacje korzystają z dedykowanych worktree działających w tle (odizolowanych od katalogu roboczego)
• W projektach innych niż Git zadania są wykonywane bezpośrednio w katalogu projektu
• Automatyzacje korzystają z domyślnych ustawień sandboxa

Konfigurowanie automatyzacji: 1. Otworzyć projekt w aplikacji komputerowej 2. Kliknąć kartę Automations na pasku bocznym 3. Zdefiniować wyzwalacz (harmonogram, webhook lub uruchomienie ręczne) 4. Napisać prompt i wybrać tryb wykonywania (local lub worktree) 5. Ustawić poziom rozumowania dla uruchomienia automatyzacji (App v26.312)⁷² 6. Automatyzacje będą uruchamiane zgodnie z harmonogramem, a wyniki trafią do kolejki przeglądu

Przykładowe zastosowania: - Klasyfikowanie zgłoszeń: automatyczne kategoryzowanie nowych zgłoszeń i nadawanie im priorytetów - Monitorowanie CI: obserwowanie niepowodzeń kompilacji i proponowanie poprawek - Reagowanie na alerty: reagowanie na alerty monitorowania za pomocą analizy diagnostycznej - Aktualizowanie zależności: sprawdzanie i stosowanie poprawek zabezpieczeń

Wyniki pojawiają się w kolejce przeglądu i wymagają zatwierdzenia przez człowieka.

Obsługa systemu Windows

Aplikacja Codex Desktop App została wydana dla systemu Windows 4 marca 2026 roku (App v26.304) z natywną obsługą PowerShell, natywnym sandboxem systemu Windows oraz pełnym zestawem funkcji, w tym skills, automatyzacjami i worktrees, bez konieczności korzystania z WSL.⁶⁶

GitHub Action i CI/CD

Oficjalna integracja GitHub Action umożliwia korzystanie z Codex w potoku CI/CD.¹⁸

Podstawowe użycie

# .github/workflows/codex.yml
name: Codex
on:
  pull_request:
    types: [opened]

jobs:
  codex:
    runs-on: ubuntu-latest
    outputs:
      final_message: ${{ steps.run_codex.outputs.final-message }}
    steps:
      - uses: actions/checkout@v5
      - name: Run Codex
        id: run_codex
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          prompt-file: .github/codex/prompts/review.md
          sandbox: workspace-write
          safety-strategy: drop-sudo

Opcje konfiguracji

Dane wyjściowe: final-message, czyli tekst końcowej odpowiedzi Codex przeznaczony dla kolejnych kroków/zadań.

Strategie bezpieczeństwa

Kontrola dostępu

with:
  allow-users: "admin,maintainer"     # Limit who can trigger
  allow-bots: false                   # Block bot-triggered runs

Domyślnie: przepływy pracy Codex mogą wyzwalać wyłącznie współpracownicy z uprawnieniami do zapisu.

Codex SDK

Biblioteka TypeScript SDK pozwala osadzać możliwości agenta Codex w niestandardowych aplikacjach.¹⁹

Instalacja

npm install @openai/codex-sdk

Podstawowe użycie

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();

// Multi-turn conversation
const turn1 = await thread.run("Diagnose CI failures and propose a fix");
console.log(turn1.finalResponse);

const turn2 = await thread.run("Implement the fix and add tests");
console.log(turn2.items);

// Resume a previous session
const resumed = codex.resumeThread("<thread-id>");
await resumed.run("Continue from previous work");