Claude Code 升级指南

一、当前版本信息

环境	安装方式	升级命令
Windows/Linux	npm	npm update -g @anthropic-ai/claude-code 或 claude update
Windows/Linux	Python pip	pip install --upgrade claude-code
Linux/macOS	Homebrew	brew upgrade claude-code
Linux/macOS	Cargo (Rust)	cargo install --force claude-code

---

二、各平台详细说明

1、Windows 环境

1.1.使用 npm 安装升级

npm update -g @anthropic-ai/claude-code
# 或直接使用 CLI 内置命令
claude update

1.2.使用 pip 安装升级

pip install --upgrade claude-code

---

2、Linux 环境

2.1.使用 npm 安装升级

npm update -g @anthropic-ai/claude-code
# 或使用 CLI 内置命令
claude update

2.2.使用 pip 安装升级

pip install --upgrade claude-code

2.3.使用 Homebrew 安装升级

brew upgrade claude-code

2.4.使用 Cargo 安装升级

cargo install --force claude-code

---

二、版本检查

升级完成后，检查当前版本：

claude --version

输出示例：

2.1.80 (Claude Code)

---

三、注意事项

1. 需要管理员/Root权限：使用 npm 或 pip 全局安装时，可能需要使用 sudo（Linux）或以管理员身份运行（Windows）

2. 环境变量：升级后可能需要刷新 shell 环境或重启终端，使新版本生效

3. 网络连接：升级需要访问 npm、pip 或 brew 的官方仓库

4. 备份配置：升级通常会保留 settings.json 等配置文件，但建议重要配置提前备份

---

四、故障排查

1、npm升级失败

# 清理 npm 缓存后重试
npm cache clean --force
npm update -g @anthropic-ai/claude-code

2、pip升级失败

# 使用用户级别安装
pip install --upgrade --user claude-code

3、权限问题

# Linux/macOS: 使用 sudo
sudo npm update -g @anthropic-ai/claude-code

# Windows: 以管理员身份运行 PowerShell

4、配置 npm 使用国内镜像

# Windows: 临时使用淘宝镜像
npm install -g @anthropic-ai/claude-code@latest --registry=https://registry.npmmirror.com
# 或永久设置
npm config set registry https://registry.npmmirror.com
# 安装完成后再改回官方（可选）
npm config set registry https://registry.npmjs.org

---

五、相关链接

• Claude Code 官方文档
• npm 包页面
• GitHub Issues