Akademia · Narzędzia agentowe

OpenAI Codex CLI: autonomiczny agent w terminalu.

Codex CLI to open-source agent kodujący napędzany rodziną GPT-6: buduje projekty od zera, refaktoryzuje, debuguje i integruje się z MCP. Poniżej instalacja, plik konfiguracyjny, tryby zatwierdzania i komendy, które realnie wykorzystujemy.

Ostatnia aktualizacja:

Dłonie na klawiaturze mechanicznej, na monitorze terminal z wyjściem agenta CLI
GPT-6rekomendowana rodzina modeli
Open-sourcelicencja Apache 2.0
Rustnatywny binarny CLI

Agent, który prowadzi projekt od zera po produkcję.

OpenAI Codex CLI to agent do autonomicznego kodowania w terminalu. Open-source na licencji Apache 2.0, napisany w Rust, działa na macOS, Linux i Windows. Modelu nie musisz wybierać: po zalogowaniu kontem ChatGPT Codex sam sięga po rekomendowany wariant, dziś z rodziny GPT-6. Od wersji 0.159.1 (29.09.2026) domyślny jest GPT-6.1 Sol, obok niego najmocniejsza Astra i najtańsza Luna. GPT-5.4 i GPT-5.4-mini zniknęły z Codeksa 31.08.2026, GPT-5.5 odchodzi 14.10.2026, a GPT-5-Codex z września 2025 oraz o3 i codex-1 to już zamknięty rozdział.

Kluczowe możliwości:

  • Budowanie projektów od zera.
  • Refaktoryzacja i debugowanie kodu.
  • Quality gates na żądanie.
  • Integracja z MCP (Model Context Protocol).
  • Regulowany wysiłek rozumowania: od szybkich odpowiedzi po tryby Max i Ultra przy najtrudniejszych zadaniach.

Uwaga historyczna: oryginalne Codex API zostało zamknięte w marcu 2023. Obecny Codex CLI (2025) to całkowicie nowy produkt o innych możliwościach.

Rodzina modeli pod inżynierię oprogramowania.

Codex nie jest przywiązany do jednego modelu. Domyślnie bierze rekomendowany wariant, a Ty przełączasz się między modelami w locie komendą /model albo wybierasz go przy starcie flagą -m. Stan na koniec września 2026, przy logowaniu kontem ChatGPT:

  • GPT-6.1 Sol (gpt-6.1-sol): domyślny od 29.09.2026. Wynikami zbliża się do Astry, a kosztuje mniej, więc pasuje do długiej, powtarzalnej pracy nad kodem.
  • GPT-6 Astra (gpt-6-astra): najmocniejszy model, na zadania, które wymagają długiego rozumowania i pracy z wieloma narzędziami.
  • GPT-6 Luna (gpt-6-luna): najoszczędniejszy, do konkretnych, powtarzalnych zadań: ekstrakcji, przekształceń, drobnych poprawek.
  • GPT-6 Sol oraz GPT-5.6 Sol, Terra i Luna: nadal dostępne w okresie przejściowym.

Z Codeksa zalogowanego kontem ChatGPT wycofano GPT-5.4 i GPT-5.4-mini (31.08.2026) oraz GPT-5.3-Codex-Spark (14.09.2026). Linia „-codex" (gpt-5.3-codex, gpt-5.2) zniknęła z listy już w maju 2026, podobnie jak codex-mini-latest i o3-mini. GPT-5.5 odchodzi 14.10.2026, więc jeśli siedzi w Twoim config.toml, skryptach albo wywołaniach codex exec -m, podmień go już teraz. Przy logowaniu własnym kluczem API te wycofania Cię nie dotyczą, bo dostępność modeli wynika wtedy z klucza.

Głębokość myślenia ustawiasz sam. W /model wybierasz wysiłek rozumowania, a w części modeli także Max (więcej czasu na jedno zadanie) i Ultra (praca rozdzielona na subagentów). Na co dzień wystarcza ustawienie domyślne; wyższe poziomy zużywają więcej tokenów.

Node.js 22+, a potem jedna komenda npm.

Wymagania systemowe

  • Node.js 22+: wymagana przy instalacji przez npm.
  • npm lub npx (instalowane razem z Node.js).
  • System: macOS, Linux lub Windows (natywnie w PowerShell albo przez WSL2).
  • Git 2.23+, min. 4 GB RAM (8 GB rekomendowane).

1. Instalacja Node.js

Windows: pobierz instalator Node.js 22 ze strony nodejs.org. Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

macOS (Homebrew):

brew install node

Po instalacji zweryfikuj wersję: node --version.

2. Instalacja Codex CLI

Najszybciej skryptem instalacyjnym, bez Node.js. macOS i Linux:

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

Windows (PowerShell):

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

Przez npm (wymaga Node.js 22+):

npm install -g @openai/codex

Albo przez Homebrew:

brew install --cask codex

Po instalacji komenda codex działa z dowolnego miejsca w systemie. Paczka @openai/codex jest aktywnie rozwijana.

Przy pierwszym uruchomieniu wybierz „Sign in with ChatGPT". CLI wchodzi w plany ChatGPT Plus, Pro, Business, Edu i Enterprise. Do automatyzacji w CI możesz zamiast konta użyć klucza API: płacisz wtedy według cennika API i nie masz funkcji chmurowych, np. code review na GitHubie.

Windows (natywnie): Codex działa natywnie w PowerShell z sandboxem Windows. WSL2 pozostaje opcją (np. dla zgodności z narzędziami linuksowymi), ale nie jest już wymogiem. W razie potrzeby uruchom wsl --install i zainstaluj Node.js oraz Codex CLI wewnątrz WSL.

Jeden plik TOML: model, tryb i serwery MCP.

Plik konfiguracyjny: ~/.codex/config.toml.

1. Domyślny model

model = "gpt-6.1-sol"  # lub gpt-6-astra, gpt-6-luna

Jeśli klucza model nie ustawisz, Codex sam dobiera rekomendowany wariant. Model ustawia się kluczem najwyższego poziomu, bez tabeli [model].

2. Tryby zatwierdzania i sandbox

approval_policy = "on-request"   # "on-request", "never" albo { granular = { ... } }
sandbox_mode = "workspace-write" # "read-only", "workspace-write", "danger-full-access"

Po przepisaniu CLI na Rust polityka zatwierdzania i sandbox to dwa osobne klucze. Stare tryby suggest/auto-edit/full-auto są legacy.

  • approval_policy — kiedy Codex pyta o zgodę: on-request (pyta przed wyjściem poza sandbox) do pracy interaktywnej, never do CI. Wariant granular pozwala osobno przepuszczać albo automatycznie odrzucać poszczególne kategorie próśb.
  • sandbox_mode — zakres działań: read-only, workspace-write (zapis w katalogu projektu), danger-full-access.

Aktualizacja: wartość approval_policy = "untrusted" została wycofana i potrafi zablokować start Codeksa, więc usuń ją z config.toml, profili i skryptów. on-failure jest przestarzałe. Jeśli chcesz zachować ostrzejsze pytanie o każdą komendę, pomiń approval_policy i oznacz projekt w ~/.codex/config.toml jako trust_level = "untrusted". W trakcie sesji uprawnienia zmienisz komendą /permissions (np. Auto albo Read Only).

3. Serwery MCP

Każdy serwer to osobna tabela [mcp_servers.NAZWA], nie tablica [[...]]. Serwer lokalny (stdio) opisujesz przez command i args, zdalny przez url:

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

[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"

Od trybu interaktywnego po konkretny prompt.

Uruchamianie

codex                                  # tryb interaktywny
codex "Zbuduj aplikacje todo w React"  # z konkretnym promptem
codex -i screenshot.png "Wyjasnij ten blad"  # z zalacznikiem obrazu
codex resume                           # wznowienie sesji

Komendy wbudowane w sesji

KomendaDziałanie
/initTworzy AGENTS.md z instrukcjami projektu.
/statusPokazuje konfigurację i zużycie tokenów.
/diffPokazuje git diff bieżących zmian.
/modelPrzełącza model i wysiłek rozumowania.
/permissionsZmienia, co Codex może robić bez pytania (np. Auto albo Read Only).
/reviewQuality check na żądanie.

Praktyczne przykłady

Budowanie strony ze screenshota:

codex -i wireframe.png "Zbuduj responsywna strone landing page zgodnie z tym wireframem, uzyj Tailwind CSS"

Debugowanie i testy:

codex "Znajdz wszystkie memory leaks w tym projekcie, napraw je i dodaj unit testy"

Duża refaktoryzacja:

codex "Zrefaktoryzuj caly projekt aby uzywac TypeScript strict mode, zaktualizuj wszystkie komponenty i testy"

ChromeDevTools MCP: Codex steruje Chrome.

Czym jest Model Context Protocol i jak działa, opisujemy w szkoleniu Serwery MCP. ChromeDevTools MCP daje Codeksowi pełną kontrolę nad przeglądarką Chrome: nawigację, wypełnianie formularzy, testowanie UI, screenshoty, debugowanie i wykonywanie JavaScript.

Instalacja MCP

codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest

Konfiguracja zapisze się w ~/.codex/config.toml. Alternatywnie dodaj ją ręcznie:

[mcp_servers.chrome-devtools]
command = "npx"
args = ["chrome-devtools-mcp@latest"]

Po instalacji możesz dawać komendy w języku naturalnym, np.:

Otworz localhost:3000, sprawdz czy sa bledy w konsoli i napraw je w kodzie

Podgląd: komenda /mcp w sesji Codex pokazuje skonfigurowane serwery MCP i ich narzędzia (z argumentem verbose także szczegóły serwerów). Pełną listę serwerów MCP znajdziesz na github.com/modelcontextprotocol/servers.

Aktualizacja: od wersji 0.142.2 (czerwiec 2026) narzędzia z serwerów MCP domyślnie przechodzą przez wyszukiwanie narzędzi (tool search), o ile model i provider to obsługują. Poprawia to wykrywanie narzędzi przy dużej liczbie serwerów, a dla starszych modeli zachowuje dotychczasowe zachowanie.

Chcecie tak pracować całym zespołem?

Akademia to materiały. Wdrożenie to dwa kwartały na Waszym kodzie, z pomiarem efektu w DEVLens. Audyt 90 minut wystarczy, żeby sprawdzić, czy ma to u Was sens.