Follow Discord

Claude Code v2.1.287

latestnext 526 entries read Grouped into 448 v2.1.286 → v2.1.287 Mods API: +10 added · 0 removed · 10 changed · 11 docs only Markdown JSON Follow Unofficial

You can now run gh api REST calls in sessions that do not have the GitHub CLI installed. Claude Code supplies its own limited gh and sends those calls through the session's GitHub proxy. A new command, claude daemon remote-control stop-shell, stops a background shell command running for a cloud session. Programs driving Claude Code can now read a background task's output with a get_task_output request. Compression of requests sent to the model is available through CLAUDE_CODE_GZIP_REQUEST_BODY_BLOCKS and is off by default. Admins can now set CLAUDE_CODE_TRANSCRIPT_LOCAL_GC through managed policy to turn on local transcript clean-up.

This build holds 7 things that are not switched on yet. Claude Code can offer to move you to a newer model, as a one-line notice or a dialog. A reworked way of saving your shell's functions, aliases and options for Bash commands is also in the code. Both stay off unless Anthropic turns them on remotely. Groundwork has landed for running the SessionStart hooks of plugins that load mid-session. None of this changes what you see today.

Remote sessions no longer forget their background tasks when they reconnect. A stalled live-update connection now times out and reconnects instead of hanging forever. Relaunching after /update now resumes your conversation even when Claude's last reply could not be saved. Messages from Amazon Bedrock guardrails now show up in the reply instead of going missing. A shell command that only names a web address is no longer escalated as if it touched a protected file path. /plugin-types is no longer listed among the command categories.

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

Five to try today

Picked from 30 you can use now
  1. /plugin help can list a command for searching the Anthropic Directory

    The /plugin help screen can show /plugin directory [query] for searching the Anthropic Directory in Discover

    Extensions
  2. Four new startup environment variables for cloud sessions

    Claude Code now reads four new startup environment variables and passes them through to cloud sessions; they do nothing unless set

    Sessions & agents
  3. New environment variable for tool output when Claude Code runs as an MCP server

    A new environment variable, CLAUDE_CODE_MCP_SERVE_TOOL_OUTPUT, appears alongside the other MCP server-mode variables

    Extensions
  4. Optional compression of requests sent to the model, off by default

    Claude Code can compress the requests it sends to the model in gzip blocks, controlled by CLAUDE_CODE_GZIP_REQUEST_BODY_BLOCKS and off by default

    Elsewhere
  5. plugin install --replace explains that it needs a full plugin id

    Running plugin install --replace without a name@marketplace id now says that id is needed and that nothing was installed

    Extensions

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

Read this release → Every row →
Reading as
Show only
Tier
Flag state
Names
Pick an entry · j / k steps through · rest on a row to peek
64 entries

What probably matters to you

Anything you can use today, anything that visibly changes, and anything worth poking at. One line each, open for detail.

+New
You'll notice
Useful5 Signal4
Group of 3 GitHub Notable unclear

Built-in gh api stand-in for sessions without the GitHub CLI#

When no GitHub CLI is found at session start, a built-in gh handles gh api REST calls through the session's GitHub proxy

Unclear It is not clear what starts this stand-in or whether it is used by default in every session that lacks the GitHub CLI.

Details 0 0 Feedback
↑Improved
You'll notice
Useful4 Signal5
Models unclear

Model picker can use the short name for the fable model family#

Model picker entries in the fable family can now be stored under the short name 'fable' when that name points to the same model

Unclear It is not clear whether fable models are offered to users at all.

Details 0 0 Feedback
fable
↑Improved
You'll notice
Useful3 Signal4
Group of 4 Remote Tools unclear

Remote tools: approval time limits, background commands and a host inventory#

Remote tool serving gains a max_ask_ms approval limit, carried-over approvals, background Bash commands and a report of the host machine

Unclear It is not clear exactly what happens to the request once it is carried over.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal4
Group of 5 Bash Tool unclear

Background agents and background commands can now be refused#

Background agents and background Bash commands gain new refusal paths, new wording for the model, and per-agent ownership on remote hosts

Unclear It is not settled that this only affects remote sessions, or what the limit is.

Details 0 0 Feedback
run_in_background
◌In dev
You'll notice
Useful3 Signal4
Group of 6 Models unclear

Reworked offer to switch to a newer model when resuming a session#

The prompt offering a newer model on resume gets new wording, a remote config for line or dialog form, and new rules for how often it asks again

Unclear It is not clear what triggers the offer or what exactly accepting it changes.

Details 0 0 Feedback
+New
Use it now
Useful5 Signal4
Cloud Sessions Notable unclear

Four new startup environment variables for cloud sessions#

Claude Code now reads four new startup environment variables and passes them through to cloud sessions; they do nothing unless set

Unclear It is not clear what each variable changes when set, or what normally sets them.

Details 0 0 Feedback
↑Improved
You'll notice
Useful4 Signal3
Group of 3 Plugins no docs found unclear

Anthropic Directory plugin marketplace with search, policy controls and stricter install checks#

A built-in Anthropic Directory marketplace adds plugin search, org and managed-settings controls, and stricter checks with new error codes on update and uninstall

Unclear It is not known what starts the search or the marketplace, or what the built-in default for the marketplace is.

Details 0 0 Feedback
allow_plugin_directory_search
+New
Use it now
Useful4 Signal4
Plugins Notable unclear

plugin install --replace explains that it needs a full plugin id#

Running plugin install --replace without a name@marketplace id now says that id is needed and that nothing was installed

Unclear It is not clear what controls whether --replace is available in a given session.

Details 0 0 Feedback
claude plugin install
+New
Use it now
Useful4 Signal4
Settings unclear

Held settings changes can be accepted or discarded, including for cloud sessions#

Settings edits Claude made without your approval are held for you to accept, discard or leave, and cloud sessions use only accepted versions

Unclear It is not clear what switches the holding of changes on, what the accept command is called, or whether it is available in this build.

Details 0 0 Feedback
↑Improved
You'll notice
Useful4 Signal4
Plugins unclear

Plugins from the plugin directory are checked against a listed commit#

The plugin directory is now handled as its own marketplace, with installs checked against the exact version the directory lists

Unclear It is not clear whether this is already available to users or still switched off in this build.

Details 0 0 Feedback
·Internal
Under the hood
Useful4 Signal4
Startup unclear

New import review dialog registered among the startup dialogs#

A new import review offer dialog is registered with the startup dialogs, and the name you-should-know-plugin joins an internal list

Unclear It is not clear when the dialog is shown, whether anything controls it, or what the list containing you-should-know-plugin is used for.

Details 0 0 Feedback
↑Improved
You'll notice
Useful2 Signal4
Group of 3 Hooks unclear

Cloud device hooks treated as author opt-in and run from the project folder#

Cloud 'device' command hooks now count as opted in by their author, start in the project folder, and show optedIn in the hooks listing

Unclear Only the description changed, and it is not clear whether how these hooks run changed too.

Details 0 0 Feedback
cloud
◌In dev
You'll notice
Useful2 Signal4
Group of 3 Skills unclear

Groundwork for skills loaded from attached folders#

Skills from attached folders can now appear in skill listings, a slot for them exists but nothing fills it yet, and unreadable paths are flagged

Unclear Something outside Claude Code, such as an app that hosts it, might fill this list in a way not found here.

Details 0 0 Feedback
·Internal
You'll notice
Useful2 Signal4
Group of 3 Channels unclear

Poll events gain groups, declared fields and new notices about other sessions#

Out-of-band poll events can arrive as atomic groups with declared fields, and messages from other sessions get new notices

Unclear It is not clear what sends grouped events, or what decides whether the user-role protection applies.

Details 0 0 Feedback
+New
Use it now
Useful5 Signal3
SDK Notable no docs found unclear

Programs driving Claude Code can ask for a background task's output#

A new get_task_output request lets a program controlling Claude Code read a background task's output

Unclear It is not clear whether the request works without the feature switch, or what the parts behind the switch do.

Details 0 0 Feedback
get_task_output
↑Improved
Use it now
Useful3 Signal3
Group of 2 SDK unclear

New get_task_output and prepare_turn control requests#

Programs driving Claude Code can now read a background shell or Monitor task's output with get_task_output, and send prepare_turn

Unclear It is not clear which connection types refuse get_task_output.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal4
Side Agent unclear

A new tip suggests turning on the You should know side agent#

A new tip points you to /plugin to turn on the You should know plugin, a side agent that watches while Claude works

Unclear It is not clear whether the tip system itself is switched on for everyone.

Details 0 0 Feedback
/plugin
↑Improved
You'll notice
Useful3 Signal4
Remote Tools unclear

Approvals for remotely served tools gain two new switches and a prompt category#

Tool approvals for remotely served tools gain two off-by-default switches, a category on each approval prompt, and settings-file write checks

Unclear What these changes mean for a person approving a remotely served tool is not worked out.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal4
Cloud Sessions unclear

Cloud sessions can place files into a protected home folder#

In cloud sessions, files can now be placed into a home folder under /uploads/.home, never overwriting existing files

Unclear It is not clear which setting switches home files on.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal4
Remote Tools unclear

Remote tool calls can wait for a lost host to reconnect instead of failing#

When the machine behind a remote tool call drops off, Claude Code can now wait for it to come back before giving up

Unclear It is not clear which kinds of remote connection support this wait, or whether the switch is on in this release.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal4
Side Agent unclear

Tip about the side agent reworded#

A tip now describes a side agent that watches for things you might miss during longer tasks and shows them above the prompt

Unclear It is not clear whether the feature this tip describes is available to users.

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful3 Signal4
Bash Tool unclear

Reworked saving of your shell setup for Bash commands, behind a remote switch#

A reworked way of capturing your shell's functions, aliases and options for Bash commands is in the code, off unless switched on remotely

Unclear Besides the remote switch there is another condition on when the new snapshot is used, and what it checks is not clear.

Details 0 0 Feedback
·Internal
Under the hood
Useful3 Signal4
Subagents unclear

Forked subagents can be given tighter tool permissions#

A forked subagent can now be launched with a stricter tool permission check layered over the main conversation's

Unclear What launches a fork with the narrower check is not known.

Details 0 0 Feedback
+New
Use it now
Useful4 Signal2
Group of 2 Plugins unclear

Plugin commands now handle the built-in directory marketplace#

Plugin marketplace add, remove, list, details and /reload-plugins now treat the built-in plugin directory specially, including when policy blocks it

Unclear It is not clear what makes the built-in directory unavailable rather than on, so it is not known who sees these messages.

Details 0 0 Feedback
+New
Use it now
Useful4 Signal3
Sessions unclear

Background sessions view gains a stop action#

The view of background sessions can now stop a session, keeps the age on the resume list steady, and some group header clicks no longer fold

Unclear Where the stop action is shown, and whether you can reach it yet, was not stated.

Details 0 0 Feedback
↑Improved
You'll notice
Useful4 Signal3
Remote Control no docs found unclear

Remote session connections gain a connection timeout setting#

The configuration for remote bridge sessions now accepts a timeout for setting up a connection: 0 to turn it off, or 20 seconds or more

Unclear The default value and where the timeout is actually applied are not clear.

Details 0 0 Feedback
sse_connect_timeout_ms
↑Improved
You'll notice
Useful2 Signal4
Bedrock unclear

Clearer error when a Bedrock model id is rejected#

When AWS rejects a model id as invalid, the Bedrock gateway now returns an error saying the model is not available and how to map it

Unclear It is not clear which gateway product this applies to.

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful2 Signal4
Startup unclear

Three new startup options appear without a stated purpose#

Claude Code's startup settings gain three new options: cloudDefaultNotAllowed, noMonorepo and terminalInput

Unclear It is not clear what any of the three options does, or whether a reader can set them directly.

Details 0 0 Feedback
·Internal
Under the hood
Useful2 Signal4
Subagents unclear

Background subagent launches can now require a confirmation step#

Starting a background subagent can now need confirmation and a hand-over, and is cancelled if refused

Unclear It is not clear what performs the confirmation or when that step applies.

Details 0 0 Feedback
·Internal
Under the hood
Useful2 Signal4
Permissions unclear

Standing allow rules offered by the server are now held#

When the server offers a single standing allow rule for permissions, Claude Code now stores it as held and logs that it did so

Unclear It is not clear what offers these rules, whether anything gates it, or what happens to a held rule afterwards.

Details 0 0 Feedback
+New
Use it now
Useful4 Signal2
Plugins unclear

The /plugin menu can turn the built-in marketplace on or off#

The plugin marketplace manager lists a built-in marketplace with Turn on and Turn off actions, and explains when policy hides every plugin

Unclear It is not clear what decides whether the built-in marketplace entry is shown.

Details 0 0 Feedback
/plugin
+New
You'll notice
Useful4 Signal2
SDK unclear

SDK messages can now say how long the model spent thinking#

SDK messages for a streamed thinking block can now carry a thinking_duration_ms field with how long it took

Unclear It is not confirmed that every program receiving these messages gets the field.

Details 0 0 Feedback
↑Improved
Use it now
Useful3 Signal2
Prompt Input unclear

Prompt shortcut prefixes now include n: and work after a space#

The a:, s: and o: prompt prefixes are now joined by n:, and can follow a space instead of only starting the text

Unclear What these prefixes do when Claude Code finds them is not known.

Details 0 0 Feedback
n:a:s:o:
↑Improved
Use it now
Useful4 Signal1
Terminal UI unclear

PageUp and PageDown keys added to selection lists#

Selection lists such as settings menus now map PageUp and PageDown to paging up and down

Unclear It is not confirmed that every selection list acts on these two keys.

Details 0 0 Feedback
select:pageUpselect:pageDown
+New
Use it now
Useful4 Signal1
Plugins unclear

Plugin browser shows who maintains a plugin and can filter by marketplace#

Plugin details now show community-managed status, repository and pinned commit, and the Discover list gains per-marketplace tabs switched with ctrl+s

Unclear It is not clear which of these changes depend on the internal check or what that check tests.

Details 0 0 Feedback
+New
Use it now
Useful4 Signal1
Terminal UI unclear

Right-click and middle-click can paste in fullscreen mode#

In fullscreen mode, right-click copies a selection or pastes, and on Linux middle-click pastes the primary selection

Unclear It is not clear whether this mouse paste behaviour is switched on for every user.

Details 0 0 Feedback
↑Improved
Use it now
Useful3 Signal1
Sessions unclear

Fleet view search can filter by name and group#

Fleet view search now accepts n: for a name and g: for a group, alongside the existing a:, s: and o:

Unclear It is not clear what o: searched before it was mapped to output.

Details 0 0 Feedback
a:s:o:
Were these the right ones to put at the top? 0 answered
Below the fold

Everything else

Smaller changes and internals, grouped as the pipeline found them. Nothing is dropped, it is only further down.

208 entries

Improvementsopen

29 more of these are in What probably matters to you, above.

↑Improved
You'll notice
Useful3 Signal3
Group of 2 Models unclear

Refusal fallback model can keep your effort level#

When a refusal switches Claude Code to a fallback model, your effort setting can now carry over to it, with some exceptions

Unclear It is not clear whether the carry-over, or the refusal fallback itself, is switched on for users.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Group of 2 Skills unclear

Skills can be withheld and reported as switched off for the session#

A skill can now be withheld for a session, and Claude is told it is switched off rather than that it failed to download

Unclear What causes a skill to be marked as withheld is not known.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Group of 2 Cloud Sessions unclear

Organization policy can now block cloud sessions#

Cloud sessions, including launching in the cloud by default, now respect an organization policy that can deny them

Unclear It is not clear what the default-to-cloud setting is or how it is turned on.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Group of 2 Attachments unclear

Image uploads can send scaled-down copies and tell Claude when they do#

Image uploads now report scaled-down copies and error codes, and Claude is told when an image was sent smaller than the original

Unclear It is not clear what the maximum number of posts limits during an upload.

Details 0 0 Feedback
↑Improved
You'll notice
Useful2 Signal3
Group of 2 Slash Commands unclear

/context shows less detail in hosted worker sessions#

In hosted worker sessions, /context now leaves out the message breakdown, built-in and system tool lists, and system prompt sections

Unclear It is not clear which sessions count as hosted workers.

Details 0 0 Feedback
/context
↑Improved
You'll notice
Useful2 Signal3
Group of 4 Cloud Sessions unclear

Turn handoff can name files to copy into the home directory#

A turn_handoff request can now carry up to 16 file names, and workers can advertise file_names and home_files support

Unclear Whether the remote side of this is already in use is not known.

Details 0 0 Feedback
↑Improved
You'll notice
Useful2 Signal3
Group of 3 Models unclear

effortLevel updates are skipped when already satisfied#

Settings and control updates carrying effortLevel are now ignored when a check finds the model and engine state already satisfy them

Unclear Which models or levels cause the setting to be skipped is not known.

Details 0 0 Feedback
effortLevel
↑Improved
You'll notice
Useful2 Signal3
Group of 2 Plugins unclear

Plugins report when their dependencies were not installed#

Plugin installs gain new errors and warnings for dependencies that were not installed, screened or allowed, plus stricter marketplace source checks

Unclear Where the two dependency error codes are raised is not shown.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Skills unclear

Claude is told when your message mentions a skill by name#

When a message contains /<skill>, Claude Code can tell the model and ask it to run the skill only if you want it run

Unclear It is not clear whether either change is switched on, or which setting chooses the stricter relay.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal2
Group of 2 Monitor Tool unclear

Monitor tool reworks its output handling, rate limiting and description#

The Monitor tool changes where stderr is reported, gets a configurable output rate limiter with batching, and trims its description in some conditions

Unclear It is not clear what decides which of the two versions of the instructions is shown.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Hooks unclear

Hooks modules can no longer use dynamic import()#

Claude Code now refuses a hooks module that uses import() and tells the author to use a static import declaration instead

Unclear It is not clear whether hooks modules themselves are generally available or limited by a switch.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal2
Group of 2 Tools unclear

Still-running operations now return their latest output#

When Claude checks on a still-running operation, the result now includes the latest output instead of only saying it is running

Unclear It is not clear which tool this applies to, or whether it is switched on for everyone.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
MCP unclear

Startup can drop a single MCP server instead of waiting for it#

Claude Code can now drop a named MCP server during startup so that server does not hold up startup finishing

Unclear It is not clear what triggers dropping a server or whether a user can ever cause it.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Cloud Sessions unclear

Cloud-served shell commands can run in the background#

Shell commands run for a cloud session can now be told to run in the background, and a GitHub CLI stand-in folder option is added

Unclear It is not clear what the gh stand-in folder is used for.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Hooks unclear

Repeated hook crashes now switch off only the affected mods#

After repeated crashes in the hooks worker, only the mods running there are switched off, and anything they held back stays held back

Unclear It is not clear what counts as a mod here, or which hooks still run after the fallback.

Details 0 0 Feedback
↑Improved
You'll notice
Useful3 Signal3
Attachments unclear

Oversize images can be scaled down before they are uploaded#

Claude Code can now shrink oversize PNG, JPEG and WebP images before uploading them, and tries a new image path for images sent by MCP servers

Unclear It is not clear which features use the new upload path, or whether MCP images go through the scaling step.

Details 0 0 Feedback
↑Improved
You'll notice
Useful2 Signal3
Cloud Sessions unclear

File staging accepts more mounted folders#

Claude Code's file staging now accepts files from more mounted folders, not only the outputs folder

Unclear It is not clear which other mounted folders are now accepted.

Details 0 0 Feedback

Continues on page 2 →

Verbatim
Official · Anthropic

Anthropic’s official release notes

Published verbatim by Anthropic for v2.1.287. 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 106 bullets, 14 name something an entry on this page also names, 40 name something no entry here does, and 52 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

No change to the system prompt since v2.1.286.

Claude Code, interactive mode

Documentation

What the docs did around this release

1187 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 57 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