Headless
Een AI-sessie die draait zonder zichtbare interface, aangestuurd door een script of cron-taak in plaats van door een mens achter een scherm.
Laatst bijgewerkt op
Een headless AI-sessie is een sessie zonder grafische interface. Er is geen chatvenster, geen terminal die je ziet, geen mens die typt. In plaats daarvan start een script of geplande taak (zoals een cron job of LaunchAgent op macOS) de AI met een vaste opdracht, en de AI voert die zelfstandig uit.
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 een vlag die permissies automatisch goedkeurt.
Voorbeeld
Een typisch headless commando in Claude Code:
claude -p "Sorteer mijn inbox" --model claude-sonnet-4-6 --allowed-tools "mcp__gmail__*" --dangerously-skip-permissions
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. --dangerously-skip-permissions zorgt dat de AI niet wacht op handmatige goedkeuring.
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.