版本

Claude Code 最新版本与更新记录

Q: 升级后出问题，怎么回到旧版本？

把 autoUpdatesChannel 设为 stable，它通常落后一周并跳过有严重回归的版本。原生安装器也可以指定版本号安装，见 Anthropic 的 安装文档。

Q: 升级会影响中转的配置吗？

不会。ANTHROPIC_BASE_URL 和令牌写在 ~/.claude/settings.json 或环境变量里，升级不改它们。配置方法见 Claude Code 接入。

Q: 这一页多久更新一次？

页面顶部的发布日期就是最近一次核对的日期。最新版本号以 claude update 的输出和 CHANGELOG 为准。

发布于 2026 年 10 月 30 日 · 最后核对 2026 年 10 月 30 日

Claude Code 几乎每天发一个版本。这一页记下当前的最新版本、怎么升级，以及最近几个版本里对日常使用影响较大的变化，按 Anthropic 的 CHANGELOG 中文整理。版本号取自 npm 上 @anthropic-ai/claude-code 的发布记录，2026 年 10 月 30 日核对。

要点

latest 和 stable 两个通道的当前版本见下表，每小时从 npm 同步；stable 通常落后一周左右。
原生安装会在后台自动更新；Homebrew、WinGet 和 Linux 包管理器默认不自动更新，要手动升级。
claude --version 查看版本，claude update 立即升级，claude doctor 查看上次更新是否成功。
新发布的模型可能需要比 stable 通道更新的 Claude Code，想马上用就切到 latest 通道。

当前版本

通道	版本	发布日期	说明
latest（默认）	2.1.317	2026 年 11 月 2 日	新功能一发布就收到
stable	2.1.311	2026 年 10 月 26 日	通常落后一周左右，跳过有严重回归的版本

最近的发布：2.1.317（11 月 2 日）、2.1.316（10 月 31 日）、2.1.315（10 月 30 日）、2.1.314（10 月 30 日）、2.1.312（10 月 27 日）。版本号和日期每小时从 npm 同步，日期按 UTC。

怎么查看版本和升级

claude --version   # 查看当前版本
claude update      # 立即升级到所在通道的最新版本
claude doctor      # 检查安装、设置文件，以及上次自动更新的结果

原生安装（curl -fsSL https://claude.ai/install.sh | bash）会在后台自动更新。
Homebrew：claude-code 跟 stable 通道，claude-code@latest 跟 latest 通道，默认都不自动更新，用 brew upgrade claude-code 或 brew upgrade claude-code@latest 升级。
WinGet：默认不自动更新，用 winget upgrade Anthropic.ClaudeCode 升级。

切换 latest 和 stable 通道

在 Claude Code 里打开 /config，改 Auto-update channel；或者写进 ~/.claude/settings.json：

{
  "autoUpdatesChannel": "stable"
}

想关掉自动更新，在同一个文件的 env 里加 "DISABLE_AUTOUPDATER": "1"。用中转时，新模型上线后如果 stable 通道的版本还不认识它，切回 latest 再 claude update。

最近版本的重要变化

每个版本的完整列表很长，这里只挑对日常使用、以及通过网关或中转使用 Claude Code 影响较大的条目。

2.1.314（10 月 30 日）

新增 permissions.blockWritesOutsideWorkingDirectories：在任何权限模式下，Write、Edit 和 NotebookEdit 都拒绝写工作目录以外的路径。
VS Code 和 Claude Desktop 的 Code 标签页新增空闲压缩：超过 20 万 token 的对话闲置后会先做摘要，提示缓存过期后下一条消息就用摘要继续。
修复：网关不接受工具搜索的 tool_reference 块时请求反复被拒；现在会去掉工具搜索重发一次，并在本会话里记住。
修复：管理员限制了模型的 effort 时，会话每轮都报 “Invalid effort level”；现在会自动降低 effort 重试，并说明用了哪一档。
修复：claude -p 启动失败时以退出码 0 静默退出；现在会打印错误并以 1 退出。

2.1.312（10 月 27 日）

修复：Claude 只看了开头就覆盖子目录里很大的 CLAUDE.md、规则文件或被 @ 引用的文件；现在 Write 会要求先读完或原地编辑。
修复：在 git 仓库里用 Bash cd 进更深的目录后，按目录生效的 skill 找不到。
用量限制的提示把 5 小时窗口改称 “5-hour limit”，不再叫 “session limit”。
prompt 和 agent 钩子每个会话最多同时运行 24 个（含子代理）。

2.1.311（10 月 26 日）

修复：标准上下文的会话在请求超过 20 万 token 时报 “Usage credits required for 1M context” 并停下；现在会压缩对话后继续。
修复：CLAUDE.md 里有很长的列表项时，启动和读写文件后长时间卡住。
修复：自动压缩后 Claude 看到的 MEMORY.md 和 CLAUDE.md 仍是旧内容。
修复：子代理用不了在它启动之后才连上的 MCP 服务器的工具。

2.1.310（10 月 23 日）

修复：部分网关和兼容服务器拒绝 effort-2025-11-24 beta 值或对话中途的系统消息，导致请求失败；现在会去掉它们重试。通过网关或中转使用的话，建议至少升级到这个版本。
修复：“Prompt is too long” 之后的压缩对 base64、SVG 这类密集文本保留过多，下一次请求又失败。
非交互会话（-p、Agent SDK）在转录文件很大时，压缩阶段的内存占用降低。

常见问题

升级后出问题，怎么回到旧版本？

把 autoUpdatesChannel 设为 stable，它通常落后一周并跳过有严重回归的版本。原生安装器也可以指定版本号安装，见 Anthropic 的安装文档。

升级会影响中转的配置吗？

不会。ANTHROPIC_BASE_URL 和令牌写在 ~/.claude/settings.json 或环境变量里，升级不改它们。配置方法见 Claude Code 接入。

这一页多久更新一次？

页面顶部的发布日期就是最近一次核对的日期。最新版本号以 claude update 的输出和 CHANGELOG 为准。

来源

anthropics/claude-code：CHANGELOG.md
npm：@anthropic-ai/claude-code（版本号与发布日期，dist-tags 中 latest 与 stable）
Claude Code：Set up Claude Code（自动更新、发布通道、claude update、claude doctor）