Claude Code

TL;DR

2026-09-24 更新（v2.1.280 换默认模型 + v2.1.281 桌面安全控制）：两个版本，一件影响账单、一件影响企业部署。

① v2.1.280（2026-09-22）：默认 Opus 换成 Claude Opus 5.5。与 Anthropic 同日发布 Opus 5.5 同步——未显式指定模型的会话，默认模型与计费档位已变（$4/$20，缓存读 $0.20）。同时新增一项对工具作者很关键的设置：此前固定 2048 字符的 MCP 工具描述上限现在可覆盖，schema 写得比较啰嗦的 MCP 服务不再被迫砍描述。该版本信息来自第三方 release 汇总站，Anthropic 官方 CHANGELOG 请以 GitHub 仓库 为准。

② v2.1.281（2026-09-23）：桌面策略与跨账号 AWS。桌面策略块新增 blockReadsOutsideWorkingDirectories 与 disableBypassPermissionsMode 两项控制（并支持较新的 Claude Desktop key）；Claude Apps 网关的 Bedrock upstream 支持 assume role——网关通过 STS 担任 IAM 角色调用 Bedrock，可跨 AWS 账号，并可选「每开发者一个 session」；Bedrock upstream 新增 guardrail: {id, version} 以套用 Amazon Bedrock Guardrails。企业网关/多账号部署的团队值得重点看这一版。同为该第三方汇总来源，上线前请核对官方 Release Notes。

③ v2.1.282（2026-09-24，据官方 CHANGELOG 核对）：这一版的主线是「恢复与遥测的边界」，三项新增、三项变更值得单独记：

• 新增 maxProseWidth：宽终端下限制 Claude 散文（prose）的显示宽度，表格与代码块仍保持全宽——把终端拉满屏时正文不再被拉成超长行。
• 新增遥测可见性：启动通知 + /status 与 claude doctor 现在会列出项目设置文件里被忽略或已关闭的遥测变量。想知道「这个项目到底有没有在往外发数据」，现在有官方入口可查。
• 新增 allowClaudeInChromeWithManagedMcp 托管设置：允许 claude --chrome 与独占的 managed-mcp.json 同时运行（Chrome 被阻止时的报错会指名该设置）；网关侧新增 store.readiness_grace_seconds，让 /readyz 在 Postgres 短暂中断（如故障转移）期间继续保持 ready。
• 变更一：遥测关闭时，直连 Anthropic API 的会话 auto mode 默认改用服务端分类器（CLAUDE_CODE_AUTO_MODE_SERVER=0 可退出）。这与 2.1.280 的「本地分类器计费」是同一条线的延续——不想让 auto mode 走服务端的团队必须显式设这个变量。
• 变更二：项目级与本地级设置现在「忽略」会开启导出 / 设置端点 / 捕获内容的 OpenTelemetry 变量（如 CLAUDE_CODE_ENABLE_TELEMETRY、OTEL_LOG_*）。这是一条安全向的收紧：防止一个 clone 下来的仓库通过项目设置把遥测导出指到外部端点。如果你此前故意在项目 .claude/settings.json 里配了 OTel，升级后这项会静默失效，需要挪到用户级或托管级配置。
• 变更三：anthropic-skills 与 claude-ai 命名空间下的技能文件夹、命令文件、工作流命令「不再加载」；以该名称配置的 MCP server 也不再列出技能与提示（其工具仍可用）。依赖这两个命名空间做内部技能分发的团队，升级后会发现技能凭空消失，属于必须回归测试的一项。
• 修复侧关键三处：① 对话历史里含 API 无法解密的 Web 搜索结果时每个请求都 400——现在已修；② Claude 正在工作时用 /model、/rename、/artifacts 等即时斜杠命令会丢掉早期的 extended thinking，现在已修；③ 每次交互都报 Invalid data in redacted_thinking block 的会话，现在会丢弃思考块并重试一次。此外还有一批 vim 模式修复（>> 缩进空行、r 计数、dd/dj/dG 后光标落点、yy 不再移动光标等），以及恢复「从未压缩的超大会话」的时间优化——与 上下文压缩 配合看，长会话的体感会明显好转。

行动建议：升级到 2.1.280+ 后，显式指定模型（/model 或配置）再跑关键任务——默认模型静默变更会同时改变账单、延迟与输出风格；企业网关部署请把 v2.1.281 的权限与 guardrail 能力纳入安全评审；升级 2.1.282 后请重点回归三项：项目级 OTel 配置是否失效、anthropic-skills / claude-ai 命名空间的技能是否消失、auto mode 是否被切到服务端分类器。

v2.1.280 同批细节（2026-09-25 补录）：除换默认模型外，这一版还修了几处会直接影响「无人值守跑批」与「多 MCP 服务」两类场景的行为，值得单独记一笔：

• auto mode 不再死循环重试：此前当安全检查拒绝复核某个动作时，auto mode 会反复重试同一动作；现在只拒绝一次并明确提示「重试无用」。另一种情况——安全检查没有给出回答时——会退避重试，连续 10 次后停止本轮并给提示。跑无人值守任务的人，这条直接决定了失败时是「安静地烧钱」还是「干净地停下」。
• 符号链接写入的判定口径变了：过去写入一个符号链接路径时，按其在仓库内的拼写判断，于是 acceptEdits、allow 规则与 auto mode 可能批准一次落在仓库外的写入；现在提示会写明实际落点，且上述三种自动批准不再对落在树外的写入生效。
• agent 类型 hook 不再响应 PermissionRequest：改由 command / http 两类 hook 处理，误配会收到明确报错。把权限审批挂在 agent hook 上的团队，升级后审批链路会直接断掉，属于必须回归测试的一项。
• VS Code 侧新增四个对话入口：/status（版本、账号、模型、服务端详情）、/sandbox（沙箱模式、非沙箱回退与排除命令）、/export（导出会话为纯文本）、/plan（切到 plan mode）。其中 /sandbox 与 Agent 沙箱 的配置密切相关。
• 可观测性：hook_execution_complete 的 OpenTelemetry 事件新增 hook 输出体积与超限输出落盘数量两个字段。

本批细节依据 Claude Code 官方 CHANGELOG 的公开镜像整理，AI 之家 未逐条实测；升级前请以 GitHub 仓库 CHANGELOG 为准。

2026-09-27 更新（收尾额度 / graceful wind-down）：Anthropic 官方账号 @ClaudeDevs 于 2026-09-25 宣布：Claude Code 在任务中途触发 5 小时用量上限时，不再在编辑过程中一刀切断，而是尝试寻找一个优雅的停点，把手上这一步做完再停。额度从每周限额中扣除一小段固定时间，自动生效、不能申请、不能累积、不能挪用。

• 适用范围（官方列出两项）：Pro 计划每周一次；Max 与 Team Premium 计划每次触发 5 小时会话上限都可用。需要继续工作时可开 extra usage，按标准价格计费并受消费上限约束。
• 为什么值得单独记：长任务 Agent 最脏的失败不是做错，是做到一半被切断——三个文件已改、两个没改、测试是红的。收尾额度换的不是额度总量，是**「干净的停点」**。
• 口径提示：发布日在官方推文为 09-25、国内媒体 IT之家 记为 09-26 转发；版本归属 2.1.283 及二进制级实现细节（收尾提示原文、新增响应头、note 只在回合中途注入等）均来自第三方技术博客而非官方发布，本站未实测，标注为待核实。
• 配套习惯（决定收尾质量）：① 大任务先要一份 todo list（会被 checkpoint 保存，「完成当前步骤」才有具体对象）；② 按步提交而不是按任务提交——停在 4 个小 commit 之上才是干净的；③ 别在 90% 用量时启动大规模 fan-out（提示会阻止新开子 agent，但拦不住已在跑的 worker）；④ 开 extra usage 前先把消费上限设好。

详见 Claude Code 收尾额度资讯。

2026-09-28 更新（v2.1.283，据官方 CHANGELOG 核对）：企业模型管控 + 提示词审计

这一版的主线是「把模型选择的管理权从用户手里收回给管理员」，四项值得单独记：

• ① availableModelsMatch 托管设置：设为 "exact" 时，availableModels 里的一条只放行它写明的模型版本，新发布的版本在被列入之前保持封禁。这是对「升级 CLI 就顺带换了默认模型」的直接回应——金融、医疗这类要先过合规确认才能换模型的环境，这项才有意义。
• ② deniedModels 托管设置：可单独拦掉指定模型，即使它在 availableModels 白名单里。白名单管「默认放行什么」，黑名单管「绝对不许出现什么」，两者叠加时黑名单优先。
• ③ /doctor prompt-audit（别名 /checkup prompt-audit）：审计 CLAUDE.md、skills、agents、commands 里为旧模型写的提示词模式。模型换过几代之后，团队知识库里通常留着一批「请一步步思考」「不要编造文件路径」这类为旧模型弱点写的句子——不只是冗余，还会拖慢输出、挤占上下文。该命令会把陈旧路径、陈旧命令与互相矛盾的指令文件排在报告前面。
• ④ 可观测性两处：OTEL_LOG_TOOL_CONTENT=1 时，MCP 工具、WebFetch、WebSearch 的输出会写入 tool.output OpenTelemetry span 事件；新增 x-claude-code-prompt-id 网关提示头（需 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 开启），让 LLM 网关能把同一次用户提问产生的多个请求归组。

两处必须回归的修复：

• 托管沙箱设置的「整块失效」：此前 managed sandbox 设置只要有一个嵌套值非法，整块被忽略——管理员以为策略生效了，实际因为一个拼错的字段整体没加载，属于 fail open。现在非法值 fail closed，其余部分仍生效。2.1.282 已修了 permissions / autoMode / worktree / attribution 四处同类问题，2.1.283 补上 sandbox。
• claude-ai 名称保留被回退：2.1.282 保留了 claude-ai 名称，导致同名的 skills / commands / workflows 与 MCP prompts 被拦（见上一版）；2.1.283 恢复加载，且 Skill(claude-ai:*) 规则降级为普通前缀规则。上一版因此消失的技能，升级到 2.1.283 后应能重新加载。

另外两项小改动：/model 的 Opus 行与默认模型名去掉了「(1M context)」后缀（因为 Opus 本身已是 1M 上下文，上下文窗口没变，别误读成缩水）；屏幕阅读器模式下权限对话框不再把被引用的命令与路径读成对话框自己的文本。

口径提示：官方 CHANGELOG 的版本标题下不标注发布日期，本节日期为本站核对当日（2026-09-28）所见的最新版本，非厂商公布的发布日。详见 v2.1.283 企业模型管控资讯。

2026-09-30 更新（v2.1.284 + v2.1.285，据官方 CHANGELOG 核对）：Sonnet 5.5 默认化 + 供应商白名单

两个版本连着发，主线各一条。

① v2.1.284 —— 默认 Sonnet 换成 Claude Sonnet 5.5。官方条目原文：新增 claude-sonnet-5-5，成为 Anthropic API 上的默认 Sonnet 模型，1M 上下文、$2/$10、缓存读 $0.20。没有显式指定模型的会话，从这一版起跑的是 Sonnet 5.5 而不是 Sonnet 5——价格不变，但输出速度与每任务 token 都变了。同版还有四项值得记：

• auto mode 新增「Yes, but ask again next time」：读取工作目录外文件的提示，此前只有「永久允许」与「每次拒绝」两个极端；现在可以只放行这一次，下次继续问。
• 网关花费上限改为显示美元金额（如 $271.40 / $500.00 spent this month），状态栏 rate_limits.spend_limit 增加 used_usd / limit_usd / period。
• /mcp reconnect all：一次重连所有连接失败或需要认证的 MCP 服务，多 MCP 服务环境下最实用的一条。
• effort 滑块可重绑键位：新增 effortSlider:decreaseEffort / increaseEffort / toggleUltracode 三个 keybinding action。
• 修复「Prompt is too long」压缩后仍报错——现在会再压一次、保留更少近期对话。

② v2.1.285 —— allowedProviders 托管设置。这是继 v2.1.283 的 availableModelsMatch / deniedModels 之后，企业管控的第三块拼图：管理员可限制这台机器能用哪些 API provider（Anthropic API、自定义端点、Bedrock、Mantle、Vertex AI、Foundry、Claude Platform on AWS、Cloud 网关）。三者合起来才真正闭合——先限定能连哪个供应商，再限定能用哪些模型，最后单独否决具体版本。同版还有：

• CLAUDE_CODE_DISABLE_WEB_FETCH：环境变量级关闭 WebFetch 工具（此前只能靠权限规则挡）。
• claude --desktop：在当前目录打开 Claude 桌面应用，配合 --continue / --resume <id> 可续跑会话。
• claude plugin configure <plugin>：查看插件选项与未设项，或用 --values-stdin 从 stdin 写入配置。
• claude plugin install --config 支持 <server>.<key>=<value>，安装时就把打包 MCP 服务自己的配置写好，不必再进 /plugin → Configure。
• 修复：托管设置文件被系统拒绝读取时不再直接拒绝启动，改为告警并跳过该文件策略（其他读取错误与无法解析的文件仍会阻止所有会话）；Remote Control 附件下载失败会重试最多两次；切模型后仍沿用旧输出上限的问题。

行动建议：升级到 2.1.284+ 后，显式指定模型（/model 或配置）再跑关键任务——默认 Sonnet 已经从 5 换成 5.5；企业网关部署请复查 allowedProviders × availableModels × deniedModels 三者的组合是否符合策略；依赖 WebFetch 的流程，升级 2.1.285 后确认 CLAUDE_CODE_DISABLE_WEB_FETCH 是否被误设。同样提醒：官方 CHANGELOG 版本标题下不标注发布日期，本节日期为本站核对当日（2026-09-30），非厂商公布发布日。详见 Claude Sonnet 5.5 发布资讯。

2026-10-01 更新（v2.1.286，据官方 CHANGELOG 核对）：重试策略、--bare 语义与计费口径三处改动

这一版没有新模型，但有三条会改变既有脚本行为的变更，升级前值得先看。

• 变更一：失败请求的重试上限改成「整个模型调用共用一次配额」。 官方原文：一次失败的调用在默认重试设置下最多发 14 个请求（此前重试上限按分片计，实际请求数可能更多）。对跑批与 CI 的影响：超时与 5xx 的尾部耗时收敛了，但单次调用的重试预算变少，把 --max-retries 之类调高的脚本需要重估。
• 变更二：--bare 语义收紧。 现在 --bare 只连接命令行上点名的 MCP 服务、不给模型发 system reminders、不启动后台任务；且在 --bare 下，shell 命令到超时后直接停止，不再转入后台。用 --bare 跑无人值守脚本的团队必须实测这一条——此前「超时自动转后台」是很多长跑脚本的隐式依赖。
• 变更三：send-now（ctrl+enter）改为把 skill 自己的 shell 命令移到后台，而不是结束它；同理在 subagent 视图里 send now 会把该 subagent 正在跑的命令转后台，让消息立刻被读到。

三条值得记的可靠性修复：

• 模型被拒时自动回退一次：当 Anthropic API 拒绝你的默认模型或某个别名解析出的模型时，原来每一轮都会失败；现在会在同档位的上一代模型上重试一次。
• 登录凭据不再「群开浏览器」：多个 Claude Code 进程与 IDE 扩展在 gcpAuthRefresh / awsAuthRefresh 凭据过期时各自弹一个登录浏览器的问题已修；macOS 上「另一个窗口 /login 成功、本窗口仍显示 Not logged in」也一并修了（根因是残留的 ~/.claude/.credentials.json）。
• 网关花费计量两处算错：1 小时 prompt 缓存写入按更便宜的 5 分钟费率计价，以及跑 web search 等服务端工具的流式回合只计了第一次模型调用的输入 token——两处都会低估实际花费，用网关做成本归集的团队建议复核历史账单。

另外两项偏体验但实用：权限请求堆叠时显示「2 of 5」计数；项目或用户技能里若有名为 verify 的技能，Claude 会在提交前自动运行它（docs-only 与 tests-only 的提交除外）。还有一处安全向修复：组织策略关闭 Remote Control 后仍保持连接的会话，现在会断开并给出提示。

行动建议：升级 2.1.286 后立即回归三项——① 用 --bare 的无人值守脚本（超时不再转后台）；② 依赖重试参数的长跑任务（单次调用上限降到 14 个请求）；③ 有网关成本看板的团队复核 09-30 之前的账单是否因上述两处计量问题被低估。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节日期为本站核对当日（2026-10-01），非厂商公布发布日。

2026-10-07 更新（v2.1.287 ~ v2.1.292，据官方 CHANGELOG 逐条核对）：Claude Mods 上线 + 四个补丁版本连发

这是本站自跟踪 v2.1.x 以来单一窗口内版本最密集的一次（6 个版本 / 7 天），主线是「把 harness 变成可编程的控制平面」，紧随其后的是一轮回归冲刺。

① v2.1.287 —— Claude Mods：插件第一次能改「更深的行为」。 官方条目原文为 Added Claude Mods: plugins may now modify deeper behavior。Mods 是写在插件里的 TypeScript 钩子，按加载顺序依次执行，随 /plugin 安装的插件分发，CLI 与桌面端都生效。从官方条目与后续四个版本的钩子命名可以拼出它的能力面：

口径提示：上表「脱敏 / 改界面」两行的概括性描述来自二手转引（Ted Factory 2026-10-04 简报），官方 CHANGELOG 只以钩子名的形式出现，本站未逐条实测；钩子名一列均为官方原文。同理，二手来源称 Team / Enterprise 内置 sec-default mod 用于防止用户安装的 mod 绕过管理员权限规则，该说法未见于本站核对的 CHANGELOG 条目，标为待核实。

同一版还带来一个默认关闭的内建 mod：You should know，官方原文表述是「a built-in mod where a side agent watches your back and flags things you or Claude might miss」，开启命令为 /plugin enable cc-plugin-you-should-know@builtin，仅对第一方会话且遥测开启时可用。

② v2.1.288 —— 长会话与恢复（这一版基本是一份事故清单）。 修的都是长周期任务里最难复现、也最伤信任的问题：长会话在上一条回复报告零 token 用量时报 Prompt is too long 而不是自动压缩；--resume 丢掉刚由压缩恢复出来的文件与上下文；恢复后的会话不保存本轮最后一条回复（下一次 --resume 看到提问没有回答）；恢复 2.1.286 及更早开始的会话会丢掉模型早期的 thinking。同版新增 /code-review --max-findings <n>|all（可报告多于或少于默认上限的发现，直到显式传 default 才复位），以及 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS——走 Mantle 或会拒绝结构化输出的网关时，会话标题、记忆召回与 prompt 钩子此前会全部失败。详见 上下文压缩。

③ v2.1.289 —— 权限规则的边界。 主线是「复合命令里的 deny / ask 不再被绕过」：官方修了「复合 shell 命令中嵌套部分的 deny/ask 规则，在受管机器上盖不住用户安装的 mod 给出的批准」，以及 Read deny 规则此前不作用于通过符号链接 @-mention、改动或 IDE 选中的文件。凡是靠 deny 规则做合规边界的团队，这一版必须重跑一次规则验证。

④ v2.1.290 —— 给 mod 作者的可观测性。 turn.step 钩子结果新增 serverToolUses（API 自己跑的工具调用，即 advisor，含 id / name / input / 起止时间）；tool.check 事件新增 agentId（钩子可区分子 agent 与主会话的权限检查）与 ceiling。CLI 侧新增 claude attach <name> 与 claude logs <name>（会话名的一部分即可代替 id）。另外修了 WebFetch 静默丢弃超过 100,000 字符的页面正文——现在会说明有多少没读到，并接受 offset 续读。

⑤ v2.1.291（回归热修）：修 2.1.290 引入的「云会话丢权限答复」与 2.1.288 引入的「退出时丢掉会话最后几条消息」。

⑥ v2.1.292（当前最新）：三条影响面较大的变更——

• 本地（stdio）MCP 服务默认协商协议版本 2026-07-28，且包括 Bedrock、Vertex 与 Foundry 在内的每次安装都走新版本；不兼容的自建 MCP server 需显式设 MCP_PROTOCOL_NEGOTIATION=legacy 退出。另有兜底：启动时不响应新版协议检查的本地 server，在第一次慢连接后会被记住 7 天并走旧方式。
• Agent 工具新增 effort 参数，可指定子 agent 跑在哪个 effort 档；claude plugin install 新增 --marketplace <source>（按与 marketplace add 相同的策略检查补齐 marketplace 后再安装）。
• 一批安全修复：UNC 网络路径的文件读取此前可绕过权限提示与 auto mode；macOS / Windows 上读取 notebook 或 PDF 时，读取中途被替换的链接可以让它返回批准范围之外的文件；受管沙箱的 read-deny 路径在会话中途出现或改指向时，不会撤销其覆盖范围内的项目授权；rm -rf 对 8.3 短名等 Windows 别名写法的处理。

行动建议：① 用插件 / Mods 的团队请钉版本并回归——7 天 6 个版本、其中两个是回归热修，跟着 latest 跑风险很高；② 依赖 --resume 与长会话的脚本升到 2.1.288+；③ 自建本地 MCP server 的，升级 2.1.292 后先确认协议协商，不兼容就先设 MCP_PROTOCOL_NEGOTIATION=legacy；④ 走网关且被拒结构化输出的，用 CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS 兜底。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节日期为本站核对当日（2026-10-07），非厂商公布发布日。详见 Claude Mods 上线资讯。

2026-10-08 更新（v2.1.293，据官方 CHANGELOG 核对）：默认 Haiku 换成 Claude Haiku 5.5 + 一条「白干」级别的压缩修复

⑦ v2.1.293 —— 默认 Haiku 换成 Claude Haiku 5.5。官方条目原文：「Added Claude Haiku 5.5 (claude-haiku-5-5), now the default Haiku model on the Anthropic API — 1M context, $0.10/$0.50 per Mtok ($0.50/$2.50 for prompts over 100K)」。

这一条对账单的影响方式和此前的 v2.1.280（换默认 Opus）、v2.1.284（换默认 Sonnet）是同一类：没有显式指定模型的会话，跑的已经不是你以为的那个模型。三档默认模型至此全部换成 5.5 家族（Opus 5.5 / Sonnet 5.5 / Haiku 5.5）。注意 Haiku 5.5 是分档定价——单次输入越过 100K token 时，输入价从 $0.10 跳到 $0.50（5 倍）、输出从 $0.50 跳到 $2.50；如果你的子 agent 调用习惯塞很长的上下文，便宜的那一档可能拿不到。详见 Haiku 5.5 发布资讯。

同版还有两条值得单独拎出来的修复：

• ⭐ 压缩（compaction）之后 Claude 会把已完成的工作「撤销重做」。官方条目原文：「Fixed Claude sometimes treating its own last actions before a context compaction as done after it, and retracting or redoing finished work」。这是长会话里最昂贵的一类 bug——不是报错，而是悄悄把已经做完的活回滚或重复做一遍，账单翻倍且结果可能倒退。用长会话跑重构的团队，这一版建议优先升。
• HTTP MCP 连接的内存泄漏：官方原文 「an HTTP MCP connection kept every request it had sent until it closed」。长跑会话里挂了多个 HTTP MCP 服务的，内存会随请求数单调增长——这也是长会话 OOM 的一个常见嫌疑，升级后可排除。

其他与日常使用相关的条目：agentType 加入 subagentStatusLine 载荷（脚本现在能区分自定义子 agent 类型）；Mods 的 $.tool.register 新增 isDeferred（false 时工具 schema 从一开始就在 prompt 里，而不是藏在 tool search 后面）；单文件 cat / head / tail / sed -n / grep 看不到路径作用域规则与嵌套 CLAUDE.md 的问题已修（此前只有用 Read 工具才加载，用 Bash 看文件会漏掉项目指令）。

另有两项**回退（revert）**值得知道，避免按旧印象操作：① 撤回了 2.1.281 引入的「auto mode 拒绝消息称覆盖结果而不只是精确命令」的改法；② 撤回了 2.1.290 对「云会话在容器重启后丢失 /loop 唤醒或计划任务而一直休眠」的修复——该问题重新存在。

行动建议：① 升级后显式指定模型再跑关键任务，三档默认模型均已换代；② 跑长会话重构的务必升到 2.1.293，压缩后重做已完成工作这条直接影响成本与正确性；③ 用 HTTP MCP 且会话很长的，升级后观察内存占用是否回落。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；本版日期取自 GitHub Releases 的 tag 时间 2026-10-07T18:10:20Z，CHANGELOG 本身不写日期。

2026-10-09 更新（v2.1.294 + v2.1.295，据官方 CHANGELOG 逐条核对）：钩子「失败即放行」被修掉 + 终端状态协议

同一天（2026-10-08）连发两版，性质完全不同：前者是安全热修，后者是大批量稳定性收敛。

⑧ v2.1.294（热修）—— 写成自然语言指令的钩子会「放行它本该拦下的东西」。 官方两条原文：

• 「Fixed prompt and agent hooks written as instructions (such as "Block commands that...") allowing what they should block」
• 「Improved how prompt hooks on Stop and SubagentStop written as instructions (such as "Carry on if the build is broken") are judged, so Claude is less likely to stop early」

这条对把钩子当护栏用的团队是必修项：用「拦掉危险命令」这类自然语言描述写的 prompt / agent 钩子，此前可能判断失效、直接放行——你以为装了护栏，实际没有。升级后请回归一遍你的钩子规则（尤其是用大白话写、而非结构化 decision 输出的那些）。

⑨ v2.1.295（当前最新，143 项变更 / 89 项修复）—— 五条最值得记：

• ⭐ onFailure: "block"：命令与 HTTP 钩子新增该选项。官方原文 「a hook that can't start, times out, or exits with an unexpected code blocks the action instead of letting it through」。此前钩子自身崩溃 / 起不来 / 超时 = 检查被静默跳过、动作照常执行；现在可以失败即封闭（fail closed）：

  { "hooks": { "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "./check.sh", "onFailure": "block" }] }] } }
  

  
  凡是拦密钥泄露、拦危险命令这类不允许被跳过的钩子，都应显式加上它——这与 2.1.294 那条修复是同一条主线（护栏不能因为自己出错就变成摆设）。
• 终端状态协议 OSC 7501：官方原文 「Added Program Status Protocol (OSC 7501) support: terminals that implement it can show whether Claude Code is working, waiting on you, or done」。支持该协议的终端（iTerm2、Ghostty 系等）可在标签页标题 / 状态栏直接显示「干活中 / 等你输入 / 完成」，不用再靠猜窗口内容。它走现有 pty，SSH 场景也能用。
• CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS：给无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）等 429 / 529 的等待时间设上限。跑定时 / 批量任务的，这条能防住「一个任务卡在无限退避里、下个 cron 又起一个」的叠加。
• MCP 工具描述长度上限 2,048 → 16,384 字符（走 tool search 加载的那批）——此前被截断的长描述现在能完整进 prompt。
• MCP 稳定性一批：远程 MCP server 断线超过 15 秒后不再一直连不上、也不会对「连上就断」的服务死循环重连（退避上限 30s）；MCP 工具返回的 CSS / JS / XML 不再被存成 .bin（Read 工具此前拒绝读）。

⑩ 另一条容易被忽略但影响互操作：官方 「Changed claude.ai connectors to negotiate MCP protocol version 2026-07-28 by default on installs that fetch no flags; MCP_PROTOCOL_NEGOTIATION=legacy opts out」——claude.ai 连接器默认协商 2026-07-28 版 MCP 协议，与 2.1.292 那批 CLI 侧协议协商是一致的口径（见 MCP）。不兼容时用 MCP_PROTOCOL_NEGOTIATION=legacy 退出。

行动建议：① 用了 prompt / agent 钩子的，升到 2.1.294+ 并回归一次规则有效性；② 把护栏钩子显式加上 onFailure: "block"，别再让「钩子自己挂了 = 放行」；③ 跑无人值守 / 定时任务的，设 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 防任务叠加；④ 挂远程 MCP 且遇到过断线后连不上的，升 2.1.295。详见 v2.1.295 钩子「失败即封闭」资讯。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；2.1.294 / 2.1.295 的日期取自第三方发布汇总站标注的 2026-10-08（CHANGELOG 与 GitHub Releases 均未给出厂商公布发布日），非厂商官方公布日期，如与官方口径冲突以官方为准。

2026-10-10 更新（v2.1.296，据官方 CHANGELOG 逐条核对）：企业管控延伸到 Claude Desktop，另外有一条会直接挡住中文老项目的改动

⑪ ⭐ 编辑非 UTF-8 文件会被直接拒绝——GBK 被官方点名。 官方原文：

Fixed Edit and NotebookEdit replacing every non-ASCII character in files that are not valid UTF-8 (Windows-1252, Shift-JIS, GBK); such edits are now refused

这是本版最可能影响国内团队的一条行为变更：此前对这类文件做 Edit / NotebookEdit，每一个非 ASCII 字符都会被替换掉——中文注释、日文字符串、Windows-1252 编码的遗留资源文件，改一次就全毁。现在这类编辑被直接拒绝（而不是「改坏」）。

行动建议：维护 GBK / Shift-JIS 老仓库的，升级 2.1.296 后会碰壁——这不是 bug，是新行为。先把文件转 UTF-8 再交给 agent 改，否则编辑会失败。此前已经被 2.1.295 及更早版本「改坏」过的文件，不要指望这条修复能回滚，请从版本控制里恢复。

⑫ 企业管控延伸到 Claude Desktop 的 Code 页签。 官方原文 「Added a code key to the Claude apps gateway's managed.policies[]: the same settings as cli, also applied in Claude Desktop's Code tab」——同一份托管策略现在能同时管 CLI 与 Desktop 的 Code 页签，desktop 键之外新增 code 键。对已经在用托管策略做统一管控的组织，Desktop 侧不再是监管盲区。同版还修了 2.1.295 引入的一个回归：托管设置里 forceLoginMethod: gateway 但未配 forceLoginGatewayUrl 时，已保存的网关登录被忽略。

⑬ 子 agent 可以比主会话更早自动压缩。 新增 autoCompactWindow（写在子 agent frontmatter 或 --agents 定义里）。配合 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL（让所有 workflow agent 跑在同一个模型上，其他子 agent 保留各自模型），长任务编排的成本与上下文窗口终于可以分开调了。

⑭ Read 工具新增 allow_large 选项：上下文还有空间时，一次读完超大文本文件（突破常规体积限制），不再需要分段读。

⑮ 插件 / Mod 侧一批原型污染类加固：constructor / prototype 命名的插件密钥会在下次保存时被删掉的问题已修；$.agent.register 在 mod 已被重载或移除后仍从其钩子里调用成功的情况现在会被拒绝；$.http.fetch 对 Content-Length 超过 4 MiB 限制的 HEAD 请求不再误拒。写 Mod 的团队请注意：这类修法的方向是「收」不是「放」。

⑯ Windows 四条值得单独看：PowerShell 命令超过约 1 KB 就一律要审批的问题已修，allow 规则与只读检测现在适用到 32 KB；stdio MCP server 不再被强杀（先关 stdin，300 ms 后才杀进程树）；无 GitHub SSH key 的机器装 owner/repo 插件时，clone 会改用 HTTPS 重试；Git Bash 里 rm -rf /c/Users/<name> 在 bypass permissions 模式下不再不询问——最后一条是安全相关，此前可能绕过审批直接删。

⑰ 其他值得一提：CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 让 529 过载重试的最大退避可配；Bash 权限检查此前会自动批准某些先赋值 BASH_ARGV0 再使用的命令，现在改为提示确认；Haiku 5.5 等只支持 adaptive thinking 的模型在部分网关后的 token 计数已修；/code-review 在云会话 / Agent SDK / IDE 集成里不再吐裸 JSON 数组，改为编号列表。

行动建议：① 维护非 UTF-8 老仓库的先转码（见 ⑪，本版最大的行为变更）；② 用托管策略的加 code 键把 Desktop Code 页签一起管起来；③ 长任务编排加 autoCompactWindow 与 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL 分开调成本；④ 用 bypass permissions 模式的 Windows 用户，升级后 Git Bash 的 rm -rf 会重新要确认，别以为工具坏了。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；v2.1.296 的日期取自第三方发布汇总站标注的 2026-10-09，CHANGELOG 与 GitHub Releases 均未给出厂商公布发布日，非厂商官方公布日期。

2026-10-16 更新（v2.1.299 / v2.1.300 / v2.1.301，据官方 CHANGELOG 逐条核对）：空闲自动压缩、Mods 拿到改写权，301 是一轮大范围修复

先看一个不同寻常的版本序列问题：官方 CHANGELOG 里 2.1.297 与 2.1.298 两节缺失——从 2.1.299 直接跳回 2.1.296。本站未获知缺失原因（可能是内部版本或已回滚），在此声明并明确不作推断。

v2.1.299 —— 空闲自动压缩，卡在一小时缓存过期之前。 官方原文要点：会话 ≥200K token 且空闲约 54 分钟后自动压缩。为什么是 54 分钟：一小时 prompt cache 过期之前——压缩动作本身还吃得到缓存价，而不是等缓存失效后按全价重算。可调：CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 改 200K 这个阈值，settings.json 里 "idleCompaction": false 关掉（两者都要求 v2.1.290 及以上）。

代价必须写清楚：压缩是有损的（见 上下文压缩），而空闲压缩触发时你不在场，无法像手动 /compact 那样先确认保留什么。依赖会话内原始产出的场景建议关掉它（"idleCompaction": false），把它当成「省钱开关」而不是「默认正确」。

v2.1.300 —— Mods 从「能拒绝」升级到「能改写」。 agent.spawn 钩子从此可以改写工作流 agent 的 prompt 与 model（此前只能拒绝）；新增 prompt.change 钩子（prompt 框文本被非键入方式改动时触发：历史回填、清空、撤销、插件填充）。同时收紧的一面：updatedInput（PreToolUse / PermissionRequest 钩子改写后的入参）现在按 Claude 自己的输入校验——未知键会被丢弃，工具本身拒绝的输入会直接拒掉这次调用。写过 hook 的团队升级后要回归一遍自己的 PreToolUse 改写逻辑。可观测性同步补齐：api_request 事件新增 cache_creation_5m_tokens 与 cache_creation_1h_tokens（缓存写入按生命周期拆开统计），trace span 新增 GenAI 语义约定属性。

v2.1.301（当前最新）—— 一轮覆盖面很广的修复版。 五条最值得记：

⑱ 跨模型切换的成本保护：「Fixed a case where switching to a model with a smaller context window could spend usage credits on a summary by the previous model without asking first」，且 Improved 一条进一步说明——会话太长装不进新模型时，先由旧模型做摘要。另有 「Fixed conversations being compacted over and over, on a model you didn't pick, behind an LLM gateway whose responses name a different model than the one requested」——走网关的团队注意：此前可能出现「反复压缩 + 用了一个你没选的模型」。

⑲ Read 工具不再把二进制当文本读：.xlsm / .parquet / .epub / .heic 等此前会被当文本读入（#大量 token 换来一堆乱码），现在修了。

⑳ Grep / Glob 失败不再静默报「无匹配」：此前搜索程序异常退出时会报告 0 结果——这是一类极其危险的静默失败（你会以为「确实没有」，实际是没跑成），现在会返回错误说明搜索失败。

㉑ 退出时可能删掉未推送提交的 worktree：WorktreeCreate 钩子创建的 worktree，若可能含未推送提交，退出时不再不问就删。

㉒ /rewind 之后 skills 不再从模型可见列表里消失；工作流脚本在同一会话里经 Bash cd 后被读 / 改 / 重跑时不再莫名要权限或被拒。另有一批终端兼容性修复（VTE < 0.53 的 >0q / >4m 乱码、iTerm2 的 GOK 杂串）。

同版还有三条能力新增：vim 模式 % 跳转匹配括号、mod Input 新增多行 rows 字段、CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS（无人值守重试遇到重置时间过远的用量上限时直接结束而不是干等）；VS Code 侧新增 LaTeX 数学渲染。

行动建议：① 依赖会话内原始产出的，把 idleCompaction 关掉；② 写了 PreToolUse / PermissionRequest 钩子改写入参的，升到 2.1.300+ 后必须回归一次（未知键会被丢弃）；③ 走 LLM 网关的，升到 2.1.301 并确认网关返回的模型名与请求一致，避免被反复压缩；④ 脚本里依赖 Grep / Glob 「0 结果」分支的，升级后要能处理新的报错路径——此前你的「没有匹配」可能一直是假的。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节「2026-10-16」为本站核对当日（299/300 于 10-15 核对、301 于 10-16 核对），非厂商公布发布日。详见 v2.1.299 / v2.1.300 资讯。

2026-10-17 复核（版本序列，一手）：重取官方 CHANGELOG 原文，当前最新版本仍为 v2.1.301，未见 2.1.302 及以上版本；2.1.297 与 2.1.298 两节仍然缺失（版本头序列为 2.1.301 → 2.1.300 → 2.1.299 → 2.1.296 → 2.1.295 …）。缺失原因本站仍未获知，继续不作推断——这是本站连续第二次复核确认同一现象，若后续官方补齐或给出说明，将回炉本节。

2026-10-18 更新（v2.1.302，据官方 CHANGELOG 逐条核对）：独立版 Claude Design 关停日期首次出现，fork 子代理铺到全部入口

先纠正本站上一条已被推翻的陈述：上文「2026-10-17 复核」称「未见 2.1.302 及以上版本」，该陈述已于本次核对被证伪——官方 CHANGELOG 中 2.1.302 一节确已存在，GitHub Releases 记录的 tag 时间戳为 2026-10-16T20:53 UTC（即本站 10-17 复核时该版本实际已发布，属本站漏检）。这是本站第二次出现「版本序列推断被证伪」的情形（前一次见 Gemini CLI v0.64.0 资讯），判据随之修正：核对版本序列必须同时取 CHANGELOG 与 GitHub Releases 两个来源，只取其一会漏。2.1.297 / 2.1.298 两节仍然缺失（本次为连续第四次复核确认），原因依旧未获知，不作推断。

㉓ 独立版 Claude Design（claude.ai/design）将于 2026-12-14 关闭。 官方原文：「Added a notice to /design-sync and /design-login that standalone Claude Design (claude.ai/design) closes by December 14, 2026」。官方未说明关停后设计能力是否并入其他产品线、是否提供数据导出或替代路径，本站不作推断，列入待核实。依赖 /design-sync 的设计→开发流程请按 12-14 这个截止日安排迁移。

㉔ fork 子代理默认开启，范围从终端扩大到 claude -p / Agent SDK / 桌面端 / VS Code。 官方原文：「Changed fork subagents (subagent_type: "fork") to be on by default in claude -p, the Agent SDK, the desktop app and VS Code, as they already are in the terminal」；CLAUDE_CODE_FORK_SUBAGENT=0 关闭，claude mcp serve 永不提供。同版还改了两点执行模型：桌面端与 VS Code 的主会话子代理一律后台运行（不再由 Claude 自己决定），而子代理自己发起的 Agent 调用在上述入口中默认前台运行。

㉕ 空闲压缩拿到可见开关。 /config 新增 Idle compaction 行，可关闭或重新打开 2.1.299 引入的空闲自动压缩；空闲压缩之后的提示现在会说明怎么关掉它。默认仍是开启——本站对 2.1.299 那条的建议不变：依赖会话内原始产出的场景请关掉它（settings.json 里 "idleCompaction": false）。

㉖ 新增 CLAUDE_CODE_AUTO_MODE_MODEL：指定客户端 auto mode 分类器使用的模型。官方明确它 does not change the model for server-side auto mode——想靠它调整服务端 auto mode 的成本会落空。

㉗ 图片读取加了 128 MB 硬上限。 官方原文：Read 工具此前会把任意大小的图片文件、或名字像图片的管道 / 设备文件整个读进内存；图片源超过 128 MB 现被拒绝。这是内存安全修复，不是功能删减。

一批不写在标题里但会咬人的修复（按影响面排序）：

另有一条行为变更：claude -p 与 Agent SDK 在「无权限模式 + 遥测关闭或全新安装」的第三方 provider 会话中改为以 default 模式启动（--permission-mode auto 仍保留 auto）。

行动建议：① 用 /design-sync 的团队按 2026-12-14 排迁移；② claude -p 脚本升级后回归一次——主会话子代理改为一律后台，等待逻辑可能失效；③ 依赖会话内原始产出的，到 /config 的 Idle compaction 行关掉压缩（现在终于有 UI 入口了）；④ 项目放在 exFAT / FAT32 盘上的 Windows 用户，升级 2.1.302 后才可正常写入；⑤ 装了 Git 2.56+ 且用 worktree 并行的，本版修了游离 .git 导致的创建失败。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；本节 2026-10-16T20:53 UTC 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 v2.1.302 资讯。

2026-10-19 更新（版本复核 + 一轮不在 CHANGELOG 里的性能改动）：stable 仍为 v2.1.302，gzip 默认压缩与云会话预热带来首 token 等待大幅下降

版本复核（一手，GitHub Releases API + 官方 CHANGELOG 双源）：截至 2026-10-19，最新 stable 仍为 v2.1.302（tag 时间戳 2026-10-16T20:53:06Z），未见 2.1.303 及以上版本；2.1.297 与 2.1.298 两节仍然缺失（本站连续第五次复核确认同一现象），原因依旧未获知，继续不作推断。沿用既有的双源判据：只取 CHANGELOG 或只取 Releases 都会漏。

㉘ 自 v2.1.300（2026-10-14）起，发往 api.anthropic.com 的大请求默认 gzip 压缩，遥测关闭时同样生效。 这一条不在官方 CHANGELOG 的功能标题里，但对应的官方议题是 #90457「Compress API request bodies with gzip by default」（创建于 2026-08-28，状态 open）；CLAUDE_CODE_GZIP_REQUEST_BODIES=0 可关闭。原因很直白：Claude Code 每一轮都会把完整对话、文件片段与工具定义重新上传，长会话单请求常达数百 KB 至 1 MB 以上，上行链路窄的环境最吃亏。gzip 压的是线路上的字节，不是计费 token——它省时间，不省钱。

㉙ 配套的延迟数字（官方 X 账号 ClaudeDevs 公布，四家二手转录一致）：本地会话首 token 前等待 p90 从 4.07 秒降到 1.33 秒（约 3 倍），云会话 16.99 秒 → 6.00 秒（约 2.8 倍），网页版与 Cowork 3.36 → 2.17 秒，API p50 首 token 时间 1.53 → 1.01 秒。前三组不含模型计算时间，API 那组含——不可横向比较。 详见 延迟优化资讯。

㉚ 一条对国内与云厂商接入用户最关键的限定：官方 issue #103218「Opt-in gzip request bodies for Bedrock, Vertex and custom base URLs」 仍处于 open 状态——即默认 gzip 目前落在 api.anthropic.com 这一条路上，走 Amazon Bedrock / Google Vertex / 自建网关 / 第三方中转的很可能仍在发送未压缩请求体。本站的措辞保留：issue open 不等于功能一定未实现（议题可能在实现后未关闭），本站未逐行核对源码确认最终落地状态，故此处只作提示并列入待核实。

行动建议：① 升级到 2.1.300 及以上才有默认 gzip；② 走企业代理 / 网关的团队，请验证中间设备能处理 gzip 请求体，出问题时用 CLAUDE_CODE_GZIP_REQUEST_BODIES=0 关掉对比定位；③ base URL 不是官方域名的（Bedrock / Vertex / 中转），不要照 1.33 秒设预期；④ 有成本对账需求的组织注意：云会话改为「开始打字即预热」，会为未提交的 prompt 起算力。

2026-10-20 更新（v2.1.303，CHANGELOG + GitHub Releases 双源核对）：一个只写了「修复与稳定性改进」的版本，以及 2.1.297 / 2.1.298 第六次确认缺失

先纠正本站上一条已被推翻的陈述：上文「2026-10-19 更新」称「未见 2.1.303 及以上版本」，该陈述已于本次核对被证伪——GitHub Releases 中 v2.1.303 已存在，tag 时间戳为 2026-10-18T22:26:54Z 且 prerelease: false；也就是说本站 10-19 复核时该版本已发布约 20 小时，属本站漏检。这是本站第三次出现「版本序列推断被证伪」的情形（前两次见 Gemini CLI v0.64.0 资讯 与本站 10-18 更正），判据维持不变：核对版本序列必须同时取官方 CHANGELOG 与 GitHub Releases 两个来源，并以 Releases 的 prerelease 字段判定 stable，不要看 tag 名有没有后缀。

㉛ v2.1.303（当前最新 stable）在官方 CHANGELOG 里只有一行：「Bug fixes and reliability improvements」；GitHub Releases 的同名条目正文同样是这一句话。官方未逐条列出本版改动，本站因此不对改动内容作任何断言，也不转录任何第三方猜测。

这条本身值得记一笔：Claude Code 的版本节奏是「功能密集期」与「收敛期」交替出现的——2.1.299 / 300 / 301 属于前者，2.1.303 是典型的收敛版。看到纯修复版不必等解读，但也不该顺势假设它「什么都没改」：官方不列条目的直接后果是变更面无法从公开渠道枚举，钉版本 + 自己回归是唯一稳妥的做法。

㉜ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第六次复核确认）：当前 CHANGELOG 的版本头序列为 2.1.303 → 2.1.302 → 2.1.301 → 2.1.300 → 2.1.299 → 2.1.296 → 2.1.295 …。缺失原因本站仍未获知，继续不作推断；若官方后续补齐或给出说明，将回炉本节。

行动建议：① 跑生产的钉到 v2.1.303（当前最新 stable），并保留上一个已知良好版本以便回滚；② 不要因为「只有一行 Bug fixes」就跳过回归——官方不列条目等于变更面不可枚举；③ 仍在等 2.1.297 / 2.1.298 内容的，截至本次核对官方仍未补齐，不要按这两个编号规划排期。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；本版 2026-10-18T22:26:54Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。

2026-10-21 更新（v2.1.304，CHANGELOG + GitHub Releases 双源核对）：/auto-mode-setup 上线 + Code Review 三档强度 + 两处会丢数据的删除路径被修

先纠正本站上一条已被推翻的陈述：上文「2026-10-20 更新」把 v2.1.303 称作「当前最新 stable」。该陈述已于本次核对被更新——GitHub Releases 中 v2.1.304 已存在，tag 时间戳为 2026-10-19T21:34:39Z 且 prerelease: false。这是本站第四次出现「版本序列被后续版本追上」的情形，判据维持不变：核对版本序列必须同时取官方 CHANGELOG 与 GitHub Releases 两个来源。

㉝ 新增 /auto-mode-setup：一次引导式配置，读取你的项目与近期会话来教 auto mode 认识你的环境。官方原文写明它 "now also available on Bedrock, Vertex, Foundry, Claude apps gateway and telemetry-disabled sessions"——覆盖面已扩到企业平台与关闭遥测的会话。auto mode 此前最大的问题就是"它不知道你的项目是什么"，这一条是官方给出的答案。

㉞ Code Review 支持三档强度，且可按仓库单独设置：组织所有者可在 Quick / Standard（默认）/ Deep 之间选，并给单个仓库单独设档；另新增**覆盖整个 GitHub 组织所有仓库（含以后新建的）**的选项。同批还修了一个静默失败——管理员刚打开 Code Review 一两分钟内创建的 PR 会被无声跳过，现在会重试并补评审。

㉟ 两处会丢数据的删除路径被修（本次最该立刻升级的理由）：

㊱ Pro / Max 恢复旧会话会先给警告：当恢复一个非活跃会话会吃掉 5 小时用量上限里"可观的一部分"时，提示你继续恢复或开新会话——官方称开新会话后你提到上一个会话时 Claude 能自己去找。

㊲ Mods 的权限模型再收紧：tool.check 的答复新增 decider: "person"（只有权限对话框或宿主回调能批准，无人可问时按 mod 给出的理由拒绝），事件新增 e.isReadOnly；settings.read 钩子改为收到每一层配置并重写合并结果，于是受管 mod 可以把组织的某项配置变成"上限"。

㊳ 其他值得知道的：CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k 此前会静默设成 100K，现在接受 k / M 后缀并会警告越界；自定义 ANTHROPIC_BASE_URL 后面 tool search 改为默认开启，网关返回 400 / 422 时自动去掉该字段重试；修了 LLM 网关后的 context_management: Extra inputs are not permitted 报错；agent teams 里在主会话批准关闭请求不再把整个 CLI 一起退出；Windows 上直接调用 Git for Windows 的 git.exe，git 命令启动更快；Opus 5.5 的 /fast 对话框标题去掉了"(research preview)"标签。

㊴ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第七次复核确认）：当前 CHANGELOG 的版本头序列为 2.1.304 → 2.1.303 → 2.1.302 → 2.1.301 → 2.1.300 → 2.1.299 → 2.1.296 → 2.1.295 …。缺失原因本站仍未获知，继续不作推断。

行动建议：① 立刻升级——尤其是用 git worktrees 跑并行 agent 的团队，"HEAD 分离时退出即删"恰是该工作流的高发状态；② 升级后先跑一次 /auto-mode-setup 再依赖 auto mode；③ 用 Code Review 的组织本周把每仓库档位配一遍，别等默认 Standard 跑满一个月才发现账单价；④ 走 LLM 网关且遇到过 context_management 报错的，本版已修。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；本版 2026-10-19T21:34:39Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 v2.1.304 资讯。 2026-10-22 更新（v2.1.305 / v2.1.306，官方 CHANGELOG + GitHub Releases 双源核对）：一个 2.1.304 自己的功能回归被当场修掉，沙箱、Workflow 续跑与 /usage 同批变化

先更新本站上一条已被后续版本追上的陈述：上文「2026-10-21 更新」把 v2.1.304 称作「最新 stable」。该陈述已于本次核对被更新——GitHub Releases 中 v2.1.305（tag 时间戳 2026-10-20T20:46:50Z）与 v2.1.306（2026-10-21T03:16:31Z）均已存在且 prerelease: false。这是本站第五次出现「版本序列被后续版本追上」的情形，判据维持不变：核对版本序列必须同时取官方 CHANGELOG 与 GitHub Releases 两个来源。

㊵ v2.1.305 的头号条目是修 2.1.304 自己引入的回归。 官方原文：「Fixed every request failing on Vertex, Bedrock and other providers when the endpoint or a gateway rejects tool search, and behind gateways with ToolSearch disallowed or left out of --tools (a 2.1.304 regression): Claude Code now retries without it」。结合上文 ㊳ 那一条——2.1.304 让自定义 ANTHROPIC_BASE_URL 后面 tool search 默认开启——实际后果是：在 Vertex / Bedrock / 各类 LLM 网关后面，每一个请求都可能失败；2.1.305 的处置是被拒时自动去掉 tool search 重试。这条值得单独记：2.1.304 那版写的「网关返回 400 / 422 时自动去掉该字段重试」只兜住了部分场景，真正兜住是在 305。走自建网关 / 第三方中转 / 云厂商接入的团队，请务必升到 v2.1.305 及以上。

㊶ 沙箱侧开了一个口子，同时官方把代价写在了同一句话里：新增 sandbox.allowNestedUserNamespaces，让沙箱内的命令可以在 Linux 上创建 user namespace（官方点名 Chromium 与 rootless podman 这两类需求），并直说这会绕过沙箱的文件保护。也就是说这是一个显式降低隔离强度的开关，不是白拿的兼容性改进——请按安全决策处理，不要按 Compat 开关处理。

㊷ 长任务链路上的两条状态 bug 被修：① Workflow 续跑不再重跑已完成的 agent——此前 resume 会把 journal 里标记为已完成的 pipeline() / parallel() agent 重新执行一遍，现在直接从 run 的 journal 取结果；② 云会话与 teammates 在压缩不得不丢掉最老消息时，不再瞒着 Claude——此前 Claude 并不知道拿到的摘要是不完整的。

㊸ /usage 从「列数字」变成「给修法」：每条警告改为一个指明来源的单行修复建议，按 f 可直接套用，同样的修法在 VS Code 与 /doctor 里同步出现。同批还把 MCP 同意对话框改成「给 prompt 的回车不容易被误判为 Accept」，并把启动警告从 logo 上方的裸文本收进 debug 日志（不限制任何东西的权限规则改为在 banner 下以警告行显示）。

㊹ 其余值得知道的（均为官方 CHANGELOG 原文）：新增 CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS，让无人值守重试模式能察觉在自己重试之前就已解除的用量上限；修了 /effort 与 /autocompact 在模型名与 modelOverrides 值仅大小写或 [1m] 标签不同时不生效；修了裸仓库里的新 worktree 从本地 HEAD 而非默认分支起、以及未改动的 subagent worktree 有时不被清理；ENOSPC 报错从裸文件路径改成「磁盘已满且什么都没执行」；云会话或 SDK 的 setMcpServers 传入的 MCP server 不再在会话中途被同名配置顶掉；子代理切到 fallback 模型后不再报出原名；受管 mod 的 docked pane 限制在终端宽度 45% 以内；allowedMcpServers 不再过滤只在 env 里用 ${VAR} 的 managed-mcp.json stdio server——升级后白名单漏掉的会加载，要继续拦截请改用 deniedMcpServers；Claude Desktop 按路径挂载的插件，在组织设置了 allowManagedPermissionRulesOnly 时不再保留其 allowed-tools；/artifacts 的删除确认改为 1 或 Enter 保留、2 删除、Esc 取消，y / n 不再应答。

㊺ Code Review 再修两条：PR 评审期间有多次 push 时不再漏审最新 commit；重评审时更早的 blocking 结论还开着的情况下不再以 LGTM 开场。

㊻ v2.1.306（当前最新 stable）只有两条，但都落在出错现场：① 修了云会话里不带会话环境变量启动 claude -p 时报「Not logged in」；② 修了 MCP 工具很多的会话里，真实的 API 错误被换成「prompt is too long」，并触发一次不必要的压缩。第二条尤其阴——报错本身是错的，还会顺手把上下文压掉一轮，排查方向会被彻底带偏；看到「prompt is too long」但工具很多时，先升到 2.1.306 再判断是不是真超长。

㊼ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第八次复核确认）：当前 CHANGELOG 的版本头序列为 2.1.306 → 2.1.305 → 2.1.304 → 2.1.303 → 2.1.302 → 2.1.301 → 2.1.300 → 2.1.299 → 2.1.296 → 2.1.295 …。缺失原因本站仍未获知，继续不作推断；若官方后续补齐或给出说明，将回炉本节。

行动建议：① 走 Vertex / Bedrock / 自建网关 / 第三方中转的团队，立刻升到 v2.1.305 及以上——2.1.304 在这条路上可能让每个请求都失败；② 用了 allowedMcpServers 白名单的组织，升级后请复核一次 MCP 加载清单（${VAR} 那条改动会让此前被过滤的 server 上线，需要继续拦截请改 deniedMcpServers）；③ 跑 Workflow / pipeline 编排的，305 之后 resume 才真正幂等，此前重跑已完成 agent 会重复消耗与重复副作用；④ 看到「prompt is too long」而工具很多时，先升 2.1.306；⑤ 想开 sandbox.allowNestedUserNamespaces 的，把它当安全决策——官方明写它会绕过沙箱文件保护。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期；本处 2026-10-20T20:46:50Z 与 2026-10-21T03:16:31Z 均取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。

2026-10-23 更新（v2.1.307 / v2.1.308 / v2.1.309，官方 CHANGELOG + GitHub Releases 双源核对）：API 版本可切换，护栏有了审计事件，309 一口气补掉六条沙箱绕过路径

㊽ 三天三个版本：v2.1.307（tag 2026-10-21T22:17:02Z）、v2.1.308（2026-10-22T04:34:55Z）、v2.1.309（2026-10-22T22:18:57Z），prerelease 均为 false，v2.1.309 是当前 stable。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，上列时间取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。

㊾ v2.1.307 的两条 feat：

• /claude-api api-version：官方原文 「Added /claude-api api-version to move Claude API code to API version 2026-10-21」。API 版本不再硬编码，有合规钉版需求的企业有了官方切换入口。
• ⭐ claude_code.safety_event：官方原文 「Added the claude_code.safety_event OpenTelemetry event for each tool call a permission rule, auto mode, a safety check, a hook or the sandbox stopped, prompted or sent back」。这是护栏的第三块拼图——把「谁拦了什么」变成可观测事件，覆盖权限规则 / auto mode / 安全检查 / 钩子 / 沙箱五种来源，区分**拦下（stopped）、提示（prompted）、放行（sent back）**三种结果。对照本站记录的演进：2.1.294 修「钩子自己出错时静默放行」 → 2.1.295 给 onFailure: "block" 让失败即封闭 → 2.1.307 补「拦了要有记录」，三者合起来才是完整闭环：会拦 → 拦不住时不放行 → 拦了留痕。
• 其余 fix 里两条影响面较大：prompt-caching-scope beta header 不再发到自定义 ANTHROPIC_BASE_URL 网关与 Foundry（官方点明这两处该 header "has no effect"）；HTTP MCP 工具调用不再重复发送——连接中途关闭时只对只读或幂等工具重试。后者对非幂等写操作是实打实的安全改进。

㊿ v2.1.308 官方只有一句「Bug fixes and reliability improvements」，未逐条列出——本站不对该版内容作任何断言。

㊱ v2.1.309 是沙箱收口版：官方条目全为 fix，但至少六条指向同一件事——沙箱开了，但有一条路能绕出去：

㊲ 另三条值得记：① 禁用的 MCP server 不再被权限提示重新连上（claude -p 与 SDK 会话）——「禁用了但又能用」是管控配置最危险的失效形态；② 超大嵌套 CLAUDE.md 导致会话反复压缩已修，超限的嵌套 CLAUDE.md 现在只加载开头——这是行为变更：依赖深层嵌套 CLAUDE.md 传内容的团队，升级后会发现后面的内容不生效；③ profile store 写保护在配置目录经 symlink 到达时不生效，已修。

㊳ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第九次复核确认）。缺失原因本站仍未获知，继续不作推断。

行动建议：① 生产钉 v2.1.309，保留上一已知良好版本；② 用了 --mcp-config 传配置的，升级后回归一次（本版改了该文件可写性）；③ 依赖深层嵌套 CLAUDE.md 的，检查是否有内容因超限被截断；④ 用了 claude_code.safety_event 的，确认你的 OTel 采集端能接住新事件类型。把「沙箱绕过路径」当作需要定期复核的清单，不要一次配好就放心——本版六条修复说明这类洞是持续出现的。详见 v2.1.307~309 资讯。

2026-10-25 更新（v2.1.310，官方 CHANGELOG + GitHub Releases 双源核对）：Monitor 工具补齐到 Bedrock / Vertex / Foundry，网关拒绝 effort beta 值不再全量失败

㊴ v2.1.310 于 tag 时间戳 2026-10-23T23:39:00Z 发布，prerelease: false，是当前 stable——生产请改钉 v2.1.310（上一版 v2.1.309 已进入历史）。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，该时间取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。本版全为 fix / improved / changed，无新增 feat。

㊵ 头两条必须合起来读——它们指向同一件事：非直连 Anthropic API 的环境，此前功能缺失或直接失败：

• Monitor 工具与插件 monitor 补齐到 Bedrock / Vertex / Foundry，以及关闭遥测或非必要流量的会话；同时长时间前台 sleep 在这些环境下也被纳入阻断。官方原文：「Added the Monitor tool and plugin monitors on Bedrock, Vertex, and Foundry, and when telemetry or nonessential traffic is disabled; long foreground sleeps are now blocked there too」。
• 网关 / 兼容服务器拒绝 effort-2025-11-24 beta 值或会话中途 system 消息导致的请求失败，现在会自动去掉这些重试。官方原文：「Fixed requests failing behind some gateways and compatible servers that reject the effort-2025-11-24 beta value or mid-conversation system messages; Claude Code now retries without them」。

这条演进线本站已记录多次：v2.1.281 把 AGENTS.md 回退扩展到 Bedrock / Vertex / Foundry / LLM 网关 / 关遥测会话 → v2.1.304 → 2.1.305 修掉 tool search 在这条路上的回归 → v2.1.310 补齐 Monitor 并对网关不认识 beta 头做自动降级。结论：官方是在一个版本一个版本地补，而不是一次性对齐。走云托管 / 自建网关 / 关遥测的团队，每升一版都要复核「哪些能力在我这里还没有」，升级后跑一次 /doctor。

㊶ 两条数据安全类修复（都容易被忽略，但都会丢东西）：

㊷ 企业级变化：Cloud sessions 与 Remote Control 权限进入 Enterprise 自定义角色，Owner 可按角色分别控制访问；在管理设置里开启这两项时，会要求确认并列出已获该权限的角色。与本站已记录的 claude_code.safety_event（v2.1.307）连起来看，路径清晰：能看见（Monitor）→ 有事件（safety_event）→ 能按角色分权（Enterprise roles）。

㊸ 其余影响面较大的条目：① Windows：PreToolUse / PermissionRequest 钩子在 Git Bash 缺失且钩子命令为纯引号字符串时放行工具调用（fail open），已修；② Linux：/sandbox 会点名 Ubuntu AppArmor 对用户命名空间的限制及解除方法，当它导致 bubblewrap 无法启动沙箱时；③ 读文件权限提示不再说明符号链接指向何处，已修；④ 非交互会话（-p、Agent SDK）在 transcript 极大时压缩的内存占用改善；⑤ MCP 工具在非交互会话超时且 elicitation 无人应答时，错误会明确告诉 Claude「没有收到回答，不要再调用」。

㊹ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第十一次复核确认）。缺失原因本站仍未获知，继续不作推断。

行动建议：① 生产钉 v2.1.310；② 走网关 / 云托管 / 关遥测的，升级后跑 /doctor 并复测 Monitor 是否可用；③ 设了大 cleanupPeriodDays 的，立刻检查近期粘贴图片等资产是否还在；④ 排查「压缩后仍 prompt too long」前先升到 310。详见 v2.1.310 资讯。 2026-10-28 更新（v2.1.311，GitHub Releases 官方 Release Notes 原文 + tag 时间戳一手核对）：一轮纯修复版，三条与日常体感直接相关

㊺ v2.1.311 于 tag 时间戳 2026-10-26T21:51:23Z 发布，prerelease: false，接替 v2.1.310 成为当前 stable——生产请改钉 v2.1.311。 官方 Release Notes 标题为 「What's changed」，条目几乎全部是修复。本次已取得官方 Release Notes 正文（不是 CHANGELOG 转录）。

㊻ 三条最值得记的修复：

㊼ 其余条目里两条偏工程化：① self-hosted-runner 新增 --hold-idle-file 与 --max-hold-min，用于主机报告仍有进程在跑时保持空闲会话；② 修掉了 CLAUDE.md 中存在超长列表项时启动 / 读写文件后的长时间卡死。此外还修了 MCP 资源读取未返回时中断不生效、claude -p 与 SDK 会话消息乱序或保留已撤回消息、SubagentStop 之外的若干子代理 worktree 与后台会话问题，以及 @ 文件选择器忽略 .ignore / .rgignore 的反向（re-include）规则。

㊽ 2.1.297 与 2.1.298 两节仍然缺失（本次为本站连续第十四次复核确认）。缺失原因本站仍未获知，继续不作推断；同时沿用既有判据：核对版本序列必须同时取官方 CHANGELOG 与 GitHub Releases 两个来源，本次 Releases 列表顶部即为 v2.1.311，未见 312 及以上。

行动建议：① 生产钉 v2.1.311；② 写了 SubagentStop 钩子的，升级后先跑一次回归看触发次数；③ 被「Usage credits required for 1M context」打断过的，升级后复测长任务，若仍复现应检查是否被配置固定了旧行为；④ 自建 runner 上跑长任务的，看看 --hold-idle-file / --max-hold-min 是否正好解决你的空闲会话被回收问题。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节 2026-10-26T21:51:23Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 10-28 版本复核资讯。

2026-10-29 更新（v2.1.312，GitHub Releases 官方 Release Notes 原文 + tag 时间戳一手核对）：三条 Changed 会改行为，其中一条是撤下刚上线三周的遥测事件

v2.1.312 于 tag 时间戳 2026-10-27T20:24:20Z 发布，prerelease: false，接替 v2.1.311 成为当前 stable——生产请改钉 v2.1.312。 官方 Release Notes 标题仍是 「What's changed」，条目以 fix 为主，但三条 Changed 会实际改变运行行为：

① 停止发送 claude_code.safety_event（OpenTelemetry 事件）——官方原文 "Changed Claude Code to stop sending the claude_code.safety_event OpenTelemetry event"。该事件是本站 10-23 复核时记录的新增可观测性能力（随 v2.1.307 引入），上线约三周即被撤下。任何基于该事件做的告警 / 审计面板，请立即确认是否已静默失效。 官方未说明撤下原因，本站不作推断。

② 自定义模型名改用短 system prompt——官方原文："Changed Bedrock, Vertex, Foundry and Mantle to use the shorter system prompt for model names Claude Code doesn't recognize, such as custom deployment names and inference profile ARNs, even when they front Sonnet or Haiku"。想保留完整 prompt 的，设 CLAUDE_CODE_SIMPLE_SYSTEM_PROMPT=0。

③ 自动换模型覆盖到无法识别的模型名——被标记消息后的自动切换现在也作用于自定义部署名等；不想要的设 CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1 关掉。

其余条目里三条偏日常体感：大文件不再被只看了开头就整体覆写（官方原文："Fixed Claude overwriting a very large CLAUDE.md, rules file or @-included file in a subdirectory after seeing only its start; Write now asks Claude to read it all or edit in place"）；prompt 与 agent 钩子改为每会话最多同时跑 24 个（子 agent 计入），另最多 12 个等待超过其事件超时的，timeout 小于 1 秒按 1 秒算；用量提示语把「session limit」改称「5-hour limit」。另有网关新增 oidc.user_id_claim（支持用 sub 之外的 id_token claim 标识人，例如 Microsoft Entra ID 的 oid）、全屏下点击「to send now」提示即可立即发送排队消息，以及 OTel mcp_server.name 改为上报官方市场插件声明的固定 URL 远端 MCP server 的真实名称（不再一律 custom）。

行动建议：① 生产钉 v2.1.312；② 查一遍是否依赖 claude_code.safety_event——这是本轮唯一会让既有监控静默失效的变更；③ 走 Bedrock / Vertex / Foundry / Mantle 且用了自定义部署名的，升级后先跑一次关键任务确认行为；④ 钩子多的项目，升级后注意 24 并发上限是否让既有流水线排队变慢。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节 2026-10-27T20:24:20Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 10-29 版本复核资讯。 2026-10-31 更新（v2.1.314，GitHub Releases 官方 Release Notes 原文 + Releases / tags 双端点一手核对）：写入边界可以拒绝了，两个开关语义反转，一个退出码从 0 变 1

v2.1.314 于 2026-10-30T01:06:26Z 发布，prerelease: false，接替 v2.1.312 成为当前 stable——生产请改钉 v2.1.314。 同时经 Releases 与 /tags 两个端点核对，v2.1.313 不存在（序列为 …311 → 312 → 314），这是本站第十五次确认该缺口，官方未说明原因，本站不补写编号。

① 新增 permissions.blockWritesOutsideWorkingDirectories——官方原文 "Added permissions.blockWritesOutsideWorkingDirectories: Write, Edit and NotebookEdit refuse paths outside the working directories in every permission mode"。这是本版唯一的新设置项，也是唯一把「越界写入」从可协商变成可拒绝的护栏；它是 opt-in，且在所有权限模式下都生效，不会降级、不会询问。与 Agent 沙箱 互补：沙箱挡的是进程行为，这条挡的是工具入参。

② 两个语义反转（都在 Changed 段）：其一，FORCE_HYPERLINK=false（含 no / off）现在把超链接关掉，此前是打开——变量名不变、语义取反，照抄旧配置的环境会得到相反结果；其二，Cowork 云会话里钩子对 MCP 工具调用的 allow 现在算「没有回答」，改由分类器或权限提示决定，此前钩子放行即放行。

③ claude -p 启动失败不再静默成功——"Fixed claude -p exiting with code 0 and no output when startup failed; it now prints the error and exits 1"。这条被官方放在 Bug Fixes 里，但对既有系统的影响等同于 breaking change：用退出码判断成败的 CI 脚本，升级后第一次真失败才会暴露。本站已连续三轮遇到「Bug Fixes 里藏着行为变更」，判据同步收紧：Bug Fixes 段里凡改变退出码、改变默认值、改变「算不算数」的判定的条目，一律按行为变更处理。

其余值得记的：worktree 沙箱绕过被补掉（"Fixed sandbox protections not applying to a worktree entered by claude -p --resume or --continue"）——与本站 git worktree 并行 agent 指南 记录过的绕过同源，依赖 worktree 隔离做并行编排的请升级；带点号的模型 ID 不再被误判为旧模型（自建网关后的 claude-opus-4.8 一类，此前会按错误的上下文窗口、输出上限、effort、思考模式与成本处理）；管理员封顶 effort 时不再整轮失败，改为自动降级重试并告知实际档位；.trash 有了硬上限（skills / plugins 各约 1024 条，且官方写明 优先于 cleanupPeriodDays）；空闲压缩扩围到 VS Code 与 Claude Desktop 的 Code 页、关闭遥测的订阅者，以及 Bedrock / Vertex / Foundry / LLM 网关；PreCompact 钩子输出截断到 10,000 字符；长 headless / SDK 轮次里父会话不再保留子 agent 的工具结果，多子 agent 场景内存占用下降。网关侧另新增 upstreams 的 groups IdP 白名单与 Bedrock 的 guardrail_trace（记录命中哪条护栏，不含命中文本）。

行动建议：① 生产钉 v2.1.314，保留 v2.1.312 作为回滚点；② 全局搜一遍 FORCE_HYPERLINK（CI / Dockerfile / shell profile），升级后逐个确认终端表现；③ 用 claude -p 退出码判成败的流水线，主动跑一次失败路径；④ 自建网关用户重新核对模型 ID 的上下文窗口与单价，此前可能一直是错的；⑤ 依赖 worktree 隔离的并行编排必须升；⑥ 想收写入边界的再评估 permissions.blockWritesOutsideWorkingDirectories，先确认 agent 是否需要写工作目录外的临时文件。详见 v2.1.314 资讯。

2026-11-01 更新（v2.1.316，官方 CHANGELOG + GitHub Releases / tags 双端点一手核对）：Opus 4.8 快速模式一个月后硬失败，网关策略改为逐层叠加

㊿ v2.1.316 于 tag 时间戳 2026-10-31T01:01:35Z 发布，prerelease: false，接替 v2.1.314 成为当前 stable——生产请改钉 v2.1.316。 经 Releases（/releases/tags/v2.1.315 返回 404）与 /tags 双端点核对，v2.1.315 不存在，序列为 …312 → 314 → 316；v2.1.313 的缺口本站第二次确认，2.1.297 / 2.1.298 的缺口为第十六次确认，官方未说明原因，本站不补写编号。

本版头条是一条 Deprecated，且它的重点在「不回退」：官方原文 "Deprecated fast mode for Opus 4.8 as of October 30, 2026; it will be removed on November 30, 2026. After removal, fast mode requests on Opus 4.8 return an error and do not fall back to standard Opus 4.8. Migrate to Opus 5.5 to keep the speedup." 三个时间点要分开读：2026-10-30 起弃用但仍可用 → 2026-11-30 移除 → 移除后是报错，不降级到标准 Opus 4.8。Opus 4.8 本身没有退役，退役的只是它的 fast mode——不要把这条读成「换模型」。另：官方只说「迁到 Opus 5.5 以保留加速」，未说明 5.5 是否有对等 fast 档及其单价，本站不替官方推断。

网关侧四项：pooled_budget（组内成员共享一份月度预算，叠加在个人限额之上）；managed.policy_mode: layered（每条命中的策略都生效、逐层合并，而不是只取第一条——已经写了多条策略的组织，升级后可能看到此前被遮蔽的限制开始拦人）；guardrail.input_tagging（Bedrock upstreams，把 prompt 包进护栏 prompt attacks filter 需要的 input tags，all_messages_and_system 连 system prompt 一起包——这暗示此前部分组织的护栏过滤器可能并没在正常工作）；CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP（保留互相签发成环的系统交叉证书）。

两个 effort / 关键字开关：CLAUDE_CODE_DISABLE_ULTRATHINK（关掉 ultrathink 关键字）；CLAUDE_CODE_SUBAGENT_EFFORT（子代理在无其它指定时用这一档，不再继承会话的——fan-out 编排里一个 xhigh 主会话此前会把所有子任务都拉到 xhigh）。

修复里三条值得单列：① 🔧 Claude Code 自行退出时遗留的 shell 命令被修（"Fixed shell commands being left running on macOS and Linux when Claude Code exits by itself, for example when credentials are refused or a cloud session is archived"）；② 🔧 Vertex AI / Bedrock 上 sonnet / opus / haiku 别名在最新型号不可用时改为切到旧型号，此前是会话中途报错；③ 🔧 网关此前没有对请求里每个模型都做白名单校验，现在命中被封模型会返回 400 并指明字段。另修 --restricted 会话在 Read allow 规则覆盖时仍上传工作目录外文件。

Changed 两条：① 不含 "$defaults" 的 autoMode.allow 不再移除 scheduled-task prompts 上的内置规则；② Team / Enterprise 的服务端托管设置改为无需审批提示即生效，且本地副本校验不通过时被拒。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节 2026-10-31T01:01:35Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。

行动建议：① 生产钉 v2.1.316，保留 v2.1.314 作为回滚点；② 今天就 grep fast mode（应用代码 / CI / 压测脚本 / 成本表），11-30 之前改完，不要假设到期会降级；③ 评估 Opus 5.5 是否真有对等加速再排迁移；④ 组织用户升级后逐组复核最终生效的策略集合（尤其是启用了 policy_mode: layered 的）；⑤ 用 Bedrock 护栏的回头看 prompt attacks filter 此前是否一直没被触发；⑥ fan-out 编排显式设 CLAUDE_CODE_SUBAGENT_EFFORT；⑦ 走 Vertex AI / Bedrock 且用模型别名的，升级后确认回退行为。详见 v2.1.316 资讯。

来源说明：本文基于 code.claude.com 官方文档、Anthropic 定价页面、第三方独立评测（laozhang.ai / explainx.ai / computingforgeeks.com）综合整理。v2.1.287 ~ v2.1.301 一节依据 Anthropic 官方 CHANGELOG 原文逐条核对（CHANGELOG 由 https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md 取得；2.1.297 / 2.1.298 两节在官方 CHANGELOG 中缺失，原因未获知，本站不作推断）。Anthropic 模型版本迭代快，命令和价格请以最新官方文档为准。

2026-11-02 更新（供应链安全事件，非版本更新）：Cursor 扩展市场出现被植入 SSH 后门的 Claude Code 2.1.312 / 2.1.313

这不是 Claude Code 自身的漏洞，但是每一个 Claude Code 用户都需要确认的一件事。 据 Cursor 官方安全公告，太平洋时间 2026-10-29 约 2:27–13:35，其 VS Code 扩展市场上架了被恶意篡改的 Anthropic.claude-code 2.1.312 与 2.1.313（Windows / macOS）。官方原文："These malicious versions of the extension were not developed by Anthropic"，并称无证据表明该扩展的其它版本或官方分发渠道受影响。

版本号在这里既是线索也是陷阱，本站用双端点核对给一个交叉验证：经 GitHub Releases 与 /tags 核对，v2.1.312 在官方渠道存在且正常（tag 2026-10-27T20:24:20Z，prerelease: false），而 v2.1.313 官方根本没有（/releases/tags/v2.1.313 返回 404，本站第十六次确认）。两句话要分开读：官方发过的版本号也可能是脏包（2.1.312 就是），官方没发过的版本号本身就是异常信号（2.1.313 就是）。前者只能靠哈希比对，后者查一次 404 就能发现。

载荷做了四件事：① 收集并上报主机名、用户名、OS、架构、主目录路径、环境变量名、工作目录、已配置的 Git 邮箱、公网 IP；② 往 authorized_keys 写入攻击者控制的 SSH key（注释 svc-telemetry）、尝试开启本地 SSH 服务并建立反向隧道；③ 用 **LaunchAgent（macOS）/ 计划任务（Windows，尝试以 SYSTEM 运行、回退到启动目录脚本）**做持久化，后台脚本约每 60 秒重试一次隧道；④ 向 134[.]209[.]82[.]225 POST 主机信息。官方给出的减损事实：由于恶意代码自身存在错误，除 Cursor 以管理员权限启动这类极不常见的情况外，「开启 SSH 服务」这一步会失败；且官方已与托管商协作把攻击者服务器下线。但 SSH key 已写入、持久化已安装、主机信息已上报——官方明确要求无论结果如何都按流程处置。

行动建议：① 从 Cursor 扩展市场安装过 Claude Code 的，先跑自查：grep -qs svc-telemetry ~/.ssh/authorized_keys && echo "svc-telemetry key found" || echo "No key found; machine not impacted"（Windows 用官方公告里的 PowerShell 版本）；② 卸载扩展不等于清干净——官方原文 "Uninstalling the extension may not be sufficient — the payload drops standalone persistence scripts that keep running"，请用官方提供的 remediate-macos.sh / remediate-windows.ps1；③ 在可信系统上轮换凭据与会话（官方点明：环境变量名的收集范围有限，并不排除后续通过后门拿到凭据）；④ 版本本身无需回退——当前 stable 仍是 v2.1.316，官方 GitHub Releases 渠道未受影响；⑤ 团队侧重新评估扩展来源白名单。完整 IoC 与处置流程见 投毒事件资讯。

2026-11-04 更新（v2.1.317，GitHub Releases 官方 Release Notes 原文 + tag 时间戳一手核对）：三条写在 Fixes 里、实为「判据变更」的条目

v2.1.317 于 tag 时间戳 2026-11-03T01:25:46Z 发布，prerelease: false，接替 v2.1.316 成为当前 stable——生产请改钉 v2.1.317，保留 v2.1.316 作回滚点。 版本序列经 Releases 与 /tags 双端点核对为 …312 → 314 → 316 → 317；v2.1.313 / v2.1.315 两个缺口此前已多次确认，官方未说明原因，本站不补写编号、不作推断。

第一条：claude -p 在磁盘写满或配额耗尽时，退出码从 0 改为 1。 官方原文 "Fixed claude -p exiting 0 when a full disk or quota lost its transcript or ~/.claude.json writes; it now prints an error and, in text and json output, exits 1. Full NFS exports may be missed"。三个要点：① 成败判定反转——此前 transcript 写不进去但进程仍返回 0，上游 CI 看到绿色、实际结果没保存；② 官方自陈边界：NFS 完全写满这种情况仍可能漏判，修复覆盖的是本地磁盘与配额，不是所有写盘失败；③ 用退出码判成败的流水线，升级后会走进失败分支，需先跑一次失败路径确认上游处理正确。

第二条：stdio MCP 服务器的 AWS_BEARER_TOKEN_BEDROCK 从「传空串」改为「不设置」。 官方原文 "Fixed stdio MCP servers receiving an empty AWS_BEARER_TOKEN_BEDROCK when their env config sets it to empty; the variable is now unset, so the server can use the machine's own AWS credentials"。这是环境变量语义变更，不是新增开关——此前因拿到空串而失败的 Bedrock 调用，现在会真的去用机器自身的 AWS 凭据；共享机器 / 多账号环境要复核这个权限面。

第三条：Grep / Glob 命中时间上限时，不再被当成完整结果。 官方原文 "Fixed Claude treating partial Grep and Glob results as complete when a search hit its time limit"。此前搜索被截断后模型会当「这就是全部」继续推理；现在会明确告知不完整——但下游流程是否处理这个信号，要自己实现。

Removed 一条容易被忽略：Read 工具的「file unchanged since your last Read」占位符被撤掉，重复读取未改动文件重新返回全文。 这是把此前为省 token 做的优化回退了，长会话上下文占用会回升；与 v2.1.311 起「standard-context 会话超过 200K 自动压缩续跑」叠加后，压缩会更早触发。反复回读大文件的团队值得观察压缩频率。

新增能力四条：① onFailure: "block"（Agent SDK hook 回调）——回调失败时阻断该动作而非放行，把「钩子挂了 = 不生效」翻成「钩子挂了 = 不许做」；② web / shell 工具调用把账号邮箱地址发往网络前会先询问；③ /schedule 在云定时任务拿到「你没要求的 connectors」时告警并可移除；④ CLAUDE_CODE_DISABLE_NESTED_SESSION_ID——自建 runner 上设 1，让 claude -p 在会话内运行时使用该会话的 ID 与 transcript（回到早期版本行为）。

Changed 两条会改行为：① SendMessage 发给运行中的后台 agent 会更早到达——它正在跑的命令被移到后台而不是被停掉；② 子代理 / 队友用另一模型时，改用该模型自己保存的 effort 档位或它的默认值，不再继承会话 effort。第二条与 v2.1.316 新增的 CLAUDE_CODE_SUBAGENT_EFFORT 是同一问题的两个层次，fan-out 编排的实际 effort 需重新核对——主会话设 xhigh 不再等于所有子任务都 xhigh。

企业侧成本可见性补齐：新增 GET /v1/organizations/analytics/cost（按日期区间读历史花费，可按总量 / 按开发者 / 按天 / 按 IdP 组聚合），以及 admin: 网关上每名开发者 IdP 组的按日记录，保留期 admin.identity_retention_days，成本报表按它分组。报表取数口径（是否含 cache 读写、是否含 pooled_budget 扣减）与 admin.identity_retention_days 的默认值 / 上限，官方本条均未写，本站不替官方推断。另修「组池化预算耗尽后，状态行与 /usage 把开发者个人额度显示成 100% 已用」。

可观测性：OTel 指标 / 事件 / span 新增 anthropic.plan、anthropic.seat_type、anthropic.provider、anthropic.custom_base_url——此前无法在可观测性侧区分套餐与供应商；OTel 导出补超时：代理不应答时不再无限挂起，10 秒超时，可用 OTEL_EXPORTER_OTLP_TIMEOUT 放宽到最多 30 秒。另修 DISABLE_PROMPT_CACHING_OPUS / DISABLE_PROMPT_CACHING_SONNET 对 [1m]、其他区域与无日期后缀的默认模型写法此前不生效。

Windows 两条：① 部分卷上原生路径查找失败导致每次工具调用都被拒绝的问题已修，工作目录校验改为比较文件夹标识；② 未由 Claude Desktop 启动的会话，scratchpad 等临时路径不再随项目路径长度增长，repo 被克隆进去后撞 260 字符路径上限的问题解除。

行动建议：① 生产钉 v2.1.317，保留 v2.1.316 作回滚点；② 用 claude -p 判成败的流水线，先跑一次失败路径（配额 / 只读挂载模拟），确认上游把退出码 1 当失败而不是被 || true 吞掉；③ stdio MCP + Bedrock 的，升级后逐个确认凭据来源，尤其是共享机器与多账号场景；④ 把 Grep / Glob 当穷举结果的自动化加兜底；⑤ fan-out 编排重新核对子代理实际 effort；⑥ 长会话成本重新估算（Read 占位符撤销后 token 开销回来了）；⑦ 企业客户先核对成本报表口径再当账单用。沿用既有口径：官方 CHANGELOG 版本标题下不标注发布日期，本节 2026-11-03T01:25:46Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 v2.1.317 资讯。

2026-11-05 更新（v2.1.318，GitHub Releases 官方 Release Notes 原文 + tag 时间戳一手核对）：权限提示不再被抢跑的按键答掉，「脏配置」不再被静默重置为默认值

v2.1.318 于 tag 时间戳 2026-11-04T00:01:03Z 发布，prerelease: false，接替 v2.1.317 成为当前 stable——生产请改钉 v2.1.318，保留 v2.1.317 作回滚点。 npm dist-tags 出现分叉：latest / next 均为 2.1.318，但 stable 仍停在 2.1.311——写死 @stable 安装的脚本会落后七个版本。v2.1.313 / v2.1.315 两个序列缺口仍未获解释，本站不补写编号。

第一条（本版最该升的理由）：权限提示不再接受「抢跑」的按键。 官方原文 "Fixed permission prompts being answered by keys typed just after sending a message, or before a slow prompt appeared"。此前你发完消息后紧接着敲的键、或提示弹出前的抢跑按键，可能被当成对权限提问的回答——在权限场景里，误触等于批准。修复后只有提示出现后的按键才算数。共用终端、Tmux 多窗格、脚本驱动 TTY 的场景，这一条直接关系审批是否真被看到。

第二条：~/.claude.json 不是合法 JSON 时，非交互启动改为失败。 官方原文 "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"（关联 #87551）。此前会静默用默认值覆盖你的配置。 同批还修了：空文件且无备份不再被判为损坏（按「不存在」启动）；恢复命令不再指向空 / 截断的备份；网络家目录写不进时不再把登录态替换成空文件；只跑 claude -p 的家目录在保留期清理时先取新备份再删最后一份好的。

第三条：claude -p / Agent SDK 又一处「假成功」被补。 mod 钩住 turn.step 时，即使 API 错误截断了回复，此前仍会报成功；现在不会。这与 v2.1.317 的退出码修复是同一条线。

Changed 里有一条会直接断掉上手路径：在 IDE 终端里启动时不再自动安装 / 更新 IDE 扩展。要用请从外部终端跑 /ide，或用编辑器自己的扩展视图。上手文档写「在 IDE 终端里跑 claude 即可」的会失效。

Removed 一条影响跨版本续聊：撤掉了 2.1.288 加的「从 2.1.286 及更早版本发起的会话，--resume 时保留早期 thinking」——那段 thinking 现在可能被丢弃。官方未说明丢弃条件，上下文占用变化需自测。

新增能力五条：① claude auth status 增加 loginExpiresAt，claude -p 的 JSON 结果增加 credential_expires_at，到期前 10 天开始在 stderr 打一行提醒；② 网关 mantle 上游支持 assume_role（跨 AWS 账号 + 按开发者归属成本）；③ mod 的 $.model.fork 支持 effort，可让副任务固定跑 low，结果里回报实际 effort；④ 会话中开启它写入的 mod 时会记录你的回答；⑤ MCP 工具在加载完成前被调用时，错误里返回该工具的输入 schema。

其他会改行为的 Changed：① deniedMcpServers 的 URL 条目扩大生效范围——现在也拦上游 URL 匹配的 Anthropic 自带服务，以及云会话 / 自建 runner 上的 connector（会话拿到的是 connector 自己的 URL）；② 「切换模型时提示」设为「每次询问」时，子代理停下而不是自动切模型；③ 后台子代理在所有 provider 上超过 3 分钟就把 shell 命令移到后台（此前只在部分 provider），目的是不让 prompt cache 过期；④ /permissions 各视图改用标准对话框，连按两次 Ctrl+C 变为返回 / 取消而非退出；⑤ /claude-api managed-agents-onboard 新建 agent 的内置工具与模板 MCP 工具默认 auto 权限策略（"Judge risky actions"）——与 Console 对齐，但默认权限变宽，要收紧须显式说「run without asking」；⑥ 自建 runner 编排日志格式变更（ok session=… 全级别打 stdout、字段顺序调整），匹配 retryable=true: 的脚本要改。

修复里几条日常体感明显的：--continue 在畸形工具调用重试耗尽后丢上一段对话（v2.1.314 引入的回归）；macOS 上大量 Bash 命令并发时会话卡住且内存增长；claude mcp add / remove 写配置前先拿锁（拿不到就等或退出 1）；/logout、claude auth logout、claude mcp remove 在配置写失败时不再报成功；共享家目录上另一终端重新登录后，原作业不再报 Not logged in；空闲压缩不再用「不是摘要的回复」替换整段对话；NODE_EXTRA_CA_CERTS 指向空文件 / 非 PEM / 首证书损坏时不再全连接失败（改为使用可读证书并告警）；无人值守运行不再每次重写未变化的 ~/.claude.json。

行动建议：① 生产钉 v2.1.318，保留 v2.1.317 作回滚点；② 用 @stable 标签装 CI 的立刻改成显式版本号（stable 仍指 2.1.311）；③ 共用终端 / 自动化驱动 TTY 的，升级后重跑一次权限流程，确认没有「未读提示即批准」的入口；④ 流水线先跑一次「配置损坏」路径（放个非法 JSON 到 ~/.claude.json），确认上游把启动失败当失败；⑤ 改上手文档：IDE 终端不再自动装扩展；⑥ 跨版本 --resume 的用户测一次上下文长度；⑦ managed-agents-onboard 出来的 agent 复核权限策略是否真的是你要的 auto；⑧ 自建 runner 更新日志匹配正则。沿用既有口径：官方 Release Notes 标题为 What's changed，标题下不标注发布日期，本节 2026-11-04T00:01:03Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 v2.1.318 资讯。

2026-11-07 更新（v2.1.319，GitHub Releases 官方 Release Notes 原文 + tag 时间戳一手核对）：auto 模式不再降级到本地分类器，四处权限绕过同版修完

v2.1.319 于 tag 时间戳 2026-11-06T17:04:01Z 发布，prerelease: false，接替 v2.1.318 成为当前 stable——生产请改钉 v2.1.319，保留 v2.1.318 作回滚点。 上一版记录的 npm 分叉（stable 停在 2.1.311）本轮未复核，装 CI 前请自查 npm view @anthropic-ai/claude-code dist-tags。

第一条（本版最该读的）：auto 模式「没有兜底」了。 官方原文 "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 CLAUDE_CODE_AUTO_MODE_SERVER=0 to keep using it (Bedrock, Vertex and Foundry are unchanged)." 含义：关遥测、关特性开关、走 LLM 网关这三种部署下，服务端核验不了的调用今后一律询问或拒绝，不再偷偷降级到本地内置分类器。 要回退旧行为显式设 =0；Bedrock / Vertex / Foundry 三家托管不受影响。反向开关同版补上：网关下 =1 即便设了 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 也开启服务端检查，若你用 managed settings 设了后者，必须同时把前者设成 1。

🆕 第二条（无人值守的正解，但代价要知道）：新增 permissions.denyInsteadOfPrompting。 本该等在权限提示上的工具调用直接被拒、但该轮继续，覆盖终端会话、子代理与 teammate。这不是变安全，是把「卡住」换成「跳过」——任务不会停在没人点的对话框上，但会静默少做一步。

第三条：四处权限绕过同版修完，其中两条属安全面。 ① "a crafted environment prefix could hide part of a command from permission checks" ——在命令前拼构造过的环境变量前缀，权限检查只看得到命令的一部分；② "a sed command could skip the permission check in accept-edits and auto mode" ——sed 在 accept-edits 与 auto 两档最宽的模式下曾可跳过检查；③ "a sandbox escape when creating a worktree" ——创建 worktree 时存在沙箱逃逸；④ "/rewind could restore or delete a file through a directory symlink"。另有一条同类：带引号的词会让 Bash 的 deny / ask 规则匹配失败。四条都指向同一件事：权限规则按文本匹配，而 shell 允许同一件事有很多种写法。

第四条：claude -p 又补一处假成功。 auto 模式下因「拿不到安全检查」而被拒时，此前退出码 0，现在文本与 JSON 输出都改 1。这是 v2.1.317（磁盘满 / 配额耗尽）、v2.1.318（mod 钩住 turn.step）之后同一条演进线第三次延伸。

新增能力：① MCP 工具调用改为后台任务——MCP server 把工具调用当任务跑时立刻移到后台、完成后告知模型；CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1 可改回「在工具调用内等待」；② CLAUDE_CODE_DISABLE_FEATURE_FLAGS ——停止拉特性开关但不关遥测，每个开关改用内置默认值；③ /claude-api latency-optimize ——找 Claude API 代码里让人等待的位置，并拿你的 eval 试更快的设置；④ /usage 对「走 Claude apps 网关、无花费上限」的开发者新增今日 / 本周 / 本月花费；⑤ /tasks 新增「Earlier in this session」行，列出已结束的子代理，即使它已离开列表或你重启过也能重开并继续对话。

网关侧：admin.pooled_conflict_rule 与 admin.pooled_priority_order ——指定一个开发者在多个组时，哪个组的 pooled 预算先扣（此前只能看到「池子扣了」，不知道扣的谁）；login_notice（浏览器验证页与登录页显示运维自定义文案）；CLAUDE_GATEWAY_LOG_FORMAT=json（运维日志转 JSON，含 severity / time / message）。

两条「看着是优化、实际改行为」的条目：① /context 不再每轮把整个可视网格发给模型——此后模型只读那张表，长会话后续轮的上下文成本会降，但模型对上下文的感知也变了；② Bash 沙箱开启时，起始目录以下的嵌套 .claude/skills 默认不加载，除非你就在那里启动或 /cd 过去——依赖深层 .claude/skills 的仓库升级后会发现技能「消失」。

其他会改行为的 Changed：① 更宽的 deny 覆盖时，精确的 ask 规则直接失效（改为拒绝而非弹提示）；② PostToolUse hooks 会在「新消息打断该轮后完成的工具调用」上运行，最多给 10 秒；③ --trust-workspace false 现在连仓库 settings 文件与 skills 里的 hooks 一起停；④ --add-dir 目录里的插件市场要等该目录的信任对话框被接受后才注册；⑤ 自定节奏的 /loop 一轮结束未重新排期即结束，CLAUDE_CODE_LOOP_KEEPALIVE=1 保留旧行为；⑥ which 带非常规参数开始要授权。

时间线提醒：新版启动告警对「没有 desktopHome 却依赖 coworkTabEnabled: false 或 chatSessionRetentionDays」的策略提前报错，原因是 Claude Desktop 将在 11 月 10 日变更——具体变更内容本条未展开，本站记录日期，不推断影响面。

行动建议：① 生产钉 v2.1.319，保留 v2.1.318 作回滚点；② 走 LLM 网关的，先决定 CLAUDE_CODE_AUTO_MODE_SERVER 取 0 还是 1，并检查 managed settings 里有没有 DISABLE_EXPERIMENTAL_BETAS 与之冲突；③ 用 --worktree 或仓库里有目录符号链接的，复测沙箱与 /rewind；④ 依赖深层 .claude/skills 的，升级后确认技能仍加载；⑤ 要开 denyInsteadOfPrompting 的，只对「缺项可接受」的任务开，并要求模型显式汇报被拒的动作。沿用既有口径：官方 Release Notes 标题为 What's changed，标题下不标注发布日期，本节 2026-11-06T17:04:01Z 取自 GitHub Releases 的 tag 时间戳，非厂商公布发布日。详见 v2.1.319 资讯。

核心特性

终端原生的 Agent 体验

不像 Cursor / Windsurf 那种"AI IDE"，Claude Code 是个 CLI 工具——在任何编辑器旁边开个终端，跑 claude，就进入了一个能读你整个 codebase 的对话环境。

cd your-project
claude                          # 进入交互模式
> 帮我把这个 Express 项目迁移到 Fastify，写完之后跑测试确认通过

它会自动：列出相关文件 → 给出计划 → 等你按回车确认 → 一次改多个文件 → 跑测试 → 报告结果。整个过程你可以在另一个窗口干别的，Claude Code 不抢编辑器焦点。

子代理（Sub-agents）+ 并行任务

Claude Code 2.x 引入了 子代理 机制：主对话可以派发独立的子任务到隔离 context 中跑，结果摘要返回主线。典型场景：

/subtask            # 派发独立子任务（2026-07 起取代内联子 agent）
/fork               # 复制当前会话到后台并行推进
/agents             # 管理子代理
/tasks              # 列出后台运行的子代理

据 computingforgeeks.com 2026 cheat sheet 整理，子代理让"一边改前端，一边改后端"这种并行操作不会污染主对话上下文。2026-07 更新后，/subtask 取代了旧的内联子 agent 写法，/fork 则能把整个会话复制一份丢到后台继续跑；会话级新增上限（WebSearch 200 次、子 agent 200 个），MCP 调用超 2 分钟自动转后台执行。

v2.1.232（2026-08-14）子 Agent 进一步强化：

• Subagent forking 默认开启：子 Agent 继承完整对话上下文与 prompt cache，减少重复计算、提升一致性；
• @-mention 跨会话通信：用 @会话名 语法可在不同 Claude Code 会话间直接发消息（底层走 SendMessage，默认无需确认），便于多会话协同；
• 非 teammate 的子 Agent 默认后台运行，减少主会话阻塞；
• GitLab marketplace 支持，扩展可用命令/技能分发渠道；
• 安全加固：修复了若干权限绕过与凭证处理漏洞，Remote Control 稳定性提升。

Projects 重构：从「文件夹」到「协调器」（2026-09-17 起 beta）

在此前很长一段时间里，多个 Claude Code 会话并行跑同一仓库，拆活、分工、缝合结果全靠人。官方于 2026-09-17 起把 Projects 重做成一套编排结构（官方公告：Projects redesigned）：

你：一个目标 + 连接的仓库/上下文
        ↓
coordinator（协调器）：拆任务 → 派活 → 跟踪 → 审结果 → 汇总
        ↓
thread A（云端 session，独立分支 + 仓库副本）→ 开 PR、跑测试
thread B（同上）                              → 开 PR、跑测试
thread C（同上，内部再拆 subagents / loops / workflows）
        ↓
重叠改动 = 普通 merge conflict（不提前阻止）；coordinator 给合并顺序建议

几个容易看漏、但决定你怎么用它的细节：

• 一个 thread = 一个完整 Claude Code 云端 session。开 6 条并行就按 6 倍用量算，plan 上限会比单会话快得多触顶；coordinator 与 worker 的 model / effort 可分别设置，这是控成本的主要旋钮。
• 冲突不提前阻断。官方原话是「重合部分按普通 PR 冲突处理」——也就是说集成负载没有消失，只是被推到了 review 阶段，你的 CI 与分支保护策略必须够硬。
• 共享记忆是项目级的。某个 thread 学到的「发版改到周五」「动 billing 前要先找谁」，会沉淀进项目记忆供后续 thread 复用；library 则收集你上传的文件与 Claude 产出的产物，新 thread 不必重新贴上下文。
• 可用范围窄。beta 先给「使用 Claude Code cloud sessions、且 web / desktop 上没有既有 project」的 Pro / Max 订阅者；一周内扩到更多 Code 用户，Team / Enterprise 与 chat / Cowork 排在后面。既有 project 维持原样，随放量再升级。
• 线程目前只在云端跑；官方称「在你自己机器上、走你自己的网络」即将支持。有代码不出内网要求的团队先别把它排进计划。

AI 之家 观点：这次重构真正的变化不是「能并行」，而是把并行的控制权交给了 Agent，同时把责任留在了 Git 上——分支、PR、merge conflict 这些团队已有的流程完全没变。选型的判断点因此从「它能不能拆任务」变成「你有没有足够强的 CI 去接住它拆出来的 PR」。没有 CI 兜底的团队，并行只会把集成风险放大。

Slash 命令（生产力关键）

Claude Code 内置了一套 slash 命令，是日常使用的核心：

learn-prompting.fr 2026-04 总结：成熟团队最常用的三个是 /compact（每 20-30 分钟一次防止 context drift）、/clear（新任务开新会话）、自定义命令（写在 .claude/commands/ 提交进 git）。

MCP 集成（一等公民）

MCP 是 Anthropic 自家协议，Claude Code 是 MCP 支持最完整的客户端。配置一次 .mcp.json，Claude Code 就能在对话里调任意 MCP server 暴露的 tool：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres", "postgresql://..."]
    }
  }
}

之后你就能直接说"查一下 users 表里最近 7 天注册的人数"——Claude Code 自动通过 MCP 跑 SQL，结果返回对话里继续讨论。

后台 / 远程模式

/background 让当前会话脱离终端，作为后台 agent 继续跑；/teleport 把网页端会话拉到本地终端继续；/remote-control 从手机或另一台机器接管这台机器的 Claude Code 会话。这套体系是面向"agent 长时间跑"设计的，区别于 Cursor 的"实时交互"。

价格与运行成本

根据 explainx.ai 2026-06 评测 和 Anthropic 官方定价 整理：

周限额变化（2026-08-30 官宣）：9 月 14 日起 Pro / Max / Team / 按席位 Enterprise 的标准周限额永久 +25%；5 月 13 日起的临时 +50% 促销（延期四次）9 月 13 日结束。按新基线算，相对当前 1.5x 的实际可用量减少约 17%——重度用户建议把大任务排进 9 月 13 日前，并把非强推理任务分流到 Cline + 国产模型（GLM-5.3-Flash、Qwen3.8-Flash）。API 按 token 计费（BYOK）不受此调整影响。

2026-10-08 更新（下表已过期，现役默认模型是 5.5 家族）：本节价格表最后一次核对是 2026-07，与当前的默认模型阵容已不一致。截至 v2.1.293，Claude Code 在 Anthropic API 上的三档默认模型全部换代为 5.5 家族（据官方 CHANGELOG 一手条目）：

三点必须注意：① 下表的 Sonnet 5「促销价到期回升 $3/$15」从未发生——官方定价页至今仍列 $2/$10，本站已撤回该推断；② Haiku 5.5 是分档定价，输入越过 100K token 时单价翻 5 倍，不要按「1M 上下文很便宜」直接上；③ Sonnet 5.5 的缓存读已降半，长会话场景的实际成本低于本节成文时的估算。详见 Haiku 5.5 发布资讯 与 Prompt Caching。

以下为 2026-07 核对的历史口径，保留作成本对照，不再代表当前默认模型的定价：

• Sonnet 5：促销 input $2 / output $10（至 2026-08-31），之后标准 $3 / $15 per 1M token（该「回升」未发生，见上方更新）
• Opus 4.8：input $5 / output $25 per 1M token（已大幅低于早期 Opus 4 的 $15/$75）
• Haiku 4.x：input $1 / output $5 per 1M token

SWE-bench Verified 参考：Opus 4.8 官方提交 87.6%、Sonnet 5 80.8%（Claude Code 内实测），是长任务编程能力的第一梯队。注意 Sonnet 5 换了新分词器，同文本 token 数约 +30%，核算成本要按实际 token 量。

ksred 博客真实使用日志：作者 8 个月用 ~100 亿 token，API 价折合 $15,000+，订阅实际只花 $800——订阅模式对重度用户极度划算，但前提是能搞定支付。

上手 5 分钟

# macOS / Linux / Windows (WSL)
curl -fsSL https://claude.ai/install.sh | bash

# macOS 用 Homebrew
brew install --cask claude-code

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# 验证 + 登录
claude --version
claude auth login          # 走浏览器 OAuth，绑定 Pro / Max 订阅
# 或用 API key
export ANTHROPIC_API_KEY=sk-ant-...

# 进项目，启动
cd your-project
claude /init               # 生成 CLAUDE.md
claude                     # 进入交互模式

国内使用注意事项

1. 账号：注册 claude.ai 需要海外手机号（Google Voice / Twilio 可，国内号被封死）
2. 支付：Pro / Max 订阅只收海外信用卡（MasterCard / Visa）+ 海外账单地址。第三方平台（如老张 / DMXAPI）可用支付宝走 API 代理，但是 BYOK 模式
3. 网络：终端 OAuth 流程对代理稳定性要求高，掉线会反复弹浏览器
4. 替代路径：用 Aider 或 Cline 接 DeepSeek-V3 / GLM-5.2 是国内最经济的"Claude Code 平替"思路

与同类怎么选

选 Claude Code 如果你：

• 重视长任务自主性 + 上下文管理
• JetBrains / Vim 用户，不想换 IDE
• 团队需要 SSH 远程 / 后台 agent 模式
• 已经在用 Claude Pro/Max，加 Code 是边际成本

别选 Claude Code 如果你：

• 国内、个人、预算紧（去 Aider + DeepSeek）
• 想要纯 IDE 内 inline 体验（Cursor）
• 主要写补全而非 agent 任务（GitHub Copilot）

避坑清单

• ANTHROPIC_API_KEY 优先级最高：你以为在用 Pro 订阅，但 env 里有 key 时实际走 API 计费——卡崩之前先 env | grep ANTHROPIC 检查
• 长会话不 /compact 会越来越笨：context 接近上限时，模型会开始忘记前面约定。社区共识：每 20-30 分钟 /compact 一次或 /clear 开新会话
• /model 切换是个坑：跨模型切会丢部分 context 据 r/ClaudeAI 反馈；建议起新会话指定模型
• /init 生成的 CLAUDE.md 要 review：自动生成的会有冗余/错误，第一次进项目花 5 分钟整理
• .claude/commands/ 自定义命令是放大器：把团队最常用的工作流写成 /deploy /migrate /review-pr，提交进 git
• 后台 agent + 重写大量文件 = 危险组合：长任务跑通常加 --permission-mode plan 或开 acceptEdits 但配合 git worktree
• Windows 原生支持有限：官方推荐 WSL，PowerShell 安装路径有时跑不通
• API token 烧钱速度：BYOK 模式下，复杂 refactor 单次任务可能消耗几百万 token

一手验证 · Claude Code近期变化

以下要点来自 AI 之家编辑部对官方信源的一手核实（逐条实录见对应见证页）；直接关系选型与成本的变化，采纳前建议复核最新状态。

• 2026-09-28 Claude Code v2.1.283（2026-09-25）新增 availableModelsMatch 与 deniedModels 托管设置：管理员可把可调用模型版本锁死为白名单，并单独否决指定模型（详见证录）
• 2026-09-27 Anthropic 官方账号 @ClaudeDevs 于 2026-09-25 宣布：Claude Code 在任务中途触发 5 小时用量上限时，不再在编辑过程中直接中断，而是从周限额里扣一小段固定额度，让 Agen……（详见证录）
• 2026-09-20 2026-09-17 起，Anthropic 把 Claude Code 的 Projects 从「存文件和聊天记录的文件夹」重做成编排结构：给定目标与仓库，coordinator 拆任务、派发给并行 thread，……（详见证录）
• 2026-08-30 Anthropic 官方账号 2026-08-30 宣布：9 月 14 日起 Pro/Max/Team/按席位 Enterprise 的 Claude Code 标准周限额永久上调 25%（详见证录）
• 2026-07-22 据 2026-07-22 的 AI Coding 日报，Claude Code 最新版本将核心运行时从 Node.js 切换至 Bun（Zig+Rust 重写），大型代码库响应速度提升约 40%、内存占用降 25%、……（详见证录）

相关阅读

• 同类对比：Cursor / Windsurf / Codex CLI / Aider / Cline
• 概念：AI Agent / 多 Agent 编排 / Function Calling / MCP / Context Engineering
• 模型：Claude Sonnet 5 / Claude Opus 4.5 / Claude Haiku 4
• 进阶：Vibe Coding / Prompt Engineering

Long-tail quick picks

长尾检索速查：下面三项对应「Claude Code 开源版 / 免费版 / 国内可用」等搜索意图，方便直接跳转。

Open-source alternatives

• 是否开源：否
• 闭源商业工具，无官方开源版；同类开源可看 Cline / Aider / OpenCode。

Free tier

• 是否有免费档：否
• 价格概要：API 按 token 计费 / Pro $20 / Max $100-$200 / Team Premium $100-$125 seat
• 无免费档，预算敏感可转 Trae（国内版免费）或 GitHub Copilot（$10/月）。

China availability

• 是否国内可用：否
• 中文友好度评分：3 / 5
• 国内访问需稳定代理；高频切 IP 可能触发风控。中文场景可考虑 Trae / 通义灵码 / Comate。

相关替代品：

• codex
• aider
• cline

来源

• 官网：https://claude.com/claude-code
• 官方文档：https://code.claude.com/docs/en/overview
• GitHub：https://github.com/anthropics/claude-code
• CLI Reference：https://code.claude.com/docs/en/cli-reference
• 官方定价：https://claude.com/pricing
• Projects 重构官方公告：https://claude.com/blog/projects-redesigned
• v2.1.275 / 276 / 277 版本记录：https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
• 第三方评测：laozhang.ai / explainx.ai / computingforgeeks.com / ksred.com / learn-prompting.fr

本卡片由 AI 之家 编辑部根据官方公开资料与第三方评测整理。所有事实点均标注来源；如发现价格 / 命令 / 功能与最新官方信息不一致，请通过 反馈邮箱 反馈。