# Claude Code 2.0：发布时间、新功能和升级方法 > Claude Code 2.0 于 2025 年 9 月 29 日发布，2026 年 10 月 31 日的最新版是 2.1.316。附各种安装方式的升级命令和实测结果。 - Canonical HTML: https://omniakey.com/zh/blog/claude-code-2-0 - Markdown: https://omniakey.com/zh/blog/claude-code-2-0.md - Published: 2026-10-31 (updated 2026-10-31) - Author: Kiki, COO at OmniaKey - Language: zh - Category: Guide - Reading time: 10 min - All posts: https://omniakey.com/blog/llms.txt --- Claude Code 2.0 于 2025 年 9 月 29 日发布，带来了 VS Code 扩展、改版的终端界面，以及能用 `/rewind` 回退的检查点。它已经不是当前版本：2.0 系列停在 2026 年 1 月 6 日的 2.0.77，2026 年 10 月 31 日的最新版是 2.1.316。 |版本|发布时间|状态| |-|-|-| |2.0.0|2025年9月29日|2.0 首个版本| |2.0.77|2026年1月6日|最后一个 2.0.x| |2.1.0|2026年1月7日|2.1 首个版本| |2.1.316|2026年10月31日|最新| 原生安装这样升级： ```bash claude update claude --version ``` ## Claude Code 2.0 是什么时候发布的？ Anthropic 在 2025 年 9 月 29 日 14:41 UTC 把 2.0.0 发到 npm，同一天发布了公告「Enabling Claude Code to work more autonomously」（npm registry，2026 年 10 月 31 日核对）。2.0 系列一共发布 70 个版本，最后一个是 2026 年 1 月 6 日的 2.0.77。其中 2.0.74 发布于 2025 年 12 月 19 日，2.0.76 发布于 2025 年 12 月 22 日。 2.1.0 在第二天，也就是 2026 年 1 月 7 日上线。到 2026 年 10 月 31 日，registry 里一共有 555 个版本，`latest` 标签指向 2.1.316，`stable` 指向 2.1.309。Anthropic 的安装文档说，stable 渠道一般比 latest 晚一周左右，还会跳过有严重问题的版本（2026 年 10 月 31 日核对）。 ## Claude Code 2.0 新增了什么？ 2025 年 9 月 29 日的公告和 2.0.0 的 changelog 里，主要变化是这几项： - 原生 VS Code 扩展（beta），带侧边栏面板和行内 diff。 - 重做的终端界面，状态信息更清楚，Ctrl+r 可以搜索历史提示。 - 检查点：每次改动前保存代码状态。 - Claude Code SDK 改名为 Claude Agent SDK。 - 发布时的默认模型是 Claude Sonnet 4.5。 2.0.0 的 changelog 一共 10 条，其中四条原文是： - 「New native VS Code extension」 - 「Fresh coat of paint throughout the whole app」 - 「/rewind a conversation to undo code changes」 - 「/usage command to see plan limits」 检查点今天还是这套规则：每次发出开启新一轮的提示都会建一个检查点，一个会话保留最近 100 个，快照在会话最后一次保存快照后约 30 天删除。`/rewind` 或者空提示时按两下 Esc 会打开菜单，四个选项是恢复代码和对话、只恢复对话、只恢复代码，或者总结。只由 Bash 命令改动过的文件不会被记录，subagent 的改动通常也抓不到，所以大改之前先用 git 提交。 ## 2.0 之后有哪些变化？ 2025 年 12 月 19 日的 2.0.74 加了 LSP（Language Server Protocol）工具，可以跳转定义、查找引用、看悬停文档。2026 年 1 月 7 日的 2.1.0 有 15 项变化，其中包括： - skills 新建或修改后立即生效，不用重启。 - skills 可以用 `context: fork` 跑在分叉出来的子 agent 里。 - 新增 `language` 设置，决定 Claude 用哪种语言回复。 - iTerm2、WezTerm、Ghostty 和 Kitty 里，Shift+Enter 直接可用。 - 修掉了 OAuth token、API key 和密码可能出现在调试日志里的安全问题。 从 2026 年 3 月 31 日的 2.1.89 起，发布包的 manifest 带签名，更早的版本只有校验和。npm 包现在要求 Node.js 22 以上，2.0.0 时是 Node.js 18 以上。Pro、Max、Ultra、Team、Enterprise 和 Anthropic API 的默认模型已经是 Opus 5.5。 ||2.0（2025）|现在| |-|-|-| |版本|2.0.0|2.1.316| |默认模型|Sonnet 4.5|Opus 5.5| |npm 的 Node|18+|22+| |CLI 选项|40|66| |命令|6|18| 「CLI 选项」和「命令」两行，数的是 2.0.76 和 2.1.316 的 `claude --help` 输出。 和 2.0.76 比，2.1.316 的帮助输出里能看到这些变化： - 新命令包括管理后台 agent 的 `agents`，管理后台会话的 `attach`、`logs`、`stop` 和 `rm`，还有 `auth`、从别的 AI 编程工具导入配置的 `import`、删除本机上某个项目的 Claude Code 数据的 `purge`，以及做云端多 agent 代码审查的 `ultrareview`。 - 新选项，包括为会话新建 git worktree 的 `--worktree`、从 `low` 到 `max` 的 `--effort`、在后台启动会话的 `--bg`、`--remote-control`、关掉所有自定义配置启动的 `--safe-mode`，以及 `--name`。 - `--permission-mode` 去掉了 `default` 和 `delegate`，加了 `auto` 和 `manual`，脚本里传 `default` 或 `delegate` 的要换新值。 - 只有一个选项消失了：`--mcp-debug`，它在 2.0.76 里已经标为弃用。 ## 怎么查看版本并升级 Claude Code？ 先跑 `claude --version` 看自己的版本，它会打印版本号加 "(Claude Code)"，例如 `2.1.316 (Claude Code)`。然后按当初的安装方式升级。 ```bash # 原生安装 claude update ``` ```bash # Homebrew，stable 渠道 brew upgrade claude-code # Homebrew，latest 渠道 brew upgrade claude-code@latest ``` ```bash # WinGet winget upgrade Anthropic.ClaudeCode ``` ```bash # npm npm install -g @anthropic-ai/claude-code@latest ``` 原生安装在后台自己更新，启动时和运行中都会检查，新版本下次启动才生效。Homebrew、WinGet 和 Linux 包管理器（apt、dnf、apk）装的要手动升级。在原生安装上跑 `claude update`，会打印下面前两行之一，Homebrew、WinGet 和 apk 装的打印第三行。 ```text Successfully updated from to version Claude Code is up to date () Claude is up to date! ``` `claude doctor` 显示上一次升级的结果和自动更新有没有开。VS Code 扩展的版本号，就是它内置的 Claude Code 版本。 npm 装的不要用 `npm update -g`，它沿用当初安装时的版本范围，可能到不了最新版。也不要用 `sudo npm install -g`。 ## 旧版本 2.0 升级时会发生什么？ 2026 年 10 月 31 日，我们在一台 Node.js 26.12.1 的 Mac 上跑了五次全新安装。每次都用一个空的 home 目录，并通过 OmniaKey 的 API 调用 Claude 模型。 |安装方式|能启动|升级后| |-|-|-| |原生 2.0.0|是|2.1.308| |原生 2.0.76|是|2.1.314| |npm 2.0.76|是|失败| |npm 2.0.0|崩溃|没跑| 两个原生安装都正常启动，`claude update` 也都把它们升到了 2.1.x。2.0.0 安装用了 36.6 秒，升级用了 35.6 秒。2.0.76 安装用了 51.6 秒，升级用了 29.6 秒。 ```text Successfully updated from 2.0.0 to version 2.1.308 Successfully updated from 2.0.76 to version 2.1.314 ``` 两次都没有升到当时 npm 上最新的 2.1.316，所以升级之后要跑 `claude --version` 确认，不要直接当成已经最新。 npm 的 2.0.76 能启动，但升级失败： ```text New version available: 2.1.316 (current: 2.0.76) Error: Failed to install update Or consider using native installation with: claude install ``` 版本停在 2.0.76。npm 的 2.0.0 更早出问题：在这台机器的 Node.js 26.12.1 上启动就崩，退出码 1。 ```text TypeError: Cannot read properties of undefined (reading 'prototype') ``` 同一台机器上原生的 2.0.0 启动正常，所以这是 npm 版 2.0.0 在这个 Node 版本上的问题。npm 的 2.1.316 装上后正常启动，打印 `2.1.316 (Claude Code)`。用 npm 装的话，升级用上面那条 npm 命令，或者照报错里的提示，用 `claude install` 换成原生安装。 旧版本还会占磁盘。原生升级之后，新旧两个版本都留在 `~/.local/share/claude/versions/` 下，启动器指向新的那个。我们量到的二进制大小：2.0.0 是 74 MB，2.0.76 是 182 MB，2.1.308 是 275 MB，2.1.314 是 279 MB。 ## 怎么锁定版本、回滚或延后升级？ 装指定版本，用同一个脚本加版本号： ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` ```powershell & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89 ``` 把版本号换成 `stable` 就在 stable 渠道起步。安装时选的渠道会成为自动更新的默认渠道，之后可以在 settings.json 里改： ```json {"autoUpdatesChannel": "stable"} ``` `latest` 是默认值，一有新版本就装。`stable` 一般是一周前的版本，会跳过有严重问题的发布，`/config` 里也有同一个开关。新发布的模型可能要求比 stable 渠道更新的版本，想马上用就换到 latest。 `minimumVersion` 设一条下限，自动更新和 `claude update` 都不会装更旧的版本： ```json {"minimumVersion": "2.1.143"} ``` `DISABLE_AUTOUPDATER` 设成 1（放在 settings.json 的 env 里）只关掉后台检查，`claude update` 照样能用。`DISABLE_UPDATES` 会挡住所有升级方式，手动也不行。 GitHub 上有两位用户报告过相关的坑。2026 年 2 月 12 日，一位用户报告了这个问题（[issue #25165](https://github.com/anthropics/claude-code/issues/25165)，已关闭）： > When running `curl -fsSL https://claude.ai/install.sh | bash -s ` to install a specific version, the script downloads the new binary but fails to update the symlink, leaving the user on the old version. 大意是装指定版本时，脚本下载了新的二进制，却没有更新软链接，用户还停在旧版本。 2026 年 5 月 17 日，一位 Windows 用户报告，在 stable 渠道下装了 2.1.143 之后，自动更新把它换回了当时 stable 的 2.1.133。把 `autoUpdatesChannel: "latest"` 和 `minimumVersion: "2.1.143"` 一起设上之后，原话是「stopped the revert」，也就是不再被降回去（[issue #60065](https://github.com/anthropics/claude-code/issues/60065)，已关闭）。 锁完版本，记得跑 `claude --version` 确认数字对。 ## 旧版本还能用吗？ Anthropic 没有公布旧版本的截止日期，我们查过的官方页面也没有说 2.0.x 会被拒绝。不过 API 仍可能返回 400 `claude_code_version_too_old`。原因有两种：你选的模型要求更新的版本，或者你的组织策略要求更新版本（Anthropic 错误文档，2026 年 10 月 31 日核对）。 通过网关使用时，旧安装内置的默认模型可能让它直接用不了。不指定模型启动时，2.0.76 会请求它内置的 `claude-sonnet-4-5-20250929`，我们的网关不提供这个模型，请求就失败了。2.1.316 请求的是 `claude-opus-5-5`，正常回答。 所以要自己用 `--model` 或 `ANTHROPIC_MODEL` 环境变量指定模型。用 `--model claude-sonnet-5-5` 指定之后，2.0.76 顺利修好了下面那个 bug。 早期的 2.0 本身也有问题。2025 年 10 月 1 日有用户报告，Claude Code 2.0.0 和 2.0.1 在 Linux 的 Emacs 和 shell 里界面一直卡死（[issue #8657](https://github.com/anthropics/claude-code/issues/8657)，已关闭）。 所以没有特别理由就升级。留在 2.0 的话，每次会话自己指定模型。 ## 新版本在同一个任务上更好吗？ 我们用同一个修 bug 任务跑了 2.0.76 和 2.1.316，非交互模式，都带 `--model claude-sonnet-5-5`。 任务： > The tests in test\_wordcount.py fail. Find the bug in wordcount.py, fix it, and run python3 test\_wordcount.py to confirm. Do not change the test file. 问题出在统计单词时区分了大小写。 ||2.0.76|2.1.316| |-|-|-| |改法|同一行|同一行| |之后测试|通过|通过| |用时|25.8 s|15.9 s| |轮次|5|5| |CLI 估算费用|$0.129|$0.055| |缓存读取|50,547|34,306| 两个版本改的是同一行，都在统计前用 `text.lower()` 把文本转成小写，也都没碰测试文件。改完测试都通过，两份 diff 逐字节相同，新版本省下的是时间，答案没有变。 2.1.316 用了 15.9 秒，2.0.76 用了 25.8 秒，用时少了 38%，Claude Code 自己估算的费用是 $0.055 对 $0.129，主要因为它读写的缓存 token 更少。这两个美元数字是 Claude Code 自己的估算，不是我们实际付的钱。一个任务、每个版本各跑一次，样本很小。 ## 国内怎么用 在国内可以用人民币直接充值，支持支付宝和微信支付。充值后建一个 OmniaKey key，按下一节设好两个环境变量，就能在 Claude Code 里调用 Claude 模型，同一个 key 也能给别的工具用。 ## 怎么用 API key 代替订阅？ Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号，免费的 claude.ai 套餐不包含它。接网关要设两个变量：`ANTHROPIC_BASE_URL` 决定请求发到哪里，另一个是凭证，其中 `ANTHROPIC_AUTH_TOKEN` 按 `Authorization: Bearer` 发送，`ANTHROPIC_API_KEY` 按 `x-api-key` 发送。base URL 只改请求去哪，不改哪个模型回答，所以模型也要自己指定。 ```bash export ANTHROPIC_BASE_URL="https://api.omniakey.com" export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key" claude --model claude-sonnet-5-5 ``` 上面的测试都是这么跑的，OmniaKey 的 key 放在 `ANTHROPIC_AUTH_TOKEN` 里。 两个变量怎么填、Windows 上怎么设，见 [Claude Code API key 指南](https://docs.omniakey.com/cn/guides/claude-code-api-key)。一步步的配置看 [我们的安装教程](https://omniakey.com/zh/blog/claude-code-setup) 和 [不订阅也能用 Claude Code](https://omniakey.com/zh/blog/claude-code-api-without-subscription)。 [Claude Opus 5.5](https://omniakey.com/zh/claude-opus-5-5) 和 [Claude Sonnet 5.5](https://omniakey.com/zh/claude-sonnet-5-5) 的模型页写了各自适合做什么。套餐价格见 [Claude Code 价格](https://omniakey.com/zh/blog/claude-code-pricing)。 ## 常见问题 ### Claude Code 2.0 是最新版本吗？ 不是。2.0 系列停在 2026 年 1 月 6 日的 2.0.77。2026 年 10 月 31 日的最新版是 2.1.316，跑 `claude --version` 看自己装的是哪个。 ### Claude Code 2.0 什么时候发布的？ 2025 年 9 月 29 日。2.0.0 在这一天发到 npm，和 Anthropic 的公告同一天，2.1 系列从 2026 年 1 月 7 日开始。 ### 怎么升级 Claude Code？ 原生安装跑 `claude update`，或者等它在后台自动更新。Homebrew 跑 `brew upgrade claude-code` 或 `brew upgrade claude-code@latest`，WinGet 跑 `winget upgrade Anthropic.ClaudeCode`，npm 跑 `npm install -g @anthropic-ai/claude-code@latest`。升级完用 `claude --version` 确认。 ### 怎么装旧版本的 Claude Code？ 把版本号传给安装脚本。macOS、Linux、WSL 用 `curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89`，PowerShell 用 `& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89`。 ### Claude Code 能免费用吗？ 不能。免费的 claude.ai 套餐不包含 Claude Code，它需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号。另一条路是 API key，来自 Anthropic Console 或网关，按用量计费。 ## 来源核对 - [npm 上的 @anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code)，2026 年 10 月 31 日核对 - [Anthropic 发布公告](https://www.anthropic.com/news/enabling-claude-code-to-work-more-autonomously)，2026 年 10 月 31 日核对 - [Claude Code changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)，2026 年 10 月 31 日核对 - [安装文档](https://code.claude.com/docs/en/setup)，2026 年 10 月 31 日核对 - [检查点文档](https://code.claude.com/docs/en/checkpointing)，2026 年 10 月 31 日核对 - [LLM 网关文档](https://code.claude.com/docs/en/llm-gateway-connect)，2026 年 10 月 31 日核对 - [模型配置](https://code.claude.com/docs/en/model-config)，2026 年 10 月 31 日核对 - [错误说明](https://code.claude.com/docs/en/errors)，2026 年 10 月 31 日核对 - [VS Code 扩展](https://code.claude.com/docs/en/vs-code)，2026 年 10 月 31 日核对 - [Pro、Max、Ultra 套餐说明](https://support.claude.com/en/articles/11145838-use-claude-code-with-your-pro-max-or-ultra)，2026 年 10 月 31 日核对 - [GitHub issue #8657](https://github.com/anthropics/claude-code/issues/8657)，2026 年 10 月 31 日核对 - [GitHub issue #25165](https://github.com/anthropics/claude-code/issues/25165)，2026 年 10 月 31 日核对 - [GitHub issue #60065](https://github.com/anthropics/claude-code/issues/60065)，2026 年 10 月 31 日核对