Follow Discord
Sweep 27 Oct 2026 · 19:04Z Build v2.1.312 531 read Stable v2.1.308 Latest v2.1.312 Next v2.1.312 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.311 ·

Plugins using ${CLAUDE_PROJECT_DIR} can now fail instead of using a fallback folder

When the project folder can't be found, ${CLAUDE_PROJECT_DIR} in a plugin is no longer replaced with another folder and an error is raised instead

You'll notice Improvements
JSON All of v2.1.311
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
PluginsArea: what it touches
ImprovementsKind: in v2.1.311,
ImprovementsSection of the release
What

Plugins are add-ons for Claude Code. A plugin can write ${CLAUDE_PROJECT_DIR}, and Claude Code replaces it with the path of your project folder. That replacement now happens only when the project folder is known. If looking up the project folder comes back empty, Claude Code now raises an error, where it used to fill in another folder instead.

Why

Plugin hooks (commands a plugin runs automatically) that rely on ${CLAUDE_PROJECT_DIR} may now stop with an error in situations where they previously ran with a substitute folder.

See this entry in the whole of v2.1.311 →

Feedback