如何卸载 Claude Code:完全卸载指南 (2026)

使用 2 条命令卸载 Claude Code。npm 卸载、配置清理、macOS、Linux、Windows 全攻略。另附如何保留免费的 Anthropic 积分。

Claude CodeUninstall Claude CodeRemove Claude CodeClaude CLIAI Perks
Author Avatar
Andrew
AI Perks Team
12,775

Quick Answer

运行 `npm uninstall -g @anthropic-ai/claude-code` 以全局删除 Claude Code。然后删除 `~/.claude` 处的配置文件夹,以清理设置、身份验证令牌和命令历史记录。适用于 macOS、Linux 和 Windows。请保持您的 Anthropic API 积分在 getaiperks.com 上对其他工具保持活跃。

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠,帮助初创企业和开发者节省开支。

AI Perks Cards

如何卸载 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积分上节省您的预算

搜索优惠
OpenAI
OpenAI,
Anthropic
Anthropic,
Lovable
Lovable,
Notion
Notion

推广您的 SaaS

覆盖全球 90,000+ 寻找类似您工具的创始人

立即申请

开发者卸载 Claude Code 的原因

有几个常见原因:

  • 切换工具 - 迁移到 Cursor、Windsurf、Codex 或其他编码助手
  • 重新安装 - 干净地修复损坏的安装
  • 释放磁盘空间 - 移除未使用的全局 npm 包
  • 隐私考虑 - 清除所有本地存储的身份验证令牌和历史记录
  • 多机清理 - 从不再使用的机器上移除

无论您出于何种原因,卸载过程都相同。如果您将来想重新安装,只需一条命令即可完成。


AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠,帮助初创企业和开发者节省开支。

AI Perks Cards

第一步:卸载 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.jsonMCP 服务器配置

删除前,如果您想稍后恢复您的设置,请考虑备份 ~/.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,000AI Perks 指南
AWS Activate (Bedrock - Claude)$1,000 - $100,000AI Perks 指南
Google Cloud Vertex (Claude)$1,000 - $25,000AI Perks 指南
Microsoft Founders Hub$500 - $1,000AI Perks 指南
VC 合作伙伴计划$1,000 - $5,000AI 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 uninstallnpm 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 多个额外的初创公司福利
  • 跨工具跟随您的积分计划

在 getaiperks.com 订阅 →


只需 2 条命令即可卸载 Claude Code。在 getaiperks.com 永久保留您的免费 Anthropic 积分。

AI Perks

AI Perks 提供 AI 工具、云服务和 API 的独家折扣、积分和优惠,帮助初创企业和开发者节省开支。

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.