3.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