Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.234 ·

CLAUDE_CODE_PROJECT_DIR_NAME overrides the per-project state folder

You can name the per-project history folder yourself, as long as you also set a custom config directory.

Use it now Notable New Features
JSON All of v2.1.234
Use it nowTier: how much it should matter to you
3Useful: my rating, 1 to 5
2Signal: worth watching, 1 to 5
ConfigurationArea: what it touches
New FeaturesKind: in v2.1.234,
What probably matters to youSection of the release
What

Claude Code keeps each project's history and sessions in a folder under projects in its config directory, named after the project path. You can now name that folder yourself with CLAUDE_CODE_PROJECT_DIR_NAME, which only applies when CLAUDE_CONFIG_DIR is also set.

Details
  • The name must match [A-Za-z0-9_-]{1,64}.
  • Windows reserved device names are rejected: con, prn, aux, nul, com0-9, lpt0-9.
  • When the override differs from the usual path-derived name, history and session lookup searches both folders, so existing sessions are still found.
Usage
export CLAUDE_CONFIG_DIR=~/.claude-work
export CLAUDE_CODE_PROJECT_DIR_NAME=my-project
Evidence

CLAUDE_CODE_PROJECT_DIR_NAME

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

Read from
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Customize sessions in self-hosted environments touched a line naming CLAUDE_CONFIG_DIR after this was published. | `CLAUDE_CONFIG_DIR` | Per-session Claude config directory, written at session start from the snapshot of the runner host's config that the runner captures at startup; see [Permissions and tool approval](#permissions-and-tool-approval). W… self-hosted-environments-configuration see the edit
Confirmed since Anthropic's documentation has since written up CLAUDE_CONFIG_DIR, on Claude Code changelog. * \[VSCode] Fixed the session list, settings toggles, and chat tabs when `CLAUDE_CONFIG_DIR` is set in a settings file or the `environmentVariables` setting changelog see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up CLAUDE_CONFIG_DIR, on Claude Code changelog.
Anthropic's release notes agreeAdded the optional CLAUDE_CODE_PROJECT_DIR_NAME environment variable: hosts that give each session its own config directory can choose a…
The name it cites is new in this buildNew in this build: CLAUDE_CODE_PROJECT_DIR_NAME

See this entry in the whole of v2.1.234 →

Feedback