Akademia · Narzędzia agentowe
Codex CLI to open-source agent kodujący napędzany rodziną GPT-5-Codex: 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:
01 / Wprowadzenie · Czym jest
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 z rodziny GPT-5.x. Stan na połowę 2026: domyślnym punktem startu jest GPT-5.5 (najnowszy model frontier), obok niego GPT-5.4 i szybszy GPT-5.4-mini. Dedykowana linia „-codex" (gpt-5.3-codex, gpt-5.2) została w maju 2026 wycofana z listy wyboru dla logujących się przez ChatGPT. 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.
02 / Model · GPT-5.x
Codex nie jest przywiązany do jednego modelu. Domyślnie bierze rekomendowany wariant rodziny GPT-5.x, a Ty przełączasz się między nimi w locie — komendą /model. Stan na połowę 2026:
Osobna linia „-codex" (gpt-5.3-codex, gpt-5.2) zniknęła z listy wyboru przy logowaniu kontem ChatGPT. Model dynamicznie alokuje czas „myślenia" i dostosowuje zasoby do skomplikowania problemu — od krótkich odpowiedzi po długie sesje nad złożonym zadaniem.
03 / Instalacja · macOS, Linux, WSL
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 nodejsmacOS (Homebrew):
brew install nodePo instalacji zweryfikuj wersję: node --version.
Najszybciej — skryptem instalacyjnym (macOS/Linux), bez Node.js:
curl -fsSL https://chatgpt.com/codex/install.sh | shPrzez npm (wymaga Node.js 22+):
npm install -g @openai/codexAlbo przez Homebrew:
brew install --cask codexPo instalacji komenda codex działa z dowolnego miejsca w systemie. Paczka @openai/codex jest aktywnie rozwijana.
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.
04 / Konfiguracja · config.toml
Plik konfiguracyjny: ~/.codex/config.toml.
model = "gpt-5.5" # lub gpt-5.4, gpt-5.4-miniJeśli klucza model nie ustawisz, Codex sam dobiera rekomendowany wariant. Model ustawia się kluczem najwyższego poziomu — bez tabeli [model]. Linia „-codex" (gpt-5.3-codex, gpt-5.2) oraz starsze codex-mini-latest i o3-mini zostały wycofane.
approval_policy = "on-request" # "untrusted", "on-request", "never"
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.
untrusted, on-request (pyta przed wyjściem poza sandbox), never.read-only, workspace-write (zapis w katalogu projektu), danger-full-access.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"05 / Komendy · Uruchamianie i sesja
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. |
/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"06 / MCP · Kontrola przeglądarki
Model Context Protocol to otwarty standard stworzony przez Anthropic, który pozwala agentom AI na bezpieczną integrację z narzędziami zewnętrznymi. ChromeDevTools MCP daje Codex pełną kontrolę przeglądarki Chrome — nawigację, wypełnianie formularzy, testowanie UI, screenshoty, debugowanie i wykonywanie JavaScript.
codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latestKonfiguracja 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 kodziePodgląd: komenda /status w sesji Codex pokazuje wszystkie zainstalowane serwery MCP i ich status. 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.
Wdrożenie u Was
Akademia to materiały. Wdrożenie to dwa kwartały na Waszym kodzie — z pomiarem efektu w DEVLens. 30 minut wystarczy, żeby sprawdzić, czy ma to u Was sens.