nangongwentian-fe/update-claude-code

更新 Claude Code

步骤

1. 使用 npm 全局安装最新版本：

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

2. 验证更新是否成功：

claude --version

3. 向用户报告更新后的版本号。

4. 清理旧版本：检查本机是否存在多个 Claude Code 版本残留，如有则只保留最新版本：

# 检查本地版本目录
ls ~/.local/share/claude/versions/

# 获取当前 symlink 指向的版本
readlink ~/.local/bin/claude

如果存在多个版本目录，不要只改 symlink——自动回滚机制会把 symlink 改回去。正确做法是通过 npm 安装来彻底绕开这套机制：

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

npm 安装的版本路径（通常为 ~/.nvm/versions/node/vX.X.X/bin/claude 或系统 npm bin）在 PATH 中优先级高于 ~/.local/bin/claude，可完全绕开自动回滚机制。

安装完成后，清理旧版本目录：

# 删除全部版本残留目录
rm -rf ~/.local/share/claude/versions/

再次验证版本正确：

claude --version && which claude

确认 which claude 输出的是 npm 路径（如 ~/.nvm/...），而不是 ~/.local/bin/claude。

注意事项

• curl -fsSL https://claude.ai/install.sh | bash 这种方式在部分地区（如中国大陆）无法访问，会返回 HTML 错误页面而非安装脚本，不要使用。
• npm 方式是最可靠的更新方法，直接使用即可，无需代理。
• 如果 npm 也失败，检查 npm 是否已安装：npm --version，并提示用户先安装 Node.js。
• Claude Code 使用自动更新机制，会将各版本下载到 ~/.local/share/claude/versions/ 目录，~/.local/bin/claude 是一个 symlink。当新版本崩溃时会自动回滚 symlink 到旧版本，导致 --version 显示的版本低于预期。仅修改 symlink 无法解决问题，回滚机制会重新下载旧版并改回去。必须通过 npm 安装来绕开这套机制。
• 清理 ~/.local/share/claude/versions/ 目录后，npm 安装的版本不受影响，仍可正常使用。