v2.1.3292026-11-19
本次更新围绕可靠性与细节修复展开。新增功能方面:信任对话框会标明文件夹钩子的声明位置;托管设置中的钩子加载失败时,非交互环境会给出警告;/tasks 现在汇总本会话的定时任务、/loop 唤醒、目标与会话分叉,按 x 可逐个停止;/mcp 服务器页面新增「Server message」行,展示远程 HTTP MCP 服务器拒绝连接时的 JSON-RPC 错误;/status 新增「Marketplace auto-update」行,说明哪些托管市场不会自动更新及原因;Code Mode 可与 OpenTelemetry 事件和指标同时开启。
修复较多,挑重点说:~/.claude.json 在网络卡顿或文件锁导致读取失败时被误清为默认值的问题已解决;macOS 上因钥匙串只读导致的反复登出改为会话到期后停止并说明原因;/terminal-setup 不再损坏 VS Code 配置文件;IDE diff 接受的文件不再丢失末尾换行和 BOM;/teleport 选择云端会话改为新开会话,不再覆盖当前对话;/usage-credits 与 /usage 的登录与额度提示更准确;/code-review 会用 gh pr diff 读取指定 PR,无法读取时明确说明;Code Mode 的失控循环现会被限制终止,内存占用问题也一并修复。
v2.1.3282026-11-19
Claude Code 本次更新围绕自动模式、钩子机制与自托管运行器展开。Claude Opus 4.6 和 Sonnet 4.6 在 Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 及 Claude 应用网关上新增自动模式,未指定权限模式的交互会话将默认启用。mcptool 钩子新增 "onFailure": "block" 选项,调用失败时会阻止操作,与命令和 HTTP 钩子行为一致。新增环境变量 CLAUDECODEDISABLEDEFERREDTOOLRESUME,宿主可借此阻止 claude -p --resume 和 --continue 执行被钩子延迟的工具调用。
自托管运行器新增 --repository-folder、--hook-label、--metadata 等参数,并在 /metrics 中补充会话排队等待与启动失败的统计指标。
修复方面,解决了 zsh 下以 = 开头的 Bash 命令报「not found」、自动压缩复用旧系统提示词、markdown 渲染卡死、Esc 键在权限提示中丢失、粘贴内容被截断后误输入、定时任务文件读取失败导致其他任务被清空、token 计数重复统计重试回复、额度耗尽时误报速率限制,以及部分网关下自动模式每轮失败等问题。
v2.1.3272026-11-17
Claude Code 本次更新集中在会话可靠性与权限细节上。会话恢复方面修复了多处消息丢失或回退的问题:进程被杀后重发同 UUID 消息、空回复或命令被杀后恢复、重启期间 Stop 后的远程消息、/clear 后任务丢失与回潮,以及输出 token 截断后立即压缩导致工具调用丢失。权限与配置方面,/install-github-app 改动仓库前会先确认;claude mcp add-json <name> - 支持从 stdin 读取服务器 JSON,令牌不必出现在命令行;/export 覆盖已有文件前会询问;/status 会列出损坏的 agent、skill、命令与输出样式文件、快捷键错误、失效沙箱等;/config 会提示被其他设置覆盖的行。另修复了 claude mcp add/remove 项目作用域误删 .mcp.json 其他顶层键、auto 模式忽略带 .\ 的 PowerShell 通配规则、--disallowedTools 括号规则失效、嵌套 claude 被 forceLoginOrgUUID 拒绝等问题。/tui classic 成为非全屏渲染器的新名称,/tui default 仍可用。
v2.1.3262026-11-16
这版更新集中在两块:一是补齐了一批提示信息,二是修掉不少会让人困惑或出错的毛病。
新增方面,Code Mode 现在可以和 agent teams 同时开启,已开启的用户在带团队的会话中会直接进入 Code Mode。启动时若 --allowedTools、--disallowedTools 或 --tools 里有不完整的规则条目,会给出警告;/status 新增一行,显示是服务商还是环境变量(如 DISABLETELEMETRY)关闭了某些功能;/plugin 与 claude plugin list 会提示被忽略的 plugin.json 字段;Ctrl+O 可查看被隐藏的启动提示,子代理视图里也补上了 esc to stop 提示。OpenTelemetry 资源属性新增 OTELRESOURCEINCLUDEHOST,默认关闭。
修复方面,几处值得留意:后台会话在崩溃或换目录重开后可能丢失 shell 导出的 LLM 网关,现在会在发起模型请求前直接停止;后台服务曾误杀被复用进程号的用户进程(如 SSH 登录);设置文件写入失败时,/permissions 与 /add-dir 的改动不再假装已保存,终端会警告并指明文件;嵌套数千层的设置值会导致崩溃或只部分生效,超过 64 层将被丢弃并告警。此外还修了 Bash 权限提示的误导性警告、MCP headersHelper 失败波及其他会话、Linux 下沙箱命令残留占位文件、以及若干交互细节(如文件夹信任提示误答 Yes、启动时输入被吞等)。
v2.1.3252026-11-13
Claude Code 这版更新以修复为主。安全方面,修复了 zstd 压缩响应解码中的漏洞。交互体验上,VS Code 等集成终端在读取或编辑过 Jupyter notebook 后会提示重跑单元格;组织策略拦截请求时,报错下方新增了 /rewind 或 /clear 的出路提示;/security-review 等命令在裸仓库 worktree 中报错的问题也已修复。模型相关修复较多:opusplan 或 haiku 模式下子代理不再被错误切换模型,sonnet[1m] 设置重装后不会被改写成 API 拒绝的 id。此外还修了会话恢复丢轮次、工作目录删除后命令报错、/stats 活跃天数多算一天、/voice 提示不准确等一批细节问题。
v2.1.3232026-11-12
What's changed
- Added Code Mode, an experimental opt-in in which Claude writes JavaScript to call its tools; see https://code.claude.com/docs/en/code-mode to turn it on, or to turn it off for an organization
- Added engines["claude-code"] to plugin.json: plugins outside their stated Claude Code version range are not installed, updated or loaded, and install and update pick the newest version that fits
- Added type checking of a plugin's TypeScript hooks module to claude plugin validate; each finding is a warning, and --strict fails on it
- Added to claude plugin validate the $ nouns a mod's engine.create hook adds, withholds or replaces
- Added support for CLAUDECODEAUTOMODEMODEL in managed settings for Claude Desktop sessions on third-party providers (takes effect once Claude Desktop includes this version)
- Added an options menu (stop, switch to usage credits, upgrade) when a model needs usage credits that are turned off or used up
- Added a progress heartbeat every 30 seconds while hooks run long in claude -p and SDK sessions, so a host such as Claude Desktop won't end the turn as hung (once it includes this version)
- Added .docx support to Artifact tool asset uploads
- Added a /diff to close hint to the diff panel, and the keys that focus and close a panel to the ? shortcut guide
- Added a start-up warning for Bash allow rules with a ` in a variable's value, such as Bash(PORT= npm run dev)
- Added a warning when a plugin's language server can't start, naming the server and what to check
- Added a one-time startup notice naming CLAUDECODEPERFORCE_MODE when Perforce settings are found and the mode is off
- Added CLAUDECODEDISABLEAGENTPROGRESS_SUMMARIES (available since 2.1.318): set it to 1 to turn off subagent progress summaries and the requests that write them (anthropics/claude-code#86879)
- Added CLAUDECODERESUMEHINTCOMMAND, which a program that starts Claude Code can set to have the exit hint name its own resume command
- Added unsetOptionCount to the claude plugin install --json result: how many userConfig options are not yet set
- Added isPromptCovered to the props a mod's pane is drawn with, telling it when a dialog or a field above the prompt covers the prompt
- Fixed running /compact again, or after a command such as /context, summarizing away a message that Claude had not answered yet
- Fixed a resumed session joining your next message to an old interrupted message that was not resumed
- Fixed a memory spike at the next prompt after Claude changed a very large file
- Fixed a setting saved in a running session undoing a hand edit made to settings.json moments earlier; a settings file you delete during a session now stays deleted
- Fixed claude plugin commands and claude mcp list signing you out of a Console profile when they ended while the token was being renewed
- Fixed Edit and Bash running out of memory on certain /proc files, and Edit hanging or running out of memory on devices and named pipes
- Fixed Claude Code failing to start, or to clear stored credentials at sign-out, when saving its configuration file failed with "Out of memory"
- Fixed requests sent without streaming failing on errors that streamed requests recover from, such as a rejected image, thinking block or beta header
- Fixed ExitWorktree, the worktree exit dialog and /resume leaving the session in the wrong folder when the folder the shell was in before entering the worktree had been deleted
- Fixed accents and other combining marks sometimes landing left of the text, leaving stale copies on screen, or silently disappearing when text wraps
- Fixed the last key of a key chord, such as Enter in ctrl+x enter, acting on a dialog's text field when the chord's own action isn't available there
- Fixed ps processes piling up when the process listing Claude Code runs before stopping a command takes too long
- Fixed subagent transcripts and large tool results being saved apart from the session's transcript after entering a worktree created by a WorktreeCreate hook or belonging to a nested repository
- Fixed a session on a named Anthropic profile moving to another sign-in when /fork, the Left arrow or --bg continued it in the background; reopen any session that was open during the update
- Fixed a background session sending a conversation under another sign-in when its named Anthropic profile is missing, changed or overridden; it now stops and says so
- Fixed a session on an API key, auth token or workload identity from its shell (not a setup token) moving to another sign-in in the background; it now stops and says so
- Fixed MCP tool calls ending in the sign-in server's error, such as TOKEN_EXPIRED, instead of asking you to sign in again
- Fixed an expired claude.ai login showing "Credit balance too low" when a saved Console key or ant auth login profile without credit was used instead
- Fixed a session on a named Anthropic profile being handed to an older background service that could not keep its sign-in; it now says to restart the service
- Fixed a background session's sign-in leaving the previous account's login or other credentials in place; it now clears them for every session on the computer, and a refused sign-in can leave no login
- Fixed background sessions moving between a profile and the stored login when an update restarted them
- Fixed sessions opened before a sign-in keeping signed-out feature flags after the sign-in
- Fixed sessions that kept failing after a Claude apps gateway sign-in expired: once you sign in again with /login in another terminal, they carry on at the next message
- Fixed the billing notice naming your ant auth login organization when a custom X-Api-Key header is set
- macOS: Fixed "Not logged in · Please run /login" coming back right after a successful /login or a token refresh when the keychain was slow to answer
- Fixed turns failing in Claude Desktop when an organization's gateway answers an expired token with 403: Claude Code now asks Desktop for a fresh token and retries
- Fixed the error shown when Amazon Bedrock refuses your account a model: it no longer says to refresh your AWS credentials, it says to enable the model
- Fixed the awsAuthRefresh or gcpAuthRefresh command sometimes running twice for one request when three or more sessions needed a fresh sign-in at once
- Fixed the claude -p warning about an ended claude.ai login to say that claude auth logout also removes saved MCP server logins and plugin secrets
- Fixed Bash permission prompts offering "don't ask again" for commands that write to sensitive paths such as .git or .claude, where the saved rule did not stop the next prompt
- Fixed a case where some lsof commands ran without a permission prompt
- Fixed Bash commands that write a file with cat > file <<EOF being shown as "Read 1 file"
- Fixed a case where Bash permission checks judged an rm from the wrong folder and skipped the dangerous-removal prompt under bypass permissions or a Bash allow rule
- Fixed --permission-mode auto or a settings defaultMode: auto starting in a mode that could allow more when auto mode was unavailable. It now starts in Manual mode, which asks first
- Fixed plan files sometimes being written outside the project when plansDirectory is set; a write that can't be shown to stay inside the project is now refused
- Fixed a permission prompt when Claude read the output of its own background command or agent after entering a worktree
- Fixed a case where Bash permission checks missed part of a command
- Fixed a case where the Bash sandbox could switch off during a session
- Fixed Bash allow rules with an attached wildcard, such as Bash(ls), skipping the permission prompt in some cases; a rule that names a variable, such as Bash(NODEENV*), now asks
- Fixed auto mode running behind a gateway at ANTHROPICBASEURL` on a model whose gateway name contains "haiku"; such a model
v2.1.3222026-11-10
What's changed
- Added fast mode on Vertex in the global, us and eu regions, falling back to standard speed if Vertex refuses it
v2.1.3212026-11-09
What's changed
- Added Claude Fable 5.2 (claude-fable-5-2), now the default Fable model — 1M context, $8/$40 per Mtok with $0.20/Mtok cache reads
- Added --settings <file> to claude remote-control, which applies a settings file to every session it starts; if the file changes, no new session starts until you restart claude remote-control
- Fixed MCP OAuth requests sending secrets such as refresh tokens to another host when a server redirected them
- Fixed a case where a read-only Bash command ran outside the sandbox without a permission prompt
- Fixed a case where Bash permission checks judged a file write from the wrong folder and didn't prompt
- Fixed deny rules and protected-file prompts not applying to the file that a cp or mv into a directory writes
- Fixed the "Draws from usage credits" note showing after a switch to Fable on Enterprise seats whose plan includes Fable
- Fixed the fallback model sometimes declining a request or mentioning a stopped response when the first model was blocked before replying
- Fixed claude mcp login printing a SEP-2352 issuer warning each time you sign in again to a server that Claude Code registered with
- Fixed NotebookEdit deleting or overwriting a notebook's first cell when the call named no cell, on network paths (UNC shares, WSL folders, /net mounts)
- Fixed Edit changing the first of several matches, replacing a whole file on an empty old_string, or editing a notebook as text, on network paths (UNC shares, WSL folders, /net mounts)
- Fixed /config showing Manual as the default permission mode when new sessions start in auto mode; pressing Space on "Auto (default)" now saves Don't Ask, not Plan
- Windows: Fixed FileChanged hooks stopping for paths set through watchPaths after the first shell command, when the session's working directory had a lowercase drive letter
- Fixed --plugin-dir . and --plugin-dir ./builtin writing generated type files for Claude Code's built-in plugins into a builtin folder
- Fixed context usage estimates overcounting tool definitions when exact token counts are unavailable
- Fixed /compact showing twice in Remote Control on web and mobile
- Fixed plugin auto-updates and /plugin marketplace updates downloading a plugin again for each worktree or folder of a repository
- Fixed auto mode losing a background subagent's report that had started a turn when the conversation was compacted before Claude answered it
- Fixed project skills, commands and agents staying missing after their folder was removed and came back mid-session, such as with git stash, including after entering a worktree
- Fixed claude -p sometimes telling Claude that background commands get 30 minutes when they are stopped after 10
- Fixed pkill, pgrep and pidwait in cloud sessions matching the session's own parent processes
- Fixed Claude in Chrome and computer use server processes staying alive after their parent exits behind a proxy that stalls connections
- Fixed a large hook output pointing Claude to a file that held another hook's output from the same tool call
- Fixed apps that embed Claude Code getting their own PreToolUse hook's ask reason instead of another hook's when both asked
- Fixed a PreToolUse hook's ask being lost when another hook's defer finished first and could not be honored
- Fixed a rare crash on permission prompts and background tasks
- Fixed project skills, commands and agents disappearing from the menu in SDK and desktop sessions after Claude entered a worktree
- Fixed /desktop on macOS saying Claude Desktop is not installed when it is in ~/Applications
- Fixed OpenTelemetry repository attributes (vcs.*) missing from Claude Desktop sessions that start on a pre-started process
- Fixed WebFetch passing "No response from model" to Claude as page content when the model reading the page returned no text; the call now fails with a clear error
- Fixed screen reader mode delaying the prompt at startup when the system clock moved back while Claude Code was starting
- Fixed a command's panel sometimes not coming back after a dialog closed, leaving no panel or prompt on screen until the next redraw
- Fixed a project's MCP server being disconnected after the first message in a Claude Desktop Code tab session when the desktop app has an MCP server or extension of the same name
- Fixed a turn ending with "API Error: EPROTO: The TLS handshake failed" when the connection broke partway through a reply; the partial reply is kept or the request is retried, as before 2.1.302
- Fixed high memory use in long sessions that repeatedly read single lines from large files
- Fixed fast mode losing replies, switching models or retrying for minutes when fast serving is rate-limited, overloaded or failing; it now tries standard speed on the same model first
- Fixed one request carrying far more background agent reports than intended after Claude was stopped while several were waiting
- Fixed messages from a Claude Desktop Code tab session to your other sessions staying paused after you typed while Claude was still working
- Fixed claude agents ignoring --permission-mode, --dangerously-skip-permissions, --model, --effort or --agent typed before agents when a flag such as --verbose was also on the line
- Fixed a case where Remote Control showed as off with "login expired" in the desktop app while its connection was still up, because the app was briefly unable to hand over a sign-in token
- Fixed a Remote Control message sent with "Queue for later" reaching Claude in the middle of the running turn
- Fixed the git status given to Claude at session start reading as clean when git status failed; it now reads as unavailable
- Fixed the git status given to Claude at session start showing the first listed file as staged when its changes were not staged
- Fixed a hang or out-of-memory crash when a connector in a cloud session lists resources with very long names
- Fixed Remote Control showing as connected after its connection closed for good while the session's history was still uploading
- Fixed screen reader mode turning off when you return to a conversation from agent view
- Fixed screen reader mode y/n questions taking as yes a stray "y" at the end of text typed as the question opened
- Fixed cloud sessions telling Claude that a host is probably not allowed when it is allowed and the network proxy could not connect to it
- Fixed an MCP server sometimes showing as connected with no tools after it was reconnected or the session's directory changed while its tools were still loading
- Fixed Bash commands sometimes running in the wrong folder when Claude sent several at once and an earlier one changed folders
- Fixed files Claude sends from cloud and Remote Control sessions failing at once when an upload gets an HTTP 507 from a proxy; the upload now gets a second try
- Fixed new messages not being saved, and claude -p, SDK and VS Code sessions hanging, when memory ran out while the transcript was being read
- Fixed sign-in, token refresh and logout waiting indefinitely when something on the network accepts the connection but never answers the TLS handshake
- Fixed a sent file showing under a different name in the Claude apps when its name hid text-direction or control characters; Claude now refuses to send such a file
- Fixed sub-agent progress summaries running a request to its end after the model replied with a tool call
- Fixed Bash reads such as grep -r foo "$PWD/src" asking for permission when the same command with the path typed out runs without asking
- Fixed Claude apps gateway refusing to start when a desktop setting holds a field newer than the gateway, such as a managed MCP server's oauth.omitResource; it now warns and serves it
- Fixed Bash commands coming back empty for zsh users whose .zshrc sets KSHOPTIONPRINT
- macOS: Fixed "Unable to read managed policy settings" at startup when a valid MDM profile was slow to read: the read i
v2.1.3192026-11-06
What's changed
- Changed auto mode with telemetry or feature flags off, including behind LLM gateways: calls the server can't check are asked about or denied, with no fallback to the built-in classifier; set CLAUDECODEAUTOMODESERVER=0 to keep using it (Bedrock, Vertex and Foundry are unchanged)
- Changed auto mode behind an LLM gateway: CLAUDECODEAUTOMODESERVER=1 turns on the server-side check even with CLAUDECODEDISABLEEXPERIMENTALBETAS set; if managed settings set the latter, they must set the 1 too
- Added support for MCP tasks in the terminal: when an MCP server runs a tool call as a task, Claude Code moves it to the background right away and tells Claude the result when it finishes
- Added the CLAUDECODEDISABLEMCPTASK_BACKGROUND environment variable to make Claude Code wait for an MCP task inside its tool call instead of moving it to the background right away
- Added permissions.denyInsteadOfPrompting setting: a tool call that would wait on a permission prompt is denied and the turn continues, in terminal sessions, subagents and teammates
- Added /claude-api latency-optimize to find where your Claude API code makes people wait and try faster settings against your eval
- Added the CLAUDECODEDISABLEFEATUREFLAGS environment variable, which stops feature-flag fetching without turning off telemetry; every flag then uses its built-in default
- Added spend for today, this week and this month to /usage for developers behind a Claude apps gateway who have no spend limit, when the gateway runs this version or later
- Added admin.pooledconflictrule and admin.pooledpriorityorder to the Claude apps gateway, to set which pooled group budget pays first for a developer in several groups
- Added an optional login_notice setting to the Claude apps gateway that shows an operator-defined message on the gateway's browser verification page and on Claude Code's sign-in screen
- Added CLAUDEGATEWAYLOG_FORMAT=json to the Claude apps gateway: operational log lines become JSON with severity, time and message, for log collectors that read the level from a field
- Added a Claude apps gateway boot warning for a case where another policy's availableModels also allows a custom model id that one policy lists by name
- Added start-up warnings to the Claude apps gateway for policies with no desktopHome that rely on coworkTabEnabled: false or chatSessionRetentionDays, ahead of Claude Desktop's November 10 change
- Added a warning when your claude.ai login ends and Claude Code continues on the sign-in from ant auth login, which bills usage to your Claude Console organization
- Added a line at startup naming the Claude Console organization that is billed in a case where Claude Code uses the sign-in from ant auth login
- Added an "Earlier in this session" row to /tasks that lists finished subagents, so you can reopen one and message it even after it leaves the list or you restart
- Added a note to /loop confirmations in cloud sessions that a timer stops with its container, with an offer of a loop that survives
- Fixed MCP servers on the older handshake failing to connect, or returning empty results, because Claude Code declared an extension that it only uses with newer servers
- Fixed a long-running MCP tool call on a claude.ai connector sometimes never reporting its result after --resume
- Fixed a session's diff failing to load on claude.ai and the mobile apps when the folder Claude Code runs in has a file or folder named HEAD
- Fixed /diff showing "Diff unavailable" when a git repository has a file or folder named HEAD at its top level
- Fixed the /diff pane opening blank in sessions where 64 or more turns edited files
- Fixed slash commands typed after a leading space, tab or newline being sent to Claude as plain text instead of running
- Fixed a request that kept failing with a 401 refreshing your login on every retry and causing 401s in your other sessions
- Fixed /context sending its full visual grid to Claude on every later turn; Claude now reads only the table
- Fixed claude -p exiting 0 in auto mode when its actions were refused because no safety check was available: text and JSON output now exit 1
- Fixed a case where Claude Code listed every project file at start on Linux for projects on a network file system (NFS, SMB, Lustre and similar)
- Fixed a case where auto mode was wrongly refused when a client sent a model change and a request for auto mode back to back
- Fixed /status showing "Auto mode server: Enabled" when the server-side review isn't reaching the session, for example behind an LLM gateway that drops it
- Fixed Claude-drafted feedback, surveys and /feedback continuing to appear after the server refused feedback for your organization
- Fixed Claude drafting feedback on third-party gateways, where it can't be sent
- Fixed auto mode refusing actions without saying why when permission rules or autoMode settings are very large: it now explains and, unless autoMode deny rules are set, asks you in the terminal
- Fixed a case where Bash deny and ask rules missed commands written with quoted words
- Fixed subagent hand-back reports showing an internal marker and provenance note when expanded outside verbose mode
- Fixed claude -p --resume with a prompt losing a deferred tool call when its MCP server is missing: the run now exits 1, keeps the call and refuses later input
- Fixed a case where text was dropped from informational messages sent to SDK clients
- Fixed a case where Agent SDK hosts got a generic exit-code error instead of a failed run's own error message when the disk was full
- Fixed CLAUDECODERESUMEINTERRUPTEDTURN re-running a turn that was interrupted in plan mode when the session resumes in another permission mode
- Fixed edits to a settings file being ignored when made within a few seconds of Claude Code writing that file
- Fixed a config file left at the legacy name hiding your setup with no warning: Claude Code now says on stderr when a home holds two config files, and which is in use
- Fixed ~/.claude.json, settings and edited files ending up empty or cut off when the disk fills during a save in a read-only folder or to a bind-mounted file (one session saving at a time)
- Fixed Write ending the turn as a refusal when it couldn't read the file to overwrite
- Fixed background Bash commands that finish almost instantly losing their output while being reported as completed
- Fixed the Bash tool's diff of changed files missing a file that the command wrote just before it ended
- Fixed a mistyped model name, such as opus-5-5, telling you to update Claude Code instead of suggesting the model you meant
- Fixed a case where NotebookEdit changed the wrong cell when the notebook changed while a permission prompt was open
- Fixed a ~0.5s hang after pressing Enter on the /login success screen: the dialog now dismisses immediately and the post-login refresh runs in the background
- Fixed Ctrl+G not opening the external editor while typing an "Other" answer to a question in screen reader mode
- Fixed Monitor's WebSocket watch failing with "could not resolve" behind a proxy when CLAUDECODEPROXYRESOLVESHOSTS is set and the machine has no DNS of its own
- Fixed claude plugin eval warnings suggesting max: 0 for a tool that must not be called, which could never pass
- Fixed background plugin auto-update not installing a dependency added by the updated plugin version
- Fixed Cmd+click not opening links in Ghostty over tmux in sessions opened from the agents view
- Fixed a mod's hot reload in .claude/skills missing a file that was deleted just after it appeared, and missing its return
- Fixed /rewind failing with "No files were restored" when restoring code to a checkpoint from before /branch
- Fixed the /claude-api skill saying Console web settings don't apply to Managed Agents sessions, and tightened its credential and permission examples
v2.1.3182026-11-04
What's changed
- Added a record of your answer when Claude Code asks to turn on the mods it writes in a session
- Added assume_role on mantle upstreams of the Claude apps gateway, for a role in another AWS account and for per-developer AWS cost attribution
- Added an effort option to a mod's $.model.fork, so a quick side job can run at low whatever effort the session uses; the result reports the effort sent
- Added the date a stored claude.ai sign-in ends to claude auth status (loginExpiresAt) and to claude -p JSON results (credentialexpiresat)
- Added a one-line stderr warning to claude -p text output, starting 10 days before a stored claude.ai sign-in ends
- Fixed --continue sometimes losing the earlier conversation after a malformed tool call's retries ran out (regression in 2.1.314)
- Fixed macOS sessions with many running Bash commands stalling while memory grew
- Fixed permission prompts being answered by keys typed just after sending a message, or before a slow prompt appeared
- Fixed /logout, claude auth logout and claude mcp remove reporting success, and changes to trust, consent or MCP settings being dropped with no word, when the config file could not be updated on a shared network home directory
- Fixed jobs exiting with Not logged in when another terminal or host signs in again to the same account and organization on the same home
- Fixed claude mcp add and remove writing the config without its lock: they now wait for it or exit 1, though another job's save can still replace a saved server
- Fixed claude plugin commands exiting before a slow token refresh was saved, which could sign you out on the next run
- Fixed claude plugin validate passing a custom-named marketplace file that claude plugin marketplace add rejects
- Fixed stdio MCP servers that exit on the version probe being re-probed on every start; a server that dies in under 3s for its own reason is also pinned to the legacy handshake for 7 days
- Fixed sessions being refused at startup by an allowedProviders list that another login on the same machine had stored
- Fixed idle compaction replacing a conversation with a reply that was not a summary
- Fixed the "Now using usage credits" notice reappearing about every 30 seconds while a background subagent is running
- Fixed custom slash commands that fail, or that only Claude can invoke, printing nothing in claude -p and SDK sessions
- Fixed claude -p and Agent SDK sessions reporting success when an API error cut off a reply while a mod hooked turn.step
- Fixed a message sent right after a model change still running after Stop in headless sessions: Stop now cancels or stops it as it would a queued message
- Fixed a deleted session transcript being re-created with its last prompt when an idle non-interactive session exited
- Fixed claude remote-control hosts, the background daemon and self-hosted runners failing to start new sessions (spawn ENOENT) after an update or version cleanup removed the binary of a still-running process
- Fixed a running Claude Code process owned by another user (for example one left by sudo claude) being treated as dead by version cleanup, which could delete its binary
- Fixed /remote-control showing a session as available after a failed connection
- Fixed /design revoke reporting success when the request failed with a 404
- Fixed a shell command approved after a self-hosted runner or cloud session restart running in the session's start folder, not the folder it was asked in; if that folder can't be entered, it is not run
- Fixed Claude not being told when an approved connector tool was unavailable after a cloud session restart
- Fixed cloud sessions being stopped in the middle of a turn when the service refuses uploads for several minutes
- Fixed variables a Setup hook writes to CLAUDEENVFILE not reaching the Bash tool in some cloud sessions
- Fixed the iPhone app showing a cloud session's turn as finished while it kept running, after a response was cut off at a tool call or a refused image or document was removed
- Fixed a restarted session re-sending a message that failed with an API error, ahead of the newer message waiting behind it
- Fixed a restarted session dropping its interrupted turn when the restart came right after Claude read a large image or retried a tool call
- Fixed every connection failing when the NODEEXTRACA_CERTS file is empty, not PEM, or starts with a damaged certificate: readable certificates are now used, with a warning on stderr
- Fixed workflows re-running finished agents when resumed after a usage limit
- Fixed /mcp in cloud sessions counting tools the model can't use; a server's row now shows how many of its tools are available
- Fixed a duplicate notification when Claude left the status field out of a PushNotification call
- Fixed the error for a too-large image in a request with more than 20 images always saying the limit was 2000px; it now shows the API's limit
- Fixed the runtime in background shell details not updating while the dialog is open
- Fixed a mod's turn.step hook making a stopped reply finish as a success in headless runs
- Fixed retention cleanup leaving a home that only runs claude -p with no ~/.claude.json backup: it now takes a fresh backup before deleting the last good one
- Fixed the stored login being replaced by an empty file when a network home directory has no room left for data but still takes new files
- Fixed tokens from setup-token being refused at start on machines with forceLoginOrgUUID, when the token belongs to a permitted organization
- Fixed non-interactive launches replacing a ~/.claude.json that isn't valid JSON with defaults; the start now fails, says how to restore the file, and leaves it as is (anthropics/claude-code#87551)
- Fixed an empty ~/.claude.json with no backup being reported as corrupted; Claude Code now starts as it does when the file is missing
- Fixed the restore command printed for a damaged or missing ~/.claude.json naming an empty or cut-off backup, or failing on a read-only file
- Fixed the sign-in failure when a stored claude.ai login reaches its time limit: it now says so, and in claude -p names claude auth login and claude setup-token
- Improved how ~/.claude.json, settings files and the stored login survive saves on shared network home directories: they are less often deleted, briefly emptied or replaced by a near-empty or older copy
- Improved sessions on network file systems to look again when the configuration file is wrongly reported as missing, so fewer start without your MCP servers and trusted folders
- Improved MCP tool errors: a call made before the tool is loaded now returns its input schema
- Improved the reliability of git commits and pull request creation when the Bash tool runs macOS's built-in /bin/bash
- Improved "Ask your admin for more usage" in the usage limit menu to send the request in one step
- Improved how fast remote sessions reconnect after a pause or sleep
- Improved You should know toasts to say "try again" instead of "press 2", which only works in the terminal
- Improved auto-update reliability: a brief network failure while verifying a release is now retried right away instead of waiting for the next check
- Improved unattended runs (claude -p, SDK apps) to stop rewriting ~/.claude.json on every run when nothing in it changed
- Changed Claude Code to no longer install or update the IDE extension when started in an IDE terminal; use /ide from an outside terminal or your editor's extensions view
- Changed subagents to stop instead of switching models when "Switch models when a message is flagged" is set to "Ask each time"
- Changed background subagents to move a shell command to the background after 3 minutes on all providers, so the prompt cache doesn't expire while it runs
- Changed subagent progress summaries on Bedrock, Vertex, Foundry, or with telemetry off: on a cold prompt ca