Czym jest tryb headless?
Tryb headless to uruchamianie agenta kodującego bez interaktywnej sesji, zwykle ze skryptu, hooka gita, crona albo kroku CI. Claude Code używa claude -p, Codex codex exec, a CLI Cursora ma tryb print (-p). Nie ma kto odpowiedzieć na pytanie o zgodę, więc uprawnienia, format wyjścia i sprawdzenie wyniku trzeba ustawić w poleceniu.
- Po angielsku
- Headless mode
- Pierwsze wdrożenie
- Poziom 4, darmowy przewodnik
- Szukane też jako
- tryb nieinteraktywny, print mode, agent w CI
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Dlaczego to ważne.
W uruchomieniu headless nie ma kto niczego zatwierdzać: claude -p startuje w trybie Manual (od v2.1.285 w trybie auto u zewnętrznych dostawców lub z wyłączoną telemetrią), więc przekaż --permission-mode dontAsk, żeby u każdego dostawcy odmawiał wszystkiego, co wymagałoby zgody, a codex exec odrzuca polecenie, które potrzebuje zatwierdzenia. Polityką jest więc lista dozwolonych działań, a wynik musi sprawdzić skrypt, nie agent. Nocne zadanie może przez tydzień „kończyć się sukcesem”, nic nie zapisując, bo każda edycja została odrzucona, a skrypt sprawdzał tylko, czy proces się zakończył.
Ta sama edycja, z człowiekiem i bez
Edycja, na którą agent nie ma zgody: w sesji interaktywnej i w claude -p uruchomionym ze skryptu.
- Decyduje człowiek
- Co się wykonuje
- Na czym możesz polegać
Sesja interaktywna Ty odpowiadasz
-
Prośba
Agent chce edytować plik
Akcja wymaga zatwierdzenia.
-
Pytanie o zgodę
Pytanie może trafić do ciebie
W trybie Manual Claude Code pyta, a ty możesz odpowiadać na pytania i zatwierdzać ryzykowne kroki.
-
Odpowiedź
Zatwierdzasz albo odmawiasz
Człowiek obserwuje przebieg.
-
Na czym możesz polegać
Twojej decyzji
Edycja trafia do pliku tylko wtedy, gdy powiedziałeś „tak”. W trybie auto tę decyzję podejmuje klasyfikator.
`claude -p` ze skryptu Nie ma kto odpowiedzieć
-
Prośba
Agent chce edytować plik
Skrypt nie dopuścił tego w poleceniu.
-
Pytanie o zgodę
Tryb Manual, nikogo nie ma
claude -pstartuje w trybie Manual w każdym planie. -
Decyzja
Odmowa, a przebieg trwa dalej
Wszystko, co wymagałoby zgody, jest odrzucane, a przebieg toczy się dalej bez tego.
-
Na czym możesz polegać
Tylko na tym, co sprawdza skrypt
Zadanie w cronie „kończyło się sukcesem” przez tydzień, nic nie zapisując: sprawdzało, czy proces się zakończył, a nie wynik.
Jak robi to każde narzędzie.
Cursor, Claude Code i Codex nazywają to po swojemu. Każda notatka ma datę sprawdzenia.
Cursor
Tryb print (-p, --print) w Cursor CLI, którego poleceniem jest agent (dokumentacja CLI Cursora, sprawdzone 2026-10-12), udokumentowany dla GitHub Actions. Opcji wyjścia czytelnego dla maszyn nie sprawdzono ponownie.
Macierz funkcji (dokumentacja Cursora), 2026-08-28
Claude Code
claude -p wykonuje jedno zadanie i kończy się, w trybie Manual, w którym nie ma kto zatwierdzać; --output-format json zwraca jeden obiekt wyniku, a --json-schema zwalidowany.
-p pomija okno zaufania do katalogu, ale hooki projektu, jego blok env i każdy serwer z .mcp.json nadal się ładują i działają, więc uprawnienia podaj w poleceniu. Kod wyjścia to 0 przy sukcesie i niezerowy, gdy przebieg się nie powiódł, także po osiągnięciu --max-turns.
Przewodnik po skryptach z Claude Code, Claude Code 2.1.283, 2026-09-26
Codex
codex exec (alias e) wypisuje końcową wiadomość na stdout i nigdy nie pyta o zgodę; --json daje zdarzenia JSONL, a --output-schema FILE odpowiedź sprawdzoną względem schematu.
Polecenie, które potrzebuje zgody poza sandboxem, jest odrzucane. Bez flagi sandboxa Codex może czytać repozytorium i uruchamiać polecenia tylko do odczytu, ale nie może edytować; --sandbox workspace-write pozwala na edycje przy wyłączonej sieci. Poza repozytorium Git kończy się kodem 1, chyba że podasz --skip-git-repo-check.
Przewodnik po codex exec, Codex 0.157.1, 2026-10-03
Najczęstsze pytania.
Jak uruchomić Claude Code w trybie headless?
Poleceniem claude -p "task". Dodaj --output-format json, żeby skrypt mógł rozgałęzić się na wyniku, i --json-schema, gdy odpowiedź ma mieć określony kształt. Sesja claude -p startuje w trybie Manual, więc wypisz dokładnie, co zadanie może robić, na przykład --permission-mode dontAsk --allowedTools "Bash(npm test *)".
Jak uzyskać wyjście czytelne dla maszyny?
Claude Code przyjmuje --output-format json lub stream-json oraz --json-schema. Codex przyjmuje --json dla zdarzeń JSONL, --output-schema FILE dla końcowej odpowiedzi o zadanym schemacie i -o FILE tylko dla końcowej wiadomości. Opcji wyjścia w Cursorze nie sprawdzono ponownie.
Czy można bezpiecznie uruchamiać headless na dowolnym repozytorium?
Nie. claude -p pomija okno zaufania do katalogu, a hooki repozytorium i serwery z .mcp.json nadal się ładują i działają. Nigdy nie uruchamiaj go na kodzie, którego nie napisałeś, gdy w środowisku jest sekret, na przykład na pull requeście z forka. Takie uruchomienia zaczynaj od --bare --setting-sources "" --strict-mcp-config.
Czytaj dalej.
Przewodniki, które idą głębiej, oraz hasła i porównania obok tego.
W dokumentacji
Powiązane hasła
Czy ta strona odpowiada na Twoje pytania?
Jedno kliknięcie, bez logowania.
Czego tu szukasz?
Co Cię powstrzymuje?
Jak się to czyta?
Dzięki. Jeśli zostawiasz e-mail, odpisze Ci Michał.
Odpowiada na Twoje pytania?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
Czytaj przewodniki w tych samych słowach.
Otwórz wszystkie przewodniki z Toolkitem. Każde hasło jest tu zdefiniowane raz, a przewodniki używają go tak samo.
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Odpisuje Michał, nie automat. Adres służy tylko tej odpowiedzi.