Skip to content

第 34 周 · 8月24-28日 ​

--restricted 受限模式、modelPricing 让成本数字按组织合同价算、promptCacheTtl 把主对话缓存拉到 1 小时、新增 PreModelSwitch/PostModelSwitch 钩子,以及三处符号链接越权的安全修复。

版本范围: v2.1.242 → v2.1.251

重磅更新 ​

--restricted:把 Claude Code 关进只读盒子 ​

v2.1.248 起可用 --restricted(或 CLAUDE_CODE_RESTRICTED=1)启动:会执行命令或代码的内置工具与 WebFetch 全部移除(除非在 --tools 里点名保留),文件工具限定在工作目录内,bypassPermissions 被拒绝,用户/项目/本地设置文件一律忽略。

适合两类场景:给不受信的仓库做代码阅读,以及在 CI 里跑只分析不落地的任务。它不是权限模式的一档,而是启动期就把能力面砍掉,因此不存在「模式被绕过」的问题。

成本数字按组织的合同价算 ​

v2.1.243 新增 modelPricing 托管设置,/cost、状态栏与遥测的花费不再用目录价,而是用组织谈下来的价格与折扣系数。对内部要做成本分摊的团队,这一条比任何统计面板都实用。

同版还给 /usage 加了 Loops 分解:每个 loop 的运行次数、总 token、单次 token 与最近运行时间,用来揪出失控或跑得太勤的 /loop 任务。

提示缓存 TTL 可以拉到 1 小时 ​

v2.1.243 新增 promptCacheTtl 与 subagentPromptCacheTtl。API key 与云供应商用户可以让主对话保持 1 小时提示缓存,子 agent 维持 5 分钟。长会话反复被 5 分钟 TTL 打断的情况到此为止。

v2.1.248 补上了按 agent 的粒度:agent frontmatter 里的 experimental.cacheTtl("5m" 或 "1h")可以单独指定某个子 agent 的缓存 TTL。

模型切换现在可以被钩住 ​

v2.1.251 新增 PreModelSwitch 与 PostModelSwitch 钩子事件,可以拦截、确认或标注一次模型切换。同时 SessionStart 的恢复钩子会收到会话陈旧度与预估的重新缓存成本,便于自己判断「这个会话值不值得恢复」。

/cost 也在这一版加了按会话的提示缓存明细:命中率、未命中、重新缓存的 token、冷热状态,状态栏脚本可以读 prompt_cache 对象。

安全与权限 ​

  • v2.1.251 修复文件工具(Read/Write/Edit)会跟随「权限检查之后」在工作目录内被替换的符号链接,可能读写到批准范围之外
  • v2.1.251 修复市场条目声明的插件命令可指向插件目录之外,现按路径穿越错误拒绝
  • v2.1.251 修复 Grep 与 Glob 不对经由符号链接搜索路径到达的文件应用 Read(...) 拒绝规则
  • v2.1.246 对子命令前带通配符的 Bash 允许规则(如 Bash(git * main))给出启动告警,因为它同样会匹配插在子命令前的选项
  • v2.1.247 收紧 markdown 终端超链接渲染:指向网络或自动挂载路径、含控制字符、或以不可见字符开头的链接目标改按纯文本渲染

值得留意的行为变更 ​

  • v2.1.247 Sonnet 5 的默认自动压缩窗口改为完整 1M 上下文,会话约 967K token 才触发压缩(原约 934K)
  • v2.1.247 跨会话同伴消息默认折叠为一行 Message from @<sender>: <首行> 预览,Ctrl+O 展开全文
  • v2.1.248 跨会话消息(SendMessage/ListAgents)在 Bedrock、Vertex、Foundry 以及关闭遥测时同样可用
  • v2.1.248 /loop 的自定节奏动态模式与无提示词自主默认模式改为始终可用,含 Bedrock/Vertex/Foundry
  • v2.1.246 /goal 对长时间运行的后台工作,空闲会话每个目标最多主动检查三次,你的下一条消息再放行三次
  • v2.1.251 移除 6 种少用语言的语法高亮(1c、gml、isbl、mathematica、maxima、sqf),原生二进制共减小约 7.5 MB

稳定性修复要点 ​

  • v2.1.245 修复在 glibc 2.44 的发行版(Arch、CachyOS、Fedora Rawhide)上启动崩溃
  • v2.1.243 修复 /resume 只列出最近 50 个会话,现可滚动加载更多
  • v2.1.243 修复非交互(-p)与 SDK 会话里远程 MCP 服务器断连后永不恢复
  • v2.1.251 修复某一轮模型只产出思考内容后,对话卡在 text content blocks must be non-empty
  • v2.1.251 修复 Opus 5 在 effort 为 xhigh/max 且关闭思考时请求失败,该情况改按 high 发送
  • v2.1.246 修复自定义主题的 diff 颜色在 diff 与 /theme 预览中被忽略

新增能力速览 ​

  • v2.1.247 SendFeedback 工具:出错时 Claude 可起草反馈报告,你在 /feedback 审阅后发送(feedbackDrafts 关闭)
  • v2.1.247 /claude-api cost-optimize:围绕缓存、token 卫生、批处理、effort、模型选择做可度量的成本改动
  • v2.1.243 modelPicker 设置:用有序带标签的模型列表定制 /model 选择器
  • v2.1.243 /login → Anthropic Console 新增免密钥的「用 Console 账号登录」
  • v2.1.248 服务端托管设置诊断:加载失败时启动告警,/doctor 与 /status 说明原因
  • v2.1.251 前台子 agent 的工具调用与结果向 Remote Control 客户端实时流式推送

← 返回 What's New · 完整更新日志

Claude Code 中文文档 - 社区翻译项目