Claude Code 2.0：发布时间、新功能和升级方法

Claude Code 2.0 于 2025 年 9 月 29 日发布，带来了 VS Code 扩展、改版的终端界面，以及能用 /rewind 回退的检查点。它已经不是当前版本：2.0 系列停在 2026 年 1 月 6 日的 2.0.77，2026 年 10 月 31 日的最新版是 2.1.316。

原生安装这样升级：

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。

「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)。然后按当初的安装方式升级。

# 原生安装
claude update

# Homebrew，stable 渠道
brew upgrade claude-code
# Homebrew，latest 渠道
brew upgrade claude-code@latest

# WinGet
winget upgrade Anthropic.ClaudeCode

# npm
npm install -g @anthropic-ai/claude-code@latest

原生安装在后台自己更新，启动时和运行中都会检查，新版本下次启动才生效。Homebrew、WinGet 和 Linux 包管理器（apt、dnf、apk）装的要手动升级。在原生安装上跑 claude update，会打印下面前两行之一，Homebrew、WinGet 和 apk 装的打印第三行。

Successfully updated from <old version> to version <new version>
Claude Code is up to date (<version>)
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 模型。

两个原生安装都正常启动，claude update 也都把它们升到了 2.1.x。2.0.0 安装用了 36.6 秒，升级用了 35.6 秒。2.0.76 安装用了 51.6 秒，升级用了 29.6 秒。

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 能启动，但升级失败：

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。

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。

怎么锁定版本、回滚或延后升级？

装指定版本，用同一个脚本加版本号：

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

把版本号换成 stable 就在 stable 渠道起步。安装时选的渠道会成为自动更新的默认渠道，之后可以在 settings.json 里改：

{"autoUpdatesChannel": "stable"}

latest 是默认值，一有新版本就装。stable 一般是一周前的版本，会跳过有严重问题的发布，/config 里也有同一个开关。新发布的模型可能要求比 stable 渠道更新的版本，想马上用就换到 latest。

minimumVersion 设一条下限，自动更新和 claude update 都不会装更旧的版本：

{"minimumVersion": "2.1.143"}

DISABLE_AUTOUPDATER 设成 1（放在 settings.json 的 env 里）只关掉后台检查，claude update 照样能用。DISABLE_UPDATES 会挡住所有升级方式，手动也不行。

GitHub 上有两位用户报告过相关的坑。2026 年 2 月 12 日，一位用户报告了这个问题（issue #25165，已关闭）：

When running curl -fsSL https://claude.ai/install.sh | bash -s <version> 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，已关闭）。

锁完版本，记得跑 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，已关闭）。

所以没有特别理由就升级。留在 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.

问题出在统计单词时区分了大小写。

两个版本改的是同一行，都在统计前用 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 只改请求去哪，不改哪个模型回答，所以模型也要自己指定。

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 指南。一步步的配置看 我们的安装教程 和 不订阅也能用 Claude Code。

Claude Opus 5.5 和 Claude Sonnet 5.5 的模型页写了各自适合做什么。套餐价格见 Claude Code 价格。

常见问题

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，2026 年 10 月 31 日核对
• Anthropic 发布公告，2026 年 10 月 31 日核对
• Claude Code changelog，2026 年 10 月 31 日核对
• 安装文档，2026 年 10 月 31 日核对
• 检查点文档，2026 年 10 月 31 日核对
• LLM 网关文档，2026 年 10 月 31 日核对
• 模型配置，2026 年 10 月 31 日核对
• 错误说明，2026 年 10 月 31 日核对
• VS Code 扩展，2026 年 10 月 31 日核对
• Pro、Max、Ultra 套餐说明，2026 年 10 月 31 日核对
• GitHub issue #8657，2026 年 10 月 31 日核对
• GitHub issue #25165，2026 年 10 月 31 日核对
• GitHub issue #60065，2026 年 10 月 31 日核对