Follow Discord
Writing the changelog v2.1.309 compose entry prose · 2/5

Claude Code v2.1.299

529 entries read Grouped into 439 v2.1.296 → v2.1.299 Mods API: +13 added · 0 removed · 17 changed · 27 docs only Markdown JSON Follow Unofficial

You can now set subagentInheritVerifiedTurns to true so subagents start with your earlier verified messages. MCP servers can now provide skills to Claude Code. Each skill's size and fingerprint is checked against the server's list before it loads. With CLAUDE_CODE_ENABLE_SHARE_BUNDLE set, /share sends your whole session transcript along with your feedback. In remote sessions, CLAUDE_CODE_REMOTE_MCP_CONFIG points the runner to a file of MCP servers sent by the host. Routing WebFetch through a proxy now depends on CLAUDE_CODE_WEBFETCH_USE_CCR_PROXY instead of being worked out from session state.

19 entries are in the build but not switched on yet. Claude Code can fetch context for a claude.ai Project into a session, but only once it is turned on remotely. Apps built on the SDK will be able to word their own permission prompts from a PreToolUse hook. A stricter plan mode check can ask before any action that is not read-only. Project tools can read an uploaded PDF or Word file as the original document. Agents may later start in the background by default.

MCP allow rules no longer approve tools from a different MCP server. On Windows, sandboxed git now gets your git name and email for commits. Environment variables from settings or /env now reach sandboxed Windows commands too. The resume command printed on exit now includes --worktree for worktree sessions. If CLAUDE.md fails to load, Claude Code tries again later in the session. The MCP tasks feature is now off for everyone and can no longer be turned on remotely.

Written by our agent from the shipped bundle, not by Anthropic.

Five to try today

Picked from 28 you can use now
  1. Headless and remote runs handle delivered MCP servers and --mcp-config differently

    Remote runners get host-delivered MCP servers through CLAUDE_CODE_REMOTE_MCP_CONFIG, and --mcp-config sources are filtered by scope and ownership

    Sessions & agents
  2. Feedback bundles can include the conversation transcript

    /feedback bundles can now carry a transcript.jsonl file, and /share can send the whole transcript when CLAUDE_CODE_ENABLE_SHARE_BUNDLE is set

    Interface
  3. Agent view gets new-session settings for model, effort and fast mode

    In the agent view, /model opens a picker and model, effort and fast mode can be set for new sessions from that window without being saved

    Sessions & agents
  4. New CLAUDE_CODE_ environment variables for startup and remote session tuning

    Five new CLAUDE_CODE_* environment variables tune startup, changed-file checks, MCP loading and transcripts, and are forwarded to remote sessions

    Platform & internals
  5. Self-hosted runner gains a shutdown drain and tool-server sessions

    The self-hosted runner can wait up to --shutdown-drain-sec seconds for running work on SIGTERM, and supports a tool-server session kind

    Elsewhere

Want the reasoning? Read walks the 50 entries that probably matter to you, each one opening to what changed and why.

Read this release → Every row →
418 of 439 shownClear
Reading as
Show only
Who it's for
Tier
Flag state
Names
Pick an entry · j / k steps through · rest on a row to peek
211 entries here

Improvementsopen

Continued from page 2

19 more of these are in What probably matters to you, on page 1.

↑Improved
You'll notice
Useful1 Signal1
Sandbox unclear

Sandbox write check changes when deny lists may be incomplete#

The sandbox's file-write check now returns a negative answer when its stored deny lists may be incomplete, as it already did with sandboxing off

Unclear It is not clear whether the negative answer means affected writes now ask for permission or are handled some other way.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
MCP unclear

Calling an unloaded browser or computer-use tool now returns a clear error#

If the model calls a browser, computer use or simulator MCP tool before loading it, Claude Code now returns an error saying to load it first

Unclear It is not clear whether the new error is returned to the model for everyone or only recorded in some cases.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
Sandbox unclear

Linux sandbox setup check can show one more warning#

The Linux sandbox's check for missing system pieces now runs one more test and can add its warning to the list

Unclear What the extra check tests and what its warning says are not known.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
Projects no docs found unclear

Clearer messages when a project document write is refused for a version mismatch#

Refused project document writes now say the document changed since the given version and how to retry, or that the version cannot be checked

Unclear Which tool or feature writes these project documents is not stated.

Details 0 0 Feedback
if_version
↑Improved
You'll notice
Useful1 Signal1
Settings unclear

Claude Code notes when a git-related variable is dropped from a settings file#

When applying environment variables from settings files, Claude Code now records when a git-related key was dropped and reads each layer's own block

Unclear Which git-related key gets dropped, and whether it is one a reader might set on purpose, is not stated.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
VS Code unclear

Spinner allowed in VS Code; team and enterprise check widened#

Something called Spinner is now allowed in the VS Code extension, and the team and enterprise account check passes in one more case

Unclear The extra condition that now makes an account count as team or enterprise is not known.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
Hooks unclear

Message about a hook's approval being overruled now names plan mode#

When a hook allows a tool call but Claude Code still has to ask you, the explanation now lists plan mode as one of the reasons

Unclear It is not clear whether plan mode newly forces these prompts in this version or was already doing so and is only now named in the message.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
Remote Control unclear

Remote Control now keeps track of attachments that could not be saved#

Messages arriving through Remote Control now report attachments whose files could not be created, and queued notifications are handled differently mid-turn

Unclear What a user of Remote Control actually sees differently because of these changes is not stated.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal1
Subagents unclear

Subagents refused a different working folder now fail with a clear error#

If a subagent is not allowed to run in another folder, Claude Code now stops before starting it and says to start it without cwd

Unclear The conditions under which a different working folder is refused are not stated.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal0
Cloud Sessions unclear

Cloud upload failure advice tells you to commit changed files by name#

If preparing a cloud session's upload fails, Claude Code advises committing the files you changed by name, then retrying

Unclear Whether this wording actually differs from the previous release.

Details 0 0 Feedback
↑Improved
You'll notice
Useful1 Signal0
Permissions unclear

Deny-pattern and settings-read error messages are reworded#

Messages about deny patterns ending in a separator and about unreadable settings now use new wording, and the settings one is more general

Unclear It is not clear whether deny patterns now match differently or only the message changed.

Details 0 0 Feedback
38 entries here

Bug Fixesopen

✓Fixed
You'll notice
Useful3 Signal2
Permissions unclear

MCP allow rules no longer approve tools from a different MCP server#

MCP allow rules are matched more strictly, and Claude Code warns when one cannot approve a tool from another MCP server

Unclear It is not clear whether an allow rule that matched before this change will now prompt instead.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful2 Signal1
Elsewhere unclear

Shell snapshots keep your own PATH and add missing plugin folders#

In one case, shell snapshots now save your shell's own PATH plus any missing plugin folders instead of a fixed PATH

Unclear Which situations take this new snapshot route is not shown.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful1 Signal1
Worktrees

Worktree cleanup now also removes reftable files#

Cleaning up a git worktree's admin folder now also deletes reftable files, and macOS file opens check they got the right file

Details 0 0 Feedback
✓Fixed
You'll notice
Useful2 Signal0
Terminal UI

Emoji no longer break when split during display#

The terminal display now rejoins emoji that arrive split in two pieces, so they show correctly instead of as broken characters

Details 0 0 Feedback
13 entries here

In Developmentopen

6 more of these are in What probably matters to you, on page 1.

◌In dev
Nothing to try yet
Useful3 Signal3
Group of 2 Artifacts

Artifact requests can travel as MCP tool calls#

Some artifact requests, such as pinning and listing, can be sent as MCP tool calls through a new relay, with separate tracking for each kind

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful3 Signal3
Projects no docs found unclear

Project document edits can carry a version check#

In some cases Claude is told to pass back a document's version as if_version when saving a project document

Unclear It is not clear what switches on these version-check instructions.

Details 0 0 Feedback
if_version

Continues on page 4 →

Verbatim
Official · Anthropic

Anthropic’s official release notes

Published verbatim by Anthropic for v2.1.299. Text is unmodified from the upstream changelog. Everything else on this page came out of the bundle instead, which is why the two lists don't match.

Of these 190 bullets, 54 name something an entry on this page also names, 39 name something no entry here does, and 97 name nothing specific enough to line up either way. The pairings are made on names both sides wrote down, a flag or a setting or a slash command, so read one as probably the same thing rather than as a fact, and read the middle number as candidates rather than as a miss count.

A model matched these bullets to the GitHub issues they fix, so a link can be wrong.

System prompt

1 of 27 tool descriptions changed.

Claude Code, interactive mode

11 prompt changes in this release could not be quoted from the build, so no entry on this page describes them.

Documentation

What the docs did around this release

680 documentation changes were recorded within 24 hours either side of this release, nearest first. The closest 12 are below. They're here because they happened near this release in time. That's not a claim that this release caused the edit, or that the page documents anything in it.

Switches

Every name in this release

The 88 literal strings found in the bundle, with the number of entries that name each one. Picking one searches for it. A name is here because this build's code mentions it, which is not the same as it working or being finished.

Slash commands

CLI flags

Environment variables

Settings and names in the code

Feedback