Claude Code 卸载指南

完整的 Claude Code 卸载教程，包含配置文件清理和环境变量删除。

🎯 卸载概述

本指南将帮助你完全卸载 Claude Code，包括：

卸载 CLI 工具
删除配置文件
清除环境变量
卸载 VS Code 扩展

⚠️

卸载前请确认你不再需要 Claude Code 服务，卸载后需要重新安装和配置才能继续使用。

🍎 macOS 卸载

第一步：卸载 Claude Code CLI

# 卸载全局 npm 包
npm uninstall -g @anthropic-ai/claude-code
 
# 验证卸载
claude --version  # 应该提示 "command not found"

第二步：删除配置文件

# 删除配置目录
rm -rf ~/.claude
 
# 删除日志文件
rm -rf ~/Library/Logs/claude/
 
# 删除缓存文件（如果存在）
rm -rf ~/Library/Caches/claude/

第三步：清除环境变量

对于 Zsh 用户（macOS 默认）

# 编辑 .zshrc 文件
nano ~/.zshrc
 
# 删除以下行：
# export ANTHROPIC_BASE_URL="..."
# export ANTHROPIC_AUTH_TOKEN="..."
 
# 或使用 sed 命令自动删除
sed -i '' '/ANTHROPIC_/d' ~/.zshrc
 
# 重新加载配置
source ~/.zshrc

对于 Bash 用户

# 编辑 .bash_profile 文件
nano ~/.bash_profile
 
# 删除相关行或使用 sed 命令
sed -i '' '/ANTHROPIC_/d' ~/.bash_profile
 
# 重新加载配置
source ~/.bash_profile

第四步：卸载 VS Code 扩展

# 使用命令行卸载
code --uninstall-extension anthropic.claude-code
 
# 或在 VS Code 中手动卸载
# Cmd+Shift+X → 搜索 "Claude Code" → 点击卸载

🪟 Windows 卸载

第一步：卸载 Claude Code CLI

# 卸载全局 npm 包
npm uninstall -g @anthropic-ai/claude-code
 
# 验证卸载
claude --version  # 应该提示错误

第二步：删除配置文件

# 删除配置目录
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"
 
# 删除日志文件
Remove-Item -Recurse -Force "$env:APPDATA\claude" -ErrorAction SilentlyContinue
 
# 删除缓存文件
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\claude" -ErrorAction SilentlyContinue

第三步：清除环境变量

方法一：使用 PowerShell（推荐）

# 删除用户级环境变量
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, [System.EnvironmentVariableTarget]::User)
 
# 如果设置了系统级环境变量（需要管理员权限）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", $null, [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, [System.EnvironmentVariableTarget]::Machine)

方法二：使用图形界面

按 Win + R，输入 sysdm.cpl
点击"高级"选项卡
点击"环境变量"
在用户变量和系统变量中找到并删除：
- ANTHROPIC_BASE_URL
- ANTHROPIC_AUTH_TOKEN

第四步：卸载 VS Code 扩展

# 使用命令行卸载
code --uninstall-extension anthropic.claude-code
 
# 或在 VS Code 中手动卸载
# Ctrl+Shift+X → 搜索 "Claude Code" → 点击卸载

第五步：清理注册表（可选）

⚠️

注意：修改注册表有风险，请谨慎操作或跳过此步骤。

# 删除可能的注册表项（可选）
# 需要管理员权限
Remove-Item -Path "HKCU:\Software\claude" -Recurse -Force -ErrorAction SilentlyContinue

🐧 Linux 卸载

第一步：卸载 Claude Code CLI

# 卸载全局 npm 包
npm uninstall -g @anthropic-ai/claude-code
 
# 如果使用了自定义 npm 目录
rm -f ~/.npm-global/bin/claude

第二步：删除配置文件

# 删除配置目录
rm -rf ~/.claude
 
# 删除日志文件
rm -rf ~/.local/share/claude/
 
# 删除缓存文件
rm -rf ~/.cache/claude/

第三步：清除环境变量

对于 Bash 用户

# 编辑 .bashrc 文件
nano ~/.bashrc
 
# 删除相关行或使用 sed 命令
sed -i '/ANTHROPIC_/d' ~/.bashrc
 
# 重新加载配置
source ~/.bashrc

对于 Zsh 用户

# 编辑 .zshrc 文件
nano ~/.zshrc
 
# 删除相关行或使用 sed 命令
sed -i '/ANTHROPIC_/d' ~/.zshrc
 
# 重新加载配置
source ~/.zshrc

清除系统级环境变量（如果设置过）

# 删除系统级环境文件
sudo rm -f /etc/environment.d/claude.conf
 
# 从 /etc/environment 中删除相关行（如果存在）
sudo sed -i '/ANTHROPIC_/d' /etc/environment

第四步：卸载 VS Code 扩展

# 使用命令行卸载
code --uninstall-extension anthropic.claude-code
 
# 手动删除扩展文件
rm -rf ~/.vscode/extensions/anthropic.claude-code-*

WSL2 特殊处理

如果在 WSL2 中使用，除了上述步骤外，还需要：

# 确保 Windows 侧的环境变量也已清除
# 在 Windows PowerShell 中执行上述 Windows 卸载步骤
 
# 重启 WSL2 以确保环境完全清理
wsl --shutdown
# 然后重新启动 WSL2

🧹 完整清理验证

卸载完成后，运行以下命令验证清理是否彻底：

验证 CLI 工具已卸载

# 应该提示 "command not found" 或类似错误
claude --version
which claude  # Linux/macOS
where claude   # Windows

验证环境变量已清除

# Linux/macOS
echo $ANTHROPIC_BASE_URL    # 应该为空
echo $ANTHROPIC_AUTH_TOKEN  # 应该为空
 
# Windows PowerShell
echo $env:ANTHROPIC_BASE_URL    # 应该为空
echo $env:ANTHROPIC_AUTH_TOKEN  # 应该为空

验证配置文件已删除

# Linux/macOS
ls -la ~/.claude  # 应该提示目录不存在
 
# Windows PowerShell
Test-Path "$env:USERPROFILE\.claude"  # 应该返回 False

验证 VS Code 扩展已卸载

# 检查已安装的扩展
code --list-extensions | grep claude  # 应该没有输出

🔄 重新安装

如果需要重新安装 Claude Code：

清理完成后重启终端
按照安装指南重新安装：

⚠️ 注意事项

数据备份

卸载前，如果有重要的配置或聊天历史，请备份：

# 备份配置文件
cp ~/.claude/config.json ~/claude-config-backup.json
 
# 备份聊天历史（如果存在）
cp -r ~/.claude/history ~/claude-history-backup/

项目文件

Claude Code 的卸载不会影响：

你的项目代码
通过 Claude 生成的文件
项目中的 .claude/ 目录（如果存在）

这些文件会保留在原位置。

网络代理配置

如果你为 Claude Code 配置了特殊的网络代理，卸载后这些配置也会被删除。重新安装时需要重新配置。

📱 获取帮助

如果在卸载过程中遇到问题：

💬 联系客服 - 一对一技术支持
🔍 故障排除 - 常见问题解决方案

✅

完成！ Claude Code 已完全卸载。如果将来需要重新使用，请参考相应的安装指南。

📚 相关文档

🚀 快速开始 - 重新安装后的使用指南
⚙️ VS Code 集成 - VS Code 扩展配置
🔍 故障排除 - 问题解决方案

故障排除学习指南