--base-dir
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.
The setup wizard spawns a detached runner into ./runner-setup and warns it outlives your session.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.224.
In the changelogs
4Releases whose published page names --base-dir.
-
v2.1.229
Self-hosted runner requires
--base-diron WindowsSelf-hosted runners on Windows now require you to set a base directory instead of failing oddly.
named in this entry, found in this entry's text
-
v2.1.229
Self-hosted runner requires
--base-diron Windows and validates launcher hooksOn Windows the self-hosted runner now requires --base-dir, and launcher hook config is validated.
named in this entry, found in this entry's text
-
v2.1.225
Self-hosted runner checks its base directory before starting work
The self-hosted runner fails fast if its base directory is unwritable or the mount hangs.
named in this entry, found in this entry's text
-
v2.1.224
Local runner spawn writes into ./runner-setup and checks 127.0.0.1:8080
The setup wizard spawns a detached runner into ./runner-setup and warns it outlives your session.
named in this entry, found in this entry's text
First cited
1The earliest release whose published evidence quoted --base-dir was v2.1.229, 12 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.