Headless

Headless betekent letterlijk "zonder hoofd": een AI-sessie die draait zonder dat er een mens voor een scherm zit. Een script of geplande taak (bijvoorbeeld elke ochtend om 7 uur) start het model, geeft het een opdracht en bewerkt het antwoord verder, zonder menselijke tussenkomst. Handig voor terugkerend werk: rapporten samenvatten, mailtjes triëren, prijzen monitoren.

Het woord komt oorspronkelijk uit de serverwereld: een "headless server" is een computer zonder monitor of toetsenbord. Bij AI betekent het hetzelfde principe: de agent draait op de achtergrond, zonder dat iemand meekijkt of ingrijpt.

Waarom headless nuttig is

Veel AI-taken hoeven niet interactief te zijn. Een nachtelijke security-audit, een dagelijkse inbox-sortering, het schrijven van blogposts op schema: dat zijn taken die je een keer configureert en daarna automatisch laat draaien. Headless mode maakt dat mogelijk.

In de praktijk combineer je headless mode met drie dingen:

• Een vast prompt. De opdracht die de AI elke keer meekrijgt, opgeslagen als bestand of als argument in het startcommando.
• Beperkte tools. Je geeft de AI alleen toegang tot wat hij nodig heeft (bijvoorbeeld alleen Gmail-tools, niet het hele bestandssysteem).
• Automatische permissies. Omdat er niemand is om "ja" te klikken op tool-aanroepen, draai je met --permission-mode auto: een AI-classifier beoordeelt elke actie en blokkeert riskante stappen automatisch.

Voorbeeld

Een typisch headless commando in Claude Code:

claude -p "Sorteer mijn inbox" --model claude-sonnet-4-6 --allowed-tools "mcp__gmail__*" --permission-mode auto

De -p vlag geeft het prompt mee als argument in plaats van een interactieve chat te openen. --allowed-tools beperkt welke tools de AI mag gebruiken. --permission-mode auto laat een AI-classifier per actie beoordelen of die veilig is. Veilige acties (bestanden lezen, tests draaien) worden automatisch goedgekeurd. Riskante acties worden geblokkeerd. Dat is veiliger dan --dangerously-skip-permissions, dat alles blindelings goedkeurt.

Risico's

Headless sessies draaien zonder toezicht. Dat maakt het extra belangrijk om de toolset te beperken, duidelijke instructies mee te geven (bijvoorbeeld via een CLAUDE.md-bestand), en logs bij te houden van wat de AI doet. Een fout in een interactieve sessie corrigeer je direct. Een fout in een headless sessie kan uren onopgemerkt doordraaien.