{"version":"2.1.229","anchor":"self-hosted-runner-requires-base-dir-on-windows","canonical_anchor":"self-hosted-runner-requires-base-dir-on-windows","heading":"Self-hosted runner requires --base-dir on Windows","tier":"use","area":"Self-Hosted Runner","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.229\/e\/self-hosted-runner-requires-base-dir-on-windows","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.229","markdown":"### Self-hosted runner requires `--base-dir` on Windows\n\nSelf-hosted runners on Windows now require you to set a base directory instead of failing oddly.\n\n**What**\n\nStarting a self-hosted runner on Windows without a base directory now fails with an explanatory error instead of silently falling back to a POSIX container path that does not exist there. Set `--base-dir` or the `SELF_HOSTED_RUNNER_BASE_DIR` environment variable to the directory repositories should be checked out under. The runner also now passes `CLAUDE_RUNNER_CLIENT_PLATFORM` into spawned runner environments, parsed as `client_platform`.\n\n**Details**\n\n- Passing `--base-dir` records where the value came from.\n\n**Usage**\n\n`claude ... --base-dir C:\\runner\\repos` **Evidence** `--base-dir (or SELF_HOSTED_RUNNER_BASE_DIR) is required on Windows: the built-in default is a POSIX container path that does not apply there. Pass the directory that repositories should be checked out under.`\n\n- Area: Self-Hosted Runner\n- Names: `--base-dir`, `SELF_HOSTED_RUNNER_BASE_DIR`, `CLAUDE_RUNNER_CLIENT_PLATFORM`\n- Tier: Use it now\n- Useful: 3\/5\n- Signal: 3\/5"}