Follow Discord

Claude Code v2.1.284

latestnext 434 entries read Grouped into 328 v2.1.283 → v2.1.284 Mods API: +22 added · 0 removed · 7 changed · 12 docs only Markdown JSON Follow Unofficial

You can now use Sonnet 5.5 by choosing sonnet on the Anthropic API, where it replaces Sonnet 5. Bedrock, Vertex and other providers still get their older models under that name. A new sandbox network setting, deniedResolvedAddresses, blocks allowed websites that resolve to IP addresses or ranges you list. Apps built on the SDK can save a feedback report as a local zip with the new save_locally option. The Claude gateway can now sign in to its identity provider with a certificate, so oidc.client_secret is optional. /rate-limit-options now shows up in the command list.

Several features are in this build but not switched on yet. Claude Code can clear old tool results when you return after more than an hour idle. It keeps the last 5 results and stays off unless switched on remotely. PR Steward is an agent that looks after pull requests. /autofix-pr can now step aside when PR Steward is already working on one. A hidden guide plugin for the live mods added in v2.1.283 is built in but off.

Cleaning up an agent team no longer deletes its members' worktrees. Ending a session now closes only the tmux or iTerm teammate panes that session opened. Calls to an MCP tool whose server is still starting now wait instead of failing. A broken image in a prompt no longer crashes the turn. The /design canvas mode and the dashboard artifact template are removed. Claude can also no longer start /design on its own.

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

Five to try today

Picked from 18 you can use now
  1. Sonnet 5.5 becomes the default Sonnet model, with Sonnet 5 kept in the picker

    The sonnet alias now means Sonnet 5.5 (claude-sonnet-5-5) on the Anthropic API, Sonnet 5 stays pickable, and refusal handling now covers Sonnet

    Sessions & agents
  2. New appendSystemPromptHead option moves a verified start of the appended system prompt into the cached part, in remote sessions

    Remote sessions can move a hash-verified opening of --append-system-prompt text into the cached system prompt via CLAUDE_CODE_APPEND_PROMPT_HEAD

    Elsewhere
  3. Telemetry moves onto the plugin hook system, with a built-in cc-plugin-otlp and new rules for plugin telemetry hooks

    A built-in cc-plugin-otlp can send OpenTelemetry records through plugin hooks, and plugin telemetry hooks must name a stream, with anthropic reserved

    Extensions
  4. Unattended-serving consent gets a Remote Control hub row, and a Yes is not saved when settings turn it off

    A new hub row lets you see or withdraw consent for cloud sessions running commands on your computer, and policy-blocked Yes answers are not stored

    Sessions & agents
  5. SDK feedback can be saved as a local bundle, and hosts learn the feedback mode up front

    SDK hosts can save a feedback report as a local redacted zip with save_locally, and learn at startup whether feedback is sent, bundled or disabled

    Sessions & agents

Want the reasoning? Read walks the 42 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
38 entries

Bug Fixesopen

Continued from page 2

✓Fixed
You'll notice
Useful2 Signal1
Group of 2 Remote Control unclear

Remote Control sends an error in place of a refused tool answer#

When the service refuses a tool's answer in a Remote Control session, Claude Code now sends an error result instead of dropping it

Unclear When exactly this replacement is triggered is not settled.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful1 Signal2
Usage & Limits unclear

Usage-limit dialog now fixes the auto-continue reset time when it opens#

The usage-limit dialog now takes the reset time for its auto-continue option from a snapshot made when the dialog opens

Unclear Exactly how the new calculation of the reset time differs from the old one in practice is not settled.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful2 Signal1
Internals no docs found unclear

Proxy sign-in from proxyAuthHelper is now sent on more connections#

The proxy sign-in header produced by proxyAuthHelper is now also attached to connections made through Claude Code's other proxy route

Unclear It is not clear which of Claude Code's requests go through the route that now gets the header.

Details 0 0 Feedback
proxyAuthHelper
✓Fixed
You'll notice
Useful2 Signal1
Terminal UI unclear

Your terminal is cleanly redrawn after leaving a fullscreen view#

When a fullscreen view closes, Claude Code now restores and clears the normal terminal screen instead of just redrawing over it

Unclear Which fullscreen views actually use the new clean-up is not known.

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

Sandbox write-deny paths now apply in one more sandbox mode#

Your sandbox filesystem.denyWrite paths are now enforced in the sandbox mode used when a proxy port is configured, where they were ignored

Unclear What this particular sandbox mode is used for is not clear; it may be a sandbox for scripts or checks.

Details 0 0 Feedback
filesystem.denyWrite
✓Fixed
You'll notice
Useful2 Signal1
Settings unclear

Settings files with only warnings no longer block rule and hook edits#

Removing a permission rule or editing a hook is now refused only when the settings file has real errors, not just warnings

Unclear Whether the hook-editing check is also changed in this release, or only the rule removal.

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

Queued messages pulled back into the prompt keep their pasted images#

Pulling a queued message back into the input to edit it now keeps its pasted images as placeholders in the text

Unclear This behaviour was inferred without seeing how the placeholders are written.

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

Screen is redrawn from scratch after leaving a fullscreen view#

After a fullscreen view closes, Claude Code rebuilds the normal screen from a blank frame, and a text selection now forces a full repaint

Unclear Which fullscreen views this affects and what visible problem it fixes are not stated.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful1 Signal1
Terminal UI unclear

Vim mode moves the cursor back after a repeated change that typed nothing#

In vim mode, repeating a change that inserted no text now leaves the cursor one character back, unless it is at the start of a line

Unclear It is not clear which keystrokes produce a repeated change with no inserted text.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful1 Signal1
Permissions unclear

Remote approval messages now show the right timeout, tool name and reason#

Messages about remote approval requests that timed out, ended or were withdrawn now fill in their actual timeout, tool name and reason

Unclear It is not settled whether the old messages actually showed wrong values or whether this was only a rename inside the code.

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

Malformed streamed replies now fail with "Stream event unreadable"#

A broken piece of a streamed reply now stops with the error "Stream event unreadable" instead of carrying on with bad data

Unclear Whether Claude Code retries the request after this error is not clear.

Details 0 0 Feedback
✓Fixed
Under the hood
Useful1 Signal1
Remote Control unclear

Remote Control usage report now records the spawn mode you switch to#

When you switch Remote Control's spawn mode, the usage report Claude Code sends now records the mode you switched to

Unclear It is unclear whether the report actually records a different value now, or whether the code only renamed the value it already recorded.

Details 0 0 Feedback
✓Fixed
You'll notice
Useful1 Signal1
Terminal UI unclear

Vim mode: yank to end of text and repeating accented input behave differently#

In vim mode, yanking to the end of the text moves the cursor differently, and dot-repeat stores inserted text in one standard character form

Unclear Where exactly the cursor now ends up after yanking to the end of the text is not stated.

Details 0 0 Feedback
9 entries

In Developmentopen

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

◌In dev
Nothing to try yet
Useful3 Signal3
Group of 4 Computer Use unclear

Auto mode groundwork for reviewing computer-use and browser actions#

Behind server-side switches, computer-use actions can skip allow-rule shortcuts in auto mode, and browser and desktop tools can ask for a short action summary

Unclear It is not clear what reviews these actions once they go past the allow rule, whether an automatic classifier or a prompt to you.

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful2 Signal3
Group of 2 MCP unclear

MCP connections gain an unused hook for adding per-request headers#

Claude Code-owned MCP configs can now register a provider that adds headers to each request, but nothing in this build registers one

Unclear It is not clear which future feature will use this or exactly which MCP connections it will apply to.

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful2 Signal3
Remote Tools unclear

Served remote tools stop early and report why when their switch is off#

Attaching served remote tools to a session now checks a remote switch first and reports "flag_off" instead of loading the serving code

Unclear It is not fully confirmed which remote switch this check reads.

Details 0 0 Feedback
◌In dev
Nothing to try yet
Useful1 Signal3
Tool Loading no docs found unclear

A tool in remotely triggered sessions may no longer be loaded up front#

In sessions started by a remote trigger, one tool is no longer always forced into the set of tools loaded at the start

Unclear Which tool this applies to, and whether it was always loaded up front before, is not settled.

Details 0 0 Feedback
CLAUDE_CODE_ENTRYPOINT
◌In dev
Nothing to try yet
Useful1 Signal3
Slash Commands unclear

Command availability checks gain an extra switch that nothing uses yet#

Claude Code's check on whether a command is available now consults an extra per-environment switch that nothing turns on

Unclear What will eventually set this switch, and which commands it would hide, is not known.

Details 0 0 Feedback
79 entries

Internal Changesopen

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

·Internal
Under the hood
Useful2 Signal3
Account Memory unclear

Transcript sync can record an account-level on, read-only or off choice#

Saved pause records for transcript sync can now store an account-level choice of on, read-only or off, with two new pause reasons

Unclear It is not clear which sync feature these account choices control or where a reader would set them.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal3
Skills unclear

Skills synced from the server are now recorded as owned by Claude Code#

After fetching skills from the server, Claude Code records which ones it owns, and only logs a warning if that record cannot be saved

Unclear It is not clear what Claude Code will use the ownership record for.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Group of 3 Remote Hosts unclear

Artifact and file-listing requests can ask for a read-back#

A new readBack option asks the server to read state back for artifact frame requests and list_files actions, with read_back noted on share status

Unclear Which tool or connector this belongs to is not known.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Group of 2 Usage & Limits unclear

Billing attribution header adds prompt and turn indexes#

On first-party requests, x-anthropic-billing-header now includes cc_prompt_index and cc_turn_index when both are known

Unclear One additional condition on when the header is sent was not identified.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Gateway unclear

Gateway hosts vouched for by a recognized deployment skip network pinning#

A gateway host can now be accepted because a recognized deployment vouches for it, and those hosts are not pinned to a network fingerprint

Unclear It is not clear what uses this gateway check or how a deployment comes to vouch for a host.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Remote Control unclear

Remote Control automatic titles can now be skipped#

Remote Control sessions normally get an automatic title from the 1st and 3rd message, and under some condition this is now skipped

Unclear What triggers the skip is not clear; it could be a setting, a switch, or a title you already set.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Remote Hosts unclear

File edits sent from another machine are cleaned up like remote edits#

File edits whose input came from another machine now get the same path and text clean-up that remote edit calls already got

Unclear It is not clear which kinds of session mark input as coming from another machine.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Multi-Session unclear

Queued notifications with an overlong id are dropped#

Queued notifications relayed from another session are now dropped when their id is longer than a length limit

Unclear The length limit itself.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Terminal UI unclear

Hover effects can update when content moves under a still mouse#

Parts of the terminal display can now update their hover highlight when content redraws under the mouse, not only when the mouse moves

Unclear It is not clear which parts of the interface use this.

Details 0 0 Feedback
9 entriesTelemetry · none marked notable
8 entriesElsewhere · none marked notable
·Internal
Under the hood
Useful1 Signal2
Elsewhere unclear

Task notifications can mark work the session started itself#

Task notifications about work the session launched itself, like background agents or shells, can now be labelled as such

Unclear What sets the label is not known.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Elsewhere unclear

Saved cost data with impossible token totals is now rejected#

Saved cost data is now rejected when its token totals across models are larger than the limit allowed for a single number

Unclear It is not stated what happens to the saved cost data when it fails this check, or what the limit is.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Elsewhere unclear

The web search tool's description no longer names the current month#

The WebSearch tool's description now says the month is provided in the conversation instead of naming a month and year

Unclear It is not settled which paths still fill in the real month, or whether every session gives Claude the date somewhere else in the conversation.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Elsewhere unclear

OAuth registration sends "none" in place of private_key_jwt#

When Claude Code registers as an OAuth client, a configured private_key_jwt authentication method is now sent as "none"

Unclear Whether this applies to MCP server sign-in specifically is not confirmed.

Details 0 0 Feedback
6 entriesPlugins · none marked notable
·Internal
Under the hood
Useful2 Signal3
Plugins unclear

A missing plugin store can be carried over from another session#

If a plugin's stored data file is missing, Claude Code now tries to copy it over from a related session before starting empty

Unclear It is not clear which source the plugin data is copied from.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Plugins unclear

Plugin items are looked up by plugin name together with its source#

When Claude Code finds an item by plugin name, it now matches on the name combined with the plugin's source, not the bare name

Unclear It is not clear what kind of plugin item is looked up this way or exactly how the combined name is formed.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Plugins unclear

Failed marketplace adds now carry the marketplace name and folder#

When /plugin marketplace add fails to save a marketplace, the error now includes its name and folder for Claude Code to act on

Unclear Nothing is known to use the new detail yet, so whether any recovery is offered is not settled.

Details 0 0 Feedback
/plugin marketplace add
·Internal
Under the hood
Useful1 Signal1
Plugins unclear

Replacing a plugin marketplace's source now logs the old and new source#

Re-adding a plugin marketplace with a different source now logs both the source it had and the one replacing it

Unclear It is not clear whether the replaced source is shown anywhere on screen or only in the log.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Plugins unclear

Marketplace add refusals now tell a re-add apart from a name clash#

A refused /plugin marketplace add now records whether the marketplace is already added from the same address or its name is taken by another

Unclear It is not clear whether this kind is shown to you or only used inside Claude Code.

Details 0 0 Feedback
/plugin marketplace add
·Internal
Under the hood
Useful1 Signal1
Plugins unclear

Plugin hooks-module checks now report their usage-data declarations#

Checking a plugin hooks module now lists what it declares for usage data and can report problems for that module

Unclear What the checks look for, and what counts as a problem, is not clear.

Details 0 0 Feedback
4 entriesCloud Sessions · none marked notable
·Internal
Under the hood
Useful1 Signal2
Cloud Sessions unclear

Session file sync's first upload now depends on Anthropic's shutoff, not mute#

Whether a session's file sync still owes its first upload now depends on Anthropic switching file sync off, not on the sync being muted

Unclear What muting a sync means for the user, and where this check shows up, is not settled.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal2
Cloud Sessions unclear

Waiting status for device uploads can give two new reasons#

A waiting status tied to device uploads can now report a failed git step or uploads still pending from an earlier run

Unclear Which feature or screen shows this status, and who sees it, is not known.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Cloud Sessions unclear

More diagnostics for cloud folder sync when a turn starts early#

Git-based folder sync for cloud sessions now records extra diagnostics when a turn begins before the device has reported its status

Unclear It is not clear whether this case also shows you a message.

Details 0 0 Feedback
4 entriesFile Operations · none marked notable
·Internal
Under the hood
Useful1 Signal1
File Operations unclear

Unclear file identity now counts as unknown rather than a mismatch#

When Claude Code cannot tell whether two paths are the same file, the result is now reported as indeterminate instead of not live

Unclear What this live or not-live check protects, possibly git worktrees, is not settled.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
File Operations unclear

A path check no longer rejects network locations#

A shared check for operations that take a path now only confirms a path was given and no longer refuses network locations

Unclear It is not clear which feature these operations belong to, or whether network locations are now refused somewhere else instead.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal0
File Operations unclear

More placeholder file numbers are treated as unusable when identifying files#

When identifying a file by its device and inode numbers, Claude Code now ignores more placeholder inode values, including -1 and 2^64

Unclear Whether this applies only on Windows, and which features rely on this check, is not known.

Details 0 0 Feedback
4 entriesSandbox · none marked notable
·Internal
Under the hood
Useful1 Signal1
Sandbox unclear

macOS sandbox check gives more detailed answers when a sandbox is already on#

On macOS, the check for whether a sandboxed feature can run now returns one of several modes instead of always refusing when a sandbox is already active

Unclear It is not clear which feature relies on this check, or what the new capability check behind the person mode tests.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Sandbox unclear

Linux sandbox profile errors are now recognised by name#

Claude Code now lists an error type for Linux sandbox profile failures alongside its other named error types

Unclear What this list of error names is used for is not clear, and neither is whether the error type itself is new.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal0
Sandbox unclear

Finding the sandbox runtime no longer runs npm root -g on the spot#

The step that looks for the sandbox runtime package no longer runs npm root -g itself and waits up to 5 seconds for it

Unclear Where the npm location now comes from, and so whether the pause is gone or only moved, is not known.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal0
Sandbox unclear

Linux sandbox now looks up its seccomp helper in the background#

On Linux, sandbox setup now waits for a background search for the apply-seccomp helper unless seccomp.argv0 is set

Unclear Whether the set of folders searched for the helper actually changed is not known.

Details 0 0 Feedback
4 entriesSessions · none marked notable
·Internal
Under the hood
Useful1 Signal2
Sessions unclear

Shell command output in remote sessions can be capped at a set length#

Shell command output in a remote session can now be cut to a given number of characters, and otherwise is shortened as before

Unclear Nothing in this build appears to supply the limit yet, so the cap may have no effect for now.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Sessions unclear

Remote sessions report too-large events separately#

When a remote session fails to send an event because it is too large, that failure is now reported as its own case

Unclear Whether Claude Code does anything different when an event is too large is not settled.

Details 0 0 Feedback
·Internal
Under the hood
Useful1 Signal1
Sessions unclear

Remote sessions can recognise events that are too large to send#

Sending session events now reports when the service rejected them as too large, instead of treating it as a general failure

Unclear What remote sessions do after an event is flagged as too large, and whether it is retried, is not clear.

Details 0 0 Feedback
4 entriesStartup · none marked notable

Continues on page 4 →

Verbatim
Official · Anthropic

Anthropic’s official release notes

Published verbatim by Anthropic for v2.1.284. 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 100 bullets, 33 name something an entry on this page also names, 24 name something no entry here does, and 43 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.

System prompt

1 added and 1 removed, of 218 lines, about 4 words, in the prompt 15 of 27 arms receive. 3 other prompts also changed. 1 of 27 tool descriptions changed. The appended system-reminder blocks moved: 1 line added.

Claude Code, interactive mode

Documentation

What the docs did around this release

153 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 79 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