跳到主内容

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 保留属于跨版本兼容面的收缩,官方只说「可以被丢弃」,没说在什么条件下丢——跨版本续聊的成本变化需要自己测。

相关阅读

来源

取证边界:全部事实来自官方 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。

相关对比

Aider vs Claude Code:终端 AI 编程双雄怎么选

Aider vs Claude Code 2026 选型对比:开源 BYOK 多模型 vs Anthropic 订阅长任务 Agent,从编程能力、多模型支持、价格、Git 集成、国内可用性和适合人群判断,帮你选对终端 AI 编程工具。

Claude Code vs Cline:CLI AI Agent 怎么选?2026 对比

Claude Code vs Cline 2026 选型对比:Anthropic 官方闭源 CLI Agent vs Apache-2.0 开源 VS Code 插件。从模型绑定、工作流、MCP 支持、价格、隐私和适合人群 6 个维度帮你选对 CLI AI 编程工具。

Claude Code vs Codex CLI:终端 AI Agent 双雄对比

Claude Code vs Codex CLI 2026 选型对比:Anthropic 与 OpenAI 两大官方终端 Agent 的模型、长任务、MCP 生态、Windows 支持、订阅打包价格和国内可用性全方位对比,帮你判断该用哪个终端 AI Agent,以及能不能两个一起用。

Claude Code vs Crush:Anthropic 官方 vs 多模型 TUI(2026 实测选型)

Claude Code vs Crush 怎么选:Anthropic 官方 CLI(长任务最稳),对上 Charmbracelet 开源 TUI(多模型切换 + LSP)。按模型、长任务、价格对比。

Cursor vs Claude Code:什么时候用哪个?(2026 实测选型)

Cursor 和 Claude Code 到底怎么选?一句话结论 + 决策树 + 价格实测 + 国内可用性对比。GUI 派选 Cursor,终端长任务派选 Claude Code,最优解其实是共存。

Devin vs Claude Code:AI 编程 Agent 怎么选?异步自主 vs 终端同步对比

Devin vs Claude Code 2026 选型对比:Cognition 异步自主 Cloud Agent vs Anthropic 终端同步 CLI Agent,从形态、工作模式、长任务能力、并发、价格、中文支持和适合人群 8 个维度判断,帮你选对 AI 编程 Agent。

相关评测