Home / Reference / Environment variables

`CLAUDE_RUNNER_CLAUDE_BIN`

env never mined JSON

A Claude Code environment variable, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

The runner writes a code-sign helper script, using CLAUDE_RUNNER_CLAUDE_BIN if you set it.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.224.

First seen — never in a mined build

Last seen — never in a mined build

Builds0 / 149on this box, as of v2.1.308

Written about v2.1.224 first named in a changelog, 7 Aug 2026

In the changelogs

Releases whose published page names CLAUDE_RUNNER_CLAUDE_BIN.

v2.1.307 21 Oct 2026
Self-hosted runner options for proxies, checkout hook time limits and nested repositories
The self-hosted runner reads its proxy from --agent-proxy-url, limits checkout hook time and tightens how nested-repository diffs are shown

found in this entry's text
v2.1.224 7 Aug 2026
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.

named in this entry, found in this entry's text

First cited

No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.

Presence across releases

The 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 environment variable does. All environment variables.

Names beside it

Every environment variable in the inventory starting claude_runner, up to twelve of them.

CLAUDE_RUNNER_ACTIVITY_FD v2.1.196
Claude Code now recognises the CLAUDE_CODE_REMOTE_MCP_CONFIG environment variable and passes it on to processes it starts
CLAUDE_RUNNER_CLIENT_PLATFORM v2.1.301
Odd platform labels from the runner are rejected or replaced with "unknown" instead of exported.
CLAUDE_RUNNER_DISABLE_AWAITING_ACTION_OVERRIDE v2.1.200
Boolean (1, true, yes or on) read by the self-hosted runner when a child session's turn ends. Normally, if the turn cannot be treated as a plain turn-end and the child last reported waiting_on_user: true, the runner reports the session as awaiting-action ("child parked at a prompt"); when this is true that step is skipped and the turn end goes through the turn-end-deferred path instead.
CLAUDE_RUNNER_FAIL_FAST_FETCH never mined
Two env vars change how runner git fetches handle retries and stalled delta resolution.
CLAUDE_RUNNER_FETCH_DEPTH v2.1.172
Full git checkout machinery for self-hosted runners now ships, but you cannot reach it interactively.
CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS v2.1.295
CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS sets a time cap on server-side progress when a runner fetches a repository
CLAUDE_RUNNER_SESSION_UUID never mined
Runner hooks now get CLAUDE_RUNNER_SESSION_UUID and CLAUDE_CODE_REMOTE_SESSION_UUID so your scripts can key on the session.
CLAUDE_RUNNER_SKIP_GIT_VERIFY v2.1.224
Set to exactly 1 in the self-hosted runner's environment to skip the check that a checkout hook left a .git entry in the checkout directory. Without it, a hook that exits 0 but leaves no .git fails with an error that suggests this variable for non-git SCMs; the checks that the checkout path exists and is a directory still run.
CLAUDE_RUNNER_UPDATE_BIN v2.1.307
Claude Code now treats CLAUDE_RUNNER_UPDATE_BIN and CLAUDE_RUNNER_ACTIVITY_FD like its other remote session variables
CLAUDE_RUNNER_USE_GIT_PROXY v2.1.224
Environment form of the self-hosted runner's --use-anthropic-git-proxy flag; a truthy value turns on Anthropic-managed git. The runner then registers as opted in, exits with an error unless --capacity is 1, and installs its git proxy credential setup (the help text warns this replaces the account's home-level git config).

Documentation pages 2

Customize sessions in self-hosted environmentsmentions itClaude Code CLI
Verify session identity in self-hosted environmentsmentions itClaude Code CLI

A reference table page is one whose own table defines this name, and it is where the description above came from. A page that mentions it carries the name somewhere in its text and may say nothing about it at all. Every page carrying it.