aihezu - Claude Code CLI 工具集

快速配置或清理 Claude Code / Codex，本地修改 hosts 并提供企业独立域名支持。

功能特性

- 🔑 一键配置 Claude（默认）或 Codex，支持企业独立域名（--api / --api-url）
- 🧹 一键清理 Claude Code CLI 的所有本地数据
- 🌐 自动修改 hosts 文件，将 Anthropic 域名指向本地
- 📦 自动备份配置文件和 hosts 文件（带时间戳）
- ✅ 安全可靠，不会丢失数据
- 🚀 支持 npx 直接运行，无需安装
- 🔄 自动刷新 DNS 缓存

命令列表

- ccinstall / install：交互式配置 Claude（默认）或 Codex
- Claude：默认 https://cc.aihezu.dev/api，企业可用 --api / --api-url 指定独立域名
- Codex：默认 https://cc.aihezu.dev/openai，企业可用 --api / --api-url 指定独立域名；写入 ~/.codex/config.toml 和 auth.json，使用 AIHEZU_OAI_KEY
- ccclear：清理 Claude Code 缓存和配置
- usage：查看 Claude Code / Codex / Gemini 用量统计（支持 --key 指定 API Key）

清理内容

该工具会执行以下操作：

$3

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

$3

- ~/.claude/ - Claude Code 主数据目录（包括缓存、历史、项目等）
- ~/.claude.json - Claude Code 全局配置文件

使用方法

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

$3

使用 sudo 命令运行：

``bash
sudo npx aihezu install
sudo npx aihezu ccclear
`

$3

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

1. 搜索 "PowerShell" 或 "命令提示符"
2. 右键点击，选择 "以管理员身份运行"
3. 在打开的窗口中运行命令（无需 sudo）：

`powershell
npx aihezu install
npx aihezu ccclear
`

Windows 特别说明：
- hosts 文件位置：C:\Windows\System32\drivers\etc\hosts
- 某些防病毒软件可能会保护 hosts 文件，需要临时禁用
- 推荐使用 PowerShell 配置文件设置环境变量，而不是系统环境变量

$3

- 默认域名：

`bash
sudo npx aihezu install
`

- 企业独立域名（支持传入域名或完整 URL，自动补全为 /api）：

`bash
sudo npx aihezu install --api https://your-org.aihezu.dev


或


sudo npx aihezu install --api your-org.aihezu.dev
`

也可以全局安装后运行：

`bash
npm install -g aihezu
sudo ccinstall --api your-company.aihezu.dev
`

- 直接选择 Codex（可在交互中选择，也可用参数指定）：

`bash
sudo npx aihezu install --provider codex


Codex 企业独立域名（自动补全为 /openai）


sudo npx aihezu install --provider codex --api your-org.aihezu.dev
`

$3

- 使用 npx（推荐）：

`bash
sudo npx aihezu ccclear
`

- 全局安装后运行：

`bash
npm install -g aihezu
sudo ccclear
`

$3

无需管理员权限：

`bash
npx aihezu usage
`

指定服务：

`bash
npx aihezu usage cc
`

指定 API Key：

`bash
npx aihezu usage --key sk-xxx
npx aihezu usage cc --key sk-xxx
`

运行效果

`
🧹 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 到 .claude-20250113120000
📦 备份 ~/.claude.json 到 .claude.json-20250113120000

✅ Claude Code CLI 配置和缓存已清理完成！
💡 下次启动 Claude Code 时将重新初始化
📁 备份文件保存在 /Users/yourname/ 目录下

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

恢复备份

$3

如需恢复之前的配置，只需将备份文件重命名：

`bash


恢复目录

mv ~/.claude-20250113120000 ~/.claude

恢复配置文件

mv ~/.claude.json-20250113120000 ~/.claude.json
`

$3

`bash


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. 配置清理：备份并清理 Claude Code 的配置和缓存
3. 安全备份：所有修改前都会创建带时间戳的备份文件

系统要求

- Node.js >= 14.0.0
- macOS / Linux / Windows (完整跨平台支持)
- 需要管理员/root 权限（用于修改 hosts 文件）

平台支持：
- ✅ macOS - 完整支持，包括权限修复和 DNS 刷新
- ✅ Linux - 完整支持，支持多种 DNS 服务（systemd-resolve, nscd）
- ✅ Windows - 完整支持，提供平台特定的指导和错误提示

更多 Windows 安装和配置信息，请参阅 Windows 设置指南。

许可证

MIT

问题反馈

如有问题或建议，欢迎提 Issue。