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 與環境變量

這些步驟有助於消除舊配置、緩存和第三方擴展帶來的影響，但不能保證影響任何帳號風控或關聯判定。