All retained Claude Code updates

解读这次给 Claude 应用的网关配置（managed.policies[]）新增了一个 code 键。它的作用和原来的 cli 键一样，但专门针对 Claude Desktop 的 Code 标签页生效；在桌面端使用它还会顺带打开 Claude Desktop 的网关模式。对管理员来说，这意味着可以更精细地分别管控 CLI 和桌面端 Code 标签页的策略，而不必共用一套配置。

解读为 command 和 HTTP 类型的 hook 新增了 onFailure: "block" 选项。以前 hook 启动失败、超时或返回意外退出码时，Claude Code 会当作“没问题”继续执行动作；现在只要配成 block，这类失败会直接拦住后续操作，让 hook 变成真正的强制守门人。适合用来做安全/合规拦截，例如必须通过某个检查脚本才允许写文件：在 PreToolUse 的 hook 里加上 "onFailure": "block"，检查脚本崩了也不会被绕过。

解读这条更新改进了 Stop 和 SubagentStop 两类钩子（hook）中“用自然语言写指令”的 prompt hook 的判定方式。钩子是 Claude Code 里设置在特定时机自动执行的检查，Stop 在 Claude 准备结束回答时触发，SubagentStop 在子代理结束时触发。以前如果把这些钩子写成一句人话指令，比如「如果构建失败就继续修」，模型有时会误判为条件已满足而过早停下；现在判定更准确，Claude 更不容易在该继续干活时提前收工。实际使用中，这意味着你用一句话描述「什么情况下必须继续」时更可靠，例如在 Stop 钩子里写「构建通过前不要停止」，长任务被中途打断的情况会变少。

解读Claude Code 新增了 Claude Haiku 5.5 模型（claude-haiku-5-5），并把它设为 Anthropic API 上默认使用的 Haiku 模型。它的上下文窗口达到 100 万 token，价格是每百万输入/输出 token 0.10/0.50 美元（提示超过 10 万 token 时为 0.50/2.50 美元）。实际意义是：你需要一个又快又便宜的模型来处理大文件、长日志或批量小任务时，不用再手动指定模型名，默认的 Haiku 就能直接吞下超长上下文，且成本很低；需要更强推理时再切到更大的模型即可。

解读现在安装插件时可以直接指定插件市场，不用先手动添加。执行类似 `claude plugin install my-plugin --marketplace some-marketplace` 时，Claude Code 会先按与 `claude plugin marketplace add` 相同的安全策略检查并添加该市场，然后从里面安装插件，一步到位，省去了两条命令的操作。

解读此版本无值得关注的用户可见改进

解读新增了 serverToolUses 字段：当模组（mod）实现 turn.step 钩子时，现在能拿到本轮由 API 自己发起的工具调用（即 advisor 侧调用），每条包含 id、name、input、开始与结束时间。对插件作者来说，这意味着可以完整记录、展示或审计“服务端替你执行了哪些工具”，而不只是用户/模型显式发起的调用。例如你可以在钩子里把 serverToolUses 打印成日志，排查“这轮到底跑了哪些工具”。

解读这条更新给插件开发者增加了三项能力：一是新增 agent.spawn，让一个代理可以像“组队”一样再启动/派生其他代理（teammates）来分担任务；二是插件钩子（hook）事件现在使用统一的 agent id，插件在被触发时能稳定地识别“是哪个代理在调用我”，不再出现 id 对不上的情况；三是 $.agent.list 这个代理列表接口新增了“空闲（idle）”和“等待（waiting）”两种状态，插件可以据此判断某个代理是在闲着还是在排队等结果。为什么重要：以前插件只能被动响应，很难编排多个代理协作，也难以区分代理到底是空闲还是卡住；现在插件可以主动派生代理、追踪它们的身份和状态，从而写出“主代理派活给队友代理、并根据队友忙闲决定下一步”的自动化流程。例如，一个插件的钩子里可以调用 agent.spawn 启动一个专门跑测试的队友代理，然后轮询 $.agent.list 看到它从 waiting 变为 idle，说明测试跑完了，再继续后续步骤。

解读为自定义 mod（扩展）新增了一个读取选区的能力：调用 $.ui.selection 就能拿到你在全屏模式下最后一次选中的文本；如果这次选中正好落在某一条会话记录行内，还能同时拿到那一行的完整内容。这样 mod 就能基于“用户选中的东西”做事，例如做一个“解释这段/复制这一行”的快捷操作，而不用自己去解析终端画面。

解读新增「Claude Mods」机制：插件不再只能添加命令或钩子，而是可以修改 Claude Code 更深层的行为逻辑。这意味着第三方扩展在改动核心流程（如工具调用、会话处理方式）上有了更大的权限，能做以前做不到的深度定制。对使用者来说，安装一个 Mod 后 Claude Code 的工作方式可能被明显改变，而不仅是多几个命令；同时也意味着挑选插件时要更注意来源可信度。

解读当 Claude Code 同时积压了多个待批准的权限请求时，权限提示框现在会显示类似「2 of 5」的计数，让你知道当前正在处理第几个、总共还剩几个。以前多个请求排队时界面只显示当前这一条，容易让人以为处理完就结束了；现在能直观看到进度和剩余量，批量操作时更有掌控感。

解读新增环境变量 CLAUDE_CODE_DISABLE_WEB_FETCH，用来彻底关闭 WebFetch 工具。设置后 Claude Code 就不能再抓取网页内容，适合离线、内网或合规要求严格的环境，避免模型自动访问外部网址。例如在启动脚本里 export CLAUDE_CODE_DISABLE_WEB_FETCH=1，此次会话所有网页抓取调用都会被拒绝。

解读Claude Code 现在默认使用新的 Claude Sonnet 5.5 模型（claude-sonnet-5-5），这是 Anthropic API 上默认的 Sonnet 模型：支持 100 万 token 的上下文窗口，价格为每百万输入 token 2 美元、每百万输出 token 10 美元，缓存读取每百万 token 仅 0.2 美元。对使用者的意义是：不用手动切换模型就能享受更强的长文本处理能力（可一次读入更大的代码库或文档），同时成本明显更低，尤其是重复读取同一段上下文的缓存场景。

解读在使用企业 LLM 网关代理 Claude Code 的请求时，一次用户提问常常会触发多个底层 API 请求（例如主回复、工具调用、补全等）。现在这些请求会带上 x-claude-code-prompt-id 头，网关可以据此判断「哪些请求其实来自同一个用户提示」，从而做归组统计、限流、计费或审计。默认关闭，设置环境变量 CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 才会发送这些提示头。

解读新增了 maxProseWidth 配置项：在宽屏终端里，Claude 输出的正文（散文式解释文字）会被限制在一个较窄的宽度内，而表格和代码块仍然占满整个终端宽度。这样在超宽终端下长段落不会拉成一行几百字符、读起来费劲，同时代码和表格又不会被压窄影响可读性。比如你可以在设置里写 maxProseWidth: 100，那么解释文字最多约 100 列宽，表格照旧全宽显示。

解读Claude apps 网关现在能识别较新版本的 Claude Desktop 密钥，并把它们用于桌面端策略块（desktop policy blocks），例如 blockReadsOutsideWorkingDirectories（禁止读取工作目录之外的文件）和 disableBypassPermissionsMode（禁止跳过权限确认）。这意味着企业管理员可以用新版 Desktop 客户端统一下发这些安全策略，而不必因为密钥版本不同而失效。

解读Claude Code 新增了 Claude Opus 5.5 模型（标识符 claude-opus-5-5），并把它设为 Opus 档位的默认模型。它支持 100 万 token 的超长上下文，价格是每百万输入 token 4 美元、每百万输出 token 20 美元，缓存读取仅 0.20 美元/百万 token。对使用者的意义是：不用改配置就能自动用上更强的默认模型，而且超长上下文意味着可以一次把更大的代码库、日志或文档交给它分析；同时缓存读取价格很低，重复提问同一份大上下文时成本会明显下降。

解读Claude Code 的 Auto mode（自动模式，由模型自动判断某个操作是否可以执行，减少手动确认）现在改了默认行为：对 Claude API 和 Enterprise 用户，以及在 Bedrock、Vertex、Foundry 和各类网关上使用时，默认改用「服务端分类器」来判定，而服务端分类器这部分开销不会额外计费；如果某些情况下仍然走了会产生费用的回退路径，Claude Code 会给出警告提醒。Bedrock、Vertex、Foundry 和网关用户如果想恢复旧行为，可以设置环境变量 CLAUDECODEAUTOMODESERVER=0 关闭。实际意义：企业版和云平台用户默认更省钱，而且一旦出现意外计费会得到提示，方便排查。

解读Claude Code 现在支持读取 AGENTS.md 项目说明文件。当项目里没有 CLAUDE.md 时，它会自动改用 AGENTS.md 作为项目指令，这让习惯使用跨工具通用约定（AGENTS.md 被多个编码代理共同采用）的团队不必为了兼容再维护一份 CLAUDE.md。你可以通过 /config 里的「Project instructions」项来指定/修改要读哪个文件。注意：该能力目前在 Bedrock、Vertex 和 Foundry 上还不可用。

解读此版本无值得关注的用户可见改进

解读在通过网关登录 Claude apps 的流程里，新增了「已登录账号」的展示与确认步骤：当网关返回具体账号名时，你会先看到并使用该账号确认，确认后凭据才会被保存，`/status` 里也能查到当前用的是哪个账号。这样能避免凭据被默默保存到错误（或被伪造）的账号下，排查登录/权限问题时也一眼能看出身份。

解读当程序占用的内存接近危险水平时，Claude Code 现在会主动弹出明显的警告，并给出可操作的提示（比如如何释放内存、如何安全重启）。过去内存爆掉可能表现为卡死或突然崩溃，用户不知道发生了什么；现在能提前收到提醒并及时处理，避免正在进行的会话或任务丢失。

解读给通过 LLM 网关（企业代理/中转服务）使用 Claude Code 的场景新增了一组请求头：x-claude-code-request-class（请求类别）、x-claude-code-agent-type（是主代理还是子代理）、x-claude-code-prev-tool-durations（上一轮各工具耗时）、x-claude-code-compaction 与 x-claude-code-context-compacted（是否发生了上下文压缩）。默认关闭，需要通过环境变量 CLAUDECODEGATEWAYHINTHEADERS=1 显式开启。意义在于：网关管理员以前只能看到一堆不透明的请求，现在可以按代理类型做限流/路由/计费，也能判断某次请求变慢是不是因为上下文被压缩重写了。例如公司网关可以据此把子代理的请求发到便宜的小模型池，把主代理请求发到强模型池。

解读此版本无值得关注的用户可见改进

解读现在在 Claude Code 的远程会话（云端 runner 或自托管 runner）里也能用“快速模式”了。以前快速模式只在本地会话生效，远程会话拿不到这个加速选项。启用后，主机上配置的快速模式设置，或者你在会话里直接输入的 /fast，都会在远程会话中生效——前提是你的组织允许使用快速模式。

解读此版本无值得关注的用户可见改进

解读新增了 `claude plugin eval` 命令：可以对某个插件运行它自带的评测套件，并得到带评分的、可复现的结果（输出 JSON 和 HTML 报告）。以前想验证一个插件到底有没有效果、改动后有没有变差，只能靠人工试用；现在插件作者可以把评测用例固化下来，每次改动后跑一遍拿到可对比的分数，相当于给插件加了一套自动化回归测试。用法可以直接看 `claude plugin eval --help`。

解读Claude apps 网关新增了计费配置能力：在 gateway.yaml 里设置 pricing 后，已登录的 Claude Code 客户端会通过托管设置（managed settings）拿到同样的费率，因此客户端里 /cost 显示的费用、上报的遥测数据，都会和网关侧的消费计量保持一致。对企业来说，这意味着不再出现“网关后台看到的花费和开发者本地看到的对不上”的困惑，成本核算可以直接对齐。