Claude Code 卸载指南

备份（重要）

卸载前务必备份以下内容，否则会永久丢失：

• ~/.claude/ — 配置目录，包含 skills、MCP 服务器配置、会话历史、设置等
• ~/.claude.json — 全局配置文件

# 创建备份目录
mkdir -p ~/claude-code-backup

# 备份配置目录（包含 skills、MCP、会话历史、设置等）
cp -r ~/.claude/ ~/claude-code-backup/

# 备份全局配置文件
cp ~/.claude.json ~/claude-code-backup/

# 确认备份完成
ls -la ~/claude-code-backup/

备份会保存到 ~/claude-code-backup/ 目录。

检查安装方式

Claude Code 有两种常见的安装方式：官方安装脚本（推荐）和 npm 全局安装。卸载前先确认你的安装方式：

# 检查 Claude Code 安装位置
which claude

# 如果输出类似 /usr/local/bin/claude 或 ~/.local/bin/claude
# 说明是通过官方脚本安装的

# 如果输出类似 /Users/xxx/.nvm/versions/node/v20/lib/node_modules/@anthropic-ai/claude-code/cli.js
# 说明是通过 npm 安装的

卸载（官方脚本安装）

如果你是通过官方安装脚本安装的（推荐方式），执行以下命令完全卸载：

# 1. 删除二进制文件
rm ~/.local/bin/claude

# 2. 删除安装目录（包含版本文件）
rm -rf ~/.local/share/claude/

# 3. 删除配置目录（会话历史、设置、插件等）
rm -rf ~/.claude/

# 4. 删除全局配置文件
rm -f ~/.claude.json

这会删除 Claude Code 的所有文件，包括二进制程序、版本缓存、会话历史、设置和插件。

卸载（npm 安装）

如果你是通过 npm 安装的，使用 npm 卸载命令：

# 通过 npm 卸载
npm uninstall -g @anthropic-ai/claude-code

# 删除配置目录
rm -rf ~/.claude/

# 删除全局配置文件
rm -f ~/.claude.json

文件路径参考

macOS

# macOS 上的典型路径
~/.local/bin/claude          # 二进制文件
~/.local/share/claude/       # 安装目录
~/.claude/                   # 配置目录
~/.claude.json               # 全局配置

# Homebrew 安装的 node_modules 路径
/usr/local/lib/node_modules/@anthropic-ai/claude-code/

Linux

# Linux 上的典型路径
~/.local/bin/claude          # 二进制文件
~/.local/share/claude/       # 安装目录
~/.claude/                   # 配置目录
~/.claude.json               # 全局配置

# 如果通过 npm 安装，可能在：
/usr/local/lib/node_modules/@anthropic-ai/claude-code/
# 或者 nvm 管理的 node 版本目录下

验证卸载

执行以下命令确认 Claude Code 已完全卸载：

# 验证卸载是否成功
claude --version
# 应该输出 "command not found" 或类似错误

# 检查是否还有残留文件
ls -la ~/.claude* 2>/dev/null
ls -la ~/.local/bin/claude 2>/dev/null
ls -la ~/.local/share/claude 2>/dev/null

如果所有命令都没有输出或报错 "command not found"，说明卸载成功。

恢复备份

重新安装 Claude Code 后，从备份恢复配置：

# 从备份恢复配置目录
cp -r ~/claude-code-backup/.claude/ ~/

# 恢复全局配置文件
cp ~/claude-code-backup/.claude.json ~/

保留配置（可选）

如果你只是想重新安装或升级，可以保留配置目录 ~/.claude/， 这样会话历史和设置会被保留。只删除二进制文件和安装目录即可：

# 只删除程序文件，保留配置
rm ~/.local/bin/claude
rm -rf ~/.local/share/claude/