Claude Code 2.1.267

53changes

Cap the effort level across every provider with the new maxEffortLevel setting.
Render the system prompt fresh on every request with --system-prompt-snapshot off.
Avoid a prompt-cache miss when switching models with /model.
Keep earlier reasoning intact when an MCP tool reconnects or re-renders.
Preserve parallel tool calls and hook output when resuming a large session.

New features

Cap effort level across providers

Added maxEffortLevel setting (top-level or per model under modelSettings): caps the effort level on every provider, including Bedrock, Vertex and Foundry; users can still pick a lower level

▤ In the docs

Refresh system prompt every request

Added --system-prompt-snapshot off to render the system prompt fresh on every request instead of reusing the conversation's recorded prompt (for iterating on prompt text)

▤ In the docs

[Claude Tag] Switch to a custom connector

Added a "Use a custom connector" link to the preset connection forms in Claude Tag admin settings, so you can switch to a custom connection without starting over

Improvements

Keep keystrokes ahead of streaming

Improved prompt input responsiveness: keystrokes no longer occasionally wait a frame behind spinner or streaming repaints

More changes (8) Fewer changes

Steady /diff panel loading

Improved the /diff panel: it no longer flashes "0 files changed" and a spinner before settling, and its empty state is centered in the panel

Describe commands in plain words

Improved the Bash tool's description guidance so Claude describes what a command does in plain words instead of echoing the command

Suggest /copy when clipboard fails

Improved sandbox guidance so Claude suggests /copy when clipboard commands such as pbcopy fail inside the sandbox

Faster --resume for many Bash calls

Improved --resume first-render time for sessions with many Bash tool calls

Stabilize cache for custom system prompts

Improved prompt-cache stability: subagents and sessions started with --system-prompt or --append-system-prompt now record the system prompt and tool definitions once instead of re-rendering them

Explain refused Artifact publishes

Improved Artifact tool publish errors: when a publish is refused, the message now says why and what to do about it

Report legacy git proxy usage

Self-hosted runner: Changed --use-anthropic-git-proxy to be reported to the server at registration and to print a warning for each session that still clones through the legacy git proxy

Return 429 without upstream failover

Gateway: Changed forward_user_identity upstreams to return a 429 as-is to a developer whose email was forwarded, instead of failing over to the next upstream, so the proxy's per-user limits hold

▤ In the docs

Bug fixes

Avoid cache miss on /model switch

Fixed switching models with /model re-sending every tool definition (a prompt-cache miss); commit and PR attribution text now arrives as a conversation note that updates on model changes

Preserve reasoning across tool re-renders

Fixed earlier reasoning being dropped when an MCP server re-sends, or a built-in tool re-renders, a tool the model already loaded

Defer mid-session MCP tool definitions

Fixed mid-session MCP and plugin tools being added to the tool list in sessions without ToolSearch, which broke prompt-cache reuse; supported models now receive them as deferred definitions

Preserve tool calls in large resumes

Fixed resuming a large session (transcript over 5 MB): parallel tool calls and their hook output are no longer dropped from the reloaded conversation

Close marketplace path containment gap

Fixed a case where a marketplace entry path containing a backslash could bypass the containment check for fetched marketplaces on macOS and Linux

Deny unreadable managed allow-lists

Fixed managed allowedHttpHookUrls, httpHookAllowedEnvVars and allowedChannelPlugins to admit nothing, not everything, when unreadable

More changes (35) Fewer changes

Start sandboxed Cowork scheduled tasks

Fixed Cowork scheduled tasks in the cloud failing at startup for organizations whose managed settings require sandboxing

Fix blank output on mobile

Fixed /context and other local command output rendering blank on mobile clients

Restore keys after tmux reconnect

Fixed shift+enter and option+backspace not working after reconnecting to a tmux or ssh session inside an agent view

Show last-prompt header when scrolling

Fixed the dim last-prompt header not appearing at the top of the conversation when scrolling up in fullscreen mode

Classify large Workflow output schemas

Fixed Workflow agent() calls with large output schemas being refused in auto mode instead of being checked by the safety classifier

Show re-authenticate errors sooner

Fixed expired AWS or Google Cloud credentials under a host app such as Claude Desktop retrying ten times with a generic "request failed" before the re-authenticate error appeared

Skip spurious continue turn on resume

Fixed resuming a session after /compact or another slash command ran via -p --resume: a spurious "Continue from where you left off." turn is no longer inserted

Close login dialog with Esc

Fixed /login on machines whose managed settings require Claude apps gateway sign-in: Esc now closes the dialog instead of doing nothing

Retry interrupted artifact uploads

Fixed artifact publishes cut off by a dropped connection mid-upload: they now retry once when Claude Code can tell the upload never completed, instead of reporting an unknown outcome

Honor effort frontmatter on pinned models

Fixed effort: frontmatter on custom commands, skills, and subagents being ignored on models whose default effort is still pinned (Opus 4.7, Opus 4.8, Fable 5)

Name invalid UTF-8 in artifacts

Fixed artifact publish failing with an unhelpful error when the page file isn't valid UTF-8 or contains a replacement character (U+FFFD); the error now names the line and column to fix

List new repos in @ menu

Fixed claude agents @ directory menu not listing repositories created after the session started

Refresh permission mode on join

Fixed Remote Control clients that join a Claude Desktop or VS Code session showing a stale permission mode until it was changed again

Keep remote-control sessions alive

Fixed claude remote-control exiting and dropping every attached session when its server credential expires (about 30 days after start); the host now re-registers and keeps going

Stop usage-limit warning flicker

Fixed the usage-limit warning flickering on and off during a session when requests for different models or modes report different limit windows

Preserve thinking when tools disappear

Fixed a tool that disappears mid-conversation, from a disconnected MCP server or an upgrade, rewriting the tool list and discarding earlier thinking

Stop EnterWorktree breaking prompt cache

Fixed a background worker forked from a conversation adding EnterWorktree to the conversation's tool block mid-session, which broke prompt-cache reuse

Keep tool set stable on reconnect

Fixed resumed sessions rewriting the inline tool set when an MCP connector reconnects at a different moment than before

Replay recorded tool descriptions on resume

Fixed resumed sessions re-rendering tool descriptions instead of replaying the recorded ones when the first turn ran a tool

Preserve cache when connector tools change

Fixed prompt-cache misses and dropped extended thinking when a claude.ai connector's tools change between a session and its resume

Preserve tool announcements before reconnect

Fixed resumed sessions rewriting earlier MCP tool announcements (and dropping extended thinking) before their connectors reconnect

Keep cache when resuming print mode

Fixed a prompt-cache break when a print-mode (-p) conversation is resumed interactively: the system prompt prefix no longer changes

[VSCode] Fix hang on cyclic transcripts

Fixed the extension host hanging at 100% CPU when forking, editing an earlier message, or rewinding in a conversation whose saved transcript contains a cyclic parent link

[VSCode] Fix WSL2 screenshot paste

Fixed pasting a screenshot on WSL2/WSLg inserting raw image bytes into the chat input; the image is now attached when the clipboard provides it, otherwise the paste is ignored

[VSCode] Match diff blocks to theme

Fixed chat diff blocks always rendering with a dark editor theme; they now follow the active VS Code color theme, including high contrast

[VSCode] Fix mixed RTL text order

Fixed mixed right-to-left and English text rendering in the wrong order while typing in the message input

[VSCode] Fix CRLF diff edit failures

Fixed accepting an edit in the diff view on a file with Windows (CRLF) line endings failing with "String not found in file"

[VSCode] Fix @-mentions with spaces

Fixed @-mentions dropping files whose paths contain spaces

[VSCode] Load session list over Remote-SSH

Fixed the sessions list view failing to load in windows connected over Remote-SSH when the workspace folder exists only on the remote host

[VSCode] Stop runaway ripgrep processes

Fixed runaway ripgrep processes when viewing files in large or symlink-heavy workspaces

[Claude Code on the web] Refresh expired GitHub tokens

Fixed GitHub Enterprise Server sessions showing your GitHub account as disconnected once its token expired; PR and issue operations now refresh it automatically

[Claude Code on the web] Use connected account without GitHub App

Fixed gh and GitHub API calls failing in organizations without the Claude GitHub App; they now use your connected GitHub account and say so when none is connected

[Claude Tag] Explain exhausted usage credits

Fixed Claude replying "The API rejected the request as invalid" when the organization has run out of usage credits; the reply now says so and explains how to add more

[Claude Tag] Route edit requests to the right session

Fixed thread requests to edit or delete a message Claude posted at the channel's top level being answered with a correction instead of reaching the session that posted it

[Claude Tag] Fix Connect on access requests

Fixed Connect on Tool access requests under Admin settings > Review requests failing with "Authorization failed" or showing the requested access bundle as deleted