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

通过 2 条命令卸载 Claude Code。npm 移除、配置清理、macOS、Linux、Windows 全面指南。以及如何保留您免费的 Anthropic 额度。

Claude CodeUninstall Claude CodeRemove Claude CodeClaude CLIAI Perks
Andrew
Andrew
AI Perks Team
7,756•

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、Devin Desktop(原 Windsurf)、自定义应用程序或您的下一个设置)配合使用。


精选初创企业AI积分

通过这些已认证的计划直接申请。

为什么开发者会卸载 Claude Code

有几个常见原因:

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

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


步骤 1:卸载 Claude Code 包

打开您的终端并运行:

npm uninstall -g @anthropic-ai/claude-code

这将移除全局 npm 包以及 PATH 中的 claude 命令。卸载大约需要 5 秒钟。

验证是否成功:

claude --version

如果您看到 command not found: claude,则表示卸载成功。如果仍显示版本号,您可能存在多个安装副本 - 请跳转至 故障排除部分。


精选初创企业AI积分

通过这些已认证的计划直接申请。

步骤 2:移除 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)

步骤 3:移除身份验证令牌(可选但推荐)

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 密钥。


精选初创企业AI积分

通过这些已认证的计划直接申请。

步骤 4:清理 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

精选初创企业AI积分

通过这些已认证的计划直接申请。

卸载后如何处理您的 Anthropic API 积分

这是开发者经常忽略的一点:卸载 Claude Code 不会取消您的 Anthropic API 积分。 您的 Anthropic 帐户、API 密钥和积分余额都将保持有效。

您仍然可以将这些积分用于:

  • Cursor - 在设置中添加您的 Anthropic API 密钥
  • Devin Desktop(原 Windsurf) - 将 Claude 配置为您的模型提供商。Cognition 已于 2026 年 7 月将 Windsurf 更名为 Devin Desktop 并停用了 Cascade 代理,windsurf.com 现在重定向到 devin.ai/desktop
  • 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 账单。


精选初创企业AI积分

通过这些已认证的计划直接申请。

分步操作:彻底卸载 + 保留您的积分

步骤 1:保存您的 Anthropic API 密钥

在清除 ~/.claude 之前,请从 ~/.claude/auth/ 或 Anthropic 控制台中复制您的 API 密钥。您将来使用任何工具都会需要它。

步骤 2:卸载 Claude Code

npm uninstall -g @anthropic-ai/claude-code

步骤 3:移除配置和数据

rm -rf ~/.claude ~/.claude.json

步骤 4:清理 Shell 配置

从 ~/.zshrc、~/.bashrc 中移除别名和导出。

步骤 5:保持您的免费积分有效

订阅 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 积分可与这两种工具配合使用。


精选初创企业AI积分

通过这些已认证的计划直接申请。

切换工具?保持您的免费积分有效

卸载 Claude Code 并不意味着放弃 Claude。AI Perks 确保您能够继续访问 $1,000 - $25,000+ 的免费 Anthropic 积分,这些积分可在任何工具中为 Claude 提供动力 - Cursor、Devin Desktop(原 Windsurf)、您自己的应用程序,或者您接下来使用的任何工具。

  • 分步积分申请指南
  • 累积策略,可实现 $50,000+ 的运行周期
  • 200 多个额外的初创公司福利,不限于 AI 积分
  • 跨工具跟随您的积分计划

在 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.