OpenAI Codex CLI: Polecenia i konfiguracja — ściągawka

OpenAI Codex CLI to natywny dla terminala agent programistyczny firmy OpenAI, który analizuje bazy kodu, edytuje pliki, uruchamia testy, integruje się ze zdalnymi zadaniami Codex Cloud oraz łączy się z zewnętrznymi narzędziami przez MCP bezpośrednio z wiersza poleceń.

Ta ściągawka obejmuje podkomendy i flagi Codex CLI, polityki piaskownicy (sandbox) i zatwierdzania, interaktywne komendy slash TUI, skróty klawiszowe oraz konfigurację config.toml i AGENTS.md.

🔗 Powiązane ściągawki: Porównanie terminalowych agentów AI CLI · Ściągawka Claude Code CLI · Ściągawka Antigravity CLI (agy) · Inżynieria AI Agent Harness

1. Instalacja, uwierzytelnianie i podstawowe polecenia CLI

1.1 Instalacja i uwierzytelnianie

Czynność	Polecenie	Uwagi
Globalna instalacja npm	`npm install -g @openai/codex`	Standardowa instalacja wieloplatformowa
Oficjalny skrypt instalacyjny	`curl -fsSL https://chatgpt.com/codex/install.sh \| sh`	Jednowierszowy instalator dla macOS / Linux
Logowanie w przeglądarce	`codex login`	Uwierzytelnianie kontem ChatGPT Plus / Pro / Team
Autoryzacja kluczem API	`export OPENAI_API_KEY="sk-..."`	Idealna do środowisk headless CI lub kontenerów

1.2 Podkomendy CLI i flagi globalne

Polecenie / Flaga	Opis	Przykład użycia
`codex`	Uruchom interaktywny interfejs TUI w bieżącym katalogu	`codex`
`codex "prompt"`	Rozpocznij interaktywną sesję z początkowym promptem	`codex "Debug 500 timeout errors on login"`
`codex exec` / `codex e`	Wykonanie nieinteraktywne (headless) do skryptów i CI	`codex exec "Run all unit tests and fix failures"`
`codex exec --json`	Strumieniuj ustrukturyzowane logi JSON wnioskowania i zmian w plikach	`codex exec --json "Refactor utils" > run.jsonl`
`codex review`	Nieinteraktywny przegląd kodu na bieżącym diffie Git	`codex review`
`codex resume`	Otwórz wybór sesji (zapisanych w `~/.codex/sessions/`)	`codex resume` / `codex resume --last` / `codex resume <id>`
`codex apply` / `codex a`	Zastosuj w lokalnym repozytorium zmiany wygenerowane w Codex Cloud	`codex apply <task_id>`
`codex cloud`	Przeglądaj lub zarządzaj zdalnymi zadaniami Codex Cloud	`codex cloud`
`codex mcp`	Zarządzaj integracjami serwerów Model Context Protocol (MCP)	`codex mcp list` / `codex mcp add <name> ...`
`-m, --model <name>`	Określ model używany w sesji lub uruchomieniu	`codex -m gpt-6.1-sol`
`--strict-config`	Ściśle waliduj składnię i klucze pliku `config.toml`	`codex --strict-config`

2. Matryca polityk piaskownicy (Sandbox) i zatwierdzania

Codex CLI rozdziela uprawnienia na dwie niezależne warstwy: czego środowisko może dotykać (--sandbox) oraz kiedy pytać użytkownika o zgodę (--ask-for-approval).

Flaga	Dozwolone wartości	Zachowanie i zalecane użycie
`--sandbox <mode>` (alias `-s`)	`read-only`	Tylko do odczytu: analizuje i przeszukuje kod bez modyfikacji plików
	`workspace-write`	Zapis w obszarze roboczym (zalecany domyślny): zezwala na edycję wyłącznie w drzewie roboczym
	`danger-full-access`	Pełny dostęp bez ograniczeń: pełny dostęp do systemu plików/systemu (tylko w izolowanych kontenerach)
`--ask-for-approval <policy>`	`on-request`	Zalecana polityka domyślna: model pyta o potwierdzenie, gdy wymagają tego ryzykowne działania
	`on-failure`	Eskaluje wyłącznie po wystąpieniu błędu (użyj `on-request`, jeśli ważne są monity o podniesienie uprawnień piaskownicy)
	`never`	Całkowicie cichy tryb: nigdy nie pyta interaktywnie (do CI / zautomatyzowanych potoków)

⚠️ Informacja o wycofanych i przestarzałych flagach:

Flaga --full-auto jest przestarzała (deprecated) od wersji v0.128.0. Określaj politykę piaskownicy i zatwierdzania jawnie: codex --sandbox workspace-write --ask-for-approval on-request "Fix failing tests"

Polityka zatwierdzania untrusted została wycofana w wersji v0.149.0; zmigruj konfiguracje na on-request.

3. Interaktywne komendy slash w TUI

Wpisz / w interaktywnym wierszu poleceń codex TUI, aby kontrolować kontekst, uprawnienia i przepływy pracy:

3.1 Kontekst, modele i uprawnienia

Polecenie	Funkcja	Uwagi i zastosowanie
`/init`	Wygeneruj startowy plik `AGENTS.md` dopasowany do repozytorium	Zalecany pierwszy krok w nowym projekcie
`/status`	Sprawdź aktywny model, uprawnienia i zużycie tokenów	Monitoruj pozostałą pojemność kontekstu
`/model`	Interaktywnie przełącz model oraz poziom Reasoning Effort	Dostosuj głębokość wnioskowania bez restartu sesji
`/permissions`	Zmień tryb piaskownicy i politykę zatwierdzania w trakcie sesji	Zaostrzaj lub poluzuj uprawnienia na żądanie
`/mcp`	Sprawdzaj i zarządzaj podłączonymi serwerami MCP	Weryfikuj połączenia z zewnętrznymi narzędziami i bazami danych

3.2 Przepływy inżynierskie i sterowanie sesją

Polecenie	Funkcja	Uwagi i zastosowanie
`/plan`	Przygotuj i przejrzyj plan implementacji przed edycją plików	Uzgodnij architekturę przed dużym refaktoringiem
`/review`	Przeprowadź wieloperspektywiczny przegląd kodu na niezatwierdzonych zmianach	Wykrywaj błędy, przypadki brzegowe i zagrożenia bezpieczeństwa
`/diff`	Sprawdź bieżące niezatwierdzone modyfikacje plików	Przejrzyj diffy wiersz po wierszu przed akceptacją
`/fork`	Rozgałęź wątek konwersacji do osobnego punktu kontrolnego	Przetestuj alternatywne podejście bez zaśmiecania głównego kontekstu
`/compact`	Podsumuj historię konwersacji, aby odzyskać miejsce w kontekście	Zapobiegaj utracie spójności w długich sesjach wieloturowych
`/copy`	Skopiuj ostatnią ukończoną odpowiedź do schowka	Szybko wyodrębnij łatki lub podsumowania
`/title`	Zmień nazwę bieżącego wątku konwersacji	Ułatwia odnajdywanie sesji w `codex resume`
`/statusline` / `/theme`	Dostosuj elementy paska stanu w stopce lub motyw kolorystyczny TUI	Dopasuj wygląd terminala do własnych preferencji
`/prompts:<name>`	Wywołaj niestandardowy szablon promptu Markdown	Wykonuje plik `~/.codex/prompts/<name>.md`

4. Skróty klawiszowe terminala i składnia wprowadzania

Skrót / Składnia	Działanie	Efekt i scenariusz
`@<path>`	Rozmyte odwołanie do pliku	Wstrzykuje zawartość pliku bezpośrednio do kontekstu (np. `@src/auth.ts`)
`!<command>`	Lokalne polecenie powłoki w wierszu	Uruchamia komendy shell w ramach aktywnych reguł piaskownicy (np. `!npm test`)
`Tab`	Zakolejkuj kolejny prompt	Dodaje do kolejki kolejny prompt, komendę slash lub polecenie `!` podczas pracy Codexa
`Enter`	Przerwij / pokieruj w trakcie	Wprowadza dodatkowe wskazówki, gdy agent aktywnie generuje odpowiedź
`Ctrl + G`	Otwórz zewnętrzny edytor	Twórz wielowierszowe prompty w `$VISUAL` / `$EDITOR` (Vim, VS Code itp.)
`Ctrl + R`	Przeszukaj historię promptów	Wyszukiwanie wsteczne wcześniej wysłanych promptów
`Ctrl + L`	Wyczyść i odśwież ekran	Czyści widok terminala z zachowaniem stanu konwersacji
`Ctrl + O`	Skopiuj ostatni wynik	Odpowiednik polecenia `/copy`
`Ctrl + X`	Otwórz menu klawiatury	Dostęp do zestawów skrótów i rozszerzeń
`Ctrl + C`	Anuluj / Wyjdź	Przerywa aktywne zadanie lub zamyka sesję Codex

5. Pliki konfiguracyjne i hierarchia pamięci (`config.toml` i `AGENTS.md`)

Ustawienia na poziomie projektu nadpisują globalne wartości domyślne użytkownika:

Warstwa	Zakres globalny (wszystkie repozytoria)	Zakres projektu (bieżące repozytorium)	Przeznaczenie
Konfiguracja rdzenia	`~/.codex/config.toml`	`.codex/config.toml`	Domyślny model, piaskownica, polityka zatwierdzania, przełącznik sieci, MCP
Instrukcje agenta	`~/.codex/AGENTS.md`	`./AGENTS.md` (katalog główny repozytorium)	Polecenia budowania/testów, standardy kodowania, zasady architektury
Niestandardowe prompty	`~/.codex/prompts/*.md`	—	Szablony wielokrotnego użytku dla komend `/prompts:<name>`
Logi sesji	`~/.codex/sessions/`	—	Trwałe zapisy sesji przywracane przez `codex resume`

Minimalny zalecany plik `~/.codex/config.toml`

# Domyślny model
model = "gpt-6.1-sol"

# Domyślny tryb piaskownicy i polityka zatwierdzania
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# Domyślnie ogranicz ruch wychodzący w sieci wewnątrz piaskownicy
network_access = false