Claude Code v2.1.318:权限提示不再被误按的键答掉,配置文件坏了直接启动失败
Claude Code 于 2026-11-04 发布 v2.1.318:权限提示不再被紧随其后的按键误答、~/.claude.json 无效时非交互启动改为失败、IDE 终端不再自动装扩展,另修 --continue 丢上下文。
2026-11-05 · anthropics/claude-code GitHub Releases 官方 Release Notes 原文(tag 时间戳 2026-11-04T00:01:03Z,prerelease: false)
发布 2026-11-05核实 2026-11-05要点
v2.1.318于 tag 时间戳2026-11-04T00:01:03Z发布,prerelease: false,接替 11-03 的v2.1.317。生产请改钉v2.1.318。- 权限提示不再被「手快」的按键答掉:官方原文 "Fixed permission prompts being answered by keys typed just after sending a message, or before a slow prompt appeared"。此前你在提交消息后紧接着敲的键、或提示弹出前抢跑的键,可能被当成对权限提问的回答——在权限场景里,这等于把「误触」变成了「批准」。
-
~/.claude.json不是合法 JSON 时,非交互启动改为失败:不再用默认值覆盖,而是报错、说明如何恢复、并原样保留文件(关联anthropics/claude-code#87551)。你的配置不会再被静默清空,代价是流水线会在升级后第一次运行时直接红。 -
claude -p/ Agent SDK 又一处「假成功」被补:mod 钩住turn.step时,即使 API 错误截断了回复,此前也会报成功;现在不会。 Changed里有一条会直接改变使用方式:在 IDE 终端里启动时不再自动安装 / 更新 IDE 扩展。要用请从外部终端跑/ide,或用编辑器自己的扩展视图。Removed撤掉了 2.1.288 的一项保留:从 2.1.286 及更早版本发起的会话,--resume时保留早期 thinking 的行为被取消,那段 thinking 现在可能被丢弃——跨版本续聊的上下文占用会变。- 新增登录过期可见性:
claude auth status增加loginExpiresAt,claude -p的 JSON 结果增加credential_expires_at;claude -p文本输出在到期前 10 天开始打一行 stderr 提醒。 - 新增网关
assume_role(mantle上游):可跨 AWS 账号代入角色,用于按开发者归属成本。 deniedMcpServers的 URL 条目扩大生效范围:现在也会拦下上游 URL 匹配的 Anthropic 自带服务,以及云会话与自建 runner 上的 connector(会话拿到的是 connector 自己的 URL);要按名拦。
三条改动值得展开
一、权限提示的「抢跑按键」
这条写在 Fixed 里,容易被当成小毛病划过去。实际上它改的是人机信任边界:
- 交互式终端里,权限提示是阻塞式的——它出现时你按下的键,就是你的决定。
- 问题在于提示出现之前和出现之后极短窗口内的键入,此前也可能被算作回答。
- 于是「我发完消息顺手敲了个
y」与「我读了提示再敲y」在系统看来没有区别。
修复后,只有提示出现后的按键才算数。对单人使用这是体感细节;对共用终端、Tmux 多窗格、脚本化驱动 TTY 的场景,这是审批失效的真实风险点。同版还修了「macOS 上大量 Bash 命令并发时会话卡住、内存增长」——两件事都指向同一类问题:终端交互层在高并发下的状态错位。
二、配置损坏从「静默重置」改为「显式失败」
这一组共有五条,链条很清楚:
| 场景 | 旧行为 | v2.1.318 |
|---|---|---|
~/.claude.json 不是合法 JSON(非交互启动) | 用默认值覆盖 | 失败 + 提示恢复方法 + 原样保留(#87551) |
~/.claude.json 为空且无备份 | 判为损坏 | 按「文件不存在」正常启动 |
| 恢复命令指向空 / 截断的备份 | 恢复失败 | 已修 |
| 网络家目录写不进 | 登录态被空文件替换 | 先取新备份再删最后一份好的 |
只跑 claude -p 的家目录被保留期清理 | 删掉唯一备份 | 删前先做一次新备份 |
共同点:不再替用户做「重置成默认」这个决定。 这和上一版把退出码 0 改 1、把 Grep 超时改「不算完整结果」是同一条设计线——把静默容错换成显式报告。
三、IDE 扩展不再自动装
原文 "Changed Claude Code to no longer install or update the IDE extension when started in an IDE terminal"。此前在 VS Code / JetBrains 终端里启动会自动装扩展,现在不会了。
受影响的是「第一次上手」的路径:新机器上在 IDE 终端里 claude 一跑就能用,这版之后需要 /ide 或从扩展市场装。如果你的上手文档里写着「在 IDE 终端里跑 claude 即可」,这版会把它变成失效步骤。
其他与运维相关的条目
| 条目 | 影响 |
|---|---|
claude mcp add / remove 写配置前先拿锁,拿不到就等或退出 1 | 并发写配置不再互相覆盖;但脚本要处理退出码 1 |
/logout、claude auth logout、claude mcp remove 在配置写失败时不再报成功 | 之前是静默失败,现在会说出来 |
网络家目录上同一账号在另一终端重新登录,原作业不再报 Not logged in | 多机 / 多终端共用家目录的场景 |
| 后台子代理在所有 provider 上超过 3 分钟就把 shell 命令移到后台 | 目的是不让 prompt cache 过期;此前只在部分 provider 生效 |
| 「切换模型时提示」设为「每次询问」时,子代理停下而不是自动切模型 | fan-out 编排里,子代理会真的停 |
/permissions 各视图改用标准对话框,连按两次 Ctrl+C 变为返回 / 取消而非退出 | 手习惯要改 |
/claude-api managed-agents-onboard 新建 agent 的内置工具与模板 MCP 工具默认 auto 权限策略("Judge risky actions") | 与 Console 对齐,但默认权限变宽了;要收紧得显式说「run without asking」反向选择 |
自建 runner 编排日志格式变更(ok session=… 全级别打 stdout、字段顺序调整) | 匹配 retryable=true: 的脚本要改 |
AI 之家 观点
这一版没有头条功能,但它是近期最该尽快升的一版。 理由是那条权限提示修复:它把一个「可能被当成批准的误触」变成了「一定需要你确认」。这类修复不会出现在 release 标题里,也不会有人为它写博客,可它决定了无人值守流程到底可不可信。
第二条值得记住的是设计取向的一致性。从 v2.1.314 的写入边界、v2.1.317 的退出码,到这一版的配置文件,Anthropic 连做三件事:不再替用户静默兜底,改为明确失败并保留现场。这个方向对做自动化的人是好消息——失败比静默正确更容易排查;对习惯了「它自己会好」的人是坏消息,升级后第一波 CI 红是必然的。
保留意见两点:① managed-agents-onboard 把新 agent 的权限默认设成 auto,与「收紧默认」的整体方向相反,官方解释是对齐 Console,但默认更宽就是更宽;② Removed 掉的 thinking 保留属于跨版本兼容面的收缩,官方只说「可以被丢弃」,没说在什么条件下丢——跨版本续聊的成本变化需要自己测。
相关阅读
- Claude Code 工具卡——完整版本演进、定价与国内门槛
- Claude Code v2.1.317 资讯——上一版的三条判据变更
- Agent 记忆与上下文管理——自动压缩与 thinking 保留的关系
- 11-05 版本复核——同日其他 CLI 版本线
- OpenAI 收购 Pierre——同日行业侧的代码托管变局
来源
- ⭐ Claude Code v2.1.318 Release Notes(GitHub Releases 官方原文,tag 时间戳
2026-11-04T00:01:03Z,prerelease: false) - anthropics/claude-code Releases 列表(官方,同批核对
v2.1.317/v2.1.316/v2.1.314时间戳) - npm dist-tags 核对(
latest/next=2.1.318,stable=2.1.311)
取证边界:全部事实来自官方 Release Notes 原文与 npm dist-tags 查询,未在本机实测权限提示的按键时序,也未复现 --continue 丢上下文与 macOS 卡顿(前者需交互式 TTY 时序构造,后者需长时压测)。官方 Release Notes 标题为 What's changed,标题下不标注发布日期,本文时间取自 GitHub tag 时间戳,非厂商公布发布日。v2.1.313 / v2.1.315 两个序列缺口仍未获解释,本站不补写编号。
常见问题
v2.1.318 最该注意哪一条?
权限提示的误答修复。此前你在发出消息后紧接着敲的键,可能被当成对随后弹出的权限提示的回答——也就是「手快」有可能等于「批准」。这版改成权限提示不再接受这类提前输入的按键。对跑无人值守或多人共用终端的团队,这条比任何新功能都重要。
为什么说配置文件坏了直接失败反而是好事?
非交互启动(claude -p、SDK)此前遇到不是合法 JSON 的 ~/.claude.json 会用默认值覆盖它,等于把你的配置静默清空。这版改成启动失败、告诉你如何恢复、并原样保留文件(官方关联 issue #87551),同时空文件且无备份不再被判为损坏。代价是流水线会在升级后首次运行时暴露既有问题。
npm 上该装哪个版本?
dist-tags 里 latest 与 next 都是 2.1.318,但 stable 仍是 2.1.311。npm 全局安装默认取 latest,即 2.1.318;写死 stable 标签的脚本会停在 2.1.311。