Definicja
Tryb headless
Tryb headless to uruchamianie agenta AI nieinteraktywnie, zwykle w pipelinie CI/CD albo skrypcie automatyzacji. Claude Code obsługuje go przez claude -p "task", a Codex przez codex exec i Cloud API. Nie ma człowieka w pętli.
Dlaczego to ważne
W trybie headless agent przestaje być narzędziem, którym sterujesz, i staje się częścią pipeline’u. To też moment, w którym pytania o zgodę przestają chronić, więc zabezpieczenia muszą być strukturalne — polityka sandboxa i hooki zamiast człowieka mówiącego „tak”.
Jak radzi sobie z tym każde narzędzie
- Cursor
- CLI, SDK i agenci w chmurze, z ustrukturyzowanym wyjściem.
- Claude Code
-
claude -p "prompt", a także agenci webowi i zarządzani;--output-format jsondla ustrukturyzowanego wyjścia. - Codex
-
codex exec "prompt", zcodex exec --jsondla ustrukturyzowanego wyjścia.
Najczęstsze pytania
Jak uruchomić Claude Code w trybie headless?
Poleceniem claude -p "task". Dodanie --output-format json daje ustrukturyzowane wyjście, które pipeline potrafi sparsować — i to czyni z niego krok CI, a nie coś do czytania przez człowieka.
Czy tryb headless jest bezpieczny bez nadzoru?
Tylko ze strukturalnymi zabezpieczeniami, bo nie ma komu niczego zatwierdzać. Polityka sandboxa decyduje, dokąd sięgnie polecenie, a hooki wymuszają kontrole, których agent nie pominie — oba znaczą tu więcej niż w sesji interaktywnej.
Jak uzyskać wyjście czytelne dla maszyny?
Claude Code przyjmuje --output-format json, a Codex codex exec --json. Bez tego pipeline parsuje prozę — a to różnica między krokiem CI, który potrafi rozgałęzić się na wyniku, a takim, który może go tylko zalogować.