Codex CLI: kompletne kompendium techniczne

W skrócie: Codex to wieloplatformowy agent programistyczny: 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 uczynić z niego narzędzie zwielokrotniające produktywność. Który model wybrać: dokumentacja modeli OpenAI wskazuje obecnie GPT-6 Sol (gpt-6-sol, dostępny w selektorze CLI od wersji v0.156.1) do codziennych i złożonych zadań programistycznych, GPT-6-Astra do najtrudniejszych zadań realizowanych od początku do końca (nadal jest to domyślny model dołączony do CLI, gdy nie ustawiono żadnego modelu), a GPT-6 Luna do precyzyjnie określonych zadań wykonywanych na dużą skalę. Dostępność zależy od planu, ustawień obszaru roboczego i etapu wdrażania, a modele GPT-5.6 pozostają w międzyczasie dostępne; 14 października 2026 model GPT-5.5 zostanie wycofany z Codex w przypadku logowania przez ChatGPT.¹⁴⁶¹⁷¹ Korzystają Państwo z niego po raz pierwszy? Warto przejść bezpośrednio do sekcji Instalacja i Szybki start. Śledzą Państwo wydania? Najnowszą stabilną wersją jest v0.157.1 (26 września 2026); sekcja Najważniejsze zmiany w wydaniach rozpoczyna się od podsumowania bieżącego stanu (co jest domyślnie włączone, a co nadal eksperymentalne), po czym omawia każdą wersję, natomiast Dziennik zmian zawiera wszystkie aktualizacje przewodnika.¹¹⁶¹⁷⁴

Codex działa jako wieloplatformowy agent programistyczny, a nie chatbot piszący kod. CLI odczytuje bazę kodu, wykonuje polecenia w piaskownicy, modyfikuje pliki, łączy się z usługami zewnętrznymi za pośrednictwem MCP i deleguje długotrwałe zadania do chmury. Działa lokalnie, lecz myśli globalnie; ta sama inteligencja obsługuje pięć różnych środowisk, zależnie od sposobu pracy, w tym rozszerzenie 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 kluczowych systemów. Ich opanowanie pozwala uczynić z Codex narzędzie zwielokrotniające produktywność:

1. System konfiguracji: steruje działaniem za pomocą config.toml
2. Model piaskownicy i zatwierdzania: wyznacza granice możliwości Codex
3. AGENTS.md: określa zasady działania na poziomie projektu
4. Protokół MCP: rozszerza możliwości o integracje z usługami zewnętrznymi
5. System skills: grupuje wiedzę specjalistyczną przeznaczoną do wielokrotnego wykorzystania

Przez wiele miesięcy korzystałem z Codex równolegle z Claude Code w produkcyjnych bazach kodu, potokach CI/CD i przepływach pracy zespołów. Niniejszy przewodnik przekłada te doświadczenia na kompletne kompendium, którego brakowało mi na początku. Każda funkcja została opisana z użyciem rzeczywistej składni, praktycznych przykładów konfiguracji oraz przypadków brzegowych, które sprawiają problemy nawet doświadczonym użytkownikom.

Najważniejsze wnioski

• 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 pasujący do danego sposobu pracy.⁹⁰
• Izolacja na poziomie systemu operacyjnego: Codex egzekwuje ograniczenia systemu plików i sieci na poziomie jądra (Seatbelt w systemie macOS, Landlock + seccomp w systemie Linux), a nie wewnątrz kontenerów.
• AGENTS.md działa w różnych narzędziach: Instrukcje projektu działają w Codex, Cursor, Copilot, Amp, Jules, Gemini CLI, Windsurf, Cline, Aider, Zed oraz w ponad 60 000 projektów open source. Wystarczy napisać je raz, aby korzystać z nich wszędzie.
• Profile ograniczają narzut związany ze zmianą kontekstu: Można zdefiniować nazwane ustawienia konfiguracji (fast, careful, auto) i przełączać się między nimi za pomocą --profile.
• Zarządzanie kontekstem ma znaczenie: wbudowany katalog Codex zapewnia modelom GPT-6 Astra, Sol i Luna oraz rodzinie GPT-5.6 okno kontekstu o rozmiarze 272K (API podaje 1,05M dla GPT-6 Sol i Luna); GPT-5.5 oferuje w Codex 400K do czasu wycofania go z tej usługi 14 października 2026. Aby aktywnie zarządzać budżetem tokenów, warto korzystać z /compact, precyzyjnych promptów oraz odwołań @file.⁸³¹¹²

Jak korzystać z tego przewodnika

To dokument liczący ponad 3 300 wierszy — warto zacząć od sekcji odpowiadającej poziomowi doświadczenia:

Na końcu znajduje się Podręczna karta referencyjna, która zawiera łatwe do przejrzenia podsumowanie wszystkich najważniejszych poleceń.

Najważniejsze informacje o wydaniach: co ostatnio się zmieniło

Rejestr zmian w poszczególnych wersjach, od najnowszej, przeznaczony dla osób śledzących cykl wydawniczy Codex. Korzystają Państwo z tego narzędzia po raz pierwszy? Proszę przejść do sekcji Szybki start — żadna z poniższych informacji nie jest potrzebna, aby rozpocząć produktywną pracę. Szczegóły weryfikacji (porównania, listy commitów, kontrole dokumentacji) znajdują się w przypisach.

Stan obecny

Codex CLI — stan na 26 września 2026

• Wersja stabilna: v0.157.1, opublikowana 26 września (npm latest) — poprawka dla Windows na bazie v0.157.0 (25 września).
• Wersja alpha: npm alpha wskazuje 0.159.0-alpha.4. Linia 0.158 nie doczekała się stabilnego wydania.
• Domyślnie włączone od v0.157.0: pełnoekranowy zapis rozmowy, automatyczne uruchamianie serwera działającego w tle oraz kontekst wątku Guardian. Aby wyłączyć wybraną funkcję, należy ustawić fullscreen_transcript = false w sekcji [tui], daemon_auto_start = false w sekcji [features] (albo uruchomić program z --no-daemon) lub thread_context = false w sekcji [features.guardianv2].
• Domyślnie włączone od v0.156.0: /voice, zarządzane worktrees oraz ponowne użycie kompaktacji wątku nadrzędnego przez Guardian (klucze [features]: realtime_conversation, worktrees, guardian_reuse_parent_compaction).
• Nadal opcjonalne lub eksperymentalne: eksperymentalne zarządzanie kontekstem, Codex Cloud oraz tryb kodu.
• Modele: GPT-6 Sol (gpt-6-sol) do codziennego i złożonego programowania, GPT-6-Astra do najtrudniejszych zadań realizowanych od początku do końca (nadal wbudowany model domyślny CLI, gdy nie ustawiono innego modelu) oraz GPT-6 Luna do zadań wykonywanych na dużą skalę. 14 października 2026 GPT-5.5 przestanie być dostępny w Codex przy logowaniu przez ChatGPT.
• Przypięcie wersji: npm install -g @openai/codex@0.157.1, a następnie potwierdzenie za pomocą codex --version.¹⁷⁴¹⁷⁵

v0.157.1 (26 września 2026)

Poprawka dla Windows obejmująca cztery poprawki przeniesione z głównej gałęzi. Codex nie otwiera już okna konsoli podczas uruchamiania hosta trybu kodu ani lokalnego serwera stdio MCP. Serwer działający w tle może zostać uruchomiony, gdy Windows pozostawi 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 GitHub oraz wpis w dzienniku zmian podają jedynie, że najważniejszych zmian „nie udało się ustalić”; powyższa lista pochodzi z commitów tego wydania.

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

v0.157.0 (25 września 2026)

Wydanie, które domyślnie włącza trzy kolejne funkcje.

• Pełnoekranowy zapis rozmowy jest domyślnie włączony. Pełnoekranowy interfejs, który w v0.156.0 był dostępny przez /tui, jest teraz widokiem otwieranym na początku sesji, również wtedy, gdy konfiguracja nie zawiera sekcji [tui]. Aby zachować historię przewijania terminala, należy wybrać Scrollback w /tui albo ustawić fullscreen_transcript = false w sekcji [tui]; --no-alt-screen i tui.alternate_screen = "never" nadal mają pierwszeństwo. Kliknięcie z klawiszem Shift rozszerza teraz zaznaczenie zapisu rozmowy.
• Serwer działający w tle uruchamia się automatycznie przy kwalifikujących się uruchomieniach interaktywnych, a opcja znika z /experimental. Uruchomienia z --no-daemon, --oss, --profile lub większością nadpisań -c nie korzystają z tego serwera. Jeśli ustawienia działającego serwera nie odpowiadają sesji, Codex proponuje kontynuowanie bez niego, ponowne uruchomienie go z wymaganymi ustawieniami albo anulowanie operacji (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 synchronicznych i asynchronicznych przeglądów, niezależnie od przełącznika enabled 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, znajdują się również w tym wydaniu. Dodano je także do katalogów Amazon Bedrock, przy czym GPT-6 Sol zastępuje GPT-5.6 Sol jako domyślny model Bedrock. GPT-5.6 Sol traci poziom usługi ultrafast, pozostaje więc Fast. Wbudowany katalog nie oznacza już GPT-6-Astra jako modelu obsługującego eksperymentalne zarządzanie kontekstem (zob. Zarządzanie kontekstem).

Pozostałe nowości: skrót f rozwidla rozmowę otwartą w innej aplikacji, zachowując wersje robocze i prompty w kolejce; /import działa w sesjach zdalnych i korzystających z serwera działającego w tle; terminal renderuje punktory Unicode, pola wyboru oraz wyrównane równania. Poprawki utrzymują działanie rozmów głosowych po przełączeniu wątku, odzyskują niewysłane odpowiedzi po zakończeniu tury, respektują ustawienia myszy w tmux, kierują połączenia w czasie rzeczywistym i samodzielne wyszukiwanie w sieci przez skonfigurowane serwery proxy, ponawiają przejściowo nieudane przesyłanie plików z limitem czasu wynoszącym pięć minut oraz egzekwują ograniczenia sieciowe przy przekierowaniach i otwartych połączeniach HTTP oraz WebSocket. W systemie Windows dostęp do obiektów piaskownicy jest ograniczony do sesji logowania procesu wykonawczego.¹⁷⁴

v0.156.1 (23 września 2026)

Poprawka zawierająca jedną zmianę, która wprowadza GPT-6 Sol i GPT-6 Luna do stabilnej wersji CLI. Oba modele są teraz widoczne w selektorze /model poniżej GPT-6-Astra, który pozostaje na pierwszej pozycji i nadal jest wbudowanym modelem domyślnym, gdy w config.toml nie ustawiono modelu. Rodzina GPT-5.6 jest teraz oznaczona w selektorze jako starsze modele (GPT-5.6 Sol ma opis „Starszy model programistyczny do złożonych zadań”), a GPT-5.5 jako „Model programistyczny starszej generacji”. Przy zbliżaniu się do limitu użycia monit o zmianę modelu sugeruje teraz gpt-6-luna zamiast gpt-5.6-luna.

Jeśli konfiguracja wskazuje starszy model, należy spodziewać się jednorazowego monitu o migrację: zapisane wybory gpt-5.6-sol, gpt-5.6-terra, gpt-5.5 i gpt-5.4 zostaną skierowane do GPT-6 Sol, natomiast gpt-5.6-luna i gpt-5.4-mini — do 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 nie wspomina dokumentacja: we wbudowanym katalogu Fast (priority) jest ustawiony jako domyślny poziom usługi dla GPT-6 Sol i Luna. W rezultacie 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. Stan można sprawdzić przez /fast status; /fast off przełącza na Standard.

Co zrobić: należy przeprowadzić aktualizację, a następnie wypróbować codex -m gpt-6-sol przy znanym zadaniu. Dostępność zależy od planu, ustawień obszaru roboczego i etapu wdrożenia; administratorzy Enterprise muszą najpierw włączyć nowe modele.¹⁷¹

v0.156.0 (22 września 2026)

Wydanie, które jednocześnie domyślnie włącza trzy funkcje; dwie pierwsze ogłoszono tego samego dnia w dzienniku zmian dokumentacji.

• Funkcja głosowa jest domyślnie włączona. /voice rozpoczyna rozmowę na żywo w obsługiwanych kompilacjach bez konieczności odwiedzania /experimental. Wprowadzono również konfigurowalny przełącznik F8, selektor /voice settings do wyboru głosu używanego w przyszłych rozmowach, dołączone środowiska wykonawcze głosu dla Linux i Windows oraz obsługę ograniczonego ruchu.
• 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 daemonem i mogą być tworzone z poziomu przeglądu agentów.
• Ponowne użycie kompaktacji wątku nadrzędnego przez Guardian jest domyślnie włączone: po ponownym uruchomieniu sesji przeglądu Guardian może wykorzystać zaszyfrowaną kompaktację wątku nadrzędnego.

Instrukcje wyłączania każdej z tych funkcji znajdują się w wierszach /voice i /worktree tabeli slash commands oraz w sekcji poświęconej Guardian.

Pozostałe nowości: opcjonalny pełnoekranowy TUI, wybierany przez /tui, z wyszukiwaniem w zapisie rozmowy, zaznaczaniem i kopiowaniem za pomocą myszy, kopiowaniem prawym przyciskiem, klikalnymi linkami oraz przeglądarką ostrzeżeń; sześć wbudowanych motywów w selektorze /theme; panel analityczny /usage; diagramy Mermaid i wzory TeX renderowane w terminalu, każdy z osobnym przełącznikiem; menu /daemon i flaga --no-daemon; oraz domyślnie wyłączone podsumowania rozumowania w nowych wątkach TUI. Poprawki zabezpieczeń eliminują w piaskownicy Windows luki związane z ruchem przychodzącym, uprzywilejowanymi gniazdami i uchwytami plików tylko do odczytu, a codex doctor nie wyświetla już wartości konfiguracji w komunikatach o błędach. Poprawki błędów zachowują odpowiedzi przesyłane strumieniowo po nieudanych lub przerwanych turach, naprawiają przekazywanie schowka w tmux i SSH, przywracają tryb Plan po wznowieniu oraz umożliwiają odzyskanie logowania przez systemowe serwery proxy.¹⁶⁹

v0.155.1 (18 września 2026)

Pilna poprawka jednego błędu. W wersji 0.155.0 nowy lokalny wątek TUI bez model_reasoning_summary w konfiguracji żądał podsumowań detailed, a dostawcy nieobsługujący podsumowań rozumowania całkowicie odrzucali żądanie. Wersja 0.155.1 przywraca none jako wartość zapasową, więc brak ustawionego klucza oznacza brak żądania podsumowań. Jawne ustawienia auto, concise i detailed zawsze były i nadal są respektowane. Ta sama jednowierszowa zmiana trafiła również do głównej gałęzi i została wydana w 0.156.0.

Co zrobić: jeśli nowe sesje TUI w 0.155.0 nie działały z dostawcą innym niż OpenAI lub dostawcą obsługiwanym samodzielnie, należy przeprowadzić aktualizację. Aby korzystać z podsumowań, trzeba jawnie ustawić ten klucz (zob. dokumentację konfiguracji).¹⁵⁸

v0.155.0 (17 września 2026)

Funkcja głosowa trafiła do stabilnego TUI jako eksperymentalna funkcja opcjonalna: /voice otwierało rozmowę na żywo ze strumieniowym zapisem i elementami sterowania mikrofonem, włączaną przez /experimental w obsługiwanych kompilacjach, z konfigurowalnym skrótem wyciszenia i podpisanymi zasobami głosowymi w pakietach macOS. Pięć dni później v0.156.0 włączyła ją domyślnie. W tym wydaniu zarządzane worktrees pozostawały domyślnie wyłączone.

Pozostałe zmiany w 0.155.0:

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

Poprawki zabezpieczeń zamykają możliwości ucieczki przez współpracę z WSL oraz ujawniania poświadczeń w migawkach powłoki. Memory v2 pojawia się wyłącznie jako fundament przechowywania i konsolidacji danych, a nie jako gotowa do użycia funkcja.¹⁵⁶

v0.154.0 (9 września 2026)

To wydanie utworzono mniej więcej na poziomie 0.154.0-alpha.6, dlatego wszystko, co pojawiło się po raz pierwszy w alpha.7 (funkcja głosowa na żywo w TUI, weryfikacja użytkownika MCP, Memory v2, konfiguracja automatycznych aktualizacji daemona i przypinanie poziomu wysiłku rozumowania), musiało poczekać do 0.155.

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

Nowości:

• Eksperymentalne zarządzane worktrees przez --worktree lub /worktree, z obsługą codex exec i przeglądarką worktree w TUI.
• Asynchroniczne wiadomości użytkownika: można odpowiadać na pytania w tekście, gdy Codex kontynuuje pracę, bez utraty wersji roboczej.
• Obsługa usług Windows: przygotowywanie piaskownicy, daemon app-server w systemie Windows oraz zarządzane aktualizacje daemona.
• Zdalne profile uprawnień, wykrywane z serwera aplikacji i wybierane według nazwy w TUI.
• Tryb zastępowania Vim R, bieżący stan kompaktacji kontekstu oraz eksperymentalne zarządzanie kontekstem uzależnione od możliwości modelu przy uruchamianiu sesji.

Bezpieczeństwo: pomocnicze narzędzia PATH nie są już uruchamiane przed ustanowieniem zaufania do obszaru roboczego, a piaskownica macOS została wzmocniona przed wstrzykiwaniem danych wejściowych do terminala. Połączenia MCP koordynują odświeżanie tokenów OAuth, zdalne wznawianie i rozwidlanie zachowują zapisane uprawnienia, a wznowienie rozmowy otwartej w innej aplikacji wyświetla zapis tylko do odczytu. Funkcja głosowa została wydana wyłącznie jako infrastruktura środowiska wykonawczego, a pierwsze odwołania do Daybreak w kodzie pojawiły się bez publicznej dokumentacji.¹⁵²¹⁵³

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

Poprawki wydane tego samego dnia, które wprowadziły premierę GPT-6-Astra do CLI. v0.153.3 dodała Astra do katalogów Amazon Bedrock (GPT-5.6 Sol pozostał domyślnym modelem Bedrock) i poprawiła wskazówki Astra dotyczące asynchronicznego wyjaśniania. v0.153.4 umieściła Astra w selektorze modeli, ustanowiła go wbudowanym modelem domyślnym, gdy nie skonfigurowano żadnego modelu, oraz 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 v0.153.1 i pojawia się w selektorze od v0.153.4; nie udokumentowano minimalnej wersji CLI, dlatego należy traktować te wersje jako wartości graniczne. Jeśli konto nie ma dostępu do modelu wybieranego jako wbudowany model domyślny, należy jawnie ustawić model w config.toml, zamiast polegać na ustawieniu domyślnym.^145146147148

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

v0.153.1 sprawia, że punktacja użycia komputera przez Guardian respektuje wymagania modelu: punktacja wyłącznie dla użycia komputera i szybkie decyzje dotyczące zatwierdzeń są wykonywane tylko wtedy, gdy metadane aktywnego modelu ustawiają node_repl_auto_review_required. Zmiana modelu pomijająca punktację unieważnia wcześniejsze lub będące w toku wyniki, dlatego ponowne przełączenie nie może przywrócić nieaktualnego zatwierdzenia. Opis wydania wymienia jedynie przeniesiony wpis katalogowy GPT-6-Astra, konfigurowalny przez API; selektor i model domyślny nie zmieniły się aż do v0.153.4. v0.153.2 poprawia opis poziomu Fast modelu Astra z „1,5x” na „2x speed, increased usage” (wyłącznie tekst interfejsu).¹⁴²¹⁴³

v0.153.0 (3 września 2026)

• Cofanie i ponawianie w Vim: u i Ctrl+R przywracają kompletne wersje robocze edytora, w tym wklejoną zawartość i załączniki graficzne; vim_normal.redo jest konfigurowalną akcją mapowania klawiszy.
• Zdalne repozytoria wtyczek: CLI wtyczek może wyświetlać, instalować i usuwać zdalne wtyczki, a codex plugin list pokazuje źródło, wersję, zasady instalacji oraz 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 około pięciogodzinnym oknie pozostaje mniej niż połowa limitu; pozostałe plany zachowują progi 75/90/95%.
• Zakres Guardian zależy od trybu zatwierdzania: Full Access pomija przeglądy Guardian w przypadku działań wymagających jedynie potwierdzenia, a tryb zatwierdzania User pomija punktację w tle i wstępne przygotowanie.
• features.context_management.experimental_mode (domyślnie wyłączone) udostępnia kontekst oparty na budżecie tokenów, notatki historii oraz narzędzie new_context w kwalifikujących się sesjach Plus, Pro i Pro Lite korzystających z backendu Codex.
• tui.disable_paste_burst zastępuje klucz najwyższego poziomu, który nadal działa jako rozwiązanie zapasowe.

Poprawki: sesje TUI ponownie łączą się po utracie połączenia z app-server i zachowują wersje robocze, historia przeglądów Guardian przetrwa kompaktację, ponowne uruchomienia i rozwidlenia, a zapamiętane zatwierdzenia MCP są ograniczone do wybranego konta.¹⁴⁰

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

update_plan stało się funkcją opcjonalną: tools.update_plan.enabled ma domyślną wartość false, a gdy funkcja jest wyłączona, wbudowane wskazówki update_plan są usuwane z promptów modelu, trybu współpracy, obsługi wielu agentów, kompaktacji, wstępnego przygotowania i kontynuacji celu (zob. Tryb Plan i współpraca). Pozostałe nowości: wyszukiwanie w Vim za pomocą / i ? oraz n/N, z możliwością łączenia z operatorami, przy czym nowe wersje robocze rozpoczynają się w trybie Insert; banery limitów użycia umożliwiające podjęcie działania; postęp odświeżania poświadczeń, w tym ponownego uwierzytelniania Amazon Bedrock; nazwy serwerów MCP w stylu pakietów (dozwolone są :, @, / i .); żądania formularzy MCP openai/elicitation; indywidualny dla każdego narzędzia limit MCP output_token_limit; poświadczenia zadań w chmurze ograniczone do zaufanych źródeł; konfigurowalne limity czasu thread/shellCommand; oraz budżetowanie tokenów domyślnie włączone przez metadane modelu. v0.152.1 umożliwia przeglądowi zatwierdzeń Guardian pobieranie zasad 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ą aktywne.
• Hosty trybu kodu rezygnują z transportu WebSocket (pozostają wyłącznie stdio i gRPC).
• Trwałe wątki domyślnie korzystają ze stronicowanej historii tam, gdzie obsługuje ją magazyn.
• Pojawia się poziom wysiłku rozumowania persistent wraz z narzędziami zegara i wbudowanymi wskazówkami dotyczącymi proaktywności.
• Guardian v2 domyślnie korzysta z przeglądów użycia komputera z obrazami.
• Vim otrzymuje ruchy wyszukiwania do znaku i przed znak f/F/t/T oraz gg/G.
• Wprowadzanie danych do terminali z podwyższonymi uprawnieniami może wymagać nowego zatwierdzenia (write_stdin_approval, domyślnie wyłączone).
• Konfigurowalny okres karencji dla opcjonalnych serwerów MCP (mcp_optional_startup_grace_ms, domyślnie 1 000 ms), a rozszerzenia mogą sprawdzać lub zastępować wyniki narzędzi MCP.

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

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

Hooks otrzymują zdarzenie Interrupt, uruchamiane po przerwaniu aktywnej tury najwyższego poziomu (domyślny limit czasu 1 sekunda, maksymalnie 3 sekundy, nigdy dla subagentów). /copy otwiera selektor pozwalający wybrać pełną odpowiedź, poszczególne bloki kodu lub cytaty blokowe. Do zadań można odwoływać się za pomocą wzmianek @, agenci mogą odczytywać, tworzyć i przesyłać wiadomości do zadań, a /rename proponuje edytowalny tytuł. Linki Markdown są renderowane jako klikalne etykiety, skróty mogą przełączać tryby uprawnień, Vim otrzymuje powtarzanie przez ., a niezaufane projekty nie dostarczają już instrukcji AGENTS.md na poziomie projektu. features.network_proxy.credential_broker oraz review_scope.computer_use_only z Guardian v2 pojawiają się jako konfigurowalne i domyślnie wyłączone funkcje. v0.150.1 uwzględnia zachowane obrazy w budżecie tokenów zdalnej kompaktacji.¹³²¹³³

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

Zasada zatwierdzania untrusted zostaje wycofana; konfiguracje, które jej używają, należy przenieść na on-request. Nowości: interaktywny panel codex agents, /cd, /pwd i /cwd, codex queue do przesyłania wiadomości istniejącym sesjom lokalnym lub zdalnym, więcej ruchów zmiany w Vim, rozszerzone codex doctor (ochrona punktów końcowych, awarie sieci i proxy, stan aplikacji desktopowej, łączność z usługą aktualizacji) oraz poziomy wysiłku rozumowania max/ultra w SDK. Wznowione i rozwidlone wątki przywracają swój profil uprawnień. v0.149.1 dodaje codex exec --thread-source <SOURCE> (user, subagent, memory_consolidation albo nazwa funkcji; threadSource w TypeScript SDK).

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

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

v0.147.0 usuwa codex exec --full-auto (przestarzałe od v0.128); należy użyć --sandbox workspace-write wraz z flagą zatwierdzania lub profilem. Dodaje także --approve-for-me, przenośne Agent Plugins z wyszukiwaniem w katalogach, opcjonalny protokół MCP 2026-07-28 oraz sekcje rozmowy. v0.148.0 dodaje /export do Markdown, codex exec fork, szacowane kredyty 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 bezpiecznie odmawiają działania w przypadku odrzuconych lub nieczytelnych ścieżek.¹¹⁶¹¹⁸

Wcześniejsze wydania (maj–lipiec 2026)

• v0.146.0 i v0.146.1 (29 lipca, 5 sierpnia): skonfigurowane serwery proxy obejmują każdy transport; manifesty Agent Plugins oraz repozytoria Amazon Bedrock i Claude Code; nadawanie nazw sesjom z przypinaniem wątków; skills dostarczane przez proces wykonawczy; wzmocnione domyślne ustawienia automatycznego przeglądu dla modeli obsługujących zadania cyberbezpieczeństwa.¹¹⁴¹¹⁵
• v0.145.0 (21 lipca): /import z Cursor oraz Claude Code; funkcja głosowa powraca jako strumieniowe rozmowy w czasie rzeczywistym V3; ustabilizowano opcjonalne środowisko wielu agentów v2; eksperymentalna stronicowana historia wątków i logowanie Amazon Bedrock; wbudowane wybory GPT-5.4 są migrowane do GPT-5.6 Terra i Luna. v0.144.6 ustawiła 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 zaszyfrowany magazyn lokalny poświadczeń OAuth dla CLI i MCP; stare elementy sterowania głosem /realtime zostały usunięte.¹⁰²
• v0.139.0 (9 czerwca): tryb kodu może bezpośrednio wywoływać wyszukiwanie w sieci, schematy narzędzi zachowują oneOf/allOf, codex doctor raportuje szczegóły edytora i programu stronicującego, a źródła repozytoriów pojawiają się w wyniku JSON.¹⁶⁵
• v0.138.0 (8 czerwca): /app przekazuje sesję CLI do aplikacji desktopowej, a treść zadań przesyłana od agenta nadrzędnego do subagenta jest szyfrowana w środowisku wielu agentów v2.¹⁶⁶¹⁰⁸
• v0.137.0 (4 czerwca): środowisko wielu agentów v2, skróty klawiszowe TUI F13–F24 oraz rozszerzenie skills v1.¹⁶⁷
• v0.132.0–v0.135.0 (20–28 maja): wyszukiwanie lokalnej historii rozmów, --profile jako główny selektor profilu, domyślnie włączone cele, dziedziczenie profili uprawnień i zarządzane requirements.toml, uruchamianie i zatrzymywanie codex remote-control, bogatsze codex doctor i /status, obiekty tekstowe Vim, nazwane profile uprawnień w /permissions, uwierzytelnianie Python SDK i ustawienia wstępne Sandbox oraz codex exec resume --output-schema. Aktualizacja aplikacji z 21 maja dodała Appshots, powszechnie dostępny tryb Goal oraz opcjonalnie blokowane Computer Use.^{96979899100101176}

Starsze --full-auto zostało usunięte w v0.147.0, a js_repl nadal pozostaje usunięte.^86878991116

Uwaga dotycząca stabilności: stabilne, udokumentowane funkcje obejmują podstawowy CLI i TUI, piaskownicę i zasady zatwierdzania, config.toml, AGENTS.md, skills, hooks, wtyczki, narzędzia wielu agentów, cele, profile uprawnień, /voice i zarządzane worktrees (domyślne od v0.156.0), a także pełnoekranowy zapis rozmowy i automatyczne uruchamianie serwera działającego w tle (domyślne od v0.157.0). Browser, Computer Use i Appshots to udokumentowane funkcje dla użytkowników, których dostępność zależy od platformy i planu. Eksperymentalne lub w trakcie rozwoju: Codex Cloud, tryb kodu, eksperymentalne zarządzanie kontekstem, Memory v2, lokalna tablica wiadomości agentów oraz wszystko oznaczone w tym przewodniku jako [EXPERIMENTAL] lub wymienione w /experimental; elementy te mogą się zmieniać między wydaniami. Usunięte: --full-auto (v0.147.0), zasada zatwierdzania untrusted (v0.149.0), codex mcp-server (v0.154.0) oraz js_repl.

Kanał alpha: kompilacje alpha ukazują się kilka razy dziennie, opisy wydań w liniach alpha są szablonowe, a kompilacje poza regularnym cyklem tworzone ze starszych baz pojawiają się systematycznie (najnowsze: 0.155.0-alpha.16.4, 0.157.0-alpha.11.1, 0.158.0-alpha.15.1 i 0.158.0-alpha.2.1). Co najmniej dwukrotnie znacznik npm alpha wskazywał jedną z nich, przez co @alpha instalowało kompilację starszą niż latest. Linia 0.158 rozwijała się od 0.158.0-alpha.2 (23 września) do alpha.15 (25 września), lecz nie doczekała się stabilnego wydania; 25 września znacznik alpha przeniesiono do linii 0.159, która obecnie znajduje się na wersji 0.159.0-alpha.4. W przypadku śledzenia wersji alpha należy sprawdzać npm view @openai/codex dist-tags i instalować konkretną wersję zamiast @alpha.¹⁷²¹⁷⁵ Datowana historia przechodzenia ostatnich linii alpha w stabilne wydania znajduje się w ¹⁷³.

Jak działa Codex: model mentalny

Przed omówieniem funkcji warto zrozumieć, w jaki sposób architektura Codex kształtuje wszystkie sposoby korzystania z tego narzędzia. System działa na pięciu płaszczyznach 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 / Landlock / 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 bazowa: Rodzina modeli GPT napędza cały system. Według stanu na 23 września 2026 obecną generacją jest GPT-6: gpt-6-sol do codziennych i złożonych zadań programistycznych, gpt-6-astra do najtrudniejszych zadań realizowanych od początku do końca (a także jako domyślny model dołączony do CLI, gdy nie skonfigurowano innego modelu) oraz gpt-6-luna do precyzyjnie określonych zadań wykonywanych na dużą skalę. 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, natomiast gpt-5.4 wycofano z Codex 31 sierpnia 2026.^{83117146148149171} Warstwa ta odczytuje pliki, zapisuje poprawki, wykonuje polecenia powłoki i analizuje bazę kodu. Po zapełnieniu kontekstu Codex kompresuje rozmowę, aby zwolnić miejsce. Korzystanie z tej warstwy zużywa tokeny.

Warstwa zabezpieczeń: Każde polecenie wykonywane przez Codex przechodzi przez piaskownicę na poziomie systemu operacyjnego. W systemie macOS platforma Seatbelt firmy Apple wymusza ograniczenia na poziomie jądra. W systemie Linux Landlock + seccomp filtrują dostęp do systemu plików i wywołań systemowych. Piaskownica działa na poziomie jądra, a nie wewnątrz kontenerów. Następnie zasady zatwierdzania określają, kiedy należy poprosić człowieka o potwierdzenie.

Warstwa rozszerzeń: MCP łączy usługi zewnętrzne (GitHub, Figma, Sentry). Skills obejmują wielokrotnego użytku przepływy pracy, 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 realizację niezależnych zadań asynchronicznych.

Kluczowy 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 wymagających zalogowania w przeglądarce.

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. Struktury podejmowania decyzji
8. Jak działa system piaskownicy i zatwierdzania?
9. Jak działa AGENTS.md?
10. Hooks
11. Czym jest MCP (Model Context Protocol)?
12. Tryb Code Mode
13. Środowisko wykonawcze REPL JavaScript
14. Czym są skills?
15. Plugins
16. 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. Dobre praktyki i antywzorce
28. Przepisy na przepływy pracy
29. Przewodnik po migracji
30. Skrócona karta informacyjna
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ć, obniżyć wersję lub odinstalować Codex CLI?

Od wersji v0.128.0 Codex udostępnia polecenie do samodzielnej aktualizacji; wszystkie pozostałe operacje wykonuje się za pomocą menedżera pakietów, którego użyto do instalacji.⁸⁶ Od wersji v0.146.0 artefakty wydań, metadane kanałów oraz aliasy instalatorów są udostępniane przez infrastrukturę wydań hostowaną przez OpenAI, z GitHub jako rozwiązaniem rezerwowym.¹¹⁴ Jeśli lista dozwolonych adresów w sieci obejmuje GitHub na potrzeby instalacji i aktualizacji Codex, należy dodać do niej również hosta wydań OpenAI — dzięki rozwiązaniu rezerwowemu brak wpisu na liście dozwolonych adresów powoduje dyskretne przejście na alternatywne źródło zamiast wyraźnego błędu.

# Check what you are running
codex --version                          # -> codex-cli 0.157.1
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

Przypięcie wersji jest właściwym rozwiązaniem, gdy nowe wydanie powoduje problemy. Codex rozwija się w ramach szybko aktualizowanej stabilnej gałęzi, dlatego instalacja konkretnej wersji to najszybszy sposób wycofania zmian — należy zgłosić problem, przypiąć wersję i kontynuować pracę. Warto potwierdzić wycofanie poleceniem codex --version, ponieważ druga, przesłonięta instalacja znajdująca się w PATH może po cichu nadal uruchamiać poprzedni plik binarny (codex doctor wskazuje dokładnie ten problem w sekcji Environment).

Odinstalowanie pakietu nie usuwa danych użytkownika. Dane uwierzytelniające, konfiguracja i historia sesji znajdują się w ~/.codex/. Pozostawienie tego folderu pozwala zachować dane logowania i historię po ponownej instalacji; należy go usunąć tylko wtedy, gdy potrzebny jest rzeczywiście czysty stan początkowy — rm -rf ~/.codex usuwa również config.toml, auth.json oraz wszystkie zapisane sesje.

Skrypt instalacji bezpośredniej (v0.106.0+)

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

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

Skrypt automatycznie wykrywa platformę i architekturę, pobiera właściwy plik binarny oraz umieszcza go w PATH.

Pobieranie plików binarnych

W środowiskach bez npm lub Homebrew należy pobrać pliki binarne odpowiednie dla danej platformy ze strony wydań GitHub¹:

Wymagania systemowe

• macOS: Apple Silicon lub Intel (pełna obsługa piaskownicy za pomocą Seatbelt)
• Linux: x86_64 lub arm64 (piaskownica za pomocą Landlock + seccomp)
• Windows: natywna piaskownica z ograniczonymi tokenami (od wersji v0.100.0 nie jest już funkcją eksperymentalną). 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

Dostępne są 2 metody uwierzytelniania:

1. Konto ChatGPT (zalecane): należy zalogować się przy użyciu istniejącej subskrypcji Plus, Pro, Team, Business, Edu lub Enterprise. Zapewnia to dostęp do wszystkich funkcji, w tym zadań w chmurze.
2. Klucz API: można go ustawić 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. Dostępne opcje: file (domyślna), keyring (systemowy pęk kluczy) lub auto (pęk kluczy, jeśli jest dostępny; 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. Jest ona dostępna obok istniejącego zarządzanego uwierzytelniania kluczem API (v0.140.0+) oraz łańcucha danych uwierzytelniających AWS (zob. Niestandardowi dostawcy modeli). GPT-5.6 Sol jest domyślnym modelem Bedrock.¹¹² Wersja v0.150.0 naprawia kompaktowanie konwersacji oraz zgodność modeli Amazon Bedrock z obsługą wielu agentów.¹³² Wersja v0.151.0 dodaje opcję Amazon Bedrock chronioną flagą funkcji do kwalifikujących się procesów logowania w TUI: podczas wdrażania wykrywane są istniejące profile AWS i dane uwierzytelniające ze zmiennych środowiskowych, udostępniana jest ręczna konfiguracja profili, kluczy dostępu, zmiennych środowiskowych oraz kluczy API Bedrock, pobierany jest region AWS, podczas wprowadzania dane poufne są maskowane, a po zmianie dostawcy wbudowany serwer zostaje uruchomiony ponownie.¹³⁵ Wersja v0.152.0 pokazuje postęp odświeżania danych uwierzytelniających: TUI oraz codex exec wyświetlają postęp, gdy dostawca modelu odświeża wygasłe dane uwierzytelniające, również podczas ponownego uwierzytelniania sesji Amazon Bedrock. Mechanizm opiera się na stabilnych powiadomieniach serwera aplikacji modelProvider/authRecoveryStarted i modelProvider/authRecoveryCompleted, które zawierają informacje o wątku, turze, dostawcy oraz komunikat przeznaczony 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

Weryfikacja instalacji

codex --version
# codex-cli 0.157.1

Szybki start: pierwsza sesja

Od rozpoczęcia do produktywnej 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 projektu:

cd ~/my-project                  # Any git repo works

3. Uruchomienie Codex:

codex

Zostanie wyświetlony 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 bazę kodu. Takie pytanie nie powoduje żadnych zmian — Codex modyfikuje pliki wyłącznie na wyraźne polecenie, a piaskownica i approval policy 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. Można je sprawdzić i zatwierdzić klawiszem y albo odrzucić klawiszem n.

6. Użycie slash command:

> /plan Refactor the database layer to use connection pooling

Codex tworzy plan bez jego wykonywania. Należy przejrzeć plan, a następnie zatwierdzić rozpoczęcie realizacji.

7. Sprawdzenie wykonanej pracy:

> /diff

Wyświetlone zostaną wszystkie zmiany wprowadzone przez Codex w bieżącej sesji.

Co dalej: - Skonfigurować AGENTS.md z instrukcjami dotyczącymi projektu (zob. Jak działa AGENTS.md?) - Skonfigurować profil odpowiedni do danego przepływu pracy (zob. Profile) - Wypróbować codex exec do automatyzacji nieinteraktywnej (zob. Tryb nieinteraktywny)

Główne interfejsy interakcji

Codex udostępnia pięć odrębnych interfejsów korzystających z tej samej inteligencji. Każdy z nich zoptymalizowano pod kątem 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 obejmująca:

• Pole wprowadzania: wpisywanie promptów, dołączanie plików za pomocą @, uruchamianie poleceń powłoki z prefiksem !
• Panel wyników: strumieniowe odpowiedzi modelu, wywołania narzędzi i wyniki poleceń
• Pasek stanu: model, wykorzystanie tokenów, gałąź git, tryb sandbox

Najważniejsze skróty TUI:

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

Slash commands dostępne w TUI:

Przeprojektowanie selektora przepływu pracy (v0.129.0): wznowienie i rozwidlenie są teraz łatwiej dostępne w przeprojektowanym selektorze, a nowy surowy tryb historii przewijania umożliwia przewijanie niewyrenderowanej transkrypcji, gdy trzeba skopiować polecenia lub wynik modelu w niezmienionej postaci. Przydaje się to 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 otwiera teraz domyślnie jedno menu wzmianek obejmujące pliki, pluginy i skills, zastępując mechanizm dołączania ograniczony wyłącznie do 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 równoległych agentów w różnych projektach
• Izolacja za pomocą git worktree: każdy wątek pracuje na izolowanej kopii repozytorium
• Wbudowany przegląd różnic: dodawanie zmian do obszaru staging, cofanie ich i tworzenie commitów bez opuszczania aplikacji
• Zintegrowany terminal: osobny terminal dla każdego wątku, służący do uruchamiania poleceń
• Rozwidlanie rozmów: tworzenie odgałęzień rozmowy w celu zbadania alternatyw
• Pływające odłączane okna: wydzielanie rozmów do przenośnych okien
• Automatyzacje: planowanie zadań cyklicznych (selekcja zgłoszeń, monitorowanie CI, reagowanie na alerty)
• Appshots: dołączanie do wątku okna aktywnej aplikacji na Macu w postaci zrzutu ekranu wraz z dostępnym tekstem
• Komentarze w przeglądarce w aplikacji: podgląd stron lokalnych lub publicznych, pozostawianie komentarzy dotyczących elementów lub obszarów oraz umożliwienie Codex reagowania na precyzyjne uwagi wizualne
• Computer Use: umożliwienie Codex obsługi dozwolonych aplikacji na Macu w ramach ograniczonych zadań GUI; zablokowany tryb obsługi jest opcjonalny w kwalifikujących się zdalnych turach Mac Computer Use

ChatGPT Voice, obsługiwany przez GPT-Live (desktop 26.715, 23 lipca 2026): aplikacją desktopową można teraz sterować głosem — omawiać pracę i koordynować zadania w Chat, Work oraz Codex bez pisania. W systemie macOS włączenie opcji Screen context udostępnia rozmowie appshot aktywnego okna, dzięki czemu można pytać o oglądaną zawartość zamiast ją opisywać. Funkcja jest dostępna w planach Plus, Pro, Business, Edu i Enterprise, w aplikacji desktopowej oraz zdalnie na 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 uruchamiane spacją (dodane eksperymentalnie w v0.105.0).¹¹³¹⁶⁹

Udostępniane migawki wątków (20 sierpnia 2026): we wszystkich planach Codex aplikacja desktopowa dla macOS może udostępnić migawkę lokalnego wątku Codex w trybie tylko do odczytu. Migawka nie jest aktualizowana po zmianie oryginalnego wątku; linki z kont osobistych może otworzyć każda osoba mająca link, natomiast linki z kont obszaru roboczego są dostępne wyłącznie dla członków źródłowego obszaru roboczego. Przed udostępnieniem Codex redaguje znane wzorce danych poufnych, ale OpenAI zaleca sprawdzenie udostępnianej treści, ponieważ wciąż może zawierać informacje wrażliwe. Linki można przeglądać i unieważniać w ustawieniach danych ChatGPT, w sekcji Shared links.¹²⁸

Kiedy używać aplikacji, a kiedy CLI: aplikacja desktopowa sprawdza się podczas koordynowania wielu strumieni pracy lub gdy potrzebny jest wizualny przegląd różnic. CLI warto wybrać, gdy istotna jest możliwość łączenia operacji terminalowych, tworzenia skryptów lub integracji z CI/CD.

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

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

• Domyślny tryb agenta: odczytuje pliki, wprowadza zmiany i uruchamia polecenia
• Edycja bezpośrednia: sugestie uwzględniające kontekst w aktywnych plikach
• Współdzielone sesje: sesje są synchronizowane między CLI a rozszerzeniem IDE
• To samo uwierzytelnianie: logowanie za pomocą konta ChatGPT lub klucza API

Instalacja jest możliwa z VS Code Marketplace lub sklepów z rozszerzeniami Cursor/Windsurf.³

4. Codex Cloud [EXPERIMENTAL]

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

• Zlecanie bez oczekiwania: zadania można umieszczać w kolejce, aby działały niezależnie od lokalnego komputera
• Wykonywanie równoległe: jednoczesne uruchamianie wielu zadań w chmurze
• Tworzenie PR: Codex tworzy pull requests na podstawie ukończonej pracy
• Lokalne zastosowanie zmian: pobranie 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 na stronie 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, zapewniając piąty interfejs obok CLI, aplikacji desktopowej, rozszerzenia IDE oraz chmury. Rozszerzenie dla Chrome udostępniono w maju 2026; w dzienniku zmian z 25 sierpnia 2026 dodano pozostałe cztery przeglądarki, konfigurowane w aplikacji desktopowej ChatGPT przez Settings > Computer Use. Wszystkie pięć obsługuje wzmianki o kartach i sterowanie przeglądarką; Opera nie obsługuje rozmów bocznych, dlatego zadania dla niej należy uruchamiać z aplikacji desktopowej. Rozszerzenie zaprojektowano tak, aby towarzyszyło zwykłemu przeglądaniu stron, a nie przejmowało nad nim kontroli: Codex pracuje równolegle na kartach w tle, natomiast użytkownik zachowuje kontrolę nad tym, z którymi witrynami może wchodzić w interakcję.⁹⁰¹²⁷

• Równoległa obsługa kart: Codex działa jednocześnie na wielu kartach bez blokowania karty na pierwszym planie.
• Kontrola dla poszczególnych witryn: użytkownik tworzy listę dozwolonych witryn, z którymi Codex może wchodzić w interakcję; domyślnie nie ma dostępu do żadnej.
• Przeglądarka jako warsztat pracy: rozszerzenie najlepiej sprawdza się podczas pracy z aplikacjami i witrynami, w której strona stanowi źródło prawdy — w konsolach administracyjnych, wewnętrznych panelach, interfejsach systemów zarządzania treścią i systemach zgłoszeń — nie zastępuje jednak CLI podczas pracy z lokalnymi repozytoriami.
• Ta sama inteligencja: rozszerzenie przeglądarki korzysta z tej samej inteligencji GPT-5.x-Codex co pozostałe interfejsy, dlatego konfiguracja AGENTS.md lub skills działająca w CLI przenosi te same konwencje do pracy wykonywanej w przeglądarce.

Rozszerzenie można zainstalować zgodnie z dokumentacją rozszerzenia przeglądarki, na stronie noszącej wcześniej tytuł Codex for Chrome.¹²⁷

Szczegółowe omówienie 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 razie konfliktu.

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

1. Nadpisania sesji (najwyższe): flagi CLI (--model, --sandbox, --ask-for-approval, --search, --enable/--disable, --profile) oraz nadpisania -c key=value
2. Konfiguracja projektu (.codex/config.toml, wykrywana od CWD w górę aż do katalogu głównego projektu; pierwszeństwo ma 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 użytkownikom. Więcej informacji zawiera sekcja Wdrożenie w przedsiębiorstwie.

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 komputerowej (26.715, 23 lipca 2026): Lokalny projekt w aplikacji komputerowej ChatGPT może teraz 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 w folderze głównym; foldery dodatkowe pozostają dostępne do wyszukiwania, odczytywania i edytowania plików, ale nie wnoszą żadnej konfiguracji. Plik .codex/config.toml znajdujący się w folderze dodatkowym jest plikiem, który Codex może odczytać, a nie ładowaną konfiguracją. Jest to sposób określania zakresu projektu w aplikacji komputerowej, 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-sol"                    # Docs' example default; unset = bundled default (gpt-6-astra)
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"]

# ─── 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)
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)

# 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.

# ─── 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 przyjmuje typ boolean | table. Forma logiczna jedynie uruchamia lub zatrzymuje proxy; forma tabeli zawiera zasady. To proxy wymusza reguły domen profilu uprawnień dla poleceń uruchamianych w sandboxie: gdy jest wyłączone, reguły domen [permissions.<name>.network] nie są egzekwowane, a polecenia uzyskują bezpośredni dostęp do sieci. 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 jest osobnym plikiem — ~/.codex/<name>.config.toml, zawierającym wyłącznie klucze najwyższego poziomu — a --profile <name> nakłada ten plik na ~/.codex/config.toml. Starsze tabele [profiles.<name>] w 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-sol"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "workspace-write"

Plik profilu stanowi warstwę powyżej podstawowej konfiguracji użytkownika, a poniżej konfiguracji projektu i CLI, dlatego musi zawierać jedynie wartości różniące się od konfiguracji podstawowej.¹²²

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

Łączenie 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"

Ostrzeżenie: Protokół komunikacyjny chat/completions API (wire_api = "chat") został wycofany dla 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 używać modeli lokalnych, należy zastosować flagę --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 też określić to w konfiguracji:

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

Nadpisania konfiguracji w wierszu poleceń

Dowolną wartość konfiguracji można nadpisać 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 zalecanym przez OpenAI wyborem do większości zadań Codex: złożonego programowania, obsługi komputera, pracy z wiedzą i badawczych przepływów pracy. Od 23 kwietnia dostępny w Codex CLI / wersji internetowej / aplikacji komputerowej dla planów ChatGPT Plus / Pro / Business / Enterprise / Edu / Go; od 24 kwietnia w OpenAI API. Okno kontekstu: 400K w Codex, 1M w API — Codex ogranicza okno do 400K, aby zrównoważyć przepustowość i koszty 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; według OpenAI efektywny wzrost wynosi około 20% po uwzględnieniu poprawy wydajności tokenów). Wyniki testów: 82,7% w Terminal-Bench 2.0 (ówczesny najlepszy wynik wśród publicznie dostępnych modeli), 84,9% w GDPval (44 zawody), 78,7% w OSWorld-Verified, 98,0% w Tau2-bench Telecom (bez dostrajania monitu). Przed premierą OpenAI użyło wewnętrznie GPT-5.5 wraz z Codex do przepisania infrastruktury obsługującej modele, co zwiększyło szybkość generowania tokenów o 20%.⁸³

GPT-5.5 zostanie wycofany z Codex przy logowaniu przez ChatGPT 14 października 2026 — dokumentacja modeli obejmuje wycofaniem ChatGPT, ChatGPT Work i Codex we wszystkich planach (w tym konsumenckich, Business, Enterprise i Edu), wskazując jednocześnie, ż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 komputerowej, w obu przypadkach „gdy będzie dostępny”. Należy zastąpić gpt-5.5 w domyślnych ustawieniach przestrzeni roboczej, zapisanych ustawieniach modelu, konfiguracjach zarządzanych, niestandardowych agentach, zaplanowanych zadaniach i skryptach.¹⁷¹

GPT-5.4 i GPT-5.4 mini zostały wycofane z Codex przy logowaniu przez ChatGPT 31 sierpnia 2026.¹¹⁷ Dokumentacja modeli wskazuje obecnie gpt-6-sol i gpt-6-luna jako ich zamienniki (w planach Enterprise i Edu model Luna musi najpierw włączyć administrator); korzystanie z klucza API pozostaje bez zmian.⁶⁴¹⁷¹ Dokładna lista modeli różni się w zależności od konta i etapu wdrażania. Lokalną pamięć podręczną można sprawdzić tutaj: ~/.codex/models_cache.json.

Uwaga dotycząca wycofania (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 aż do wyłączenia 23 lipca 2026.⁷¹⁸⁸

Uwaga dotycząca planu bezpłatnego (5 maja 2026): 5 maja 2026 model GPT-5.5 Instant został udostępniony w bezpłatnym planie ChatGPT. Poszerzyło to grono odbiorców rodziny GPT-5.5 poza użytkowników planów płatnych, choć dostęp do Codex CLI nadal wymaga kwalifikującej się 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, kosztujący 0,75/4,50 USD za MTok — wykorzystuje zaledwie 30% limitu GPT-5.4. Doskonale nadaje się do delegowania pracy subagentom: GPT-5.4 może zajmować się planowaniem i koordynacją, a subagenty GPT-5.4 mini — równolegle wykonywać węższe podzadania (przeszukiwanie bazy kodu, przegląd plików, przetwarzanie dokumentów).⁷⁶

Bedrock GPT-5.6 (Sol, Terra, Luna) (v0.143.0, 8 lipca 2026): w Codex dodano natywną obsługę trzech wariantów modelu GPT-5.6 hostowanych w Amazon Bedrock, w tym poziomu nakładu na rozumowanie max. Zespoły uzyskujące dostęp do modeli za pośrednictwem dostawcy Bedrock mogą wybierać je tak samo jak inne modele niestandardowych dostawców (zob. Niestandardowi dostawcy modeli); poziom nakładu max jest przeznaczony do najtrudniejszych zadań wymagających rozumowania i autonomicznego działania.¹⁰⁶ W wersji v0.144.6 (18 lipca 2026) zaktualizowano dołączone instrukcje dla modeli Sol, Terra i Luna oraz skorygowano ich okna kontekstu do 272 000 tokenów.¹¹¹ Wersja 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 dołączone wybory modeli GPT-5.4 do odpowiadających im wariantów Terra i Luna.¹¹²

GPT-6-Astra (udostępniony 3 września 2026; w Codex od v0.153.1–v0.153.4): chronologia z dokładnymi datami przedstawia się następująco: 3 września 2026 w v0.153.1 przygotowano wpis katalogu dostępny wyłącznie w API; tego samego dnia OpenAI ogłosiło GPT-6-Astra; 4 września w v0.153.4 dodano pozycję w selektorze i ustawiono ten model jako dołączony domyślny wybór CLI. W ogłoszeniu opisano stopniowe wdrażanie, rozpoczynające się od ograniczonej grupy organizacji (najpierw partnerów programu cyberbezpieczeństwa), a następnie rozszerzane „w kolejnych dniach” na ChatGPT Plus, Pro, Business i Enterprise, a także OpenAI API i AWS — informacje o wdrażaniu pochodzą z doniesień medialnych (CNBC, Axios, Forbes, Al Jazeera, 9to5Mac).¹⁴⁵ Informacja zaktualizowana 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 i Codex” oraz „działa już w API”, a dostępu dla użytkowników Plus i Business oczekiwano w ciągu kilku dni. Tego samego wieczoru Tibo Sottiaux, kierujący zespołem Codex, dodał: „Model Astra został już udostępniony także wszystkim użytkownikom Plus i Business”. W praktyce uprawnienia nadal nie są jednolite — według zgłoszeń społeczności z 5 września część kont Plus wciąż widziała w Codex wyłącznie modele GPT-5.6 — a cytowana poniżej informacja o dostępności w dokumentacji modeli nie uległa zmianie, więc pozostaje obowiązującym stanowiskiem źródła pierwotnego.¹⁴⁹ Dostępna jest już oficjalna dokumentacja: strona modelu w API przedstawia gpt-6-astra jako model flagowy, „Nasz model o największych możliwościach, stworzony do najtrudniejszych, kompleksowych zadań” — 10 USD/MTok wejściowy, 50 USD/MTok wyjściowy 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 udokumentowanym poziomem cenowym dla długiego kontekstu: dla monitów przekraczających 272K tokenów wejściowych całość żądania kosztuje 2 razy więcej za wejście i 1,5 raza więcej za wyjście, czyli według strony cennika 20 USD/MTok wejściowy i 75 USD/MTok wyjściowy. Pozycjonuje to model powyżej GPT-5.6 Terra (wariant zrównoważony) i Luna (wariant ekonomiczny), a dokumentacja Codex określa Astra jako zalecany model Codex, którego dostępność „zależy od etapu wdrażania, metody logowania i używanego klienta”, oraz wskazuje uprawnione konta Pro, Business (100 USD) i Enterprise. Udokumentowane poziomy rozumowania Astra w Codex to: Low, Medium, High, Extra High, Max, Ultra — strona modeli w dokumentacji wskazuje Medium jako poziom domyślny, natomiast dołączony katalog w v0.153.4 ustawia default_reasoning_level na low. Efektywną wartość domyślną należy więc traktować jako zależną od interfejsu i sprawdzić za pomocą /status w sesji; poziomy pozostały niezmienione po ponownym sprawdzeniu 15 września, gdy dodano opisy poszczególnych opcji w selektorze (dosłowny opis Ultra: „Maksymalne rozumowanie z automatycznym delegowaniem zadań”), a poziomy Max i Ultra wymagają potwierdzenia SDK — wydanie 0.154.0 Python SDK (10 września 2026) dodaje wartości nakładu na rozumowanie max i ultra (#39662).^146148153 W CLI model Astra można konfigurować przez API od v0.153.1 (-m gpt-6-astra), został dodany do katalogów Amazon Bedrock w v0.153.3 (GPT-5.6 Sol pozostał domyślnym modelem Bedrock do czasu zastąpienia go przez GPT-6 Sol w v0.157.0¹⁷⁴), a od v0.153.4 znajduje się w selektorze modeli i jest dołączonym modelem domyślnym, gdy żaden model nie został jawnie skonfigurowany — nie udokumentowano minimalnej wersji CLI, dlatego te wersje należy traktować jako faktyczne minima. Ta zmiana wartości domyślnej jest właściwością dołączonego katalogu CLI, a nie wszystkich interfejsów — choć luka w chmurze została później zamknięta: według stanu z 4 i 7 września Astra był niedostępny dla Codex cloud (dostępny był tam GPT-5.6 Sol), natomiast ponowne sprawdzenie 15 września wykazało, że macierz dostępności oznaczała Astra jako dostępny również dla Codex cloud; strona nadal zastrzegała: „Obecnie nie można zmienić domyślnego modelu dla czatów Codex cloud”. Zastrzeżenie dotyczące wdrażania: uprawnienia różnią się w zależności od konta, a w CLI 0.153.4+ konto nieobjęte wdrożeniem ma dołączony model domyślny, którego nie może jeszcze obsłużyć — aby zapewnić deterministyczny wybór, należy przypiąć model w config.toml (lub przekazać -m); od v0.156.1 przykładem w samej dokumentacji jest model = "gpt-6-sol". Rozliczanie trybu Fast dla Astra jest udokumentowane, mimo że strona modeli nie wymienia poziomu Fast: dokumentacja szybkości Codex wycenia go przy logowaniu przez ChatGPT na 2,5 raza więcej kredytów niż Standard („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” z tekstu katalogu v0.153.2 pozostaje wyłącznie 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” zaczyna się obecnie od GPT-6 Sol i Luna, rezerwuje Astra do „najtrudniejszych, kompleksowych zadań”, oznacza go jako niedostępny dla Codex cloud i podaje Light (low) jako początkowy poziom rozumowania, zgodnie z dołączonym katalogiem. Astra pozostaje domyślnym dołączonym modelem CLI, gdy nie skonfigurowano żadnego modelu.¹⁷¹

Ustawienia Power dla Astra (dodane do dokumentacji najpóźniej 6 września 2026): fragment dokumentacji modeli Codex poświęcony selektorowi modeli przypisuje obecnie opcje Power selektora do poziomów rozumowania GPT-6-Astra — jest to pierwsze w dokumentacji przypisanie ustawień Power do Astra — w akapicie nieobecnym podczas ponownego sprawdzenia 5 września opisanego w ¹⁴⁶ i potwierdzonym jako opublikowany 7 września. Dosłownie: „W przypadku kwalifikujących się 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. Dostępne opcje mogą różnić się w zależności od planu i etapu wdrażania”. Poprzednie zdanie dokumentacji wskazuje, że ilustracje selektora nadal przedstawiają elementy sterujące GPT-5.6. W zestawieniu z powyższą tabelą modeli: „Power” oznaczał GPT-5.6 Sol z poziomem rozumowania medium; na uprawnionym koncie ten sam zestaw ustawień obejmuje obecnie modele Terra, Sol i Astra ze stałymi poziomami rozumowania, a dostępne opcje nadal zależą od planu i etapu wdrażania. Podczas ponownego sprawdzenia 15 września 2026 akapit pozostał niezmieniony.¹⁴⁶ Aktualizacja z 23 września 2026: po premierze GPT-6 Sol i Luna dokumentacja wymienia sześć ustawień Power: „Luna High, Sol Light (ustawienie początkowe), Sol Medium, Astra Light, Astra Medium i Astra Extra High”, wskazuje, że w niektórych planach płatnych brakuje Astra Extra High, oraz sugeruje rozpoczęcie od Medium dla Sol, High dla Luna i Light (low) dla Astra.¹⁷¹

Uwagi eksperymentalne między oknami kontekstu (Astra, opublikowane w dokumentacji, funkcja opcjonalna): strona dokumentacji modeli Codex zawiera sekcję zatytułowaną „Experimental context management”, której dosłowna treść brzmi: „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, a w chwili premiery nie jest dostępny przy logowaniu przez Business, Enterprise ani za pomocą klucza API”. Dosłowny opis sposobu włączenia: „Aby włączyć tę funkcję, 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 udostępniono w v0.153.0 (zob. Zarządzanie kontekstem) — strona dokumentacji wiąże go teraz z nazwą Astra oraz logowaniem przez Plus i Pro, podczas gdy informacje o wydaniu v0.153.0 wymieniały kwalifikujące się sesje Plus, Pro i Pro Lite. W v0.154.0 zaostrzono warunki po stronie kodu: kwalifikowanie do eksperymentu jest obecnie uzależnione od możliwości aktywnego modelu podczas rozpoczynania sesji (#43147). Podczas ponownego sprawdzenia 15 września 2026 sekcja dokumentacji pozostała niezmieniona. Funkcja jest eksperymentalna i domyślnie wyłączona; należy spodziewać się zmian jej działania i kryteriów dostępności.^140146152 v0.157.0: dołączony katalog modeli nie oznacza już GPT-6-Astra ani żadnego innego dołączonego modelu jako obsługującego eksperymentalne zarządzanie kontekstem (#47397), a CLI włącza eksperyment tylko w przypadku modelu oznaczonego w ten sposób. Przy użyciu dołączonego katalogu funkcja opcjonalna nie wywołuje więc żadnego efektu; nie udokumentowano, czy katalog udostępniany zalogowanym kontom jest inny. Według stanu na 26 września 2026 dokumentacja modeli nadal opisuje możliwość włączenia tej funkcji.¹⁷⁴

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; bundled default when no model is set)
   │     │  └─ No → gpt-6-sol (everyday and complex coding; start at Medium)
   └─ GPT-6 not yet available on your account? → gpt-5.6-sol

Nakład na rozumowanie

Pozwala określić, jak długo model „myśli” przed udzieleniem odpowiedzi:

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

Szczegóły poziomu persistent (v0.151.0): tury działające z nakładem persistent domyślnie włączają przypomnienie o bieżącym czasie i przerywalne narzędzie clock.sleep (jawne ustawienia features.current_time_reminder i zarządzane wymagania są zachowywane), a także zawierają dołączone wytyczne 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 zaawansowanych: przy tym samym monicie poziom rozumowania xhigh może zużywać 3–5 razy więcej tokenów niż medium. Warto zarezerwować go dla naprawdę trudnych problemów, w których dodatkowy nakład na 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ń — przydaje się, gdy trudny problem napotkany w trakcie sesji uzasadnia tymczasowe przejście medium → high → xhigh bez użycia /effort ani -c. Po zaakceptowaniu aktualizacji modelu w trakcie sesji poziom rozumowania jest przywracany do wartości domyślnej nowego modelu, zamiast zachowywać wcześniejsze ustawienie.

Przełączanie modeli

Model można przełączyć w trakcie sesji za pomocą slash command /model albo ustawić dla pojedynczego uruchomienia przez --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 poszczególnych modeli, oraz Ramy decyzyjne, aby dobrać odpowiedni model do danego zadania.

Dostęp w planach 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 za stanowisko miesięcznie. W obszarach roboczych Business i Enterprise dostępne są teraz stanowiska tylko z Codex, rozliczane zgodnie z użyciem — bez stałej opłaty za stanowisko, z naliczaniem opłat na podstawie zużycia tokenów.⁷⁹ Strona z cennikiem przedstawia obecnie limity jako przedziały zależne od modelu (zob. tabela powyżej), a nie jako promocyjne mnożniki 2× z premiery aplikacji desktopowej w lutym 2026.¹⁶¹⁶²

Zwiększone limity użycia w maju 2026 (oferta wygasła 31 maja 2026): Codex w planie Plus działał z 25-krotnie zwiększonym limitem 5-godzinnym (wobec standardowego zwiększenia 20×), a limit w poziomie za $100 miesięcznie został podwojony w tym samym okresie.⁸⁹

Obsługa limitów użycia w TUI (v0.152.0–v0.153.0): osiągnięcie limitu nie oznacza już braku możliwości dalszego działania. W wersji v0.152.0 nad polem wprowadzania wyświetlane są banery limitów użycia umożliwiające podjęcie odpowiednich działań — sprawdzenie użycia, zarządzanie środkami, zresetowanie limitów, powiadomienie właściciela obszaru roboczego i zarządzanie planami — filtrowane według uwierzytelnionego konta i użytkownika. Dane o użyciu są odświeżane po błędach limitu, a gdy baner zawiera taką instrukcję, Codex przełącza się na pierwszy dostępny model zastępczy bez zmieniania niezwiązanych z tym ustawień wątku.¹³⁸ Wersja v0.153.0 wprowadza 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 środkach

Operacje Codex zużywają środki z przydziału w ramach planu:

Stawki dotyczą standardowej szybkości, a według strony z cennikiem stawki GPT-5.6 Sol, Terra i Luna po premierze GPT-6 „pozostają bez zmian”. W praktyce „użycie GPT-5.6 wynosi średnio 5–30 środków na wiadomość” (w sierpniu na stronie podawano 5–40). Tryb Fast kosztuje 2,5 raza więcej niż standardowa stawka w środkach dla GPT-6 Astra, Sol i Luna „tam, gdzie jest dostępny”, a dołączony katalog ustawia Fast jako domyślny poziom dla GPT-6 Sol i Luna w TUI, o ile nie zostanie ustawione service_tier. Jeśli zatem środki 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.¹⁶²¹⁷¹

W planach Enterprise i Edu liczba środkó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

W przypadku korzystania z Codex za pośrednictwem API OpenAI rozlicza użycie według liczby tokenów, zgodnie ze standardowym cennikiem 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 Sol — $2 za dane wejściowe / $10 za dane wyjściowe, GPT-6 Luna — $0,10 / $0,50, GPT-6 Astra — $10 / $50. W przypadku wszystkich 3 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, natomiast tryb Fast kosztuje 2 razy więcej.¹⁴⁶¹⁷¹ Mnożniki środków ChatGPT nie dotyczą logowania przy użyciu 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 ono 3–5 razy więcej tokenów
3. Korzystanie z --ephemeral: pomijać utrwalanie sesji w CI/CD, aby zmniejszyć narzut
4. Ograniczanie podsumowań rozumowania: ustawić model_reasoning_summary = "none", gdy wyjaśnienia nie są potrzebne
5. Przetwarzanie wsadowe w trybie exec: codex exec pozwala uniknąć narzutu TUI w zautomatyzowanych przepływach pracy
6. Monitorowanie użycia: sprawdzać /status w TUI oraz pulpity rozliczeniowe organizacji — od wersji v0.148.0 /status, wiersze stanu i tytuły terminala pokazują szacowane zużycie środkó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 kosztów pozostają podobne w różnych modelach):

Koszty różnią się w zależności od poziomu rozumowania, buforowania i długości rozmowy. Aby znacznie ograniczyć wydatki na rutynowe zadania, warto używać gpt-5.6-luna. 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 widocznym promptem:

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ć ograniczenia dotyczące modeli i poziomu rozumowania w całej organizacji - Używać gpt-5.6-luna w CI/CD — zautomatyzowane potoki rzadko wymagają maksymalnego poziomu rozumowania - Budżetowanie na podstawie profili — zdefiniować profile ci, review i dev z odpowiednimi limitami kosztów - Monitorowanie za pomocą OpenTelemetry — wdrożenia korporacyjne mogą eksportować telemetrię użycia do istniejących stosów obserwowalności

Schematy podejmowania decyzji

Kiedy używać poszczególnych interfejsów

Kiedy używać poszczególnych trybów sandbox

Kiedy używać poszczególnych poziomów rozumowania

Tryb planowania a bezpośrednie wykonywanie

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 zajmij się tym 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 jednego pliku z profile = "default" + [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 profilu dla poszczególnych sesji: codex --profile careful

Jak działa system piaskownicy i zatwierdzania?

Codex korzysta z dwuwarstwowego modelu zabezpieczeń, który oddziela to, co jest technicznie możliwe, od sytuacji, w których Codex prosi człowieka o zatwierdzenie. Podejście to zasadniczo różni się od systemu uprawnień Claude Code — Codex wymusza ograniczenia na poziomie jądra systemu operacyjnego.⁵ Zobacz także sekcję Wdrożenie w przedsiębiorstwie, aby poznać ograniczenia requirements.toml, które administratorzy egzekwują w całej organizacji.

Wzmocnienie zabezpieczeń w v0.148.0: ograniczenia piaskownicy 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, a nie po cichu dozwolona — zarówno w systemie Linux, jak i Windows.¹¹⁸

Warstwa 1: piaskownica (co jest możliwe)

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

Mechanizmy egzekwowania właściwe dla platformy:

• macOS: framework Seatbelt firmy Apple używany za pośrednictwem sandbox-exec, z profilami zależnymi od trybu, kompilowanymi w czasie działania i egzekwowanymi przez jądro systemu⁶. Od v0.121.0 profile piaskownicy macOS mogą umieszczać określone gniazda Unix na liście dozwolonych (np. docker.sock, gniazda IPC edytora), a prywatne rozwiązywanie nazw DNS nie jest już domyślnie blokowane.⁸²
• Linux: Landlock służy do ograniczania dostępu do systemu plików, a seccomp — do filtrowania wywołań systemowych. Samodzielny proces pomocniczy (codex-linux-sandbox) zapewnia wielowarstwową izolację.⁵ Bubblewrap (bwrap) jest dołączany i kompilowany jako część kompilacji dla systemu Linux (od v0.100.0 nie jest już opcjonalny)⁷. W v0.117.0 zwiększono niezawodność piaskownicy w starszych dystrybucjach z przestarzałymi konfiguracjami jądra.⁷⁵ W v0.129.0 wzmocniono uruchamianie piaskownicy w systemie Linux oraz zaktualizowano dołączony Bubblewrap do wersji 0.11.2, zawierającej poprawki bezpieczeństwa z projektu źródłowego; v0.130.0 dodała kolejne zabezpieczenia uruchamiania.⁸⁹⁹¹
• Windows: natywna piaskownica z ograniczonymi tokenami (od v0.100.0 nie jest już funkcją eksperymentalną). Obsługiwany jest również WSL (dziedziczy Landlock i seccomp z systemu Linux). W v0.117.0 ulepszono piaskownicę opartą na ograniczonych tokenach, aby zapewnić lepszą izolację procesów.⁷⁵ W v0.130.0 użytkownicy piaskownicy otrzymali dostęp do pamięci podręcznej plików binarnych środowiska uruchomieniowego aplikacji komputerowej, dzięki czemu piaskownica Windows może niezawodnie odnajdywać pliki binarne środowiska uruchomieniowego dla użytkowników piaskownicy obszaru roboczego.⁹¹

Dlaczego ma to znaczenie: w przeciwieństwie do piaskownic opartych na kontenerach (Docker) piaskownica na poziomie systemu operacyjnego jest szybsza, lżejsza i trudniejsza do obejścia. Jądro egzekwuje ograniczenia, zanim Codex w ogóle zobaczy wywołanie systemowe.

Poprawki bezpieczeństwa: - Obejście piaskownicy 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 piaskownicy.⁶⁰ W przypadku korzystania ze starszej wersji należy natychmiast przeprowadzić aktualizację. - Limit rozmiaru danych wejściowych (v0.106.0): Codex egzekwuje teraz limit danych wejściowych wynoszący około 1 miliona znaków, aby zapobiegać zawieszaniu się wskutek przetwarzania nadmiernie dużych ładunków.⁶⁰ - Bezpieczny profil devcontainera (v0.121.0): nowy, wzmocniony profil klienta dla devcontainerów Docker wykorzystuje Bubblewrap do tworzenia piaskownicy wewnątrz kontenera. WSL2 jest obsługiwany, natomiast WSL1 jest jawnie odrzucany (Bubblewrap jest niezgodny z warstwą zgodności 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 podagenta Guardian.⁸² Jeśli hooks są używane do rejestrowania zdarzeń 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 wykonywane w piaskownicy w systemie Linux otrzymują teraz minimalny system plików /dev, co poprawia zgodność z narzędziami oczekującymi węzłów urządzeń.⁶¹

Zasada ReadOnlyAccess (v0.100.0+): konfigurowalna struktura zasad umożliwiająca szczegółową kontrolę dostępu do odczytu. Można jej użyć, aby 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, aby poprosić 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 mają już zewnętrzną granicę bezpieczeństwa — never.⁸⁷

Od v0.150.0 można przypisać skrót klawiaturowy przełączający tryby uprawnień z poziomu edytora wiadomości — 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. Oznacza to, że zatwierdzenia są szczegółowe — zatwierdzenie jednego polecenia w sekwencji nie zatwierdza automatycznie kolejnych poleceń w ramach tego samego wywołania powłoki.⁴⁹

Elastyczne mechanizmy zatwierdzania (v0.105.0+)

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

• Dodatkowe uprawnienia piaskownicy: gdy polecenie wymaga dostępu wykraczającego poza bieżący tryb piaskownicy, 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 wraz z informacją zwrotną, dzięki czemu Codex może dostosować swoje podejście, zamiast po prostu ponawiać to samo polecenie

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

Codex zawiera teraz wbudowane narzędzie request_permissions, które umożliwia modelowi żądanie dodatkowych uprawnień w czasie działania.⁶⁹ Gdy model napotka zadanie wymagające podwyższonego dostępu, może formalnie poprosić o konkretne uprawnienia (dostęp do ścieżek systemu plików, sieci itp.) w ramach procesu zatwierdzania w TUI, zamiast po cichu 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 umożliwia wykonywanie zadeklarowanych przez aplikację działań 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 zasadzie „wszystko albo nic”; writes odpowiada modelowi zaufania, którego większość operatorów rzeczywiście oczekuje od integracji — swobodny odczyt, zgoda przed wprowadzeniem zmian.

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ę użytkownika, każde żądanie jest rozstrzygane w ramach procesu przeglądu oraz zatwierdzane lub odrzucane w jego imieniu.¹¹⁶ Rozwiązanie to znajduje się pomiędzy „zatwierdzaj wszystko” (podejściem, do którego zachęcało usunięte już --full-auto) a „przerywaj 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 zdolnych do działań w obszarze 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 zadaniach, w których przerwanie oznacza zatrzymanie pracy, lecz nie nadaje się do sesji obejmujących poświadczenia lub stan produkcyjny, gdy przegląd powinien należeć do użytkownika.

Zatwierdzanie podwyższonego dostępu do danych wejściowych terminala (v0.151.0)

Flaga funkcji write_stdin_approval — domyślnie wyłączona — wymaga nowego zatwierdzenia przed wysłaniem niepustych danych wejściowych do terminala unified-exec z podwyższonymi uprawnieniami. Te przeglądy są kierowane przez hooks, Guardian, serwer aplikacji i TUI jako zatwierdzenia writeStdin; środowisko terminala, katalog uruchomienia i stan podwyższonych uprawnień są zachowywane między turami, a tożsamość procesu jest ponownie weryfikowana po zatwierdzeniu, zanim zostaną zapisane jakiekolwiek bajty. W pełni sformatowana akcja i powód zatwierdzenia muszą mieścić się w 8 000 bajtów — zbyt duże lub obcięte akcje są odrzucane, zanim nastąpi żądanie zatwierdzenia lub cokolwiek trafi do terminala.¹³⁵

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

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

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"

Wartości none należy używać w przypadku poufnych plików i wzorców glob, które powinny pozostać nieczytelne nawet wtedy, gdy katalog główny projektu umożliwia zapis. W przypadku jednorazowych wyjątków dla poleceń należy preferować reguły zamiast szerokiego rozszerzania profilu.⁸⁷

v0.151.0: przywrócone wątki serwera aplikacji zachowują swoje profile uprawnień, zamiast sprowadzać je do starszych nadpisań piaskownicy dla poszczególnych tur — profile przetrwają przekierowywanie tur i zgodne zmiany katalogu za pomocą /cd, natomiast polecenie /cd, które nie pozwala bezpiecznie przedstawić przywróconego profilu jako starszego trybu piaskownicy, zostaje odrzucone, zamiast po cichu osłabiać ograniczenia.¹³⁴

Wskazówki dotyczące starszej opcji --full-auto

Starsze przewodniki opisywał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 oznaczono --full-auto jako przestarzałe, a aktualna pomoc CLI nie wymienia już tej opcji dla sesji interaktywnych. Zamiast niej należy używać powyższych jawnych flag lub nazwanego profilu uprawnień.⁸⁶

W v0.147.0 usuwanie zostało 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ą opcją --sandbox workspace-write (oraz flagą zatwierdzania lub profilem, jeśli stare wywołanie polegało na sposobie zatwierdzania zapewnianym przez --full-auto). Przed aktualizacją należy skontrolować każdą automatyzację uruchamiającą codex exec z powłoki: problem objawi się jako przerwany potok, a nie ostrzeżenie o wycofaniu.¹¹⁶

Niezawodność piaskownicy (v0.129.0): wzmocnienie uruchamiania piaskownicy Linux ogranicza wyścigi na wolnych systemach plików lub w kopiach roboczych korzystających z dowiązań symbolicznych; ulepszenia niezawodności piaskownicy Windows eliminują kilka awarii brzegowych występujących podczas długotrwałych zadań; dołączony Bubblewrap zaktualizowano zaś do wersji 0.11.2, zawierającej poprawki bezpieczeństwa z projektu źródłowego. Nie są wymagane żadne zmiany konfiguracji. Aby je uzyskać, należy uruchomić codex update.⁸⁹

Zalecane konfiguracje

Codzienna praca programistyczna (bezpieślna opcja domyślna):

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

Zaawansowany użytkownik (pełny dostęp z udziałem człowieka):

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

Opracowania społeczności zalecają to połączenie jako „optymalny kompromis”⁸; przed powtórzeniem tej porady warto jednak zrozumieć jego rzeczywiste działanie: monity o zatwierdzenie pojawiają się, gdy polecenie musi opuścić piaskownicę lub uzyskać dostęp do sieci, natomiast danger-full-access usuwa obie te granice, więc on-request praktycznie nie ma już czego eskalować. Jest to maksymalny zakres możliwości przy minimalnej liczbie pytań, a nie maksymalny zakres możliwości z weryfikacją każdego polecenia przez człowieka; aby uzyskać ten drugi wariant, należy zachować workspace-write i pozwolić, by to granica piaskownicy wywoływała monity.¹²³

Automatyzacja CI/CD:

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

Inteligentne zatwierdzanie z podagentem Guardian (v0.115.0+)

Funkcja Smart Approvals może kierować żądania przeglądu do podagenta Guardian, zamiast wymagać zatwierdzenia przez człowieka dla każdego działania. 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 późniejszych 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 przepływach CI/CD, gdy potrzebny jest zautomatyzowany przegląd z uzasadnieniem zamiast ogólnego ustawienia approval_policy = "never".

Odwrócone ustawienia domyślne Guardian v2 (v0.151.0): Guardian v2 domyślnie przeprowadza teraz przeglądy obsługi komputera wraz z obrazami. features.guardianv2.review_scope.computer_use_only ma domyślną wartość true — aby zachować szerszy zakres przeglądu narzędzi, należy ustawić false — a features.guardianv2.transcript.include_images ma domyślną wartość true — aby wykluczyć obrazy z transkrypcji Guardian, należy ustawić false. Obie funkcje udostępniono 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 pracę Guardian, która nie może zmienić wyniku. W trybie Full Access (który już łączy approvalPolicy: "never" z nieograniczonymi uprawnieniami) żądania Guardian służące wyłącznie do potwierdzenia oraz żądania MCP są zatwierdzane bez synchronicznego przeglądu, wstępnego przygotowania samplera ani oceniania w tle — środowiska oczekujące, niedziałające 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 wejść w tryb Full Access lub go opuścić. W trybie zatwierdzania przez użytkownika (approvals_reviewer = "user") pomijane są wstępne przygotowanie Guardian i asynchroniczne ocenianie, a zwykłe potwierdzenia wykonania node_repl.js są akceptowane automatycznie; kontrole działań poufnych i prośby o dane wejściowe od użytkownika zachowują dotychczasowe działanie.¹⁴⁰ Zawęża to zakres sytuacji, w których uruchamia się Guardian, a nie warstwę zatwierdzania przez człowieka: opisane w tym przewodniku monity dla danger-full-access przy on-request wynikają z zasad zatwierdzania, czyli osobnego mechanizmu. v0.152.1 umożliwia ponadto pobieranie przez przegląd zatwierdzeń Guardian zasad Node REPL z metadanych modelu (auto_review.node_repl_policy), z użyciem dołączonych zasad zastępczych, gdy to pole jest nieobecne.¹³⁹

Ocenianie obsługi komputera przez Guardian uwzględnia wymagania modelu (v0.153.1): ocenianie Guardian ograniczone do obsługi komputera i szybkie decyzje dotyczące zatwierdzeń są teraz wykonywane tylko wtedy, gdy aktywny model ustawia node_repl_auto_review_required w swoich metadanych, a wcześniejsze lub trwające oceny są unieważniane, gdy zmiana modelu powoduje pominięcie oceniania — dzięki temu powrót do wcześniej ocenianego modelu nie może przywrócić nieaktualnej decyzji o zatwierdzeniu. Jest to najważniejsza zmiana w poprawce v0.153.1, choć nie została wymieniona w opisie wydania: #42422 (cherry-pick zmiany 38ba8cdc) można potwierdzić wyłącznie przez porównanie rust-v0.153.0…rust-v0.153.1.¹⁴²

Ponowne wykorzystanie kompakcji wątku nadrzędnego przez Guardian jest domyślnie włączone (v0.156.0): #46522 oznacza guardian_reuse_parent_compaction jako stabilną funkcję 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 z PR sesje przeglądu 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): #47275 oznacza guardianv2.thread_context jako stabilną funkcję 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 enabled Guardian v2, a jawna konfiguracja i nadpisania profili są zachowywane. Aby ją wyłączyć: należy ustawić thread_context = false w sekcji [features.guardianv2] pliku config.toml.¹⁷⁴

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

Rozszerzone wykrywanie niebezpiecznych poleceń (v0.144.5): wykrywanie rozpoznaje teraz więcej wymuszonych wariantów polecenia rm, a odrzucone polecenia zawierają wyraźniejsze powody 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 firmowych, 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 stwierdzenie „wszystkie warstwy transportowe” stało się rzeczywiście prawdziwe. Skonfigurowane serwery proxy są teraz respektowane podczas uwierzytelniania, pobierania pluginów, 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 Codex działał za firmowym serwerem proxy przed v0.146.0 i logowanie lub instalowanie pluginów kończyło się niepowodzeniem, mimo że zwykłe wywołania modelu działały, prawdopodobną przyczyną była właśnie ta luka.

Systemowy serwer proxy w macOS (v0.142.2+): po włączeniu respect_system_proxy klienty uwierzytelniania w macOS respektują systemowe ustawienia serwera proxy, PAC i WPAD — dzięki temu komputery Mac w firmach, w których konfiguracja serwera proxy jest wdrażana za pomocą profili, nie wymagają już zmiennych środowiskowych serwera proxy ustawianych osobno dla każdej powłoki w przypadku ruchu uwierzytelniającego.¹⁰⁵ 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 macOS lub Windows, w tym automatyczną konfigurację PAC i WPAD, eliminując ostatnią lukę w ściśle kontrolowanych sieciach firmowych na obu systemach operacyjnych.¹⁰⁶

Testowanie piaskownicy

Przed uznaniem piaskownicy za bezpieczną należy sprawdzić jej 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 piaskownica działa prawidłowo, oba polecenia powinny zakończyć się niepowodzeniem z błędem odmowy dostępu w profilu ograniczonym do obszaru roboczego. Jeśli którekolwiek polecenie zostanie wykonane pomyślnie, należy zbadać konfigurację piaskownicy.

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 Plan Mode i współpraca

Tryb Plan Mode umożliwia Codex opracowanie sposobu działania przed wprowadzeniem zmian. Jest domyślnie włączony (od wersji v0.94.0).¹⁴ Drzewo decyzyjne „Plan Mode a bezpośrednie wykonanie” znajduje się w sekcji Ramy decyzyjne.

Tryb Plan Mode 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 Plan Mode — 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 nie uległ zmianie. update_plan to narzędzie do planowania, które model może wywołać, aby utrzymywać ustrukturyzowany plan w ramach jednej tury. W wersji v0.152.0 zostało ono udostępnione jako funkcja wymagająca wyraźnego włączenia: tools.update_plan.enabled ma domyślnie wartość false, a gdy narzędzie jest wyłączone, Codex usuwa również dołączone wskazówki dotyczące update_plan ze swoich promptów modelu, trybu współpracy, obsługi wielu agentów, kompakcji, wstępnego rozgrzewania i kontynuacji celu (niestandardowe instrukcje bazowe, instrukcje katalogu modeli, zasady współpracy oraz treść celu użytkownika są zachowywane nawet wtedy, gdy wspominają o planowaniu). Aby je włączyć, należy jawnie ustawić tools.update_plan.enabled = true w pliku config.toml.¹³⁸

Włączanie trybu Plan Mode

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

W trybie Plan Mode Codex: - Odczytuje pliki i analizuje bazę kodu - Proponuje plan implementacji - Nie wprowadza zmian do czasu ich zatwierdzenia - Przesyła plan strumieniowo w dedykowanym widoku TUI

Tryb Steer

Tryb Steer (domyślnie włączony od wersji v0.98.0) umożliwia przekazywanie nowych instrukcji podczas aktywnej pracy Codex 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 Steer jest zawsze aktywny w TUI. Jeśli woli Pan/Pani poczekać z przekazaniem instrukcji do chwili 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 wyświetlanych bezpośrednio w treści. Polecenie /theme pozwala wybrać schemat kolorów.⁶¹

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

Transkrypcja głosu (v0.105.0, eksperymentalna): Proszę nacisnąć spację, aby dyktować prompty za pomocą transkrypcji głosu. Ta funkcja jest eksperymentalna i może wymagać uprawnień do mikrofonu.⁶¹ Od wersji v0.107.0 sesje głosowe w czasie rzeczywistym obsługują wybór mikrofonu i głośnika, dzięki czemu można wskazać konkretne urządzenia wejścia i wyjścia dźwięku.⁶² Usunięto w wersji v0.140.0, przywrócono w v0.145.0: eksperymentalne elementy sterujące głosem /realtime oraz 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ą).¹⁰² W wersji v0.145.0 obsługa głosu powraca w nowej postaci: danych wejściowych audio oraz wyników narzędzi audio w popularnych lokalnych formatach dźwięku, a także strumieniowych rozmów 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ą wyraźnego włączenia: rozmowę na żywo ze strumieniową transkrypcją i elementami sterującymi mikrofonem, włączaną za pomocą /experimental w obsługiwanych kompilacjach (#43581, #43651, #44331), z konfigurowalnym skrótem wyciszania (#43690) oraz podpisanymi zasobami głosowymi w pakietach dla macOS (#43983). W wersji v0.156.0 (22 września 2026) funkcja stała się stabilna i domyślnie włączona (#44921), a tego samego dnia w dzienniku zmian dokumentacji ogłoszono: „Rozmowy głosowe są domyślnie włączone i oferują przełącznik F8, selektor ustawień /voice settings oraz wbudowane środowiska wykonawcze audio dla systemów Linux i Windows”. Aby ją wyłączyć, należy ustawić realtime_conversation = false w sekcji [features] pliku config.toml. Dokumentacja slash commands CLI nadal nie wymienia /voice, natomiast strona dokumentacji funkcji Voice opisuje ChatGPT Voice w aplikacji komputerowej, czyli odrębny interfejs.¹⁵⁶¹⁶⁹

Pozostałe ulepszenia: - Długie linki pozostają klikalne nawet po zawinięciu do kolejnych wierszy TUI (v0.105.0)⁶¹ - Linki do plików lokalnych są wyświetlane z ulepszonym formatowaniem (v0.106.0)⁶⁰ - Markdown w TUI zachowuje klikalność linków internetowych dzięki metadanym OSC 8, a tabele, dla których brakuje miejsca, 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 zachowują widoczne adresy URL (v0.150.0)¹³² - Poprawiono obsługę Ctrl+C dla sub-agentów, aby prawidłowo kończyć procesy potomne (v0.106.0)⁶⁰

System pamięci

Codex oferuje 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 kształtowania swojego działania we wszystkich przyszłych sesjach.

Co warto zapisywać

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

• Konwencje projektu: „Ten projekt używa tabulatorów, a nie spacji” 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 informacje z pamięci są wczytywane 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.

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

• Usuwanie danych poufnych: Przed zapisaniem na dysku zawartość pamięci jest automatycznie skanowana pod kątem danych poufnych
• Uwzględnianie CWD: Pliki pamięci zawierają teraz kontekst katalogu roboczego, co umożliwia przywoływanie informacji właściwych dla danego projektu
• Wykluczenie komunikatów deweloperskich: Komunikaty deweloperskie i systemowe są wykluczane z danych wejściowych pierwszej fazy pamięci, co poprawia jej jakość dzięki skupieniu na interakcjach z użytkownikiem
• Zapominanie na podstawie różnic (v0.106.0): Pamięć wykorzystuje teraz różnice do usuwania nieaktualnych faktów, dzięki czemu z czasem pozostaje zwięzła i przydatna⁶⁰
• Wybór uwzględniający użycie (v0.106.0): Pobieranie informacji z pamięci uwzględnia teraz częstotliwość użycia, nadając priorytet informacjom często wykorzystywanym i ostatnio istotnym⁶⁰
• Konfigurowalna pamięć (v0.107.0): Pamięć można teraz w pełni konfigurować. Polecenie codex debug clear-memories pozwala zresetować wszystkie zapisane informacje i zacząć od czystego stanu — 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 w fazie 2 jest teraz gpt-5.4 (zamiast wcześniejszego modelu domyślnego). Potok fazy 2 działa między sesjami i przekształca transkrypcje z fazy 1 w trwałe fakty; zmiana modelu poprawia jakość przywoływania informacji przy takim samym koszcie tokenów.⁸²
• Menu pamięci w TUI (v0.121.0): Nowy interfejs dostępny podczas sesji udostępnia tryb pamięci, możliwość usuwania pojedynczych informacji oraz przycisk resetowania. Reset pamięci zachowuje wcześniejsze przebiegi, zamiast je unieważniać, dlatego usuwa informacje dostępne do przywołania w przyszłości bez zakłócania odtwarzania sesji.⁸²

Pamięć a AGENTS.md

Wskazówka: Polecenia /m_update należy używać w przypadku faktów, które powinny być przechowywane bezterminowo. Kontekst dotyczący wyłącznie bieżącej sesji wystarczy przekazać Codex bezpośrednio w rozmowie. Do współdzielonego kontekstu zespołowego 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 Windows.⁶⁶

Instalacja

codex app                      # Auto-downloads and installs on first run

Można też 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ę rozbudowanym źródłem kontekstu, a nie jedynie narzędziem do zarządzania wątkami. Z funkcji Appshots warto korzystać, gdy Codex przed podjęciem działania potrzebuje informacji o stanie innej aplikacji na Macu: 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 w pierwszej kolejności warto używać przeglądarki wbudowanej w aplikację, jeśli strona nie wymaga uwierzytelnienia: zapewnia ona użytkownikowi i Codex wspólny, wyrenderowany podgląd, obsługuje działania w przeglądarce, takie jak klikanie, wykonywanie zrzutów ekranu, pobieranie zasobów i inspekcja tylko do odczytu JavaScript, a także umożliwia oznaczanie obszarów strony komentarzami, do których Codex może odnieść się w następnej turze.⁹⁹ W przypadku witryn wymagających zalogowania należy nadal używać 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 zadania nie można zweryfikować za pomocą ustrukturyzowanej integracji lub podglądu w przeglądarce. Funkcja może sprawdzać i obsługiwać dozwolone aplikacje na Macu, ale w przypadku edycji plików i poleceń powłoki podlega regułom akceptacji i sandboxa Codex. Używanie po zablokowaniu pozostaje ściśle ograniczone: podczas aktywnych, zaufanych tur Computer Use Codex może tymczasowo uzyskiwać dostęp do dozwolonych aplikacji po zablokowaniu Maca, przy czym działają zabezpieczenia ponownie blokujące komputer i wykrywające lokalne dane wejściowe.⁹⁹

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. Tworzy i przełącza się na nową gałąź na podstawie bieżącego HEAD 3. Uruchamia agenta w worktree — wszystkie zmiany w plikach pozostają odizolowane 4. Po zakończeniu przedstawia różnice do przeglądu — można wybrać zmiany, które zostaną scalone z powrotem

Oznacza to, że wiele wątków Worktree może działać jednocześnie w tym samym repozytorium 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ądzanego worktree jest ustalane 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ć w metadanych Git wersjonowany rekord własności codex-thread.json, wiążący go z wątkiem: zapisy są atomowe i nie zastępują istniejących danych (ponowne powiązania są idempotentne, a konfliktowi właściciele są odrzucani); ponadto podstawowe, zagnieżdżone i niezarządzane kopie robocze są odrzucane, zanim metadane własności zostaną zmodyfikowane.¹³⁵

Zarządzane worktrees trafiają do CLI w v0.154.0 (funkcja eksperymentalna): --worktree podczas uruchamiania lub /worktree w TUI tworzy odizolowaną kopię roboczą dla nowej albo sforkowanej sesji, codex exec obsługuje zarządzane worktrees na potrzeby automatyzacji, a polecenia sesji TUI wraz z przeglądarką worktree umożliwiają wyświetlanie, przeglądanie i wznawianie sesji worktree (#42196, #42366, #42652, #43069, #43120, #43286). v0.155.0 dodaje powiązane funkcje zarządzania, choć worktrees nadal nie są domyślne: w widoku przeglądu agentów można ukrywać, archiwizować i usuwać sesje worktree, wyświetlane są informacje o 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, lecz NIE znalazła się w stabilnej wersji 0.155.0, co potwierdzono przez sprawdzenie historii względem tagu rust-v0.155.0.¹⁵²¹⁵⁶

Zarządzane worktrees stają się domyślne w v0.156.0: #44870 nadaje funkcji worktrees status stabilnej, domyślnie ją włącza i usuwa z /experimental. Wraz z nią udostępniono następujące możliwości: sesje worktree mogą łączyć się z istniejącym lokalnym daemonem zamiast uruchamiać własny (#46498), a sesje worktree można tworzyć bezpośrednio z widoku przeglądu agentów (#45276), który otrzymuje również karty filtrowania według stanu (#46839). Jeśli skrypty lub konfiguracje napisano przy założeniu, że worktrees pozostają wyłączone, dopóki nie zostaną jawnie zażądane, wersja 0.156.0 zmienia ich zachowanie. 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 /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.¹⁶⁹¹⁷¹

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 worktrees działających w tle (odizolowanych od katalogu roboczego)
• W projektach bez 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 są uruchamiane zgodnie z harmonogramem, a wyniki trafiają do kolejki oczekującej na przegląd

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

Wyniki pojawiają się w kolejce przeglądu, gdzie wymagają akceptacji 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 Windows i pełnym zestawem funkcji, w tym skills, automatyzacjami oraz 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 dostępny 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ą uruchamiać wyłącznie współpracownicy z uprawnieniami do zapisu.

Codex SDK

Biblioteka TypeScript SDK umożliwia osadzanie funkcji 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");

Zaawansowane funkcje SDK

• runStreamed(...): Asynchroniczny strumień zdarzeń służący do przekazywania aktualizacji pośrednich
• Uwierzytelnianie Python SDK (v0.132.0+): logowanie za pomocą klucza API, przepływy przeglądarkowe/kodu urządzenia ChatGPT, sprawdzanie konta i wylogowywanie są pełnoprawnymi ścieżkami SDK.⁹⁷
• Uproszczona obsługa tur tekstowych (v0.132.0+): API tur Python przyjmują zwykłe ciągi tekstowe i zwracają bogatsze metadane TurnResult, obejmujące zgromadzone elementy, informacje o czasie i użyciu.⁹⁷
• outputSchema: Wymusza końcowe dane wyjściowe o strukturze JSON
• Dane wejściowe multimodalne: Można przekazywać tekst i lokalne obrazy ({ type: "local_image", path: "..." })
• Przepływy pracy z obrazami (v0.117.0): view_image zwraca adresy URL, wygenerowane obrazy można ponownie otwierać, a historia obrazów pozostaje dostępna po wznowieniu sesji⁷⁵
• view_image w wielu środowiskach (v0.130.0): W sesjach obejmujących wiele środowisk (wprowadzonych w v0.124.0 wraz z możliwością wyboru środowiska i katalogu roboczego dla każdej tury, a następnie udoskonalonych w v0.125.0 przez dodanie trwałego wyboru środowiska) view_image rozpoznaje teraz ścieżki plików za pośrednictwem wybranego środowiska, a nie lokalnego systemu plików koordynatora. Obraz dołączony ze środowiska zdalnego jest pobierany względem katalogu roboczego tego środowiska, a nie względem hosta, na którym działa SDK.⁹¹

Konfiguracja wątku i klienta

// Custom working directory, skip git check
const thread = codex.startThread({
  workingDirectory: "/path/to/project",
  skipGitRepoCheck: true,
});

// Custom environment and config overrides
const codex = new Codex({
  env: { CODEX_API_KEY: process.env.MY_KEY },
  config: { model: "gpt-5.5" },
});

Sesje są przechowywane w ~/.codex/sessions.

Środowisko uruchomieniowe: Node.js 18+.

Optymalizacja wydajności

Zarządzanie kontekstem

Rozmiary okien kontekstu zależą od modelu. Obecna rodzina GPT-5.6 (Sol, Terra, Luna) korzysta z okna o rozmiarze 272K; GPT-5.5, flagowy model poprzedniej generacji, oferuje 400K w Codex (1M w API); GPT-5.4 / GPT-5.4-mini (wycofywane z Codex 31 sierpnia 2026) oferują 1M / 400K; starsza rodzina GPT-5.3-Codex obsługiwała 272K tokenów wejściowych + 128K tokenów wyjściowych (łączny budżet 400K). We wszystkich modelach okno zapełnia się szybciej, niż można się spodziewać — warto zarządzać nim z wyprzedzeniem:

1. Regularnie używać /compact: Podsumowuje historię rozmowy, zwalniając tokeny
2. Udostępniać lokalną dokumentację: Wysokiej jakości AGENTS.md i dokumentacja lokalna ograniczają nakład związany z eksploracją (która zużywa kontekst)
3. Używać @ do dołączania konkretnych plików: Wskazywać pliki bezpośrednio zamiast prosić Codex o ich znalezienie
4. Precyzyjnie formułować prompty: Prompty o jasno określonym zakresie i wskazujące konkretne pliki zużywają mniej kontekstu niż otwarta eksploracja

Eksperymentalne zarządzanie kontekstem (v0.153.0, domyślnie wyłączone): features.context_management.experimental_mode aktywuje skoordynowany stos kontekstu — kontekst z budżetem tokenów, notatki historii oraz narzędzie new_context — w kwalifikujących się sesjach ChatGPT Plus, Pro i Pro Lite korzystających z backendu Codex. Sesje z kluczem API, dostawcy niestandardowi, punkty końcowe inne niż Codex oraz tymczasowe wątki strukturalne są wykluczone, a flaga jest wyraźnie oznaczona jako będąca w fazie rozwoju: należy traktować ją jako zapowiedź kierunku rozwoju obsługi kontekstu, a nie podstawę do tworzenia przepływów pracy.¹⁴⁰ v0.154.0 dodaje bramę zgodności funkcji: kwalifikacja jest ustalana podczas uruchamiania sesji na podstawie możliwości aktywnego modelu (#43147) — tego samego mechanizmu, który dokumentacja modeli Codex wiąże z nazwą Astra przy logowaniu do planów Plus i Pro (zob. uwagę dotyczącą różnych kontekstów w sekcji Który model należy wybrać?).¹⁴⁶¹⁵² Według stanu na v0.157.0 żaden model we wbudowanym katalogu nie jest oznaczony jako obsługujący tę funkcję (#47397), dlatego przy tym katalogu ustawienie nie przynosi żadnego efektu.¹⁷⁴

Efektywne wykorzystanie tokenów

Optymalizacja szybkości

1. gpt-5.3-codex-spark: Wariant o mniejszych opóźnieniach przeznaczony do interaktywnej współpracy
2. --profile fast: Wstępnie skonfigurowany gpt-5.6-luna z niskim poziomem rozumowania
3. Równoległe wykonywanie narzędzi: Codex wykonuje niezależne odczyty/kontrole współbieżnie, dlatego warto formułować prompty w sposób, który to umożliwia
4. Pętle zorientowane na rezultat: Zamiast instrukcji krok po kroku warto poprosić o „implementację, przetestowanie, naprawienie i zakończenie po uzyskaniu poprawnego wyniku”

Jak debugować problemy?

Typowe problemy i rozwiązania

Wykaz komunikatów o błędach

Do czego służy codex doctor?

codex doctor to jedyne polecenie, które należy uruchomić przed zgłoszeniem błędu lub diagnozowaniem uszkodzonej instalacji. Gromadzi w jednym raporcie informacje o lokalnym środowisku uruchomieniowym, konfiguracji, uwierzytelnianiu, terminalu, sieci i stanie, a szablon zgłoszenia w projekcie wymaga wklejenia jego danych wyjściowych.¹⁶³

codex doctor                           # Full human-readable report (the default)
codex doctor --summary                 # Compact view
codex doctor --json                    # Redacted structured JSON, for bug reports
codex doctor --all                     # Expand truncated lists
codex doctor --no-color                # Strip ANSI color

Raport jest podzielony na stałe sekcje, dzięki czemu można szybko przejść do potrzebnej części:¹⁶³

Każda kontrola ma znacznik stanu — ✓ prawidłowo, ✗ niepowodzenie, ⚠ ostrzeżenie, ○ bezczynność — oraz wiersz podsumowania. Opcja --json przypisuje każdej kontroli stały identyfikator, dzięki czemu wynik można wykorzystać w CI lub skrypcie pomocy technicznej, a nie tylko odczytywać wzrokowo.¹⁶³

Polecenie rozwijało się wraz z kolejnymi wydaniami: pojawiło się w wersji v0.131.0, w v0.135.0 zyskało raportowanie środowiska, Git, terminala, serwera aplikacji i spisu wątków, a w v0.139.0 dodano szczegóły dotyczące edytora i programu stronicującego (z danymi wrażliwymi usuniętymi w JSON).^96176165

Należy użyć go najpierw, a nie na końcu. Większość zgłoszeń typu „Codex nie działa” sprowadza się do problemu, który doctor już wskazuje: nieaktualnego trybu uwierzytelniania, błędu parsowania config.toml albo drugiej instalacji, która przesłania tę znajdującą się w PATH.

Narzędzia diagnostyczne

codex doctor                           # Full local diagnostic (start here)
codex --version                        # Check CLI version
codex login status                     # Verify authentication
codex mcp list                         # Check MCP server status
codex debug app-server --help          # Debug app server issues

Diagnostyka TUI w ramach sesji:

/status                                # Token/session overview
/debug-config                          # Show config layers and requirement sources
/compact                               # Summarize history to reclaim context

Uwaga: codex --verbose nie jest prawidłową flagą najwyższego poziomu. Należy użyć powyższych podpoleceń debugowania i diagnostyki TUI.

Czysta ponowna instalacja

npm uninstall -g @openai/codex && npm install -g @openai/codex@latest

Zachowuje ~/.codex/ (dane uwierzytelniające, konfigurację i sesje). Informacje o przypinaniu dokładnej wersji, powrocie do starszej wersji po wadliwym wydaniu lub całkowitym wyczyszczeniu stanu znajdują się w sekcji Aktualizowanie, obniżanie wersji lub odinstalowywanie.

Tryb debugowania

codex debug app-server send-message-v2  # Test app-server client

Zgłaszanie problemów

/feedback                              # Send logs to Codex maintainers (in TUI)

Problemy można również zgłaszać na stronie github.com/openai/codex/issues.¹

Codex Security [WERSJA ZAPOZNAWCZA]

Codex Security wszedł w fazę badawczej wersji zapoznawczej 6 marca 2026 r., wprowadzając do ekosystemu Codex uwzględniającą kontekst analizę bezpieczeństwa aplikacji.⁷⁷ Jest dostępny dla klientów ChatGPT Pro, Enterprise, Business i Edu za pośrednictwem Codex w przeglądarce.

Jak to działa: Codex Security analizuje repozytoria, aby utworzyć model zagrożeń właściwy dla danego projektu, identyfikuje luki sklasyfikowane według ich rzeczywistego wpływu oraz poddaje ustalenia rygorystycznym testom w środowisku sandboxa w celu ich potwierdzenia. Agent przedstawia ustalenia o wyższym poziomie wiarygodności wraz z poprawkami, ograniczając szum powodowany przez nieistotne błędy.

Skuteczność: W trakcie badawczej wersji zapoznawczej Codex Security przeskanował 1,2 mln commitów i zidentyfikował 10 561 luk o wysokim poziomie ważności. Precyzja zwiększała się z czasem — szum ograniczono o 84%, liczbę przypadków zawyżonej oceny ważności o ponad 90%, a odsetek wyników fałszywie dodatnich zmniejszono o połowę. System wykrył rzeczywiste luki w OpenSSH, GnuTLS i Chromium, którym przypisano 14 identyfikatorów CVE.⁷⁷

Uwaga: Codex Security jest rozwiązaniem odrębnym od wbudowanego modelu zabezpieczeń sandboxa w CLI. Sandbox chroni komputer przed Codex, natomiast Codex Security chroni bazę kodu przed lukami.

Wdrożenie w przedsiębiorstwie

Mechanizmy kontroli administratora (requirements.toml)

Administratorzy egzekwują zasady organizacji za pomocą pliku requirements.toml — konfiguracji wymuszanej administracyjnie, która ogranicza ustawienia istotne z punktu widzenia bezpieczeństwa i której użytkownicy nie mogą nadpisać:²¹

Wersja v0.146.0 dodaje rozpoznawanie planu Enterprise oraz mechanizmy kontroli administratora nad aktualizacjami w aplikacji.¹¹⁴ W zarządzanej flocie oznacza to różnicę między samodzielnym aktualizowaniem CLI przez programistów po zauważeniu nowej wersji a ustalaniem przez administratora terminu jej wdrożenia. Informacje o wydaniu zapowiadają tę funkcję, ale nie podają jej klucza w requirements.toml — dokładną nazwę ustawienia należy uznawać za niezweryfikowaną, dopóki OpenAI jej nie udokumentuje.

# /etc/codex/requirements.toml

# Restrict which approval policies users can select
allowed_approval_policies = ["on-request", "never"]   # `untrusted` retired in v0.149.0

# Limit available sandbox modes
allowed_sandbox_modes = ["read-only", "workspace-write"]

# Control web search capabilities
allowed_web_search_modes = ["cached"]

# Allowlist MCP servers by identity (both name and identity must match)
[mcp_servers.approved-server]
identity = { command = "npx approved-mcp-server" }

# Admin-enforced command restrictions
[[rules.prefix_rules]]
pattern = [{ token = "rm" }, { any_of = ["-rf", "-fr"] }]
decision = "forbidden"
justification = "Recursive force-delete is prohibited by IT policy"

[[rules.prefix_rules]]
pattern = [{ token = "sudo" }]
decision = "prompt"
justification = "Elevated commands require explicit approval"