清理 Claude Code CLI 缓存和配置文件

快速备份和清理 Claude Code CLI 的本地配置和缓存文件,同时修改 hosts 文件实现本地代理。

⚠️

由于需要修改系统 hosts 文件,必须使用管理员权限运行!

快速清理

macOS/Linux

使用 npx 直接运行(推荐):

sudo npx aihezu ccclear

或全局安装后使用:

npm install -g aihezu
sudo ccclear

Windows

以管理员身份运行命令提示符或 PowerShell:

npx aihezu ccclear

成功执行后会显示:

🧹 Claude Code CLI 清理工具
🌐 Powered by https://aihezu.dev

=== 步骤 1: 修改 hosts 文件 ===

🔧 开始修改 hosts 文件...
📦 已备份 hosts 文件到 /etc/hosts.backup-20250113120000
✅ hosts 文件修改成功!
   已添加/更新以下域名解析:
   - statsig.anthropic.com -> 127.0.0.1
   - api.anthropic.com -> 127.0.0.1
🔄 DNS 缓存已刷新

=== 步骤 2: 清理 Claude Code 缓存 ===

📂 开始清理 ~/.claude 目录下的缓存文件...

📦 备份并清理文件: history.jsonl
📦 备份并清理目录: debug/
📦 备份并清理目录: file-history/
📦 备份并清理目录: session-env/
📦 备份并清理目录: shell-snapshots/
📦 备份并清理目录: statsig/
📦 备份并清理目录: todos/

✅ 已保留以下配置和工具:
   - settings.json (配置文件)
   - commands/ (自定义命令)
   - skills/ (技能)
   - mcp/ (MCP 服务器)
   - projects/ (项目信息)
   - ide/ (IDE 配置)

📦 备份 ~/.claude.json 到 .claude.json-backup-20250113120000

✅ Claude Code 缓存已清理完成! (共处理 7 项)
💡 配置和工具已保留,下次启动 Claude Code 可直接使用
📁 备份文件保存在 ~/.claude/ 目录下

=== 全部完成 ===
更多服务请访问 AI 合租官网: https://aihezu.dev

功能特性

一键清理 Claude Code CLI 的缓存数据 (保留配置和工具)
自动修改 hosts 文件,将 Anthropic 域名指向本地
自动备份所有被修改的文件 (带时间戳)
安全可靠,不会丢失数据
智能保留配置文件、自定义命令、技能等重要内容
支持 npx 直接运行,无需安装
自动刷新 DNS 缓存

清理内容

该工具会执行以下操作:

1. 修改 hosts 文件

将 statsig.anthropic.com 指向 127.0.0.1
将 api.anthropic.com 指向 127.0.0.1
如果已存在这些域名的解析,会先移除旧记录再添加新记录
自动备份 hosts 文件 (带时间戳)
自动刷新 DNS 缓存

2. 清理 Claude Code 缓存

清理的缓存文件和文件夹:

~/.claude/history.jsonl - 历史记录
~/.claude/debug/ - 调试信息
~/.claude/file-history/ - 文件历史
~/.claude/session-env/ - 会话环境
~/.claude/shell-snapshots/ - Shell 快照
~/.claude/statsig/ - 统计信息
~/.claude/todos/ - 待办事项
~/.claude.json - 全局配置文件

保留的配置和工具:

~/.claude/settings.json - 配置文件 (包括 API Key 等设置)
~/.claude/commands/ - 自定义命令
~/.claude/skills/ - 技能
~/.claude/mcp/ - MCP 服务器
~/.claude/projects/ - 项目信息
~/.claude/ide/ - IDE 配置

所有清理操作都会创建带时间戳的备份,不会直接删除数据。配置和工具会被保留,清理后可以继续使用 Claude Code 而无需重新配置。

恢复备份

恢复 Claude Code 缓存

备份文件保存在 ~/.claude/ 目录下,文件名格式为 原文件名-backup-时间戳。

如需恢复之前的缓存,只需将备份文件重命名:

# macOS/Linux - 恢复单个文件示例
mv ~/.claude/history.jsonl-backup-20250113120000 ~/.claude/history.jsonl
 
# 恢复目录示例
mv ~/.claude/debug-backup-20250113120000 ~/.claude/debug
 
# 恢复全局配置文件
mv ~/.claude.json-backup-20250113120000 ~/.claude.json
 
# Windows PowerShell - 恢复文件示例
Move-Item "$env:USERPROFILE\.claude\history.jsonl-backup-20250113120000" "$env:USERPROFILE\.claude\history.jsonl"
 
# 恢复全局配置文件
Move-Item "$env:USERPROFILE\.claude.json-backup-20250113120000" "$env:USERPROFILE\.claude.json"

由于配置文件 (settings.json) 和工具 (commands/, skills/ 等) 不会被清理,通常不需要恢复这些内容。

恢复 hosts 文件

# macOS/Linux
sudo mv /etc/hosts.backup-20250113120000 /etc/hosts
 
# Windows (以管理员身份运行)
move C:\Windows\System32\drivers\etc\hosts.backup-20250113120000 C:\Windows\System32\drivers\etc\hosts

使用场景

Claude Code CLI 出现异常需要重置
需要通过本地代理使用 Claude API
清理大量累积的缓存和日志
切换不同的配置环境
重新初始化 Claude Code CLI

工作原理

hosts 文件修改: 将 Anthropic 相关域名指向本地 127.0.0.1,配合本地代理使用
选择性清理: 只清理缓存数据 (历史记录、调试信息、会话环境等),保留配置和工具
安全备份: 所有清理的文件都会先创建带时间戳的备份

清理后使用

由于配置文件 (settings.json) 和工具被保留,清理后可以直接使用 Claude Code,无需重新配置。

如果需要重新配置,可以参考安装指南:Mac / Windows / Linux

系统要求

Node.js >= 14.0.0
macOS / Linux / Windows
需要管理员/root 权限(用于修改 hosts 文件)

常见问题

遇到问题请查看:

工具源代码

故障排除卸载指南