如何卸载 Claude Code:完整流程
要完全卸载 Claude Code,请在终端中运行 npm uninstall -g @anthropic-ai/claude-code,然后删除位于 ~/.claude 的配置目录。这将移除二进制文件、您的身份验证令牌、自定义命令、代理和命令历史记录。
如果您正在切换到其他 AI 编码工具但仍需要 Claude API 访问权限,AI Perks 可让您连接到价值 1,000 至 25,000 美元以上的免费 Anthropic 积分,这些积分可与任何工具配合使用——Cursor、Windsurf、自定义应用程序或您的下一个设置。
在AI积分上节省您的预算
| Software | 预估积分 | 审批指数 | 操作 | |
|---|---|---|---|---|
推广您的 SaaS
覆盖全球 90,000+ 寻找类似您工具的创始人
开发者卸载 Claude Code 的原因
有几个常见原因:
- 切换工具 - 迁移到 Cursor、Windsurf、Codex 或其他编码助手
- 重新安装 - 干净地修复损坏的安装
- 释放磁盘空间 - 移除未使用的全局 npm 包
- 隐私考虑 - 清除所有本地存储的身份验证令牌和历史记录
- 多机清理 - 从不再使用的机器上移除
无论您出于何种原因,卸载过程都相同。如果您将来想重新安装,只需一条命令即可完成。
第一步:卸载 Claude Code 包
打开您的终端并运行:
npm uninstall -g @anthropic-ai/claude-code
这将移除全局 npm 包以及 PATH 中的 claude 命令。卸载大约需要 5 秒钟。
验证是否成功:
claude --version
如果看到 command not found: claude,则表示卸载成功。如果仍然显示版本号,您可能有多重安装——请跳转到故障排除部分。
第二步:删除 Claude Code 配置和数据
npm 卸载会移除二进制文件,但配置文件、身份验证令牌、自定义命令和历史记录会保留在您的主目录中。要彻底清除 Claude Code:
macOS / Linux
rm -rf ~/.claude
rm -rf ~/.claude.json
Windows (PowerShell)
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"
Remove-Item -Force "$env:USERPROFILE\.claude.json"
~/.claude 中包含什么?
| 文件/文件夹 | 内容 |
|---|---|
settings.json | 权限、钩子、环境变量 |
agents/ | 自定义子代理定义 |
commands/ | 自定义斜杠命令 |
skills/ | 技能定义 |
projects/ | 按项目划分的会话历史记录和内存 |
auth/ | API 密钥和 OAuth 令牌 |
mcp.json | MCP 服务器配置 |
删除前,如果您想稍后恢复您的设置,请考虑备份 ~/.claude:
cp -r ~/.claude ~/claude-backup-$(date +%Y%m%d)
第三步:删除身份验证令牌(可选但推荐)
Claude Code 将 OAuth 令牌存储在您的系统钥匙串中。要完全撤销它们:
macOS
security delete-generic-password -s "claude-code"
Linux
secret-tool clear service claude-code
Windows
打开凭据管理器 > Windows 凭据 > 删除任何包含“claude-code”或“anthropic”的条目。
您也可以直接从您的Anthropic 控制台撤销 API 密钥。
第四步:清理 Shell 别名和 PATH 条目
如果您将自定义 Claude Code 别名或 PATH 条目添加到您的 shell 配置中,请将其删除:
Bash
编辑 ~/.bashrc 和 ~/.bash_profile:
nano ~/.bashrc
查找并删除任何类似以下的行:
alias cc="claude"
export CLAUDE_API_KEY="..."
export PATH="$PATH:/path/to/claude"
Zsh
编辑 ~/.zshrc:
nano ~/.zshrc
删除相同的行。
Fish
编辑 ~/.config/fish/config.fish:
nano ~/.config/fish/config.fish
编辑后重新加载您的 shell:
source ~/.zshrc # 或 ~/.bashrc 等
故障排除卸载问题
问题:“claude”命令卸载后仍然可用
您可能有多重安装。检查所有 npm 前缀:
which claude
which -a claude # 列出所有匹配项
对于返回的每个路径,手动卸载:
npm uninstall -g @anthropic-ai/claude-code --prefix /path/to/install
问题:卸载过程中出现权限被拒绝
添加 sudo(macOS/Linux)或以管理员身份运行 PowerShell(Windows):
sudo npm uninstall -g @anthropic-ai/claude-code
问题:无法删除 ~/.claude 文件夹
某些文件可能被正在运行的 Claude Code 进程锁定。首先终止任何活动进程:
pkill -f claude
然后重试删除。
问题:卸载成功但 Claude 仍出现在 npm 列表中
清除 npm 缓存并重建注册表:
npm cache clean --force
npm list -g --depth=0
卸载 Claude Code 后如何处理您的 Anthropic API 积分
这是开发者经常忽略的一点:卸载 Claude Code 不会取消您的 Anthropic API 积分。 您的 Anthropic 账户、API 密钥和积分余额都保持有效。
您仍然可以在以下地方使用这些积分:
- Cursor - 在设置中添加您的 Anthropic API 密钥
- Windsurf - 将 Claude 配置为您的模型提供商
- Cline / Roo Code - 直接使用 Anthropic API
- 自定义应用程序 - 任何调用 Anthropic SDK 的代码
- Claude Desktop - 无需浏览器即可进行 Claude 聊天
- Claude.ai 网页版 - 相同的账户,不同的界面
如果您有来自 AI Perks 的免费 Anthropic 积分,它们可以与所有这些工具配合使用。积分与您的 Anthropic 账户绑定,而不是与 Claude Code CLI 绑定。
免费 Anthropic 积分可与任何 AI 编码工具配合使用
大多数开发者没有意识到,他们可以通过各种计划获得价值 1,000 至 25,000 美元以上的免费 Claude API 积分,这些计划适用于他们接下来切换的任何工具:
| 积分计划 | 可用积分 | 如何获取 |
|---|---|---|
| Anthropic Claude (直接) | $1,000 - $25,000 | AI Perks 指南 |
| AWS Activate (Bedrock - Claude) | $1,000 - $100,000 | AI Perks 指南 |
| Google Cloud Vertex (Claude) | $1,000 - $25,000 | AI Perks 指南 |
| Microsoft Founders Hub | $500 - $1,000 | AI Perks 指南 |
| VC 合作伙伴计划 | $1,000 - $5,000 | AI Perks 指南 |
总计潜在价值:4,500 至 156,000 美元以上的免费 Claude 积分
无论您是切换到 Cursor,构建自己的编码代理,还是仅将 Claude 作为备用模型,AI Perks 都能让您的 AI 账单保持为零。
分步操作:干净卸载 + 保留您的积分
第一步:保存您的 Anthropic API 密钥
在清除 ~/.claude 之前,请从 ~/.claude/auth/ 或 Anthropic 控制台复制您的 API 密钥。您将来使用任何工具都会用到它。
第二步:卸载 Claude Code
npm uninstall -g @anthropic-ai/claude-code
第三步:删除配置和数据
rm -rf ~/.claude ~/.claude.json
第四步:清理 Shell 配置
从 ~/.zshrc、~/.bashrc 中删除别名和导出。
第五步:保持您的免费积分有效
订阅 AI Perks 以保持对免费 Anthropic 积分计划的访问权限,这些计划适用于您接下来使用的任何工具。
常见问题解答
卸载 Claude Code 会取消我的 Claude Pro 或 Max 订阅吗?
不会。 订阅通过您的 Anthropic 账户收费,而不是通过 CLI。要取消 Pro 或 Max,请登录 claude.ai 并在账户设置中管理您的订阅。CLI 卸载仅移除本地工具。
我会丢失我的 Claude Code 自定义命令和代理吗?
是的,如果您删除了 ~/.claude。 如果您想保留自定义命令、代理、技能和 MCP 服务器配置,请先备份该文件夹。重新安装后,可以通过将备份复制回 ~/.claude 来恢复它们。
卸载 Claude Code 后我能重新安装吗?
是的。 只需运行 npm install -g @anthropic-ai/claude-code@latest 并重新进行身份验证。您的 Anthropic 积分和账户将保持有效。有了来自 AI Perks 的免费积分,您可以零成本重建您的设置。
我该如何在 Windows 上专门卸载 Claude Code?
以管理员身份打开 PowerShell 并运行 npm uninstall -g @anthropic-ai/claude-code。然后删除 %USERPROFILE%\.claude 和 %USERPROFILE%\.claude.json 文件夹。在凭据管理器中检查存储的 Anthropic 令牌。
卸载 Claude Code 会删除我的聊天记录吗?
~/.claude/projects/ 中的本地会话历史记录会在删除配置文件夹时被删除。云同步的历史记录(如果已启用)将保留在您的 Anthropic 账户中。claude.ai 上的网页聊天是完全独立的,不受影响。
claude uninstall 和 npm uninstall 有什么区别?
没有内置的 claude uninstall 命令。使用 npm uninstall -g @anthropic-ai/claude-code 来全局移除该包。npm 命令是官方支持的方法。
如果我改用 Cursor,我应该卸载 Claude Code 吗?
不一定。 许多开发者同时运行两者。Cursor 使用 Claude 作为模型选项,并且可以与 CLI 并行工作。如果磁盘空间和混乱不是问题,您可以同时安装两者,并根据任务选择使用哪一个。来自 AI Perks 的免费 Anthropic 积分可与这两个工具配合使用。
切换工具?保持您的免费积分有效
卸载 Claude Code 并不意味着放弃 Claude。AI Perks 确保您保持对价值 1,000 至 25,000 美元以上的免费 Anthropic 积分的访问权限,这些积分可在任何工具中为 Claude 提供支持——Cursor、Windsurf、您自己的应用程序,或您接下来使用的任何工具。
- 分步积分申请指南
- 超过 50,000 美元的堆叠策略
- 除了 AI 积分之外的 200 多个额外的初创公司福利
- 跨工具跟随您的积分计划
只需 2 条命令即可卸载 Claude Code。在 getaiperks.com 永久保留您的免费 Anthropic 积分。
