Akademia · Narzędzia agentowe
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:
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:
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.
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): 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): najmocniejszy model, na zadania, które wymagają długiego rozumowania i pracy z wieloma narzędziami.gpt-6-luna): najoszczędniejszy, do konkretnych, powtarzalnych zadań: ekstrakcji, przekształceń, drobnych poprawek.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.
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.
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.
Plik konfiguracyjny: ~/.codex/config.toml.
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].
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.
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.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).
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" 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 | Komenda | Działanie |
|---|---|
/init | Tworzy AGENTS.md z instrukcjami projektu. |
/status | Pokazuje konfigurację i zużycie tokenów. |
/diff | Pokazuje git diff bieżących zmian. |
/model | Przełącza model i wysiłek rozumowania. |
/permissions | Zmienia, co Codex może robić bez pytania (np. Auto albo Read Only). |
/review | Quality check na żądanie. |
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" 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.
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.
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.