Source Intelligence

DisclaimerUnofficial, and not affiliated with Anthropic. Nearly all of this is read straight out of what ships: npm bundles, captured prompts, published docs. Anthropic's own notes go in verbatim, marked as theirs. The rest is my reading, and every entry carries the strings behind it. If one looks wrong, vote it down and say why.

All of v2.1.229 Home All releases olderv2.1.228 v2.1.231newer
Claude Code v2.1.229

Self-hosted runner accepts a settings file, and rejects hooks and orchestrator mode on Windows

Not switched on
Useful2 Signal3
Self-Hosted Runner

The runner can pass a settings file to sessions; its Windows hooks guard never actually fires.

A guard rejecting hooks dirs and orchestrator mode on Windows exists but its platform argument defaults to "linux", so it never triggers.

--settings--hooks-dirSELF_HOSTED_RUNNER_HOOKS_DIR
What

The self-hosted runner launcher now takes a path to a settings file and passes it to the session it spawns as --settings, and settings is added to the argument names the server is not allowed to override. A separate guard is meant to fail with an explanation when --hooks-dir, SELF_HOSTED_RUNNER_HOOKS_DIR or orchestrator mode is used on Windows, but its platform argument defaults to the literal "linux" and both callers rely on that default, so it never fires in this build.

Details
  • The reserved-argument list stops a server-provided config from replacing your settings path.
  • The Windows error text explains that orchestrator mode depends on the spawn-runner lifecycle hook.
Evidence

orchestrator mode is not supported on Windows: it is driven by the spawn-runner lifecycle hook

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

Related

Other releases about the same thing. Found by shared names or similar wording; neither means one caused the other.

See this entry in the whole of v2.1.229 →