{"version":"2.1.321","anchor":"headless-user-delegated-session-start-can-be-refused","canonical_anchor":"headless-user-delegated-session-start-can-be-refused","heading":"Claude Code run without a terminal can refuse to start a delegated session","tier":"notice","area":"Delegated Sessions","scope":"org","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.321\/e\/headless-user-delegated-session-start-can-be-refused","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.321","markdown":"### Claude Code run without a terminal can refuse to start a delegated session\n\nWhen Claude Code runs without an interactive terminal, a new startup check can refuse a user-delegated session and exit\n\n**Unclear.** What the startup check tests, and so when a start is refused, is not stated.\n\n**What**\n\nClaude Code can run headless, meaning without an interactive terminal, usually when another program drives it. At headless startup there is now an extra check. If it fails, Claude Code reports `user_delegated_session_start` with the reason `refused_at_start` and exits.\n\n**Why**\n\nThis is a new way for a headless start to be refused. A program driving Claude Code may see it stop at once with that reason.\n\n- Area: Delegated Sessions\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 3\/5\n- Scope: org\n- Heads-up: no"}