10.4 版本更新与国内适配
版本更新命令
Claude Code 支持多种更新方式:
claude update # 更新到最新版本
claude install stable # 安装稳定版
claude install latest # 安装最新版(最新测试版)
claude install 2.1.118 # 安装指定版本
版本发布通道
| 安装方式 | 更新通道 | 特点 |
|---|---|---|
| Homebrew (claude-code) | stable | 约滞后正式版 1 周,最稳定 |
| Homebrew (claude-code@latest) | latest | 与官方同步,包含最新功能 |
| npm 全局安装 | latest | 自动更新到最新 |
| WinGet | 手动 | 需手动运行 winget upgrade Anthropic.ClaudeCode |
版本迁移注意事项
Windows 安装路径变更
v2.x 版本后,Windows 安装路径从 C:\ProgramData\ClaudeCode\ 变更为 C:\Program Files\ClaudeCode\。如果之前通过旧路径配置了环境变量或快捷方式,需要相应更新。
最低版本限制
企业管理员可以通过托管配置设置 minimumVersion 字段,阻止团队成员自动更新到低于组织要求的版本。
v2.x 重大变化一览
- Channels 功能(v2.1.80+):支持多渠道管理
- MCP 增强(v2.1.121+):MCP 服务器初始连接重试机制改善
- Agent SDK 更名:「Claude Code SDK」更名为「Claude Agent SDK」
- Windows 路径:不再支持旧版安装路径
国内更新注意事项
npm 安装方式
npm install -g @anthropic-ai/claude-code
# 国内建议配合代理
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
更新失败排查
- 网络超时:使用代理或切换 npm 镜像
- 权限不足:Linux/macOS 使用
sudo npm install -g - 版本不匹配:检查 Node.js 版本,建议 18+
版本回退
如果新版本出现问题,可以回退到指定版本:
claude install 2.1.118 # 回退到 2.1.118 版本
建议在回退前确认该版本可用。
查看当前版本
claude --version
# 或在 Claude Code 会话中
→ /version