跳到主要内容

Claude Code CLI 卸载重装

如果之前通过 npm 安装过 Claude Code CLI，但遇到配置异常、启动失败、命令残留或版本问题，可以按当前系统完成卸载和重新安装。

信息

仅需重装程序时，可以跳过「清理本地配置」。 桌面版请从官方下载页重新下载安装，不要执行本页的 npm 卸载步骤。

Windows​

第一步：检查当前是否已安装​

claude --version

能正常返回版本号，说明本机仍安装着 Claude Code。

第二步：卸载​

npm uninstall -g @anthropic-ai/claude-code

第三步：清理本地配置​

:::danger 这一步不可自动恢复 请先备份需要保留的 hooks、plugins 或其他个人设置。 如果设置过 CLAUDE_CONFIG_DIR，自行确认该变量指向的目录是否需要清理。 不要使用宽泛通配符，以免误删备份或其他同名前缀文件。 :::

Remove-Item -LiteralPath "$HOME\.claude" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -LiteralPath "$HOME\.claude.json" -Force -ErrorAction SilentlyContinue

第四步：验证是否卸载成功​

claude --version

提示命令不存在，或无法再输出版本信息，通常说明已卸载完成。

第五步：重新安装​

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

第六步：验证安装​

claude --version

确认能正常输出版本号后，再继续配置。配置见 Claude Code 配置。

macOS​

第一步：检查​

claude --version

第二步：卸载​

npm uninstall -g @anthropic-ai/claude-code
# 管理员权限安装的用：
sudo npm uninstall -g @anthropic-ai/claude-code

第三步：清理本地配置​

危险

先备份 hooks / plugins / 个人设置。这会删除默认目录下的 Claude 配置与相关缓存，且无法自动恢复。 不要使用 ~/.claude* 这类宽泛通配符。

rm -rf -- "$HOME/.claude"
rm -f -- "$HOME/.claude.json"

第四步：验证卸载​

claude --version

第五步：重新安装​

npm install -g @anthropic-ai/claude-code
# 权限不足时
sudo npm install -g @anthropic-ai/claude-code

第六步：验证安装​

claude --version

Linux​

步骤与 macOS 相同：

claude --version                              # 检查
npm uninstall -g @anthropic-ai/claude-code    # 卸载
rm -rf -- "$HOME/.claude"                     # 清理配置（先备份）
rm -f -- "$HOME/.claude.json"
claude --version                              # 验证卸载
npm install -g @anthropic-ai/claude-code      # 重装
claude --version                              # 验证安装

相关：Claude Code 配置 · Node.js 环境准备 · 常见问题总览