🎉 欢迎使用 AI合租 文档系统！返回主站 →
文档中心
💻 Claude Code
清理缓存和配置

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

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

⚠️

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

快速清理

macOS/Linux

使用 npx 直接运行（推荐）：

# 方式 1: 交互式清理（推荐，选择 claude 选项）
sudo npx aihezu clear
 
# 方式 2: 直接指定服务
sudo npx aihezu clear claude
 
# 兼容命令（已弃用，但仍可使用）
sudo npx ccclear

或全局安装后使用：

npm install -g aihezu
sudo aihezu clear claude

Windows

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

# 方式 1: 交互式清理（推荐，选择 claude 选项）
npx aihezu clear
 
# 方式 2: 直接指定服务
npx aihezu clear claude
 
# 兼容命令（已弃用，但仍可使用）
npx ccclear

成功执行后会显示:

🧹 正在清理 Claude Code 环境...

=== 清理缓存 ===

📂 正在清理目录: /Users/yourname/.claude...

📦 备份并清理文件: history.jsonl
   ✓ 已打包为: history.jsonl-backup-20250113120000.tar.gz
📦 备份并清理目录: debug/
   ✓ 已打包为: debug-backup-20250113120000.tar.gz

=== 刷新网络配置 ===
✅ hosts 文件条目已验证/更新。

✅ 清理完成!

其他维护命令（新增）

# 只修改配置（不清理缓存、不改 hosts）
npx aihezu config claude
 
# 检查配置状态（配置文件 + 环境变量）
npx aihezu check claude
 
# 手动备份 / 恢复 / 重置
npx aihezu backup claude
npx aihezu recover claude
npx aihezu reset claude

功能特性

  • 一键清理 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/settings.json - 配置文件 (包括 API Key 等设置)
  • ~/.claude/commands/ - 自定义命令
  • ~/.claude/skills/ - 技能
  • ~/.claude/mcp/ - MCP 服务器
  • ~/.claude/projects/ - 项目信息
  • ~/.claude/ide/ - IDE 配置

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

恢复备份

恢复 Claude Code 缓存

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

如需恢复之前的缓存,可解压对应的备份包:

# macOS/Linux - 恢复单个文件示例
tar -xzf ~/.claude/history.jsonl-backup-20250113120000.tar.gz -C ~/.claude
 
# 恢复目录示例
tar -xzf ~/.claude/debug-backup-20250113120000.tar.gz -C ~/.claude
 
# Windows PowerShell - 恢复文件示例
tar -xzf "$env:USERPROFILE\.claude\history.jsonl-backup-20250113120000.tar.gz" -C "$env:USERPROFILE\.claude"

由于配置文件 (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

工作原理

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

清理后使用

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

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

系统要求

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

常见问题

遇到问题请查看:

工具源代码

故障排除卸载指南