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 均未给出厂商公布发布日，非厂商官方公布日期。

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

核心特性

终端原生的 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 之家 编辑部根据官方公开资料与第三方评测整理。所有事实点均标注来源；如发现价格 / 命令 / 功能与最新官方信息不一致，请通过 反馈邮箱 反馈。