Claude Code 卸载指南

完整的 Claude Code 卸载流程,包括清理配置文件、环境变量和缓存数据。

卸载前检查

在开始卸载之前,建议先备份重要的配置文件和项目数据。

检查安装方式

第一步:检查全局安装

bash
npm ls -g @anthropic-ai/claude-code

第二步:检查本地安装

bash
npm ls @anthropic-ai/claude-code

第三步:检查安装路径

bash
# 查看全局包安装路径
npm root -g

# 查看 Claude Code 可执行文件位置
which claude
# 或在 Windows 上使用
where claude

卸载 Claude Code

方法一:npm 卸载(推荐)

# 卸载全局安装的 Claude Code
npm uninstall -g @anthropic-ai/claude-code

# 验证卸载
claude --version
# 应该显示 "command not found" 或类似错误

方法二:手动删除(如果 npm 卸载失败)

# 删除全局安装目录
rm -rf ~/.npm/lib/node_modules/@anthropic-ai/claude-code
rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# 删除可执行文件链接
rm -f /usr/local/bin/claude

# 删除用户数据目录
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code

清理配置文件和缓存

清理环境变量

macOS/Linux 系统

bash
# 编辑配置文件,删除相关环境变量
nano ~/.bashrc
nano ~/.bash_profile
nano ~/.zshrc

# 删除以下行:
# export ANTHROPIC_AUTH_TOKEN=...
# export ANTHROPIC_BASE_URL=...

# 重新加载配置
source ~/.bashrc
source ~/.bash_profile
source ~/.zshrc

Windows 系统

方法一:图形界面

  1. 右键点击"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 在"系统属性"窗口中点击"环境变量"
  4. 在用户变量和系统变量中找到并删除:
    • ANTHROPIC_AUTH_TOKEN
    • ANTHROPIC_BASE_URL
  5. 点击"确定"保存

方法二:PowerShell

PowerShell (管理员)
# 删除用户环境变量
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "User")

# 删除系统环境变量(需要管理员权限)
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "Machine")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, "Machine")

清理项目配置文件

检查并删除项目中的 Claude Code 相关配置:

bash
# 查找项目中的配置文件
find . -name ".claude*" -type f
find . -name "claude.config.*" -type f

# 删除找到的配置文件
rm -f .claude-settings.json
rm -f claude.config.js
rm -f claude.config.json

清理缓存数据

# 清理 npm 缓存中的 Claude Code 相关数据
npm cache clean --force

# 清理用户缓存目录
rm -rf ~/.cache/claude-code
rm -rf /tmp/claude-*

# 清理日志文件
rm -rf ~/.local/share/claude-code/logs

验证卸载

完成卸载后,运行以下命令验证是否完全清理:

bash
# 验证命令不存在
claude --version
# 应该显示 "command not found"

# 验证环境变量已清理
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_BASE_URL
# 应该为空

# 检查残留文件
ls -la ~/.claude* 2>/dev/null || echo "No Claude files found"
ls -la ~/.config/claude* 2>/dev/null || echo "No Claude config found"

卸载相关依赖(可选)

如果你不再需要 Node.js 或其他相关工具,也可以一并卸载:

卸载 Node.js

# 如果通过 Homebrew 安装
brew uninstall node

# 手动删除(如果通过官方安装包安装)
sudo rm -rf /usr/local/{bin/{node,npm},lib/node_modules/npm,lib/node,share/man/*/node.*}

常见问题

问题 1:命令仍然存在

可能原因:

  • PATH 环境变量缓存
  • 多个安装位置

解决方案:

bash
# 重新加载环境变量
source ~/.bashrc

# 或重启终端
exit
# 重新打开终端

# 检查所有可能的安装位置
which -a claude
whereis claude

问题 2:权限不足无法删除文件

解决方案:

bash
# macOS/Linux 使用 sudo
sudo rm -rf /usr/local/lib/node_modules/@anthropic-ai/claude-code

# Windows 以管理员身份运行 PowerShell
# 右键 PowerShell → "以管理员身份运行"

问题 3:环境变量未清理

解决方案:

bash
# 检查所有可能的配置文件
grep -r "ANTHROPIC" ~/.*rc ~/.*profile 2>/dev/null
grep -r "claude" ~/.*rc ~/.*profile 2>/dev/null

# 手动编辑找到的配置文件
nano ~/.bashrc  # 删除相关行

重新安装准备

如果之后需要重新安装 Claude Code:

  1. 确保 Node.js 版本 ≥ 18.0
  2. 清理 npm 缓存:npm cache clean --force
  3. 按照安装文档重新安装

完成以上步骤后,Claude Code 应该已经完全从你的系统中卸载了。

与AI一起带来无限的创新,无尽的机遇
关于
功能特性
使用文档
定价方案
联系我们
条款和政策
使用条款
隐私条款
特定商取引法