Claude Code CLI 卸载重装教程
如果你之前通过 npm 安装过 Claude Code CLI，但遇到了配置异常、启动失败、命令残留或版本问题，可以按当前系统完成卸载和重新安装。仅需重装程序时，可以跳过“清理本地配置”。桌面版请从 Claude 官方下载页重新下载安装，不要执行本页的 npm 卸载步骤。
- Windows
- macOS
- Linux
Windows 教程
第一步：检查当前是否已安装
打开 PowerShell，执行：
claude --version
如果能正常返回版本号，说明本机当前仍然安装着 Claude Code。
第二步：卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
第三步：清理本地配置
如需彻底重置配置，请先备份需要保留的 hooks、plugins 或其他个人设置，再按当前系统删除明确的配置路径。
Remove-Item -LiteralPath "$HOME\.claude" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item -LiteralPath "$HOME\.claude.json" -Force -ErrorAction SilentlyContinue
这一步会删除默认目录中的 Claude 配置与相关缓存，且无法自动恢复。如果设置过 CLAUDE_CONFIG_DIR，还需要自行确认该变量指向的目录是否需要清理。不要使用宽泛通配符，以免误删备份或其他同名前缀文件。
第四步：验证是否卸载成功
再次执行：
claude --version
如果提示命令不存在，或无法再输出版本信息，通常说明已经卸载完成。
第五步：重新安装 Claude Code
npm install -g @anthropic-ai/claude-code
第六步：安装完成后验证
安装完成后，再次执行：
claude --version
确认可以正常输出版本号后，再继续后续配置。
macOS 教程
第一步：检查当前是否已安装
打开终端，执行：
claude --version
如果能正常返回版本号，说明本机当前仍然安装着 Claude Code CLI。
第二步：卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
如果之前使用管理员权限安装，可以执行：
sudo npm uninstall -g @anthropic-ai/claude-code
第三步：清理本地配置
如需彻底重置配置，请先备份需要保留的 hooks、plugins 或其他个人设置，再执行：
rm -rf -- "$HOME/.claude"
rm -f -- "$HOME/.claude.json"
这一步会删除默认目录中的 Claude 配置与相关缓存，且无法自动恢复。如果设置过 CLAUDE_CONFIG_DIR，还需要自行确认该变量指向的目录是否需要清理。不要使用 ~/.claude* 这类宽泛通配符， 以免误删备份或其他同名前缀文件。
第四步：验证是否卸载成功
claude --version
如果提示命令不存在，或无法再输出版本信息，通常说明已经卸载完成。
第五步：重新安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限不足，可以执行：
sudo npm install -g @anthropic-ai/claude-code
第六步：安装完成后验证
claude --version
确认可以正常输出版本号后，再继续后续配置。
Linux 教程
第一步：检查当前是否已安装
打开终端，执行：
claude --version
如果能正常返回版本号，说明本机当前仍然安装着 Claude Code CLI。
第二步：卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
如果之前使用管理员权限安装，可以执行：
sudo npm uninstall -g @anthropic-ai/claude-code
第三步：清理本地配置
如需彻底重置配置，请先备份需要保留的 hooks、plugins 或其他个人设置，再执行：
rm -rf -- "$HOME/.claude"
rm -f -- "$HOME/.claude.json"
这一步会删除默认目录中的 Claude 配置与相关缓存，且无法自动恢复。如果设置过 CLAUDE_CONFIG_DIR，还需要自行确认该变量指向的目录是否需要清理。不要使用 ~/.claude* 这类宽泛通配符，以免误删备份或其他同名前缀文件。
第四步：验证是否卸载成功
claude --version
如果提示命令不存在，或无法再输出版本信息，通常说明已经卸载完成。
第五步：重新安装 Claude Code
npm install -g @anthropic-ai/claude-code
如果遇到权限不足，可以执行：
sudo npm install -g @anthropic-ai/claude-code
第六步：安装完成后验证
claude --version
确认可以正常输出版本号后，再继续后续配置。
