Immutablerelease。只有 release 标题和说明可以修改。
What's changed
- 新增
virtualText到 mod 的 prompt decorations:绘制在提示框中的文本,永远不会进入草稿或提交的提示词 - 新增
cache_creation_5m_tokens和cache_creation_1h_tokens到 OpenTelemetryapi_request事件,按生命周期拆分缓存写入 - 新增
$.ui.view({ agentId })用于 mod:当你询问时,在主视图中显示智能体的对话记录,并且$.ui.view({})返回 - 新增了一个
dir属性,位于 mod 的Text用于从右到左的文本:在 Windows 和 VS Code 的终端中,其各行按该方向阅读并靠右对齐 - 新增
/advisor在 AWS 上的 Claude Platform;在你用以下选项选择之前,不会有 advisor 运行/advisor,advisorModel或--advisor,并且CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1将其关闭 - 新增 OpenTelemetry GenAI 语义约定属性到追踪 span,例如
gen_ai.provider.name,gen_ai.conversation.id,gen_ai.tool.name和error.type - 新增支持重写工作流智能体的
prompt和model在agent.spawnmod hook 中,此前它只能拒绝工作流智能体 - 新增了
prompt.changemod hook,当提示框的文本在没有键入编辑的情况下发生变化时触发:召回的历史条目、清空、撤销或插件的填充 - 修复了云会话告诉 Claude 某个组织策略阻止了某主机,而实际上是该会话自身的网络设置阻止了它
- 修复了
/autocompact在你选择更小的自动压缩窗口时警告 token 使用量过高 - 修复了当后台命令仍在运行时退出,SessionEnd hooks 有时不运行的问题
- 修复了
claude --help在其对以下内容的描述中命名了一个已移除的工具--restricted - 修复了
claude agents当其中一个拉取请求的数据返回不完整时,不刷新任何拉取请求状态的问题 - 修复了在云会话的容器被替换后,Claude 被告知某个后台智能体已丢失、无法恢复,而该智能体此前已经恢复过一次的问题
- 修复了你曾向其输入消息的子智能体在完成后不久从
/tasks中消失,导致无法回到该对话的问题 - 修复了在你查看子智能体时,已完成的父智能体从面包屑中掉出(其子智能体显示为重新扎根在顶层)的问题
- 修复了当输入突发到达时,智能体视图将诸如 "up"、"down" 或 "escape" 这样的键入词当作对应按键的问题,这可能会在回复中途移动预览或清空草稿
- 修复了自动工具搜索(
ENABLE_TOOL_SEARCH=auto)在对话中途关闭的问题,例如在恢复后 MCP 服务器重新连接时 - 修复了被以下项拒绝的登录
forceLoginOrgUUID会保留被拒绝组织的 token,或使其仍然有效的问题/login - 修复了 Claude Desktop 和 Remote Control 会话中的 diff 视图未注意到 reftable 仓库中冲突的 cherry-pick 或 revert 的问题
- 修复了 Artifact 工具的 verbose 和 ctrl+o 行读取问题
Artifact("(unprintable path)")当调用的输入到达时;其行现在会像 Bash 那样显示 "Waiting…" 和 "Running…" - 修复了恢复会话后写入的第一条 transcript 条目在崩溃截断 transcript 最后一行时丢失的问题
- 修复了
/branch丢弃消息,以及claude purge跳过子文件夹项目的问题,当它们包含 Unicode 行分隔符或段落分隔符(U+2028、U+2029)时 - 修复了插件
WorktreeCreate和WorktreeRemove钩子在 Claude Code 启动时未运行的问题,当启动时带有--worktree(尚未支持--tmux) - 修复了 OpenTelemetry
tool_result事件缺失的问题git_commit_id在git commit -q使用 reftable ref 存储的仓库中 - 修复了 mod 的
prompt.submit钩子重写或丢弃的提示仍被记录为已输入到 OpenTelemetryuser_prompt事件和交互 span 中,以及会话标题请求中的问题 - 修复了本应发给 Claude 的关于 mod 热重载的提示出现在 transcript 中,就像是你输入的一样的问题
- 修复了 agent 钩子忽略其
model:别名如haiku现在可以解析,子智能体的模型不再覆盖它,不可用的模型会回退到调用者的模型,而不是允许该操作 - 修复了
--worktree当标签或分支名称类似 commit ID 时,会话有时从错误的 commit 启动的问题,以及其起始 git status 命名了非新 worktree 的分支的问题 - 修复了分支显示为 ".invalid" 以及
--worktree在使用 git 的 reftable ref 存储的仓库中无法重新打开 worktree 的问题 - 修复了 Claude 在会话暂存区中用裸文件名或相对路径而非完整路径命名文件的问题
- 修复了
claude remote-control服务器在短暂的登录错误(例如钥匙串被锁定)后放弃续订连接的问题;它们现在会重试,并在你需要运行时发出警告claude /login - 修复了
--worktree在裸仓库的 worktree 中,当无法获取 origin 的默认分支时失败的问题;回退基准现在是当前 checkout 的 HEAD,而不是主仓库的 - 修复了在 VS Code、Cursor 或 Devin Desktop 集成终端中启动 Claude Code 时,编辑器的命令行工具被启动两次以检查扩展的问题;现在只启动一次
- 修复了 mod 的
prompt.edit钩子在使用chat:newline键绑定(Ctrl+J,或重新绑定的 Enter)输入换行时未被触发的问题 - 修复了当 API 拒绝某个 MCP 工具的输入 schema 时,对话每一轮都因 400 错误而失败的问题;Claude Code 现在会在该对话的剩余部分中不带参数地发送该工具
- 修复了当压缩发生在回复因输出 token 上限而被截断之后时,恢复无头或 Agent SDK 会话会丢失压缩所保留的近期消息的问题(从本版本起的压缩)
- 修复了当 MCP 服务器在压缩之后才完成连接时,Claude 直到下一次工具调用才被告知该服务器的工具和指令的问题
- 修复了在一台同时服务多个会话的计算机上,Remote Control 会话在仍在运行时被标记为已停止的问题
- 修复了当压缩发生在同一轮中重试或未完成的回复之后时,恢复无头或 Agent SDK 会话会丢失其压缩摘要或带回压缩前历史记录的问题
- 修复了 Claude 在后台命令运行期间轮询其输出文件或休眠的问题
- 修复了当 TLS 检查代理的证书仅通过操作系统证书存储被信任时,功能标志和分阶段发布保持陈旧的问题
- 修复了
claude daemon stop --any在卡住的后台服务仍在运行时打印 "stopped" 的问题:现在它会等待、强制终止该服务,如果服务仍然存在则以退出码 1 说明情况 - 修复了
claude daemon stop在遥测关闭时退出且无输出,并将会话列为仍在运行的问题 - 修复了 Cowork 云会话中的 Write、Edit 和 NotebookEdit 对你自己计算机上的路径报告成功,而文件从未到达的问题
- 修复了当会话恢复一段从未列出过延迟工具的历史记录时,Claude 会去搜索对话中早先已加载的延迟工具的问题
- 修复了在深色 ANSI 主题下以及 16 色终端上,次要(暗淡)文本看起来与普通文本相同的问题
- 修复了当组织的策略无法读取时,云会话每轮挂起 5 分钟的问题;现在该轮会迅速结束并说明原因
- 修复了当会话在长回复期间重启后,云会话有时会再次运行已回复过的消息的问题
- 自托管运行器:修复了在无人读取其输出时,运行器和编排器冻结(无轮询、
/healthz或SIGTERM关闭)的问题;日志保留最新的 256 KiB 并统计丢弃数(Windows 上除外) - 改进了 Cowork 云会话中的 WebFetch,告知 Claude 某页面刚刚获取失败,而不是再次抓取它
- 改进了内置的 mod 分享
plugin-authoringskill:Claude 在打开 mod 的文件前会先扫描其中的密钥,并在扫描项目外文件夹前先询问 - 改进了 Claude 3 模型收到的关于 @ 提及的 PDF 的提示,使它们更少在未阅读的情况下作答
- 改进了 artifact 更新:Claude 现在可在一次调用中应用小改动并重新发布 artifact,并在单个响应内完成较大编辑并重新发布
- 变更
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST会话以忽略 CA-bundle、tool-proxy、git TLS 和 git config 变量,例如SSL_CERT_FILE在设置中;在 Claude Desktop 下,仅在项目设置中 - 变更 exit,强制终止在被要求停止 1.5 秒后仍在运行的后台命令;在全屏模式下,它们此前可能被遗留运行
- 变更 Claude Desktop 的 Code 标签页,在以下情况应用托管设置
forceLoginGatewayUrl指定一个由 Anthropic 运营、为该会话主机名提供服务的网关;该网关必须在启动时可访问 - 变更
claude gateway在启动时停止,并指明密钥,针对一个desktop:Claude Desktop 无法从网关使用的策略键,此前它会带警告启动 - 变更发往 api.anthropic.com 的大请求,即使遥测被禁用也使用 gzip 压缩;设置
CLAUDE_CODE_GZIP_REQUEST_BODIES=0以将其关闭 - 变更
claude-apiskill,使 Managed Agents 会话保持原样,除非你要求归档或删除它们 - 变更后台会话,通过 Workflow 工具的审批恢复被携带的工作流,而不是从交接文件运行它
- 变更本地会话记录,同时记录每个 API 请求的系统提示、工具和参数,以便你选择分享的记录能精确复现某个请求
- 变更
/sandbox模式选项,将 "Sandbox BashTool" 改为 "Sandbox commands" - 变更
PermissionRequestCowork 云会话中的 hooks:hook 的 allow 中的setMode更新现在被忽略;审批的其余部分仍然适用 - 变更 hooks:
updatedInput来自 PreToolUse 和 PermissionRequest hooks 的内容现在像 Claude 自身的输入一样被校验:未知键会被丢弃,工具拒绝的输入会拒绝该调用 - 移除
--sandbox和--no-sandbox标志,从claude remote-control,它们没有效果;传入任一现在会以错误退出。设置sandbox.enabled在设置中以沙箱化会话 - [VSCode] 新增了
claudeCode.attachSelection用于阻止编辑器中选中的文本被添加到你的消息中的设置 - [VSCode] 修复了使用额度耗尽后快速模式仍保持开启的问题,该问题会导致每个请求被拒绝并重新发送;现在它会关闭,直到你重新开启,并显示错误提示
- [VSCode] 修复了在始终思考的模型上 Thinking 开关切换为 Off 的问题;这些模型不再显示该开关
- [VSCode] 修复了在被标记的消息上点击 "Edit prompt" 时,文件或命令菜单会覆盖在恢复的提示词上的问题;现在按 Enter 会按原文发送
- [VSCode] 修复了在 Windows 上按住 Shift 将文件拖到提示词上时插入不可读的
/c:/…路径,而不是相对于工作目录的提及 - [VSCode] 修复了 VS Code 聊天字体大小设置的更改需要重新加载窗口或被主题更改撤销的问题;diff 和计划预览现在也会遵循这些设置
- [VSCode] 修复了重新加载后恢复的 "Resume session" 和标签页会打开一个空的新对话,而不是已迁移到 git worktree 中的对话的问题
- [VSCode] 修复了在召回的历史斜杠命令上按 ↑ 再按 Enter 会在没有参数的情况下运行它的问题;命令和文件菜单不再覆盖在召回的历史提示词上,直到你编辑它
- [VSCode] 修复了在 WSL、SSH 和 Dev Container 窗口中,从资源管理器或编辑器标签页按住 Shift 将文件拖到提示词上时不插入任何内容的问题
- [VSCode] 修复了在 Windows 和 Linux 上 Ctrl+Alt+F 会切换 Focus 视图,而不是在资源管理器、其他树视图或调试控制台中打开查找的问题
- [VSCode] 修复了检查在其他窗口或终端中打开的会话时会在 macOS 上创建额外进程的问题:现在它会启动
/bin/ps直接启动,而不是在每次检查时搜索 PATH 中的pson every check - [VSCode] Windows:修复了在崩溃或断电后对话显示 "still open somewhere else" 的问题,此时 Windows 已重启并将旧进程 ID 分配给了另一个程序
- [Cloud sessions] 修复了在组织关闭 "Always allow" 的连接器工具中,Cowork 的审批提示缺少 "Allow for this task" 的问题(2.1.292 中的回归)
- [Cloud sessions] 修复了在你发送第二条消息后,/ 菜单中的大多数命令在云会话中丢失描述的问题
- [Remote Control] 修复了 claude.ai 和桌面应用上 Remote Control 会话中的 diff 视图将已删除和已重命名的文件显示为已修改的问题;需要你机器上的 Claude Code v2.1.296 或更高版本
- [Claude Tag] 新增对 Slack Connect 频道的支持:Owner 或 Claude Tag 管理员可以让 Slack 中的 Claude 在与另一个组织共享的频道中作答;该功能默认关闭
- [Claude Tag] 在 Slack 线程中新增了私密的 Allow once / Deny 卡片,用于需要你批准的连接器操作,这样 Claude 会询问而不是直接拒绝;其他人只能看到它正在等待你处理
- [Claude Tag] 在 Claude in Slack 中新增对 Slack 语音片段的支持:当 Slack 提供片段的转录文本时,Claude 会读取该转录文本
- [Claude Tag] 修复了 Claude in Slack 在 Claude 自己发布到频道的消息下的线程中,被另一个应用 @ 时不予回应的问题
- [Claude Tag] 更改了管理员附加到 Slack 频道的访问权限包的行为,使其在频道变为 Slack Connect 频道后继续生效,无需移除再重新附加
- [Code Review] 修复了 Code Review 忽略
@claude review拥有写入权限但其 GitHub 组织成员身份为私密的用户的评论;他们的评论现在会启动一次审查 - [Code Review] 修复了 Code Review 的“已为此仓库暂停”评论将管理员引导至 Code Review 设置的问题;现在它会说明谁可以修复该问题,并链接到 Git providers 页面