Repository navigation
Claude Code v2.1.330
构建日期: 2026-11-20T17:55:16Z
最新更新
2.1.330
- Added sign-in to organizations managed in Anthropic's Enterprise Admin Console: after
claude auth login, Claude Code applies the organization's settings and uses its cloud provider or gateway - Added easel, a built-in mod that draws charts when asked and under MCP metrics results, on Pro, Max and, where available, Team and Enterprise on macOS and Linux; turn automatic charts off in
/config - Added
CLAUDE_CODE_FULL_SIGN_IN_LINK=1to print the full sign-in link, if the short one shows an error or a script reads values from it - Self-hosted runner: Added
--start-dir/SELF_HOSTED_RUNNER_START_DIRto have Claude start its work in a folder of a repository, while settings and hooks load as without it - Added a notice in cloud and self-hosted runner sessions when a plugin marketplace can't be fetched because its repository isn't one of the session's
- Self-hosted runner: Added a notice when Anthropic-managed git refuses a plugin's own repository, naming the plugin and what to do
- Added
commandPrintedtoclaude plugin install --jsonresults, true when the plugin's install command wrote to stderr, andcommandFailedwhen it exited with an error, was killed or timed out - Added
claude_code_self_hosted_runner_order_to_registered_secondsto the self-hosted runner's/metrics: seconds from work order issued to registration accepted, on orchestrator-spawned runners - Added
claude_code_self_hosted_runner_order_to_first_session_secondsto the self-hosted runner's/metrics: seconds from work order to first session handed over, on runners started for a session - Fixed Claude Code freezing for up to several minutes right after compacting a very long conversation
- Fixed WebFetch freezing the session for minutes on some pages, and returning an empty result for some others
- Fixed
ExitWorktreeand the worktree exit dialog deleting a worktree that another running Claude Code session was working in - Fixed changes to user settings being lost when several Claude Code processes saved them at the same time
- Fixed
--continueand--resumeopening an empty session or failing when the last saved message had a missing or invalid timestamp - Fixed the first prompt after a sleep of two minutes or more waiting three minutes on a connection that had died, on Linux and WSL
- Fixed turns failing with "JSON schema is invalid", and session files growing by many megabytes, when many MCP tools have an input schema that the API refuses
- Linux: Fixed Bash commands waiting seconds and showing no file diff for the rest of a session in slow repositories with large ignored folders such as
node_modules - Windows: Fixed Bash commands running slower for the rest of a session after Git Bash took 10 to 60 seconds to start, on machines with no custom start-up files
- Fixed
/rewindsometimes restoring an older version of a file when two queued prompts, or stacked skills, ran together right after a turn that changed it - Fixed text and images added when approving a permission prompt being dropped when the approved command or tool then failed
- Fixed MCP resources from claude.ai connectors and plugin servers not being attached when @-mentioned in the terminal's prompt box
- Fixed an MCP server that subagents declare being shut down when one of them finished, while other subagents or the session were still using it
- Fixed Claude in Chrome staying "not connected" after a brief connection problem, even though Chrome was open and signed in
- Fixed terminal sessions on Amazon Bedrock (Mantle) started with no model selected ignoring a pinned Opus model, and still calling an unavailable default model after announcing a fallback
- Fixed the rest of what you were typing being lost when a plan arrived in fullscreen mode
- Fixed claude.ai connectors with different names being dropped when they share a server URL (anthropics/claude-code#101856)
- Fixed plugins going missing from the installed list when several
claude plugincommands ran at the same time - Fixed task dependencies and metadata being lost when several task updates ran at the same time
- Fixed incomplete backups of
~/.claude.jsonbeing kept, and displacing good ones, when the disk was full - Fixed a long pause in Code Mode after code that read hundreds of files in projects with path-scoped rules or Read deny rules
- Fixed the built-in chart tool failing when Claude called it in Code Mode
- Fixed Code Mode ignoring an MCP tool's request to end the turn from a script in auto and bypass permissions modes
- Fixed Code Mode in auto mode dropping earlier thinking and rewriting the prompt cache when a mod added a note after a script loaded a skill
- Fixed Code Mode not restoring a file that a script had read after Esc and
/compact - Fixed
/contextundercounting system tools in Code Mode before Claude's first reply - Fixed a stopped background subagent sometimes not staying stopped
- Fixed Claude still waiting for a background agent that was stopped just as it finished, in sessions run by an app or the SDK
- Fixed background sessions sometimes waking in their previous permission mode after approving a plan
- Remote Control: Fixed the note about background agents ended by a Stop from a phone or the web showing in the terminal as if you had typed it
- Remote Control: Fixed the mobile apps hiding the Diff and pull request buttons, or showing a stopped session as working, after turning it on mid-conversation
- Fixed environment variables written by a SessionStart hook being lost with
claude -p --continue - Fixed
claude -pexiting 0 with no message when its output went to a file on a full disk: it now prints an error and exits 1, though a full NFS export may go unnoticed - Fixed the system prompt keeping the earlier model's instructions when the model was changed after
/contextbut before the first message - Fixed Claude sometimes replying to its commit attribution reminder and ending the turn early after the model changed mid-turn; it can still happen where managed settings set the PR attribution line
- Fixed Esc not ending an LSP tool call that was waiting for a slow or stuck language server
- Fixed LSP tool calls and diagnostics failing when several calls or edits arrived while a language server was still starting
- Fixed
/mcplisting plugin servers as built-in: they now stand under "Plugin MCPs",--mcp-configand built-in servers under "Other MCPs", and a server's page names its plugin - Fixed an "MCP server blocked by enterprise policy: easel" warning showing at every start when an MCP allowlist or denylist excludes the built-in chart tool, which stays blocked
- Fixed
/statscounting new activity in UTC days instead of your local time zone - Fixed
/ultrareviewfailing or reviewing the wrong code after the shell moved into another repository: it now stops and names both folders - Fixed Grep reporting no matches when the pattern held a line break without multiline mode; it now reports the rejected pattern
- Fixed Jupyter notebooks saved with a byte order mark being reported as invalid JSON by the Read and NotebookEdit tools
- Fixed link reference definitions being dropped from CLAUDE.md and memory files that contain an HTML comment
- Fixed running Monitors keeping the earlier conversation in memory until they end
- Fixed some Claude Desktop sessions on third-party providers, other than scheduled tasks, ending a turn with "Prompt is too long" when a PDF larger than the context window followed a long conversation
- Fixed the choice between two user or project agent files declaring the same name depending on the order the file search listed them
- Fixed
claude daemon logsnever exiting inside a git repository when there is no log file - Fixed markdown hiding a character or two after bold or italic text when a backslash came before an emoji later in the paragraph
- Fixed Edit refusing some valid hook commands in Claude settings files
- Fixed
Readwith a page range showing both halves of a scanned two-page spread on each of its pages - Fixed line breaks and class stereotypes missing from Mermaid diagrams in HTML artifacts
- Fixed the Project instructions picker in
/configshowing only one of its four choices in a 24-row fullscreen window - Fixed a subagent's own subagents and forks running on the plan-mode model in plan mode under
opusplanorhaiku - Fixed WebFetch page summaries ignoring the
/effortlevel when a gateway refuses the small fast model - Fixed
claude -pon Google Cloud's Agent Platform ignoring--settings '{"fastMode":true}'when the model comes fromANTHROPIC_MODELor a settings file; such runs now bill at the fast mode price - Fixed startup under
forceLoginOrgUUIDbeing refused after one temporary server error or dropped connection - Fixed
claude mcp removegiving no way forward for a claude.ai connector: it now says to turn it off in /mcp or remove it on claude.ai - Fixed the /mcp "Connect on claude.ai" check saying "not connected" when claude.ai has a connector at the server's URL without its query
- Fixed
/install-github-appand/design-loginshowing a generic failure for an account on hold instead of the on-hold notice and appeal link - Fixed a running MCP task being reported as stopped when you move a session to the background; the background session can now follow the task, but not if its server uses stdio or sets headers
- Fixed self-hosted runners ignoring a session until they exited, after its failure report was lost or the session was given back to the same runner
- Fixed self-hosted sessions losing the prompt cache and earlier thinking when the list of repositories a restart couldn't prepare changed
- Self-hosted runner: Fixed tool calls behind a permission prompt vanishing with no result when a new runner took over the prompt, in sessions with telemetry off
- Fixed resumed self-hosted runner sessions starting without their pushed work in large repositories when
--push-outcome-on-releaseis set - Fixed self-hosted runner sessions being shown as working when Claude Code hangs at every start and
--startup-timeout-minis from 2 to about 6 - Fixed
pkill -fin self-hosted runner sessions on Linux ending its own shell with exit code 144, or the runner (needs apkillwith--ignore-ancestors) - Fixed scheduled tasks on self-hosted runners having no tool to notify their owner when telemetry is off or a third-party provider is used
- Self-hosted runner: Fixed one slow
spawn-runnerhook keeping the orchestrator from claiming sessions for its free slots; it now polls every 4 to 6 seconds while a slot is free - Self-hosted runner: Fixed a 403, such as an IP allowlist's, logged as a bad secret or token: most such lines now lead with the server's reason, so update log alerts that match the old words
- Fixed self-hosted runners' warn mode for repository settings stopping at the first finding of most kinds: it now goes on, up to 50 for a session, and says if it stops early
- Self-hosted runner: Fixed runners that start on a full disk taking sessions and failing them; they now wait for room and exit 1 after a minute with no session, unless started from a work order
- Self-hosted runner: Fixed a failed start suggesting a retry when the runner's machine had no git credentials; the error now says whom to ask and what to do if the repository is wrong
- Fixed the self-hosted runner's
last_poll_age_secondsreading 0 while the runner had never polled successfully - Fixed the notice about a skipped scheduled task that names no organization: it now says to start Claude Code with
--resume, because/resumeinside a running session doesn't run the task - Fixed
claude plugin validatewrongly warning that a mod'sAbovePromptorAbovePromptListhook never runs in VS Code - Fixed
/design-syncdeleting a file it had just uploaded when Claude Design stored that file under a changed name - Reverted 2.1.329's removal of the automatic retry when
max_tokensexceeds a model's or gateway's limit - Improved the claude.ai sign-in link shown by /login,
claude auth loginandclaude setup-token: it is now much shorter - Windows: Improved Grep and Glob speed by no longer starting a console host for each built-in ripgrep search on a local path
- Improved the speed of file diffs
- Improved
/configsearch: most settings whose name starts with what you type come first, "effort" finds Model, and "dark" or "light" finds Theme - Improved
/resume: sessions where you only opened a screen such as/modeland left are no longer listed - Improved Reconnect in
/mcpand/plugin: a server's page now stays open, with the cause in view, when the server still fails or needs sign-in - Improved the error on macOS when sandbox deny lists are too long: it now names the long lists and how to shorten them
- Improved
/pluginin fullscreen mode: the page of a plugin with errors now starts with those errors - Improved
/ultrareview's cost confirmation on Team and Enterprise plans: it now says how much of your monthly spend limit is left when that is less than a review usually costs - Improved self-hosted runner sessions on Amazon Bedrock or Google Cloud's Agent Platform to say so when they start on another default model because your account refused the first
- Windows: Improved the error when a session's folder is on a drive Claude Code can't verify: it says why, and whether retrying can help
- Improved Code Mode: Claude is now told how to look at images and PDFs
- Improved Code Mode: after Esc, "Interrupted" now shows under the stopped command in place of a red error
- Improved Code Mode: the terminal freezes for far less time after a subagent's script makes thousands of tool calls
- Changed recurring scheduled tasks and
/loopto run up to 30 days instead of 7 while their session keeps running, and say when they end; tasks made before this release still end at 7 days - Changed more
rmcommands aimed at the root, home, a top-level folder or the working folder to ask for approval; where nobody can answer, they're refused - Changed
deniedMcpServersname entries to hide only the named claude.ai connector, not others at its URL; to block them all, deny its exact URL - Changed
claude --teleportin some setups to print the git commands for switching branch instead of running them; with-pit exits 1 until you switch - Changed unrecognized model names containing "sonnet" or "haiku" to use the shorter system prompt, like other unrecognized names;
CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0gives every model the full one - Changed skills that Claude runs with a
modelsetting, other thancontext: forkskills, to leave subagents, forks, compaction and/recapon the session's model - Changed a subagent's model fallback to carry over: agents with no model and forks it then starts run on the fallback, and the agents they start use its Bedrock region
- Self-hosted runner: Changed
spawn-runnerhooks to start while earlier ones still run, up to--hook-concurrencyper orchestrator (4 by default); set it to 1 if yours can't run beside another - Self-hosted runner: Changed Bash commands to skip the file diff when nothing needs it, so transcripts can lack it; set
bashEditDiffEnabledto true in managed settings to get every diff - Changed self-hosted runners to stop a session's start at once, without trying other runners, when a checkout hook exits with status 108
- Changed prompt hooks to accept model aliases such as
haikuorsonnetin theirmodelfield - Changed
/design-sync's fallback build of the reference Storybook to use only a Storybook installed in the project - Changed subagent progress summaries in terminal sessions signed in to a Claude apps gateway to be written from short notes instead of the whole conversation, using far fewer tokens
- [VSCode] Added
/forkto fork a conversation after its last reply (anthropics/claude-code#69272) - [VSCode] Added
/workflows, which opens the agent map with running workflows - [VSCode] Added the
claudeCode.escapeStopsClaudesetting; turn it off so Escape does not stop Claude (anthropics/claude-code#91536) - [VSCode] Added the
claudeCode.pinPromptsetting to let your message scroll away instead of staying pinned - [VSCode] Added the
claudeCode.contextUsageThresholdsetting for when the context indicator shows (anthropics/claude-code#93036) - [VSCode] Added a
promptargument to the "Open in Side Bar" command for keybindings and extensions - [VSCode] Added Move up and Move down to a session group's menu (anthropics/claude-code#98654)
- [VSCode] Fixed VS Code opening and focusing its terminal on every prompt of a connected terminal session
- [VSCode] Fixed copying a code block adding a trailing newline that ran the command on paste (anthropics/claude-code#96976)
- [VSCode] Fixed holding Enter on
/rewindrestoring files, and a double click on Remove or Delete removing a memory, MCP server or plugin marketplace, without confirmation - [VSCode] Fixed Enter on a question card sending your earlier answer instead of picking the focused one, and arrow keys not working after an "Other" answer; answered questions reopen on your pick
- [VSCode] Fixed a held-down Enter key sending a half-written message or running a typed slash command
- [VSCode] Fixed Cmd+A, C, V, X and Z not working in the rename box and dialogs on macOS
- [VSCode] Fixed Ctrl+F and Ctrl+P not moving the caret in the message box on macOS
- [VSCode] Fixed the Accept and Reject buttons doing nothing on a proposed diff moved to a new window
- [VSCode] Fixed Accept and Reject Proposed Changes showing over the chat, the terminal tab and other files; they now show only on the proposed diff
- [VSCode] Fixed a slow-starting Claude tab taking the keyboard away from the file you had gone on typing in
- [VSCode] Fixed unsaved changes and new problems being missed on macOS and Linux for files whose path contains
#,?or%20, such as aC#folder - [VSCode] Fixed whole-line selections counting one line too many in the selection chip, in @-mentions and in what Claude is told, and file links leaving out the last line of a range
- [VSCode] Fixed a conversation forked in the panel re-running an old, unanswered prompt by itself after a window reload
- [VSCode] Fixed a forked conversation running the original conversation's
/loopschedules a second time - [VSCode] Fixed /clear giving no sign that the session still runs without a newly trusted folder's CLAUDE.md and settings
- [VSCode] Fixed dialogs closing, and losing typed text, when a text selection was dragged past their edge
- [VSCode] Fixed advisor calls showing as "Unsupported content type" (anthropics/claude-code#73499, anthropics/claude-code#64158, anthropics/claude-code#90471, anthropics/claude-code#73637)
- [VSCode] Fixed the session list showing no status for the sidebar chat's session (anthropics/claude-code#93898)
- [VSCode] Fixed the plan preview's Add Comment button vanishing after a fast double click on a word
- [VSCode] Fixed long lines cut off in the Edit Notebook Cell row, permission rules squeezed in a narrow panel, hard-to-see question card marks, and menus moving the chat after a declined trust prompt
- [VSCode] Fixed signing in to an account on hold showing a generic failure instead of the on-hold notice and appeal link
2.1.329
- Added a trust dialog warning that says where a folder's hooks are declared
- Added a warning in the conversation, in Claude Desktop and other non-interactive hosts, when hooks in managed settings fail to load
- Added this session's scheduled tasks,
/loopwakeups, the goal and this conversation's forks to/tasks; x stops one after asking - Added a "Server message" row to a server's page in
/mcpthat shows the JSON-RPC error message of a remote HTTP MCP server that refuses the connection - Added a "Marketplace auto-update" row to
/statusthat names managed marketplaces that get no automatic updates, and why - Added support for turning on Code Mode while OpenTelemetry events and metrics are enabled; each tool call the code makes sends its events; tracing still keeps it off
- Fixed
~/.claude.jsonsometimes being reset to defaults when a network stall or file lock made it unreadable and cleared during a save - Fixed repeated sign-outs on macOS when Claude Code could read the Keychain but not save to it. That session now stops at expiry and says why, and other sessions stay signed in
- Fixed
/terminal-setupcorrupting VS Code settings or keybindings files around block comments, and reporting success while losing the Shift+Enter binding where keybindings.json has an unclosed string - Fixed files accepted through the IDE diff being saved without their last newline, and losing their byte order mark (BOM) when an edit was accepted by saving the diff in VS Code
- Fixed picking a cloud session in
/teleportreplacing your open conversation: the pick now starts a new session, as/cleardoes, and/resumebrings the old one back - Fixed
/usage-creditsasking Pro and Max users to log in again after opening the browser, and the link disappearing after 8 seconds if the browser doesn't open and a task stops for usage credits - Fixed
/usagesaying usage credits are off when they had run out or reached the monthly limit, and/modelnot telling Pro and Max users when that limit blocks a model that runs on usage credits - Fixed the spend limit menu showing your spend as your monthly limit and wrapping its rows under the pointer in narrow windows
- Fixed a status line script that prints without end freezing the prompt and using gigabytes of memory
- Fixed an empty, frozen screen after approving managed settings while the --resume picker, the trust dialog or another set-up screen was waiting
- Fixed choosing Default in
/modelreplacing your saved model with your organization's default when the Default row already showed your saved model - Fixed an MCP server being signed in again after you cleared its authentication while a token refresh was running
- Fixed background MCP tasks that stalled after a slow reconnect: Claude Code now reconnects most HTTP MCP servers by itself when one is left on an older protocol version
- Fixed PDFs, images and
.docx,.xlsxor.pptxfiles that MCP servers or websites send asapplication/octet-streambeing saved as .bin, which kept Claude from reading the PDFs and images - Fixed
/code-review <pr number>sometimes reviewing the checked-out branch instead of the pull request without saying so: it now reads the pull request withgh pr diff, or says when it can't - Fixed
/code-reviewstopping at a permission prompt, on most models, to look for a~/.claude/CLAUDE.mdthat doesn't exist - Self-hosted runner: Fixed
--push-outcome-on-releasesometimes deleting a session's branch on the git host - Fixed Code Mode hiding a script's finished edits and the stopped command after Esc, and losing them on exit
- Fixed a runaway loop in Code Mode filling the machine's memory; it is now stopped at a limit
- Fixed a background agent running on when it was stopped while it was being resumed
- Fixed background shell commands using memory for the earlier conversation until they exit
- Fixed Remote Control using memory for the earlier conversation after a compaction or
/clearin sessions run by Claude Desktop, IDEs or the SDK - Fixed Stop not ending a request in Claude Desktop sessions on Bedrock while it waits on a hung AWS credential_process or sign-in call
- Fixed Claude sometimes failing to send you a file on its first try on Opus 4.8 and Opus 5
- Fixed Claude not being told that a connected MCP server's tools could not be loaded, and taking it for a server with no tools, in sessions with tool search
- Fixed
claude mcp loginand/mcpsaying a service doesn't accept sign-ins from Claude Code when the service's client registration had been retired (HTTP 410 Gone) - Fixed another case of claude.ai-synced plugin hooks failing with "Plugin directory does not exist" while a session was still running on macOS
- Fixed auto mode asking for manual approval to
rma symlink that points outside the working directory or at itself - Fixed
/sandboxon Linux listingallowUnixSocketsentries as allowed: they don't open those sockets there, and/sandboxnow says so - Fixed pressing Esc twice to clear a mistyped code ending the sign-in in
/install-github-app - Remote Control: Fixed sessions going back to their first effort level after a restart while the app still showed the level you picked (not yet for sessions that start in Ultracode)
- Fixed a removed plugin's MCP server staying connected in headless sessions after
reload_pluginsor when the account's plugin list drops it - Fixed the Claude Docs connector's tools going missing when a plugin or MCP server at the same address failed to connect, and its error wrongly suggesting
/login - Fixed a new skills, commands or agents folder being missed when
--add-dirnames the working directory or Claude Code starts in the home folder - Fixed sessions started from a pre-warmed process ignoring the
autoCompactWindowsetting in the project's.claude/settings.json - Fixed
CLAUDE_AUTOCOMPACT_PCT_OVERRIDEstaying in effect in a running session after it is removed from settings.json - Fixed the Agent tool's
effortparameter being ignored for named teammates in agent teams - Fixed
/auto-mode-setupignoring recent auto mode denials when it scans a project for rules to suggest; it may now offer allow rules from them, and you review each before it's saved - Fixed a false "Couldn't save this change" warning after adding a permission rule or directory in a subfolder or worktree whose own
.claude/settings.local.jsonis unreadable or malformed - Fixed cloud sessions telling Claude to run a network proxy check after a failed request, which auto mode then blocked
- Fixed headless rewind and fork going ahead while a message sent right after a model change still waited on it
- Fixed Claude not being told when a background task was stopped while a cloud session was restarting
- Fixed
/team-onboardingreporting a guide as shared on Team and Enterprise plans when the server refused the upload - Fixed panels and questions being cut off at the prompt in fullscreen,
/help, history search and the background tasks list losing rows or titles in short windows, and tables wrapping in dialogs - Fixed resumed sessions showing "Rejected" or "Declined" for edits, questions and plans that were cut off when the session ended
- Fixed
/passesshowing the wrong number of passes after a server error, and offering usage credits for sharing when no guest passes are left - Fixed
claude --helpoutput being cut short when piped to another program - Fixed
/terminal-setupturning on "Use Option as Meta key" in Terminal.app on macOS 27, and tips there suggesting Option+Enter instead of Shift+Enter - Self-hosted runner: Fixed setup failing on Git LFS repositories cloned through Anthropic-managed git; sessions now start on pointer files, and
git lfs pullfetches the content - Fixed sessions on self-hosted environments not starting from a git remote with an SSH host alias, GitHub SSH certificates or a GHE.com SSH user; an unresolved alias's error gives two git commands
- Fixed remote MCP servers in self-hosted runner sessions staying without tools, or (over https) disconnected, after a timeout or network error
- Fixed self-hosted runner sessions being shown as having stopped responding while Claude Code was still starting
- Fixed Code Mode keeping in memory every large text file that code read, and memory growing each time a background subagent was woken
- Fixed Code Mode stopping a script at its ten-minute limit while an MCP form, an MCP link prompt or a prompt that always asks was waiting for an answer
- Fixed Code Mode scripts receiving a "moved to the background" message as data from most MCP calls over two minutes: the script now waits up to ten minutes, then gets an error
- Fixed mods that list only some tools silently turning Code Mode off; such a mod no longer keeps it off, so use managed settings for that
- Fixed Code Mode ignoring an MCP tool's request to end the turn when the tool was called from a script that Claude waits for
- Fixed a Code Mode script's
let x;keeping the value that an earlier script gavex - Fixed a Code Mode script's call with no argument failing with a missing-parameter error on tools that need none
- Fixed Code Mode scripts losing access to tools through
toolsin sessions with more than 4,096 tools - Fixed the
/code-reviewfindings card often showing "high" for a review that ran at medium, on most models - Fixed key hints in permission prompts, questions,
/modeland/rewindignoringkeybindings.json - Fixed auto-scroll, the PR status badge, the auto-compact warning and the ultracode tag not following the
/configswitches that control them in a running session - Fixed a custom cancel key not working in
/add-dir,/tuifeedback and the save-workflow form - Fixed arrow keys in the save-workflow form moving the selection in the workflow view behind it
- Fixed
/configsaying nothing, or "dismissed", after changing many settings - Fixed Read and @-mentions showing one line too many for files that end in a newline
- Fixed
/statusnot naming the model that opusplan and haiku use in plan mode - Fixed
claude doctoradvising a Keychain unlock inside a macOS sandbox, where unlocking can't help - Fixed the "Jump to bottom" pill staying hidden after copying text and scrolling away, the row under it going blank when its label changed, and quick PageUp presses scrolling too far in fullscreen
- Fixed a screen update sometimes being skipped when memory is low
- Fixed long code blocks losing a blank line and repeating another in scrollback
- Fixed prompt suggestions sometimes showing placeholder text such as
_(no suggestion)_ - Fixed the line about earlier messages on resume blaming a damaged file when the file was intact
- Fixed characters disappearing from the prompt when its text held a color code that sets several styles and a keyword or command was highlighted
- Fixed
/renameandUserPromptSubmithook titles inclaude remote-controlsessions not showing on claude.ai and mobile - Fixed the Remote Control diff listing a file twice when the branch renamed it and it was then edited
- Improved the automatic clean-up of old sessions on computers with managed settings
- Improved
/tuiand other in-place restarts to wait briefly for a login refresh, so they are less likely to sign you out - Improved memory use in long sessions that edit many files, and in long Claude Desktop sessions on macOS and Linux with many large MCP tool results
- Windows: Improved start-up and the first search on PCs where Claude Code's search program starts slowly
- Improved auto mode's handling of a short reply such as "yes" to Claude's question when telemetry is off, behind a gateway to the Anthropic API, or on Microsoft Foundry
- Improved memory use of idle Claude Desktop and SDK sessions after a long turn, and after
--resumeor--continueof a session that holds screenshots or large tool results - Improved how fast a Claude Desktop Code session with Remote Control on is ready for the next message after an answer
- Improved cloud sessions to retry plugins that failed to download at startup
- Improved Code Mode: the terminal freezes for far less time after a script makes thousands of tool calls
- Improved Code Mode: after starting a subagent, Claude now gets the same guidance on waiting as outside Code Mode
- Updated computer use on macOS to newer safety rules, so some actions are refused and some apps have less access
- Changed saved scheduled tasks: in new signed-in sessions, most saved by earlier versions need scheduling again, though
--resumeof their own session still runs them - Changed
/code-reviewwith no target on most models to review the whole branch against the default branch, and fixed it losing the diff on multi-commit branches - Changed auto mode to run
git statusless often so most requests wait less in large repositories; a git command that discards changes may be blocked until the working tree is checked - Changed
/code-review <pr number> --fix, and/code-reviewgiven a pull request URL, to stop without reviewing whengh pr diffis refused or fails - Changed 'Exit and stop tasks' to end this session's scheduled tasks so they don't run again on resume, unless you exit while Claude is responding
- Changed some teammate panes to start through /bin/sh, so they may not read shell start-up files
- Changed computer use on macOS to give up on an app launch that has not finished after 30 seconds
- Gateway: Changed the start-up warning shown while
access_control.allow_cidrsis empty to a notice at every start, boxed in text logs: never expose the gateway to the public internet - Self-hosted runner: Changed a second host name's clone of the same owner/name to go under
_repos/clones/<host>/in the base folder; no clone moves - Self-hosted runner: Changed repositories with unusual characters in their address path to clone anew in a new folder; rules and volumes naming the old one stop applying, and the old clone stays put
- Self-hosted runner: Changed
--repository-folderto take most folders in the base folder at--capacity 1(above 1, one there stops start-up); another repository's session overlapping one is refused - Changed Code Mode so a PreToolUse hook that errors no longer refuses a script's tool call, as outside Code Mode; set
"onFailure": "block"on a command, HTTP or MCP tool hook that must refuse - Changed Code Mode to refuse a script's read of a line range over 256 MiB, which could use gigabytes of memory, and fixed reads of very long lines timing out
- Changed Code Mode to also start when telemetry, nonessential traffic or feature flags are turned off; an administrator can keep it off in managed settings
- Changed Code Mode to run a script that declares its own
log,previeworsleep, which it used to refuse - Changed macOS login renewal to test the Keychain with a
Claude Code-write-checkitem - Changed the
/tasksheader and the footer's background count to one number covering shells, monitors, MCP calls, agents, workflows and scheduled tasks - Changed Stop and SubagentStop hooks to list a Monitor's script as
monitor, notshell, inbackground_tasks - Removed 2.1.326's automatic retry at the limit named in a
max_tokenserror; behind a gateway whose model takes fewer output tokens, setCLAUDE_CODE_MAX_OUTPUT_TOKENSto that limit - [VSCode] Added a line above the message box after you decline the trust prompt, with Review trust to bring the prompt back without reloading the window
- [VSCode] Fixed being signed out of Claude Code in every window and terminal when the sign-in server took 10 to 30 seconds to answer the extension's token refresh
- [VSCode] Fixed keys pressed while an input method (IME) is composing moving focus on or declining a permission prompt, running menu rows and closing dialogs (anthropics/claude-code#106358)
- [VSCode] Fixed the permission prompt for Bash, Edit, Write and other built-in tools not showing why a safety check asks
- [VSCode] Fixed a half-written plan comment being lost or moved to another passage, and an input method's Enter sending the comment, ending a session rename or picking an @-mentioned file
- [VSCode] Fixed the limit banner not saying when usage credits are in use, and the session survey covering that banner and the usage credits card
- [VSCode] Fixed screen readers not announcing a permission request that arrived while the Account & Usage dialog was open until that dialog was closed
- [VSCode] Fixed a proposed-edit diff tab staying open, with an Accept button that did nothing, after its terminal Claude Code session disconnected
- [VSCode] Fixed short tool inputs and outputs cut off at the panel's edge with no way to read the rest (they now open in an editor tab), and dragging to select text also opening one
- [VSCode] Fixed the Up key putting an earlier message over text that an input method (IME) is composing in the message box (anthropics/claude-code#101294)
- [VSCode] Fixed dropping an Explorer folder onto the chat inserting nothing on VS Code 1.103 to 1.139 or in a floating chat window, and the drop highlight vanishing with a false "Hold Shift" hint
- [VSCode] Fixed a permission prompt moving keyboard focus away from the details you were scrolling as its buttons switched on
- [VSCode] Fixed file links in a Claude tab opening in another editor group when
claudeCode.lockEditorGroupsis off (anthropics/claude-code#108884) - [VSCode] Fixed ranges written with a single tilde (
3~5 … 7~10) losing their tildes and showing struck-through text between them; only~~text~~is struck through now - [VSCode] Fixed dictation errors wrapping into a narrow column, the spinner turning while a question card waits, and a NUL symbol after each letter in the output of a failed UTF-16 command
- [VSCode] Changed Down to stop at the last item of a permission prompt instead of wrapping to Yes
- [VSCode] Changed command output to show hidden characters and control sequences other than plain colors as symbols, so Persian, Khmer, Lao, Sinhala and Malayalam text can look broken or out of order
2.1.328
- Added auto mode for Claude Opus 4.6 and Sonnet 4.6 on Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry and Claude apps gateway; interactive sessions with no permission mode start in it
- Added
"onFailure": "block"formcp_toolhooks, as for command and HTTP hooks: a hook whose call fails blocks the action - Added a warning when a message from a session that skips permission prompts may be held and dropped by a cloud session
- Added a notice in
/statusandclaude doctorwhen an OpenTelemetry exporter has no endpoint and its data would likely be lost - Added
CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME, which lets a host stopclaude -p --resumeand--continuefrom running a tool call that a hook deferred - Added support for apps that embed Claude Code to switch on the policy plugin's
allowManagedModsOnlyoption; an admin's managed settings still win - Added a startup warning to the Claude apps gateway when a policy's
maxEffortLevelis not a valid effort level - Self-hosted runner: Added
--repository-folderto name the folder that sessions use for a repository at--capacity 1, in place of its path under the base folder, which can't be a symbolic link - Self-hosted runner: Added a start-up warning when the host's settings.json sets a default permission mode that sessions ignore
- Self-hosted runner: Added
--hook-labeltoclaude self-hosted-runner orchestrator, to hand chosen session labels to thespawn-runnerhook - Self-hosted runner: Added
--metadata key=valuetoclaude --environment, to label a session for thespawn-runnerhook - Self-hosted runner: Added
claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_secondsto the orchestrator's/metrics, so a re-opened session's wait can be told from a new one's - Self-hosted runner: Added an orchestrator metric,
claude_code_self_hosted_orchestrator_sessions_given_up_total, that counts by cause how often Anthropic gave up starting a runner for a session - Fixed Bash commands in zsh stopping with a "not found" error at a word that starts with
=, such asecho ====or[ a == b ];=cmdno longer expands to a command's path - Fixed automatic compaction reusing the session's earlier system prompt instead of rebuilding it the way
/compactdoes - Fixed markdown rendering freezing on some very long or malformed input
- Fixed rare screen freezes
- Fixed Esc often being lost at a permission prompt or question when you typed straight after it; in terminals that send Alt as Esc and a key, an unused Alt or Option key now declines there
- Fixed a paste or a terminal's reply being typed into the prompt when a slow connection cut it in two
- Fixed saving a scheduled task erasing the project's other saved tasks when the scheduled tasks file can't be read, on third-party providers or with telemetry or feature flags turned off
- Fixed a scheduled task with a typo in the project's scheduled tasks file being deleted the next time that file was saved
- Fixed a case where a resumed cloud session could lose its compaction summary or recent messages when a message was saved late
- Fixed the token counts on the spinner and for subagents counting a retried reply twice, missing replies that were not streamed, and standing still while Claude thinks
- Fixed the error shown when usage credits run out mid-response, which named a rate limit
- Fixed auto mode failing every turn outside Claude Desktop with
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASset behind a gateway rejecting betas, on Bedrock, Agent Platform, Foundry or Claude apps gateway - Fixed
CLAUDE_STREAM_IDLE_TIMEOUT_MSnot lengthening the 5-minute connection limit on gateways, custom base URLs and cloud providers - Fixed some Claude Desktop sessions on third-party providers, other than scheduled tasks, ending for good with "Prompt is too long" after large tool results; the largest are now left out
- Fixed MCP tools whose input schema starts with
anyOf,oneOforallOfgoing missing on third-party providers or with telemetry or feature flags turned off - Fixed an MCP tool with an invalid input schema failing requests on third-party providers or with telemetry or feature flags turned off; the tool is now left out and Claude is told why
- Fixed effort being turned off for a subagent's model for the session if Bedrock, Google Cloud's Agent Platform or Foundry refused its progress summary's effort setting (regression in 2.1.327)
- Fixed Code Mode stopping a script when a permission prompt outside auto or bypass mode, a plan approval or a question stayed open for ten minutes
- Fixed Code Mode scripts in auto and bypass-permissions modes failing to call an MCP server that had connected while the previous script was running
- Fixed Code Mode scripts not running in the background in auto or bypass permissions mode in a session chosen in the
claude --resumepicker - Fixed Code Mode losing a loaded skill, hook context or a note typed with a permission approval when resuming a session in which one reply ran several scripts
- Fixed Claude not being told that a Code Mode script was cut off when the session was resumed from the picker or in a mode that asks for permission
- Fixed Code Mode silently using
undefinedfor top-level variables that an earlier failed script never set - Fixed Code Mode scripts not being told when a failing command's long output was cut
- Fixed Code Mode refusing valid scripts that start with a
{block - Fixed Code Mode refusing scripts that use both a top-level
awaitand a top-levelreturn - Fixed an @-mentioned small file not being attached in Code Mode after a script had read or written it
- Fixed Code Mode offering
write()andedit()to read-only subagents that can't call them - Fixed Claude starting a turn by itself in Code Mode when Esc was followed by a command such as
/model - Fixed Claude in Code Mode not being told to run workflows only when you ask, or the workflow size you set in
/config - Fixed Remote Control repeating the same disconnect message, and telling you to retry a session that can't reconnect
- Fixed a waiting permission prompt being lost, and its answer ignored, when a remote session restarted while the service was slow
- Fixed cloud sessions resuming a cleared conversation after a rewind followed by
/clear - Fixed a remote session losing a turn's tool calls and results when its runner or worker was lost after a dropped model stream had been retried
- Fixed cloud and Remote Control sessions that just started, or have an @ in their title, being unreachable in cross-session messaging from a session with Remote Control on
- Fixed Claude being told that cloud sessions can never reply; it now learns when a reply can come and how else to get the result
- Fixed
/diff, the Changes pane of Remote Control sessions and the diff beside an edit leaving out committed work after a command moved into another repository - Fixed Remote Control not showing a running workflow's agents when a session run by an IDE extension or other SDK app is opened over an hour after the workflow last made progress
- Remote Control: Fixed an idle Desktop or VS Code session showing as running after Remote Control is turned on
- Fixed the model saying background agents were still running after an SDK interrupt had stopped them
- Fixed Send now in the desktop app and SDK hosts telling Claude that a stopped web search found no results
- Fixed Cmd+letter being typed into the prompt in terminals that report Cmd
- Fixed Ctrl+click opening a link twice in GNOME Terminal, side mouse buttons acting as clicks, and the first wheel notch in the other direction being ignored after a pause, in fullscreen mode
- Fixed Shift+Enter in Konsole outside tmux and ssh, and Alt shortcuts on non-Latin keyboard layouts in terminals that speak the kitty keyboard protocol
- Linux: Fixed pasting in other apps freezing while Claude Code is suspended with Ctrl+Z, when
xcliporwl-copyis installed - Linux: Fixed Ctrl+V missing the clipboard image, pasting an old one or hanging
- Fixed text copied in fullscreen mode including the quote bar, losing spaces at line wraps when a drag scrolled upward, or missing words under the "Jump to bottom" pill
- Fixed an image path pasted into a
!command becoming an attachment - Fixed Ctrl+C showing no exit warning while the
?shortcuts list is open - Fixed Ctrl+R search in fullscreen mode and the
/themecolor editor picking the wrong row when keys arrive together, and keys being dropped there and in the search of/configand/plugin - Fixed wrong or missing colors inside GNU screen
- Fixed many background notifications cutting into the top border of open dialogs in fullscreen mode
- Fixed a message to a background agent showing a long file path in place of a pasted image
- Fixed
/goalremoving a skill's Stop hook, or ending early on another hook's result, when both had the same wording - Fixed
/bugsaying cancelled after the report was sent - Fixed Esc not dismissing the transcript share question for Pro and Max users
- Fixed
/hookslosing your place when going back - Fixed
/exportwriting a file named.txtwhen the name was left empty - Fixed
/terminal-setupin Zed replacing a symlinkedkeymap.jsonwith a plain file - Fixed
/install-github-appadding a code review workflow when asked to update the existing workflow file - Fixed
/pluginreopening a skill, or closing the open page, when a slow save or removal finished after you went back - Fixed
/pluginasking to uninstall the wrong plugin, or ignoring Esc, after leaving a plugin while a change was still running - Fixed typing and arrow keys not working on the
/pluginInstalled tab after a search with no results or a click on the tab row - Fixed holding Enter in
/pluginturning off several installed plugins - Fixed the
/usageplugin total stopping at 2,000 tokens on 1M context models, and low token estimates in/usageand/pluginwhen no model is picked - Fixed Esc on the Bedrock access keys step closing
/logininstead of going back - Fixed
/exitand Ctrl+D describing running work differently, and/exitwarning about a workflow that had stopped - Fixed Claude calling an artifact private after reading one in a shared folder or publishing to another organization's, and saying only named people can open one when its folder's people can too
- Fixed a plugin's toast sometimes showing another plugin's text
- Fixed a mod saved just after a turn began sometimes reloading mid-turn instead of at the turn's end
- Fixed one malformed
OTEL_RESOURCE_ATTRIBUTESentry dropping the variable's other labels from metric points, events, and spans. Now only that entry is left off - Fixed agent hooks running past their timeout while compacting after a request was refused as too large
- Fixed a crash at startup when
FORCE_COLORis set to a negative number - Fixed a crash in secret masking when the machine is almost out of memory
- Fixed the Bash sandbox on Linux renaming
.git/HEADafter each command when the branch name is not valid UTF-8 - Self-hosted runner: Fixed all running sessions being stopped when a proxy or web filter answered a poll with HTTP 200 and a body such as
{}; the runner now retries such a poll - Self-hosted runner: Fixed deletion of a kept clone's objects or refs, and of commits that existed only there, after a temporary disk error; that start now fails instead
- Fixed self-hosted runners stopping when their token ran out on a host whose clock is slow or was set back
- Self-hosted runner: Fixed sessions with Anthropic-managed git losing git access to GitHub after a script or hook in the session ran
claudeagain - Fixed self-hosted runners with Anthropic-managed git being unable to fetch or push where the machine's git config sets
http.proactiveAuth - Self-hosted runner: Fixed a runner that exited without telling the server when setup failed after it had registered; it now deregisters with a reason, and an on-demand runner reports the failed start
- Self-hosted runner: Fixed archiving or requeueing a session not taking effect while it waited for another session to prepare the same repository (
--capacityabove 1) - Self-hosted runner: Fixed a session with a damaged
.claude.jsonfailing every later start under--trust-workspace false; it now starts on defaults, with MCP servers turned off there on again - Self-hosted runner: Fixed a failed start's message losing the words that say what failed when a checkout hook or git printed a lot
- Fixed the self-hosted runner skipping its post-session hook when a disk stalled for a few seconds; on a dead disk a session's end can take 25 seconds longer by default
- Fixed self-hosted runners: a session that resumes in a new Claude config directory no longer loses its task list
- Fixed Claude not being told when a self-hosted session starts without one of its repositories, and why
- Self-hosted runner: Fixed
--correlation-idofclaude --environmentnot reaching thespawn-runnerhook - Fixed the self-hosted runner setup wizard's key rotation advice, which now warns that revoking a key stops the sessions running under it
- Improved
claude -pand SDK sessions to fetch managed-settings plugins that have their own git repository, in the background, for a later session - Improved how soon managed-settings plugins from a git marketplace load on a fresh machine in
claude -p, SDK and Claude Desktop sessions; a short run may exit up to 30 seconds later - Improved the time to resume large sessions
- Improved memory use when resuming a session with many images
- Improved memory use and response time in long SDK and desktop sessions that run slow commands or tools
- Improved Code Mode's speed in auto and bypass-permissions modes by removing a 0.75 second pause after most scripts
- Improved prompt caching for new Code Mode sessions that have MCP servers, and Claude is now told when a server is still connecting and when the list of servers changes
- Improved Code Mode's token use with shorter tool descriptions
- Improved Code Mode to show the command a script is running, and its output, while it runs
- Improved Code Mode edits: an edit that changes nothing no longer stops a script, and Claude is told where a failed edit matches or comes closest
- Improved Code Mode: Claude is now told which tool calls were still running when a script failed
- Improved how Claude starts dev servers in Code Mode's auto and bypass modes: Claude is told to run them as background tasks that show in
/tasks - Windows: Improved Code Mode by telling Claude that scripts' shell commands run in Git Bash and that PowerShell aliases run instead of functions with the same name
- Improved starting several in-process teammates at once: far fewer now fail with "Lock file is already being held"
- Improved the computer use approval dialog: it now shows each app's level of access and plainer warnings
- Improved cross-session messaging: Claude now explains that Remote Control is off when a cloud session or another computer is not listed
- Improved
claude -ptext output to say on stderr when a message from another session is held or dropped, and how to allow it - Improved Claude's answers on who can open an artifact it published: Claude is now told to check the artifact again instead of repeating the last publish's answer
- Improved resumed self-hosted runner sessions: Claude now checks whether its earlier work is still there, and says what is missing
- Changed plan mode and Bash prompts for Opus 4.6 and Sonnet 4.6 on third-party providers to use and offer auto mode, as on newer models;
disableAutoModeturns both off - Changed Code Mode to no longer run UserPromptSubmit hooks, managed ones included, on scripts' output; to redact that output, use a PostToolUse hook with
updatedToolOutput - Changed
/code-reviewon most models to report only bugs and CLAUDE.md violations; run/simplifyfor reuse, simplification and efficiency cleanups - Changed
/code-reviewto mark each finding Important, Pre-existing or Nit on most models, and to end each summary with a suggested fix; a clean review's list now reads "Code review found no issues." - Changed
deniedMcpServersentries of the formclaude.ai <name>to apply to that connector in cloud and self-hosted runner sessions too - Changed managed
PostToolUsehooks to no longer fire for calls refused before they ran: no log entry, rewrite, block or stop there;PostToolBatchgets most, not marked as refused - Changed
/bugto ask Yes or No before sending, so repeated Enters no longer send a report or open GitHub - Changed subagents in
claude -p, the Agent SDK, desktop and VS Code to wait for their own subagents by default whenCLAUDE_CODE_FORK_SUBAGENT=0is set - Changed
claude -pwithCLAUDE_CODE_FORK_SUBAGENT=0to count a background subagent and those it waits for against one 10-minute wait; raiseCLAUDE_CODE_PRINT_BG_WAIT_CEILING_MSfor longer chains - Changed a shell command rewritten by a PermissionRequest hook to a sandbox-excluded command to run outside the sandbox
- Changed the Claude in Chrome welcome screen and
/chrometo say that Claude Code asks before Claude acts on a site, unless your permission mode or a rule in/permissionsanswers - Changed Claude Desktop and Agent SDK sessions on third-party providers or with telemetry or feature flags off to end the turn when closed with a question open, instead of continuing without an answer
- Changed pasted text to be marked for Claude as pasted, on third-party providers or with telemetry or feature flags turned off
- Changed subagent progress summaries in terminal sessions on the Anthropic API to be written by the default small fast model from short notes, also with telemetry off, using far fewer tokens
- Changed how a sandbox that can't start is reported, unless
sandbox.failIfUnavailableis set: the next sandboxed Bash command is refused and says that the sandbox is off for the session - Changed
/list-agentsto show its list to you alone; Claude lists sessions itself when needed - Self-hosted runner: Changed the built-in
gh apito be off by default where settings guard Claude's GitHub tools by name;--use-anthropic-gh trueturns it on - Self-hosted runner: Changed a
claudethat a wrapper script runs before the session's ownclaudeis up, or after it has ended, to have no Anthropic-managed git - Self-hosted runner: Changed
CLAUDE_RUNNER_SESSION_UUIDandCLAUDE_CODE_REMOTE_SESSION_UUIDto both be set for the session and itscheckout,post-sessionandspawn-runnerhooks - Changed self-hosted runners at
--capacity 1to refuse a session earlier when the path of a repository it pushes to is a symbolic link - [VSCode] Added a notice when a message from another session is held, with a link to the settings file that can allow it
- [VSCode] Fixed the permission prompt cutting off its No button, reply field or title when the panel is low or a command, URL or description is long
- [VSCode] Fixed failed or blocked tool calls showing no reason or a reason cut short, and Glob and Grep counting an error as results
下载平台
| 平台 | 文件 |
|---|---|
| macOS Apple Silicon | claude-darwin-arm64 |
| macOS Intel | claude-darwin-x64 |
| Linux arm64 (glibc) | claude-linux-arm64 |
| Linux x64 (glibc) | claude-linux-x64 |
| Linux arm64 (musl) | claude-linux-arm64-musl |
| Linux x64 (musl) | claude-linux-x64-musl |
| Windows x64 | claude-win32-x64.exe |
SHA256 Checksums
f7c5093b9dd6560d08af28bc27b123fb55091deae3180ac39df199522da86815 claude-darwin-arm64
bbed99bb8a39bb3f94389c5c99d3d02cb75f3f983b5d1bc40b1b0d1efca84713 claude-darwin-x64
6016f90cac783e367fb1aa97c768a2efb94a0128a5b46b70fb3d8fcbbd9dd444 claude-linux-arm64
f390eaa0814e6a1bff74cbb47acb74cb9c89d30ced809fe0af5af00c7bfe8ebb claude-linux-x64
986b83557cbd428273c37f35fc08a44fc786077deeb391660884833bc581348a claude-linux-arm64-musl
510d57bbf077b49288b9f3b53b11324048f4c2da5dcb980563be82534980d621 claude-linux-x64-musl
fa797c1bc7d4a3511da42622bae53a2b7f1276ae328c668f2bfef44635301caa claude-win32-x64.exe
782519c6241a2bedfd4c0d225d59d5095b895037ae7cd2a14a12f5bc5dcba1c3 claude.exe
此版本自动从官方 GCS 存储桶同步