self-hosted-runner
A Claude Code CLI flag, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
A whole new claude self-hosted-runner command tree is available to anyone who types it.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.224.
In the changelogs
15Releases whose published page names self-hosted-runner.
-
v2.1.280
New self-hosted-runner poll-interval override parser accepts signed duration strings
Claude Code can now parse signed duration strings like '-2.5s' for a self-hosted runner's health-poll interval
found in this entry's text
-
v2.1.277
New per-tool "backgrounding" policy field, most tools opt out
Tools now declare a backgrounding policy; most tools opt out of running in the background
found in this entry's text
-
v2.1.277
Per-tool 'backgrounding' classification rolled out across nearly all built-in tools
Nearly every built-in tool now carries a 'backgrounding' classification of never, self, or detach
found in this entry's text
-
v2.1.275
New self-hosted-runner drain grace: SELF_HOSTED_RUNNER_POST_TURN_SETTLE_MS
Self-hosted runners now wait briefly after a turn finishes before shutting down, so results aren't lost
found in this entry's text
-
v2.1.274
'Claude Code on the web' renamed to 'a cloud session' / 'cloud sessions' in user-facing strings
'Claude Code on the web' is renamed to 'cloud session(s)' across error messages, menus, and commands
found in this entry's text
-
v2.1.271
New self-hosted config permission key 'self_hosted_host_config'
New self-hosted runner setting: 'self_hosted_host_config'
found in this entry's text
-
v2.1.269
CLI bootstrap: no material change, variable renames only
CLI startup code re-minified with renamed variables only, no behavior change
found in this entry's text
-
v2.1.268
New --remove-session-state flag for self-hosted runner
Self-hosted runner can now delete a session's leftover files when the session ends
found in this entry's text
-
v2.1.224
claude self-hosted-runnercommand groupA whole new claude self-hosted-runner command tree is available to anyone who types it.
named in this entry, found in this entry's text
-
v2.1.224
self-hosted-runner orchestratorpolls for spawn hints and runs your own spawn scriptAn orchestrator subcommand polls for capacity hints and runs your own spawn-runner script to autoscale.
found in this entry's text
-
v2.1.224
self-hosted-runner setupanddoctorwalk you through it in a scoped Claude sessionsetup and doctor relaunch Claude with a restricted toolset to walk you through runner install and diagnostics.
found in this entry's text
-
v2.1.224
Git identity, commit signing and proxied clones for runner sessions
--configure-git sets a commit identity and installs SSH commit signing backed by a code-sign subcommand.
found in this entry's text
-
v2.1.224
Self-hosted runner operator tools
Nine operator tools can inspect runners, sessions, secrets, health, metrics and logs, loaded only via --base-tools.
found in this entry's text
-
v2.1.224
self-hosted-runner decode-tokeninspects a session token, verifying it by defaultdecode-token prints a session token's claims, verifying signature and expiry by default.
found in this entry's text
-
v2.1.224
Self-hosted runner installs a code-sign shim
The runner writes a code-sign helper script, using CLAUDE_RUNNER_CLAUDE_BIN if you set it.
found in this entry's text
First cited
4The earliest release whose published evidence quoted self-hosted-runner was v2.1.224, 7 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.