Claude Code 2.1.311
92changes- See how often each attached skill runs in Slack channels, and which go unused, from a new Claude Tag Skills analytics view.
- Fix standard-context sessions stopping with a 1M-context credit error past 200K tokens; they now compact and continue.
- Fix long freezes at startup and after file edits caused by a very long list item in CLAUDE.md.
- Load model settings from a signed file on Bedrock, Mantle, Vertex and Foundry by default; set CLAUDE_CODE_MODEL_CATALOG=off to turn it off.
- Fix plan approval in screen reader mode sending feedback you had already dismissed with Escape.
New features
5[Claude Tag] Add a Skills analytics view
Added a Skills view to Claude Tag analytics showing how often Claude runs each attached skill in Slack channels and which go unused, with Usage links in admin settings
Keep idle sessions on self-hosted runners
Added --hold-idle-file and --max-hold-min to self-hosted-runner, to keep an idle session while your host reports processes it left running
More changes (3) Fewer changes
Add a tip for Explanatory output style
Added a tip for the Explanatory output style, shown when you ask Claude for explanations
[VSCode] Add syntax coloring to code blocks
Added syntax coloring to code blocks in Claude's replies, in light, dark and high contrast dark themes
[VSCode] Show status for slow UserPromptSubmit hooks
Added a "Running UserPromptSubmit hooks" spinner status and screen reader announcement for slow UserPromptSubmit hooks
Improvements
31Load model settings from a signed file
Changed Claude Code on Bedrock, Mantle, Vertex, and Foundry to load model settings from a signed file on downloads.claude.ai; set CLAUDE_CODE_MODEL_CATALOG=off to turn this off
Raise ultrathink to xhigh effort
Changed ultrathink in the interactive terminal to run its turn at xhigh effort on Opus 5.5, Sonnet 5.5, Haiku 5.5 and Fable 5.1 through Anthropic's API; typed while Claude is working, it raises the rest of that turn
[VSCode] Honor VS Code's telemetry setting
Changed the extension to start Claude Code sessions with DISABLE_TELEMETRY set while VS Code's telemetry setting is off, so they send no usage metrics or error reports and fetch no feature flags
More changes (28) Fewer changes
Speed up startup for Pro and Max accounts
Improved startup time for Pro and Max accounts by skipping two network requests on launches within an hour of the last check
Warn when teleport loads from compaction
Improved /teleport and claude --teleport to warn when a compacted cloud session loads from its last compaction, so the messages it summarized aren't in the local copy
Clarify background session exit messages
Improved the messages shown when a background session's process exits: they no longer promise a restart that isn't coming, and they say how to resume the session
Route artifact views by link name
Improved artifacts with several views: Claude now routes each view on the link's #name and no longer says the address bar stays the same as you switch views
Show partial output on shell timeouts
Improved shell commands that reach their timeout: the result now shows the output so far and says the command is still running in the background
Retry compaction when the summary is missing
Improved compaction: when the model's reply has no summary in it, Claude Code now usually asks for the summary once more before it replaces the conversation
Refine Artifact tool's page vs document choice
Improved the Artifact tool's choice between a page and a document: explainers and visual or interactive work become artifact pages; documents are for writing people keep editing or pass around
Speed up startup for option-only launches
Improved startup time for launches whose only arguments are options and their values, such as claude --model opus
Point users to likely causes of dropped connections
Improved the "Connection dropped" API error: it now says where to look first (the proxy or gateway in use, else VPN or firewall; Anthropic API only, Bedrock, Vertex and Foundry are unchanged)
Announce permission rule deletion immediately
Improved screen reader mode: deleting a rule in /permissions says "Deleted allow rule ..." right away
Clarify refused sign-in code message
Improved the message shown when a pasted sign-in code is refused: it now says the code may have expired or been used, and to sign in again
Check channel topic before unprompted Slack posts
Improved Slack connector sends: Claude now checks a channel's topic for posting rules before messaging a channel you didn't name
Simplify screen reader question list
Improved screen reader mode: Claude's questions are listed as "Questions: Color (answered), Pages", without arrows or symbols
Limit ultrathink rainbow to active uses
Changed the ultrathink rainbow to appear only where the keyword can raise effort, and not when the word is quoted or part of a file path
Match Ctrl+D behavior in agent view to prompt
Changed Ctrl+D in agent view to match the prompt: on an empty input, pressing it twice exits
Escape control characters in JSON output
Changed --output-format json and stream-json output to write DEL, C1 control and Unicode format characters inside strings as \uXXXX escapes; parsed values are unchanged
Drop ineffective [1m] suffix from model names
Changed model names and IDs to drop the [1m] suffix and its label on models where the suffix has no effect; the suffix is still accepted
Show permission rule warnings once per user
Changed startup warnings about permission rules in settings files to show once per user until the rule changes
Reorder /code-review's effort-level guidance
Changed /code-review to tell Claude to put the effort level first and use max only when asked
Make DISABLE_COMPACT one-directional
Changed DISABLE_COMPACT in settings files and in a mod's $.env.set so they can only turn compaction off, not back on
Reuse cached skills list across sessions
Changed sessions that set CLAUDE_CODE_SYNC_SKILLS with feature-flag fetching off to reuse a claude.ai skills list up to 10 minutes old that another session on the machine fetched
Act on scrollbar clicks at mouse release
Changed clicks on scrollbar arrows and bars in fullscreen lists to act when the mouse button is released, so moving off the scrollbar before letting go cancels the click
Clarify what claude purge deletes
Changed claude purge to say it deletes data only on this computer, not anything stored by Anthropic
[VSCode] Load Web sessions on first tab open
Changed the session list side bar to load Web sessions when the Web tab is first opened, not at startup
[Claude Tag] Skip empty-report routine messages
Improved Claude Tag routines that run in a new session: a run with nothing to report can now end without posting a throwaway message to the channel
[Claude Tag] Show a lock icon for private channels
Changed Claude Tag admin settings to show a lock instead of # for private Slack channels that your own Slack account can see
[Code Review] Report no further retries clearly
Improved Code Review's check run to say no further automatic review will start when the model still can't analyze a change on the automatic retry
[Code Review] Auto-retry reviews after server faults
Improved Code Review reliability: a review whose session fails to start because of a transient server fault is now retried once automatically, and its check run says so
▤ In the docsBug fixes
56Fix standard-context sessions stopping past 200K tokens
Fixed standard-context sessions stopping with "Usage credits required for 1M context" when a request ran over 200K tokens; Claude Code now compacts the conversation and continues
Fix freezes from long CLAUDE.md list items
Fixed long freezes at startup and after reading or editing files when a CLAUDE.md file holds a very long list item
[VSCode] Fix extension host freeze reading PATH
Fixed the extension host freezing while the login shell ran its start-up files to read PATH on macOS and Linux
Fix dismissed feedback sent on plan approval
Fixed plan approval in screen reader mode sending feedback you had dismissed with Escape
More changes (52) Fewer changes
Fix delayed interrupt during MCP or skill waits
Fixed interrupting Claude not taking effect until a timeout while an MCP server had not answered a resource read or a skill was still downloading
Fix Write/Edit stalls on huge file changes
Fixed Write and Edit stalling for up to 5 seconds after they ran, and reporting 0 lines changed, when changing thousands of lines in a file
Fix subagent access to late-connecting MCP servers
Fixed subagents being unable to use MCP tools from servers that finish connecting after the subagent starts
Fix stale memory files after compaction
Fixed Claude seeing stale MEMORY.md and CLAUDE.md content right after automatic compaction when those files were edited earlier in the session
Fix out-of-order transcripts in -p/SDK sessions
Fixed claude -p and SDK sessions saving transcript messages out of order or keeping messages that were taken back
Fix repeated SubagentStop hook runs
Fixed SubagentStop hooks running about twice a minute for each running subagent instead of once when it finishes
Fix @ picker ignoring ignore-file negation rules
Fixed the @ file picker ignoring .ignore/.rgignore negation rules that re-include git-ignored files
Fix worktree removed during background subagent work
Fixed a subagent's isolated worktree being removed while a background subagent it started was still working in it
Fix auto mode waking into unwanted new turns
Fixed background agents in auto mode that wait on their own shells starting a new main conversation turn on every wake
Fix Bash tool's working directory claim
Fixed the Bash tool description claiming the working directory always persists between calls
Fix environment block naming wrong shell
Fixed the environment block naming a shell commands don't run in, such as fish when the Bash tool uses zsh
Fix wrong project entry for local MCP servers
Fixed claude mcp add, claude mcp remove and /mcp naming the current folder instead of the project entry in ~/.claude.json that holds a local-scope server when run below a repository root
Fix duplicated error codes in MCP status
Fixed claude mcp list and claude mcp get showing the error code twice on failed-connection lines (for example ENOENT: ENOENT: ...)
Fix Remote Control stuck on Connecting
Fixed Remote Control sessions staying on "Connecting" for about two minutes when a network proxy blocks a startup request
Fix Claude's messages shown as your own on mobile
Fixed messages that Claude sends to a cloud or Remote Control session appearing as your own message in the Claude mobile apps
Explain attachment save and limit failures
Fixed Claude not being told the cause when a file attached to a message sent over Remote Control or to a cloud session could not be saved because the disk was full, or that a message's attachments past the first 20 were left out
Time out stalled WebFetch/WebSearch in Cowork
Fixed WebFetch and WebSearch hanging on a stalled response in Cowork cloud sessions; an unfinished request now fails after 300 seconds
Restart crashed background sessions that need it
Fixed a background session that crashed between turns not being restarted while it was attached, pinned, or had a scheduled task or wake-up set
Fix wrong daemon command in error suggestion
Fixed the "background service did not respond" error suggesting the disabled claude daemon restart; it now suggests claude daemon stop --any and says it ends background sessions
Avoid starting daemon on invalid respawn id
Fixed claude respawn <id> starting the background service before reporting that no background session matches the id
Warn about cache misses from plan model changes
Fixed /effort not warning about a prompt cache miss in plan mode when the plan model differs from the session model
Fix premature VS Code install success message
Fixed /ide saying the VS Code extension was installed before the install finished or when it failed
Fix Write preview errors on wide lines
Fixed the Write tool's file preview skipping rows and miscounting hidden lines when a line is wider than the terminal
Fix duplicate sends of undelivered messages
Fixed the up arrow in an agent's chat tab recalling a message that was still waiting to be delivered, so resending it sent a second copy
Fix Cowork losing tools after restart
Fixed Cowork cloud sessions losing their connectors and most tools after a restart when a plugin or your settings named an agent; Cowork cloud sessions now ignore that setting
Fix agent teams losing task list on resume
Fixed agent teams sessions showing an empty task list when coming back with --resume, --continue, /resume or --session-id, including after /clear or a crash, and /branch writing to the original session's list
Fix image paths dropped when mentioned in text
Fixed pasting text that mentions an image file, such as ! open /tmp/shot.png or /review look at /tmp/shot.png, attaching the image and dropping its path from the prompt
Fix feedback card shortcuts shown over prompt text
Fixed the feedback draft card showing its 1/2/0 and Esc shortcuts while the prompt has text, when those keys act on the prompt instead of the card
Fix lone backslashes vanishing from replies
Fixed a lone backslash in quotes or brackets, like "\" or (\), disappearing from Claude's responses
Honor DISABLE_COMPACT for agent teammates
Fixed agent teammates compacting their history when DISABLE_COMPACT is set
Hide summarize options when compact is disabled
Fixed the rewind menu offering "Summarize from here" and "Summarize up to here" when DISABLE_COMPACT is set
Fix skills rerunning after session restart
Fixed a finished /code-review, or another skill that runs in a sub-agent, running a second time when a cloud or background session restarts
Fix long thinking cut off as idle
Fixed long hidden thinking being cut off as idle on Google Vertex AI, Microsoft Foundry and Claude Platform on AWS, where the endpoint sends thinking progress updates
Fix false JetBrains install success message
Fixed /ide saying it had installed the JetBrains plugin when nothing was installed
Point subscribers to billing, not an admin
Fixed Claude Pro and Max subscribers being told to ask their admin when their subscription can't be used; the message now points to billing settings
Fix empty diff pane auto-opening
Fixed the diff pane opening by itself after an edit in wide fullscreen terminals when it had nothing to show
Fix false failed status after clearing auth
Fixed /mcp showing a remote server as failed after "Clear authentication" when the server works without sign-in
Fix false authenticated status in /mcp
Fixed /mcp showing "authenticated" for a remote server that Claude Code sends no credentials to
Fix plugin-dir folder loading as one plugin
Fixed a --plugin-dir folder of plugins loading as one plugin when an empty .mcp.json was at its top
Show large cache misses in /usage
Fixed /usage never showing large prompt-cache misses under "What's contributing to your limits usage?"
Fix status line links in background sessions
Fixed status line links staying plain text in background sessions after you open them from a terminal that supports links
Fix wrong forked wording in rewind confirm
Fixed the /rewind confirmation saying the conversation "will be forked" when the later messages are removed from the conversation
Fix wrong rewind warning about manual edits
Fixed the /rewind warning that wrongly said manual and Bash edits are never affected by a code restore
Stop retrying requests marked not to retry
Fixed Claude Code retrying requests the API marked not to retry, which could hold a turn for minutes or, in unattended retry mode (CLAUDE_CODE_RETRY_WATCHDOG), indefinitely
Fix sandbox bwrap error on plugin-dir overlap
Linux: Fixed sandboxed Bash commands failing with bwrap: Can't create file when a --plugin-dir folder was also an added directory and permissions.blockReadsOutsideWorkingDirectories was on
Start runner sessions despite blocked repos
Self-hosted runner: Fixed a session failing to start when a rate limit (HTTP 429, or a git wrapper that exits 75) blocks an added read-only repository; it now starts without that repository
[VSCode] Fix panel messages missing file context
Fixed custom skills and custom slash commands sent from the VS Code or JetBrains panel leaving out the open file or selected lines that ordinary messages include (anthropics/claude-code#102799)
[VSCode] Fix image clicks also opening text tabs
Fixed clicking an image in a tool result, or closing its preview, also opening the result's text in an editor tab
[VSCode] Stop dictation when Send button is used
Fixed voice dictation continuing to record after a message was sent with the Send button; sending now stops dictation first, as pressing Enter already did
[Cloud sessions] Fix routines locked after rejoining org
Fixed routines in Anthropic-hosted environments staying locked after their owner left the organization and rejoined; the owner can now turn them back on
[Cloud sessions] Show error toast on failed token actions
Fixed a failed routine API token delete or regenerate showing nothing if the edit dialog had already closed; it now shows an error toast
[Cloud sessions] Reject duplicate environment names
Fixed cloud environment dialogs, including the admin dialog, accepting duplicate names; they now refuse a name another listed environment already has