Claude Code 十一月更新汇总(持续更新中,截至 11-15,v2.1.317 → v2.1.325)
By 陈成 · Published November 4, 2026 · Updated November 16, 2026
Claude Code 2026 年 11 月(v2.1.317 起)更新了什么,哪些值得关注?(持续更新)
WIP:本文会随新版本陆续补充。目前收录 2.1.317(11/03)、2.1.318(11/04)、2.1.319(11/06)、2.1.321(11/09)、2.1.322(11/10)、2.1.323(11/12)和 2.1.325(11/13)七个版本。changelog 里没有 2.1.320 和 2.1.324。
主要来源:官方 changelog https://code.claude.com/docs/en/changelog.md,Code Mode 文档 https://code.claude.com/docs/en/code-mode.md 参考:Ben's Bites 十一月摘要(11.10 一期提到 Fable 5.2 发布) 整理日期:2026-11-04,11-07 补充 2.1.319,11-15 补充 2.1.321 ~ 2.1.325 上月:Claude Code 十月更新汇总
TL;DR(暂定)
- 发版节奏:11 天 7 个版本(2.1.317 → 2.1.325),共约 869 条条目,其中 224 条 Added / Changed,89 条 Improved,556 条 bug 修复。2.1.323 一个版本就有 294 条。
- Fable 5.2 上线(2.1.321):
claude-fable-5-2成为默认 Fable 模型,1M 上下文,$8 / $40 每百万 token,cache read $0.20。保存过的 Fable 5.1 选择会迁到fable(Pro / Max 立即迁,Team / Enterprise 等组织放开),/model claude-fable-5-1可以切回。 - Code Mode(实验性)(2.1.323):Claude 写一段 JavaScript 来调用工具,一段代码里可以并行跑命令、把上一个结果传给下一个调用、只把需要的部分返回给模型。默认关闭,
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1打开;只支持终端交互会话和订阅 / Console 账号,网关和三家云都不行。背景见 Codemode 调研。 - 沙箱里的 Bash 不再默认免提示(2.1.325):开了沙箱的 Bash 命令改走正常权限流程,要旧行为得设
sandbox.autoAllowBashIfSandboxed: true(托管设置开沙箱的,要设在优先级最高的托管来源里)。同版本里定时任务和/loop遇到声明了allowed-tools或 hooks 的 skill 会先问。这是本月对无人值守流程影响最大的一条。 - 未知模型 ID 默认按 1M 上下文算(2.1.323):之前是 200K。网关后面接其他厂商小窗口模型的,要提前设
CLAUDE_CODE_DISABLE_1M_CONTEXT=1,否则窗口满了会每轮报错直到/clear。 - 会话之间互发消息的上限:同一台机器上会话互相发消息不用你介入的上限,从约 20 条提到 100,000 条(2.1.323)。
- MCP tasks 进了终端(2.1.319):MCP server 把工具调用作为 task 跑时,Claude Code 直接转后台,跑完再通知 Claude;Bedrock / Vertex / 网关这些拿不到 feature flag 的环境也能用。
- 两个会改变默认行为的 2.1.319 Changed:自行调度的
/loop在某一轮结束时没有重新调度就会结束,不再自动排一个兜底唤醒(CLAUDE_CODE_LOOP_KEEPALIVE=1恢复旧行为);关闭遥测或 feature flag(包括走 LLM 网关)时,auto mode 不再退回内置分类器,服务端判断不了的调用会询问或拒绝。 - effort 继续收口:上月 2.1.316 加了
CLAUDE_CODE_SUBAGENT_EFFORT,2.1.317 又改成「子代理或 teammate 用的模型和主会话不同时,用那个模型自己保存的 effort 或默认值」,不再套用会话 effort。2.1.318 给 mod 的$.model.fork加了effort,旁路小任务可以固定跑low。 - 保护 prompt cache:后台子代理里的 shell 命令跑满 3 分钟就转到后台(所有 provider),避免缓存过期;SendMessage 发给后台 agent 时,它正在跑的命令也会转后台,消息更早送达。
- 安全:2.1.321 修了 MCP OAuth 在 server 重定向时把 refresh token 等发给另一个 host;2.1.323 / 2.1.325 又修了一长串 Bash 权限检查和沙箱的漏洞。web 或 shell 工具调用要把你的账号邮箱发到网络上时会先问(2.1.321 收窄为只拦带 User-Agent 的 shell 命令,2.1.325 又扩到脚本、文件写入、web fetch 和 MCP 调用);Agent SDK 的 hook callback 也支持
onFailure: "block";deniedMcpServers的 URL 条目现在也能挡住 Anthropic 提供的同 URL server 和云会话里的 connector。 - 登录与配置文件更稳:
claude auth status显示loginExpiresAt,claude -p在 claude.ai 登录到期前 10 天往 stderr 打警告;一大批修复针对网络共享 home 目录下~/.claude.json被清空、被替换或写丢的问题。 - 两个可能影响流程的 Changed(2.1.317 / 2.1.318):在 IDE 终端里启动 Claude Code 时不再自动安装或更新 IDE 扩展;Read 工具去掉了「file unchanged since your last Read」占位,重复读同一文件会返回完整内容。
1. 2.1.325(11-13)
重点
- 沙箱里的 Bash 改走正常权限流程:之前开了沙箱的 Bash 命令默认不弹提示,现在要
sandbox.autoAllowBashIfSandboxed: true才保留旧行为。托管设置里开沙箱的组织,这个值要写在优先级最高的托管来源里。 - 定时任务和
/loop遇到「有权限」的 skill 先问:skill 声明了allowed-tools或 hooks 时,定时任务和/loop会先询问;要无人值守地跑,把Skill(name)加进permissions.allow。 - 桌面端 / IDE / SDK 的「Always allow」变了:只有保存的规则真能放行下一次同样的命令时,才会单独提供「只存规则」的选项。依赖它的定时任务可能会停下来等你。
- 只读 git 命令在陌生仓库里先问:仓库不是项目本身也不是你信任过的,就会询问。用
--add-dir指定这个仓库可以免提示,additionalDirectories设置不算。 - 沙箱保护范围扩大:
--add-dir加进来的目录里的.claude设置、skills、agents、commands 和 hooks,沙箱内也不能写;isolated worktree 里禁止git bisect run、git maintenance register|start和scalar的设置命令。 - 子代理被输出上限截断时会被要求更简短地重答一遍,不再只返回答案的结尾。
其他
- 安全:修复 zstd 压缩响应的解码问题;Bash allow 规则可能运行另一个程序;部分复合命令不经询问就运行;沙箱对 worktree 的设置、hooks 和共享 git 目录保护不全;沙箱内命令在某些情况下能写原生更新器的下载目录。
- 凭据:沙箱自己起的辅助程序(比如网络桥)不再继承 Claude Code 的登录 token 和 API key;ripgrep、本地 git 和沙箱辅助程序拿不到 mTLS 客户端私钥的口令。
- 权限:相对路径的 deny / ask 规则(如
Read(./.env))在cd之后仍覆盖项目,也作用于--add-dir目录;mcp__plugin_*_开头的规则不再因为大小写不同漏掉插件 MCP。 - Artifact:外部可见的 artifact,子代理修改或上传前一定会问;auto mode 的同意只覆盖那一次修改。读自己的 artifact 不再弹权限提示。
- 子代理:修复
opusplan/haiku设置下有独立模型的子代理被换成 plan mode 的模型;修复换了模型的子代理按主会话模型给文件读取和 MCP 结果定大小。 - 上下文 / 模型:
CLAUDE_CODE_MAX_CONTEXT_TOKENS也作用于不认识的claude-开头模型 ID(比如网关的claude-sonnet-latest);修复很多第三方网关和 Foundry 上每轮报上下文过长而不压缩;修复保存的sonnet[1m]在新安装里被改成 API 不认的 ID。 - Mods:
/cost、$.session.usage()、--max-budget-usd和成本指标开始计入 mod 的$.model.complete/$.model.classify调用。 - MCP tasks:在后台 MCP task 的问题上按 Esc 改为「稍后回答」,问题留在
/tasks;task 等你回答时 Claude 会被告知并能提示你去/tasks;问题不会再盖住你正在打的字。 - 插件:
.mcpb/.dxt改解压到插件目录下,只读的插件文件夹也能加载;托管设置声明的远程 marketplace 里的插件算组织的,pluginDigests废弃;marketplace 的ref可以写分支或 tag 上任意 commit 的完整 ID(旧版客户端克隆不了这种 pin)。 - skills:
--plugin-dir插件里的.claude/skills不再从上层目录启动的会话加载,要在插件目录里启动。 - teammate:tmux / iTerm2 teammate 和 agents view 里按 ← 开的新会话,在会话的目录里启动,不再跟 shell 最后
cd的位置走。 - prompt suggestions:连续 8 轮由后台或定时任务发起时刷新得更少,按键或回到终端后恢复。
- CLI:
/login改隐私设置前会问;claude -p在没有缓存账号数据时先等数据再发第一个请求,干净环境里首次运行会慢几秒。 - Remote Control:
claude remote-control自己停下时退出码 4(单会话仍是 0),注册失败时 69,方便 service manager 重启;连着的会话有分享链接时,/resume和/teleport先断开。 - 云会话:Claude Code on the web、云定时任务和 Cowork 云会话在设了
sandbox.failIfUnavailable时也能启动(托管容器本来就没有命令沙箱);云会话里 tool search 加载的 MCP 工具描述上限从 4,096 提到 16,384 字符。 - runner:自托管 runner 拒绝会话目录或仓库路径是符号链接的会话(
checkouthook 产生的除外)。 - VS Code:新增 prompt suggestions(Tab 接受,
promptSuggestionEnabled: false关闭);新增不创建 API key 的 Console 登录;effort 选择器不再提供超过组织上限或maxEffortLevel的档位。
2. 2.1.323(11-12)
这是本月最大的一个版本:78 条 Added / Changed、21 条 Improved、195 条修复。
重点
- Code Mode(实验性,默认关闭):Claude 不再一个个请求 Bash / Read / Edit,而是写一段 JavaScript 来调用工具,一段代码里可以并行跑命令、把一个结果用在下一个调用里、只返回需要读的部分。
- 打开:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1(shell 或~/.claude/settings.json的env;项目设置里写了不生效)。首次会要求确认,然后重启。组织可以在托管设置里设0禁用,但不能替用户开启。 - 限制:只支持终端里的交互式
claude,不支持-p、Agent SDK、VS Code、桌面端和云会话;只支持订阅或 Console 账号,网关、Bedrock、Vertex、Foundry 都不行;模型限 Opus 5.5 / Sonnet 5.5 / Haiku 5.5 / Fable 5.2;不能和 Remote Control、Claude in Chrome、computer use、agent teams、OTel 导出、DISABLE_TELEMETRY同时用;代码默认最多跑 10 分钟;Code Mode 会话只能在开着 Code Mode 时恢复。 - 权限:代码里的每次工具调用仍走 deny / ask 规则和
PreToolUsehooks;auto mode 的分类器审的是整段代码,看不到运行时才算出来的值(比如从搜索结果里取的路径)。 - 界面上看到的还是一个个工具调用,代码要按
Ctrl+O在 transcript 里展开 Code 行才看得到。 - 和 Codemode 调研 里 Pi、Codex、Factory Droid 的做法是同一类。
- 打开:
- 未知模型 ID 的上下文窗口从 200K 改为 1M:
/autocompact可以提早压缩,CLAUDE_CODE_DISABLE_1M_CONTEXT=1保持 200K。接其他厂商小窗口模型的,窗口满了会每轮失败直到/clear,所以要在用满之前设好这个变量。 - 会话之间互发消息:同机会话之间不经你确认可以发的消息数从约 20 提到 100,000;桌面端 Code tab 也从 20 提到 100,000(2.1.321 刚从 10 提到 20)。
- 插件
engines["claude-code"]:plugin.json可以声明支持的 Claude Code 版本范围,超出范围的不安装、不更新、不加载,安装和更新会挑最新的合适版本。claude plugin validate新增对 TypeScript hooks 模块的类型检查(--strict下失败)。 - MCP 登录要确认:Claude 用来完成 MCP server 登录的工具在 bypass 和 auto mode 下也会询问;
dontAsk这类没人能回答的模式请改用/mcp。v1 MCP 客户端移除,MCP_SDK_GENERATION=v1改为用 v2 客户端的兼容模式。 - 外部可见的 artifact 更新前一定会问,即使有 allow 规则;Claude 判断不了谁能看到时也会问。
CLAUDE_CODE_DISABLE_AGENT_PROGRESS_SUMMARIES=1(2.1.318 起就能用)关闭子代理进度摘要和生成它的请求(anthropics/claude-code#86879)。
其他
- 权限:
/security-review运行前先问;「don't ask again」生成的规则像是包含密钥,或者会写进被 git 跟踪的settings.local.json时,只在本次会话有效,不保存。 - 权限:
PreToolUsehook 返回 allow 后权限检查出错,按「没有 hook 回答」处理;PermissionRequesthook 改写过的输入检查失败时,再问一次或拒绝。 - 权限:启动时警告变量值里带
*的 Bash allow 规则(如Bash(PORT=* npm run dev));修复Bash(ls*)这类紧贴通配符的规则在某些情况下跳过提示,Bash(NODE_ENV*)这种以变量名开头的现在会问;修复经sudo、env等包装的命令漏过 deny / ask 规则;修复defaultMode: auto在 auto mode 不可用时进入可能放行更多的模式,现在退回 Manual。 - 沙箱:macOS / Linux 上
git worktree add|move|remove以只读失败,在非本会话的 worktree 里 commit 也一样;经由可写目录里的符号链接授予的写权限会被忽略,要授予真实路径;--settings文件不是合法 JSON 又带sandbox键时直接停止启动。 - 凭据:Claude Code 自带的 ripgrep 和大部分内部 git 命令不再带着它的登录 token 和 API key 运行,挂在这些 git 命令下的 credential helper 或 hook 拿不到它们。
- Mods:对
engine.create的*、命名空间或取反 hook 只能观察,要增删$名词得按名字 hookengine.create;claude plugin validate会拒绝写法不对的;mod 的 pane 新增isPromptCovered属性;修复 mod 能改写 Claude Code 自己的确认问题。 - 插件:git submodule 不在记录的 commit 上时安装失败;安装命令写了 stderr 时显示警告而不是成功;
claude plugin install --json新增unsetOptionCount;插件的agent设置废弃(仍生效,但会警告);移除subagentStatusLine设置(2.1.319 才给它加了${CLAUDE_PLUGIN_ROOT})。 - hooks:
claude -p和 SDK 里 hook 跑得久时每 30 秒发一次进度心跳,宿主(比如桌面端)不会以为卡死而结束这一轮;PreCompact/PostCompact和压缩后的SessionStarthook 在子代理压缩时带上agent_id和agent_type。 - 代理:组织设置和策略请求不再用只由
ALL_PROXY设置的代理,需要代理请设HTTPS_PROXY(和 2.1.319 证书修复的方向一致)。 - 环境变量:新增
CLAUDE_CODE_RESUME_HINT_COMMAND,启动 Claude Code 的程序可以让退出提示显示自己的恢复命令;CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS上限从 64,000 提到 300,000;Perforce 项目会提示一次CLAUDE_CODE_PERFORCE_MODE。 - 用量:模型需要的 usage credits 关闭或用完时,弹出选项菜单(停止、改用 credits、升级);修复 Fable 周限额不显示重置时间和选项菜单。
- 压缩 / 会话:修复再次
/compact(或在/context之后)把还没回答的消息压掉;修复恢复的会话把你的下一条消息接到一条没恢复的中断消息上;修复改了很大的文件后下一次输入时内存暴涨;多个子代理时,结束的子代理的 transcript 更早释放。 - 登录:一批修复针对后台会话在具名 Anthropic profile、shell 里的 API key 之间悄悄切换登录,现在会停下并说明;
/logout在后台会话里现在会登出本机所有会话并删除保存的 MCP 登录和插件密钥。 - teammate:分屏 teammate 会校验请求来自它的 lead,lead 不在了的请求会被拒绝;
/clear或/resume后要重发计划批准。 - workflow:桌面端 Code tab 里的 workflow 碰到用量上限会暂停,重置后继续。
- Remote Control:切 Wi-Fi 或重连 VPN 后不再显示断开一分钟以上;在同一目录 4 小时以后重启也保留身份(最长 30 天)。
- OTel:只配了 endpoint 没配协议时默认
http/protobuf;导出超时上限改为 25 秒(之前 30 秒);一条格式错误的OTEL_RESOURCE_ATTRIBUTES不再丢掉整个变量。 - VS Code:未信任的文件夹首次会话前先弹信任提示;运行中的 Bash / PowerShell 命令输出直接显示在命令卡片下面。
- 云会话:自托管环境的新会话也有 No repository 选项;定时任务因为设置要求沙箱而起不来时发失败通知;删除会话时提醒会暂停在其中运行的定时任务。
- Claude Tag:Enterprise 计划下 Slack 里发起的 Claude Tag 会话进入 Compliance API(beta)。
- Code Review:管理设置新增 Download CSV,按仓库、按月 / 周 / 日导出 review 成本。
- 其他:Artifact 工具的资源上传支持
.docx;/stickers改为提示贴纸已领完。
3. 2.1.322(11-10)
- Vertex 的 global、us、eu 区域支持 fast mode,Vertex 拒绝时回退到标准速度。只有这一条。
4. 2.1.321(11-09)
重点
- Claude Fable 5.2(
claude-fable-5-2)成为默认 Fable 模型:1M 上下文,$8 / $40 每百万 token,cache read $0.20。- 保存过的 Fable 5.1 选择迁到
fable:Pro / Max 立即迁,Team / Enterprise 等组织放开;/model claude-fable-5-1切回。 - 社区反应见 Ben's Bites 十一月摘要 的 11.10 一期(Ben 建议几乎所有事都用 medium / low 推理档)和 Fable 5.2 改进代码库 Prompt 合集。
- 保存过的 Fable 5.1 选择迁到
- Mods 的工具调用不再弹权限提示:
$.tool.call、$.mcp.call即使碰上你的 ask 规则,或者在dontAsk和-p下,也不提示;deny 规则和组织策略照样生效。Claude 写的 mod 在 auto 和 bypass 模式下直接开启,在dontAsk下不加载。 - fast mode 被限流或过载时先在同一个模型上试标准速度,不再丢回复、换模型或重试好几分钟;fast mode 的标签改为显示当前模型名,去掉「(Opus only)」。
- 账号邮箱检查收窄:只拒绝同时带着你的邮箱和 User-Agent 的 shell 命令(不再询问),其他命令和定时运行不会再卡在它的提示上。2.1.325 又把范围扩到脚本、文件写入、web fetch 和 MCP 调用。
- MCP OAuth 安全修复:server 重定向时,refresh token 等秘密被发给另一个 host。
claude remote-control --settings <file>:给它启动的每个会话套用一个设置文件;Remote Control 会话固定在启动目录,连上的客户端不能再把它挪走。
其他
- 权限:
/bin/cp这种带路径的cp/mv也做路径检查;修复cp/mv到目录时 deny 规则和受保护文件提示不生效;修复只读 Bash 命令在沙箱外不经提示运行。 - 上下文:后台命令通知和 TaskStop 结果里超过 1,000 字符的命令只给 Claude 看开头和结尾;图片多到一个请求放不下时,Claude 会知道被丢掉的图片它是否已经看过。
- skills:
~/.claude/plugins里的.claude/skills不再因为 Claude 在那里改文件而加载;headless 会话在.claude/skills里的 mod 文件变化时会重载(CLAUDE_CODE_PLUGIN_DIR_WATCH=0关闭)。 - 托管设置:托管的
extraKnownMarketplaces声明的名字不能再从其他来源添加,被接管的数据保留cleanupPeriodDays天,选项和密钥保留到claude plugin restore-set-aside。 - Windows:找 git 等程序时跳过相对路径、UNC 和指向网络共享的 PATH 条目;启动和首个命令更快。
/model:「More models」变成列表底部不编号的一行,旧模型收在下面,不会打乱其他编号。- 网关:Bedrock / Vertex / Foundry upstream 忽略网关环境里的
ANTHROPIC_*_BASE_URL,要换 endpoint 就在 upstream 上设base_url;policy_mode: layered下托管 MCP server 会叠加所有匹配的策略;花费上限错误按本地时间显示重置时刻。 - runner:被服务端拒绝的按需 runner 改为以 0 退出(2.1.323 又改回 1)。
- 修复:网络路径(UNC、WSL、
/net)上 Edit 改错匹配、空old_string替换整个文件、NotebookEdit覆盖第一个单元格;回复中途断开时报EPROTO;/config把 auto 默认模式显示成 Manual;长会话反复读大文件单行的高内存。 - 安装:
claude install和安装脚本快 2 ~ 4 秒;加载 TLS 证书更快,启动更快。
5. 2.1.319(11-06)
重点
- 终端支持 MCP tasks:MCP server 把工具调用作为 task 运行时,Claude Code 立即把它转到后台,跑完后把结果告诉 Claude。
CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND改为在工具调用里等待;不依赖 feature flag,Bedrock / Vertex / Foundry / LLM 网关 /DISABLE_TELEMETRY下都能用,CLAUDE_CODE_DISABLE_MCP_TASKS=1关闭。背景见 MCP Tasks 与 Elicitation。 permissions.denyInsteadOfPrompting:本来要等权限提示的工具调用直接拒绝,这一轮继续跑。终端会话、子代理和 teammate 都适用,适合无人值守的场景。- auto mode 不再退回内置分类器:关闭遥测或 feature flag(包括走 LLM 网关)时,服务端检查不了的调用会询问或拒绝;
CLAUDE_CODE_AUTO_MODE_SERVER=0继续用内置分类器(Bedrock / Vertex / Foundry 不变)。网关后面用CLAUDE_CODE_AUTO_MODE_SERVER=1可以在设了CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS时仍开启服务端检查。 - 自行调度的
/loop行为变了:某一轮结束时没有重新调度,loop 就结束,不再排一个兜底唤醒;CLAUDE_CODE_LOOP_KEEPALIVE=1恢复旧行为。 /tasks新增「Earlier in this session」:列出已结束的子代理,离开列表或重启后也能重新打开并给它发消息。- 几个安全修复:构造的环境变量前缀能让部分命令躲过权限检查(Bash 权限绕过);创建 worktree 时的沙箱逃逸;
sed命令在 accept-edits 和 auto mode 下可能跳过权限检查;带引号的命令漏过 Bash deny / ask 规则。
其他
- 环境变量:新增
CLAUDE_CODE_DISABLE_FEATURE_FLAGS,只停 feature flag 拉取、不关遥测,所有 flag 用内置默认值。 - 登录:claude.ai 登录到期后改用
ant auth login的登录继续时会警告(费用记到 Claude Console 组织),启动时也会打一行说明计费的 Console 组织。 - 权限:会话里精确的 Bash / PowerShell ask 规则被更宽的 deny 规则覆盖时,直接拒绝,不再询问。
- 权限:Bash 工具运行带了查询 / 显示以外参数的
which前会询问;timeout 30 rg foo这类用timeout包一层的只读命令不再弹权限提示。 - 权限:项目设置文件或插件不能再把你在项目外关掉的 auto mode 服务端检查重新打开;Monitor 的 WebSocket watch 对每条 Bash 命令都走规则(deny 拒绝;ask 规则下 Monitor 的 allow、bypass 或 auto mode 都不再跳过提示)。
- 权限:
--add-dir的目录要先接受它自己的 trust 对话框才会注册插件 marketplace;开了 Bash 沙箱时,起始目录下层的.claude/skills只有从那里启动或/cd过去才加载。 - auto mode:修复
claude -p在 auto mode 因为没有安全检查而被拒绝时仍以 0 退出(现在 1);修复/status在服务端检查没到达会话时仍显示「Auto mode server: Enabled」;权限规则或autoMode设置很大时会说明拒绝原因。 - hooks:新消息打断这一轮后才完成的工具调用,也会跑 PostToolUse hook(最多 10 秒)。
- 子代理:safeguards 停掉子代理后,Claude 会用更窄的 prompt 重试或告诉你,不再自己把活干了。
- 子代理:修复
/clear停掉仍在运行的后台 agent、teammate 和 workflow 的命令;修复后台 agent 之后的报告被拒绝时静默丢失;修复压缩后子代理被告知去等它没启动过的后台 agent 的完成通知。 - 上下文:
/context在终端给 Claude 读的表格变短(每个列表保留最大的 10 行,按需加载的 MCP 工具每个 server 一行);修复/context每轮都把完整的可视化网格发给 Claude。 - MCP:修复走旧握手的 MCP server 因为 Claude Code 声明了新扩展而连不上或返回空结果;修复 claude.ai connector 上长时间运行的工具调用在
--resume后不报结果。 - 配置文件:Windows 上存配置时等其他程序释放文件更久,
~/.claude.json更不容易被清空;home 里有新旧两个名字的配置文件时,stderr 会说明用的是哪个;在只读目录或 bind-mount 文件上磁盘写满时,配置和编辑的文件不再变成空或被截断。 - CLI:
/model把旧模型收进「More models」;打错模型名(比如opus-5-5)会建议你想要的模型,不再让你更新 Claude Code;修复开头有空格、Tab 或换行的斜杠命令被当成普通文本发出。 - CLI:修复 401 请求每次重试都刷新登录,导致其他会话也 401;修复 Linux 上项目在 NFS / SMB / Lustre 等网络文件系统时启动会列出所有文件。
- Bash:修复几乎立即结束的后台 Bash 命令丢输出却被报告为完成;修复 Write 读不到要覆盖的文件时把这一轮当成拒绝结束。
- 代理 / 证书:只设了
ALL_PROXY时不再自动修复 TLS 检查代理的证书,改设HTTPS_PROXY;CLAUDE_CODE_PROXY_RESOLVES_HOSTS在宿主管理网络时只能从进程环境变量设,设置文件不再生效。 - Claude in Chrome:短暂断开后最多等 6 秒等会话自己的浏览器回来;
javascript_tool最多 60,000 字符的结果留在对话里;移除shortcuts_list和shortcuts_execute。 - Mods / 插件:修复
claude plugin update、/plugin的「Update now」和后台自动更新不安装新版插件新增的依赖;插件的subagentStatusLine命令支持${CLAUDE_PLUGIN_ROOT}。 - 云会话:会话迁到新 worker 时不再丢掉会话级 deny / ask 规则(保不住时会丢掉会话级 allow 规则,可能会再问一次);
/loop确认信息提醒计时器会随容器停止;Send now 不再停掉正在跑的后台 agent。 - runner:
CLAUDE_RUNNER_CHECKOUT_PATH改为每个仓库一个文件夹,同名文件夹加-2、-3…;会话结束时不再上传 debug 日志;--trust-workspace false也会阻止仓库设置文件和 skill 里的 hook。 - Remote Control:修复
claude remote-control在首次运行问题没有回答时静默以 0 退出(现在说明原因并以 1 退出);不带换行的管道y也算回答 yes。 - 网关:没有花费上限的开发者在
/usage里能看到今天、本周、本月的花费;新增admin.pooled_conflict_rule/admin.pooled_priority_order,决定开发者属于多个组时先扣哪个共享预算(pooled_budget,十月 2.1.316 新增);新增login_notice、CLAUDE_GATEWAY_LOG_FORMAT=json;花费上限错误改为「spend limit reached · resets Dec 1」。 - 网关:新增几条启动警告,包括策略没有
desktopHome却依赖coworkTabEnabled: false或chatSessionRetentionDays(为 Claude Desktop 11/10 的变化做准备)。 - OTel:
claude_code.session.count不再把没被认领的 Agent SDKprewarm()进程算进去。 - VS Code:超过 50,000 字符的 prompt 不再被静默截断;修复窗口重载后执行未批准的计划。
- Code Review:解绑 GitHub 组织时同时关掉它在 Code Review 里的 All repositories 设置,重新绑定后要手动打开。
6. 2.1.318(11-04)
重点
- 后台子代理里的 shell 命令跑满 3 分钟就转后台:所有 provider 都这样,避免命令运行期间 prompt cache 过期。
$.model.fork新增effort:mod 的旁路小任务可以不管会话 effort 固定跑low,结果里会报告实际发送的 effort。deniedMcpServers的 URL 条目也会挡住上游 URL 匹配的 Anthropic 提供的 server,以及云会话和自托管 runner 里的 connector;其他 connector 按名字拒绝。- 登录到期提醒:
claude auth status新增loginExpiresAt,claude -p的 JSON 结果新增credential_expires_at- claude.ai 登录到期前 10 天,
claude -p文本输出会往 stderr 打一行警告 - 到期时的错误会直接说明,并在
claude -p里提示用claude auth login或claude setup-token
- 不再自动装 IDE 扩展:在 IDE 终端里启动不再自动安装或更新 IDE 扩展,需要从外部终端跑
/ide,或者去编辑器的扩展视图里装。 - 云会话 No repository 选项:Anthropic 托管环境的云会话可以不选仓库直接启动。
其他
- 子代理:Bedrock / Vertex / Foundry 或关闭遥测时,子代理进度摘要遇到冷缓存可以最多等 5 分钟子代理的响应。
- 子代理:「Switch models when a message is flagged」设为「Ask each time」时,子代理直接停下,不再自己换模型。
- 子代理:修复 workflow 在用量上限后恢复时重跑已完成的 agent;修复后台子代理运行时「Now using usage credits」大约每 30 秒弹一次。
- Mods:Claude Code 问你要不要开启它在会话里写的 mod 时,会记录你的回答。
- Mods:mod 在
prompt.submit附加的内容留在用户这一轮里,不再作为 system message 发出。 - Mods:修复 headless 和 SDK 会话里 mod 挂了
turn.step时,被 API 错误截断或被停掉的回复被报告为成功。 - Mods:You should know 的 toast 文案从「press 2」改为「try again」(「press 2」只在终端里有效)。
- 上下文:撤回了 2.1.288 的一个修复:从 2.1.286 或更早版本开始的会话,恢复时之前的 thinking 可以被丢掉。
- 压缩:修复 idle compaction 用一条不是摘要的回复替换了整段对话。
- 权限:修复发完消息后紧接着敲的键,或慢出现的权限提示之前敲的键,被当成权限提示的回答。
- 权限:
/claude-api managed-agents-onboard给新 agent 的内置工具和模板里的 MCP 工具默认使用auto权限策略(「Judge risky actions」),和 Claude Console 一致;说「run without asking」可以不用。 - 权限:
/permissions的规则详情、内置规则和删除确认改用标准对话框,按两次 Ctrl+C 是返回或取消,不再退出。 - 配置文件(网络共享 home 目录):一大批修复。
~/.claude.json、设置文件和登录信息更不容易被删、被短暂清空或被旧副本替换;配置文件被误报不存在时会再找一次;/logout、claude mcp remove等在写不进配置时不再假装成功;磁盘满但还能新建文件时,登录信息不会被替换成空文件。 - 配置文件(
~/.claude.json损坏):非交互启动遇到不是合法 JSON 的~/.claude.json,不再用默认值覆盖,而是直接失败并说明怎么恢复(anthropics/claude-code#87551);空文件且没有备份时按「文件不存在」正常启动;claude -p和 SDK 在没有改动时不再每次都重写这个文件。 - CLI:用量上限菜单里的「Ask your admin for more usage」一步发出请求;自动更新验证时的短暂网络错误会立即重试。
- MCP:工具还没加载就被调用时,MCP 错误会带上它的 input schema;版本探测时就退出的 stdio server 不再每次启动都重新探测,3 秒内因自身原因退出的 server 会固定走旧握手 7 天;
claude mcp add/remove写配置时会等锁。 - 云会话:内置 Chromium 有了常见的 Chrome 名字,Playwright 以外的工具也能通过
google-chrome和CHROME_PATH找到它。 - 云会话:connector 搜索结果会告诉 Claude 只搜了 connector 目录的一部分;
gh run view --log和gh api读 GitHub Actions 日志在大多数环境里能拿到内容了。 - runner:spawn-runner hook 环境变量新增
CLAUDE_RUNNER_SPAWN_REASON(如runner_lost、resumed)。 - runner:orchestrator 日志格式变了:
ok session=…在所有日志级别都打到 stdout,nack session=…的reason=…移到retryable=…后面。匹配retryable=true:/retryable=false:的脚本要改。 - Remote Control / runner:更新或清理版本删掉仍在运行的进程的二进制后,
claude remote-control、后台 daemon 和 runner 不再报spawn ENOENT起不来新会话。 - 网关:
mantleupstream 支持assume_role,可以用另一个 AWS 账号里的角色,也能按开发者归属 AWS 成本。
7. 2.1.317(11-03)
重点
- 子代理和 teammate 用的模型和主会话不同时,用该模型保存的 effort 或其默认值,不再用会话的 effort。
和十月的关系:10/28 @bcherny 的用量调查结论里,「子代理默认继承 xhigh」是主要原因之一。2.1.316 的
CLAUDE_CODE_SUBAGENT_EFFORT是手动开关,2.1.317 把「换了模型的子代理」也默认从会话 effort 里摘出来了。 - web 或 shell 工具调用要把你的账号邮箱发到网络上之前,先询问。
- Agent SDK 的 hook callback 支持
onFailure: "block",callback 出错时阻止动作(十月 2.1.295 只给了 command/HTTP hook)。 - Read 工具去掉「file unchanged since your last Read」占位:重复读没改过的文件也会返回内容。好处是不会因为占位丢信息,代价是重复读会多花 token。
- 网关成本报表 API
GET /v1/organizations/analytics/cost:按日期范围看历史花费,可以看总数,也可以按开发者、按天、按 IdP 组拆分。
其他
- 子代理:SendMessage 发给正在运行的后台 agent 时,它正在跑的命令转到后台(不会停掉),消息更早送达。
- 子代理:修复在提示符按 Ctrl+C 清空输入时把所有后台 agent 一起停掉。
- effort:修复项目里的
effortLevel对桌面端 Code tab 这类「先预启动、再打开到项目」的会话不生效。 - Mods:内置
plugin-authoringskill 在你做的 mod 跑通后,会主动提一次帮你分享。 - Mods:修复 Remote Control 和 SDK 宿主对 mod 的工具调用提供「don't ask again」。
- 压缩:修复 CLAUDE.md 很大且有改动时,自动压缩后报「Prompt is too long」。
- 压缩:修复压缩不得不缩短自己的请求时,超长会话丢掉之前的摘要。
- 压缩:修复网关吞掉 Bedrock 的「Input is too long.」,会话每轮报「upstream rejected the request」而不去压缩。
- 缓存:
DISABLE_PROMPT_CACHING_OPUS/DISABLE_PROMPT_CACHING_SONNET对[1m]、其他区域和不带日期的默认模型写法也生效了。 - 工具:Grep / Glob 搜索超时只拿到部分结果时,Claude 不会再当成完整结果。
- 权限:
/schedule新建云端定时任务时,如果带上了你没要求的 connector,会警告并告诉你怎么去掉。 - 权限:auto mode 对子代理的工具调用给不出判断时,主视图会显示提示(之前什么都不显示)。
- 权限:修复 agent team 的 teammate 在 tmux / iTerm2 面板里以 auto mode 启动,而 lead 会话是手动模式。
- CLI:
claude -p在磁盘满或配额用尽导致 transcript 或~/.claude.json写丢时,打印错误并以 1 退出(之前是 0)。 - CLI:退出时打印的「Resume this session with」会带上你启动时的参数(比如
--chrome --debug)。 - MCP:云会话新增链接卡片:MCP server 要你打开某个链接时,可以打开或拒绝,不会再被忽略。这接着十月 2.1.316 的表单卡片,云会话里两种 elicitation(表单和 URL)都有了 UI。
- MCP:修复部分桌面端会话里项目和本地 MCP server 在第一轮之后断开;修复 stdio MCP server 在 env 里把
AWS_BEARER_TOKEN_BEDROCK设为空时收到空值,现在会直接 unset。 - 云会话:新建定时任务默认用管理员选的组织默认环境。
- runner:
CLAUDE_CODE_DISABLE_NESTED_SESSION_ID=1让 session 里跑的claude -p继续用该 session 的 ID 和 transcript(旧行为);默认已修成不再共享。 - runner:遇到 501 / 529 以外的 5xx,或心跳没有回应时,改为新开连接,不再复用出错的连接。
- 网关:设置了
admin:的网关每天记录每个开发者所在的 IdP 组,保留admin.identity_retention_days天,成本报表按它分组。 - 网关:修复组共享预算(
pooled_budget,十月 2.1.316 新增)用完后,状态栏和/usage把个人额度显示成 100% 已用。 - OTel:metrics、events、spans 新增
anthropic.plan、anthropic.seat_type、anthropic.provider、anthropic.custom_base_url;修复经代理导出时卡死或连接风暴,导出超时 10 秒(OTEL_EXPORTER_OTLP_TIMEOUT最多 30 秒)。 - 桌面端 Code tab:组织的远程托管设置还没加载到会话时会显示提示,加载完再提示一次。
- Claude Tag:在 Slack 新贴的 artifact 链接显示为带 Open 按钮的简洁卡片,点开直接在 Claude 里打开。
8. 本月要记住的日期
| 日期 | 事项 | 来源 |
|---|---|---|
Claude Desktop 变更:网关策略没有 desktopHome、却依赖 coworkTabEnabled: false 或 chatSessionRetentionDays 的,网关启动时会警告(已过) |
2.1.319 | |
| 11/09 起 | Fable 5.1 的保存选择迁到 fable(即 Fable 5.2):Pro / Max 立即,Team / Enterprise 等组织放开 |
2.1.321 |
| 11/30 | Opus 4.8 fast mode 移除,之后请求直接报错,不回退到普通 Opus 4.8 | 2.1.316(十月) |
| 12/14 | 独立版 Claude Design(claude.ai/design)关闭;2.1.317 起 /design-sync 会提前提示设计系统已迁到 Claude |
2.1.302(十月)/ 2.1.317 |
9. 对我来说值得做的事(暂定)
- 还在用 Opus 4.8 fast mode 的,11/30 前迁到 Opus 5.5。
- 给子代理配了不同模型的,升到 2.1.317 后检查它们实际用的 effort:现在跟着各自模型保存的值走,不再跟会话。
- 写 mod 时,旁路任务的
$.model.fork加上effort: "low"。 - 依赖在 IDE 终端里自动装扩展的,改成手动
/ide或在扩展视图里装。 - CI 里用
claude -p的:看一下 stderr 的登录到期警告,或者用claude auth status的loginExpiresAt做监控;自托管 runner 的日志匹配脚本按新格式改。 - 依赖自行调度
/loop一直挂着的,升到 2.1.319 后确认 loop 还在;要旧行为就设CLAUDE_CODE_LOOP_KEEPALIVE=1。 - 走 LLM 网关或关了遥测、又在用 auto mode 的:2.1.319 起不再退回内置分类器,确认
/status里 auto mode server 的状态,必要时设CLAUDE_CODE_AUTO_MODE_SERVER。 - 无人值守的会话(CI、teammate)考虑开
permissions.denyInsteadOfPrompting,避免卡在权限提示上。 - 自托管 runner 依赖
CLAUDE_RUNNER_CHECKOUT_PATH目录结构的脚本,按「每个仓库一个文件夹」改。 - 开了沙箱、靠它免提示跑 Bash 的,升到 2.1.325 前加上
sandbox.autoAllowBashIfSandboxed: true,否则无人值守的会话会卡在提示上。定时任务和/loop用到带allowed-tools或 hooks 的 skill 的,把Skill(name)加进permissions.allow。 - 网关后面接非 Claude 模型或者模型 ID 不被识别的:2.1.323 起默认按 1M 窗口算,小窗口模型提前设
CLAUDE_CODE_DISABLE_1M_CONTEXT=1,或者用CLAUDE_CODE_MAX_CONTEXT_TOKENS给准确值。 - 想试 Code Mode:
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude,挑一个要改很多文件或要筛搜索结果的任务,Ctrl+O看它写的代码;记住恢复会话时也要开着这个变量。可以和 Codemode 调研 里的结论对照。 - 用 Fable 的:确认
/model已经是 Fable 5.2,留意 $8 / $40 的价格;日常任务按 Ben 的建议用 medium / low effort。 - 做插件的:在
plugin.json里加engines["claude-code"];用了subagentStatusLine或插件agent设置的,按 2.1.323 的移除 / 废弃调整。
待补充
- 11/13 之后的版本
- X(@ClaudeDevs / @bcherny / 社区)和 Reddit r/ClaudeCode 对本月改动的讨论,特别是 Code Mode 的实测和沙箱默认值的变化(11/15 搜了一次,还没找到像样的讨论)
- Ben's Bites 后续几期里和 Claude Code 有关的内容