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.

Ostatnia aktualizacja
Autor:
Opublikowano
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.

Na tej stronie Dlaczego to ważneJak robi to każde narzędziePytania

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

  1. Prośba

    Agent chce edytować plik

    Akcja wymaga zatwierdzenia.

  2. 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.

  3. Odpowiedź

    Zatwierdzasz albo odmawiasz

    Człowiek obserwuje przebieg.

  4. 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ć

  1. Prośba

    Agent chce edytować plik

    Skrypt nie dopuścił tego w poleceniu.

  2. Pytanie o zgodę

    Tryb Manual, nikogo nie ma

    claude -p startuje w trybie Manual w każdym planie.

  3. Decyzja

    Odmowa, a przebieg trwa dalej

    Wszystko, co wymagałoby zgody, jest odrzucane, a przebieg toczy się dalej bez tego.

  4. 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.

Podaj dokładne uprawnienia w poleceniu i czytaj wynik JSON, który wylicza permission_denials, zamiast ufać samemu kodowi wyjścia. Źródło: Przewodnik po skryptach z Claude Code, Claude Code 2.1.283, 2026-09-26.

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.

Czy ta strona odpowiada na Twoje pytania?

Jedno kliknięcie, bez logowania.

wcale w pełni

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.