Claude Code 环境彻底重置 Checklist（2026 最新版）

整理来源：

- Anthropic 官方文档
- GitHub Issues
- GitHub Discussions
- Reddit（r/ClaudeCode、r/ClaudeAI）
- Hacker News 开发者讨论

更新时间：2026 年

---

一、官方确认需要清理的内容（必须）

这是 Anthropic 官方文档明确提到的目录。

1. 删除用户配置目录

Linux/macOS

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

Windows

%USERPROFILE%\.claude
%USERPROFILE%\.claude.json

里面通常包括：

• Prompt History
• Session History
• Usage Cache
• Settings
• MCP 配置
• Skills
• Hooks
• Debug Logs
• Tool Results
• Projects Metadata

---

2. 删除项目目录中的 Claude 配置

每个项目检查：

.claude/
.mcp.json

如果存在则删除。

里面可能包括：

• Project Prompt
• MCP 配置
• Local Memory
• Hook
• Skill

---

3. 不恢复历史 Session

社区一致建议：

不要：

• Resume Session
• Resume Conversation
• Restore Session

直接开启新的会话。

---

二、建议重新安装 Claude Code（官方推荐）

卸载：

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

安装最新版：

bash
npm install -g @anthropic-ai/claude-code

或者使用官方安装脚本重新安装。

---

三、建议清理 npm 环境（社区经验）

虽然官方没有要求，但 GitHub Issues 中很多开发者都会一起清理。

查看：

bash
npm config list

清理缓存：

bash
npm cache clean --force

重新安装：

bash
npm install -g @anthropic-ai/claude-code

---

四、Skills / Hooks / MCP 全部重建（社区经验）

如果以前安装过：

• Custom Skill
• Hook
• MCP Server
• Plugin

建议全部删除。

重点检查：

~/.claude/skills

~/.claude/hooks

~/.claude/mcp

~/.claude/plugins

重新安装需要的即可。

原因：

很多第三方 Skill 会自动加载。

---

五、VS Code 清理

如果安装了 Claude Code Extension。

建议：

卸载插件

删除 Workspace Storage

删除 Extension State

重新安装插件

不要恢复旧 Workspace。

Windows：

%APPDATA%\Code\User\workspaceStorage

Linux：

~/.config/Code/User/workspaceStorage

macOS：

~/Library/Application Support/Code/User/workspaceStorage

---

六、JetBrains 清理

如果使用：

• IntelliJ
• PyCharm
• GoLand

建议：

删除 Claude Plugin

删除 Plugin Cache

删除 Workspace 配置

重新安装。

---

七、项目配置重新创建

对于旧项目：

建议删除：

.claude

.mcp.json

重新初始化。

避免继承旧 Prompt。

---

八、Shell 历史（可选）

有开发者建议清理：

Bash：

~/.bash_history

Zsh：

~/.zsh_history

Fish：

~/.local/share/fish/fish_history

主要作用：

避免历史命令自动补全。

官方没有要求。

---

九、环境变量检查

确认没有遗留：

ANTHROPIC_API_KEY

CLAUDE_*

MCP_*

重新设置即可。

---

十、Git 配置检查

查看：

bash
git config --global --list

检查：

• credential helper
• user.email
• user.name

确认没有异常。

---

十一、SSH Key（可选）

查看：

~/.ssh

确认：

• id_ed25519
• id_rsa

是否需要继续使用。

通常无需删除。

---

十二、Credential Manager

Windows：

Credential Manager

删除：

• Anthropic
• Claude
• API Token

macOS：

Keychain Access

搜索：

Claude

Anthropic

删除旧 Token。

Linux：

根据发行版检查：

• GNOME Keyring
• KWallet
• Secret Service

---

十三、浏览器（可选）

如果曾通过浏览器登录：

建议：

• 删除 Claude Cookie
• 删除 LocalStorage
• 删除 IndexedDB

无需清空整个浏览器。

---

十四、终端缓存（可选）

删除：

~/.cache

中与 Claude 相关目录。

Windows：

AppData\Local

中 Claude Cache。

---

十五、日志目录

检查：

~/.claude/logs

删除即可。

---

十六、Windows Checklist

建议检查：

%USERPROFILE%\.claude

%USERPROFILE%\.claude.json

%LOCALAPPDATA%

%APPDATA%

Credential Manager

VSCode Workspace Storage

JetBrains Config

npm cache

Environment Variables

---

十七、macOS Checklist

建议检查：

~/.claude

~/.claude.json

~/Library/Application Support

~/Library/Caches

~/Library/Preferences

Keychain

VSCode

JetBrains

npm cache

---

十八、Linux Checklist

建议检查：

~/.claude

~/.claude.json

~/.config

~/.cache

~/.local/share

GNOME Keyring

VSCode

JetBrains

npm cache

---

十九、社区最常见的完整重置流程

① 卸载 Claude Code

② 删除：

~/.claude

~/.claude.json

③ 删除项目：

.claude

.mcp.json

④ 清理 npm cache

⑤ 清理 VS Code Workspace

⑥ 删除 Claude 插件

⑦ 删除 Keychain / Credential

⑧ 重装 Claude Code

⑨ 不恢复 Session

⑩ 创建新的 Project

---

二十、哪些内容属于官方确认？

官方明确建议：

• ~/.claude
• ~/.claude.json
• .claude
• .mcp.json
• 不恢复旧配置（重新初始化项目）

---

二十一、哪些内容属于社区经验？

下面这些均没有官方文档证明会影响账号风控，仅用于获得一个尽可能干净的开发环境：

• 清理 npm cache
• 删除 VS Code Workspace Storage
• 删除 JetBrains Plugin State
• 清理 Shell History
• 删除浏览器 Cookie
• 清理 Credential Manager / Keychain 中的旧 Token
• 删除 ~/.cache 中与 Claude 相关缓存
• 重新创建 Project
• 不恢复旧 Session
• 重建 Skills / Hooks / MCP
• 检查环境变量

---

二十二、目前没有证据支持的说法

截至目前，没有公开证据能够证明：

• 删除 Machine ID 可以避免账号关联
• 修改硬盘序列号可以避免风控
• 修改 MAC 地址可以避免关联
• 修改 CPU ID 可以避免关联
• 删除某个隐藏文件即可解除风控
• 存在所谓 "Claude Cleaner" 或一键清理工具能够避免账号关联

GitHub、Reddit 和 Hacker News 上均没有可靠证据支持上述说法，更多属于个人猜测或未经验证的经验分享。

---

总结

如果只是为了恢复一个干净、安全、可重新初始化的 Claude Code 本地环境，建议优先完成以下几项：

• 删除 ~/.claude
• 删除 ~/.claude.json
• 删除项目中的 .claude
• 删除 .mcp.json
• 重装 Claude Code
• 不恢复历史 Session
• 重建 Skills、Hooks、MCP
• 清理编辑器工作区缓存（VS Code / JetBrains）
• 检查并更新本地 Token 与环境变量

这些步骤有助于消除旧配置、缓存和第三方扩展带来的影响，但不能保证影响任何账号风控或关联判定。