Claude Code Pool

Claude Code 多账号池管理服务 — 自动监控额度、智能切换账号、Web Dashboard 一目了然。

基于 ccflare 修改而来。

Screenshots

系统总览	账号管理

数据分析	请求记录

系统日志

功能特性

• 多账号池管理 — 存储多个 Claude Max 订阅账号的 OAuth Token
• 实时用量监控 — 自动轮询每个账号的 5 小时/7 天用量百分比
• 自动故障转移 — 当前账号限流时自动切换到有余量的账号
• Web Dashboard — 直观查看每个账号的用量消耗、请求统计、限流状态（中英文切换）
• 智能负载均衡 — Session 粘性策略，最大化 Prompt Cache 命中率
• OAuth 登录 — 通过浏览器 OAuth 流程添加账号，无需手动提取 Token
• 请求分析 — 记录每个请求的 Token 消耗、响应时间、成本估算
• 开机自启 — macOS LaunchAgent，服务挂了自动重启

快速开始

1. 安装依赖

# 安装 Bun (如果未安装)
curl -fsSL https://bun.sh/install | bash

# 克隆并安装
git clone https://github.com/rc314159-creator/claude_code_manage.git
cd claude_code_manage
bun install

2. 构建并启动

# 构建 Dashboard
bun run build

# 启动服务
bun start

服务启动后：

• Dashboard: http://localhost:8080
• API: http://localhost:8080/api

3. 添加账号

访问 Dashboard -> 账号管理，点击「添加账号」，通过浏览器 OAuth 登录你的 Claude Max 账号。

如果已登录其他账号，用无痕窗口（Cmd+Shift+N）打开登录链接。

4. 配置 Claude Code

在 ~/.claude/settings.json 的 env 字段中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://localhost:8080"
  }
}

或者在 ~/.zshrc 中添加：

export ANTHROPIC_BASE_URL=http://localhost:8080

然后重启 Claude Code，所有请求会自动走代理池。

5. (可选) 开机自启

# 复制 LaunchAgent 配置 (修改路径为你的实际路径)
cp com.claude-code-pool.plist ~/Library/LaunchAgents/
launchctl load ~/Library/LaunchAgents/com.claude-code-pool.plist

Dashboard 功能

• 总览 — 请求统计、成功率、成本、账号用量概览（5h/7d 进度条）
• 账号管理 — 添加/删除/暂停账号、用量进度条、限流状态、OAuth 登录
• 数据分析 — Token 用量图表、成本分析、模型性能对比
• 请求记录 — 详细请求日志、Token 消耗明细
• 系统日志 — 实时日志流
• 中英文切换 — 左下角地球图标切换语言

工作原理

Claude Code → localhost:8080 (代理) → 选择最佳账号 → api.anthropic.com
                                  ↓
                          限流? → 自动切换下一个账号

1. Claude Code 发送请求到本地代理 (localhost:8080)
2. 代理通过负载均衡策略选择最佳账号
3. 使用选中账号的 OAuth Token 转发请求到 Anthropic API
4. 如果遇到限流 (429)，自动切换到下一个可用账号
5. 后台每 2 分钟轮询 OAuth Usage API，监控每个账号的实时用量

用量监控

服务会每 2 分钟轮询一次 Anthropic 的 OAuth Usage API，获取：

• 5 小时窗口用量 — 当前 5 小时滚动窗口的使用百分比
• 7 天窗口用量 — 当前 7 天滚动窗口的使用百分比
• 重置时间 — 各窗口的重置时间点

API 端点

方法	路径	说明
GET	/api/accounts	获取所有账号（含用量信息）
POST	/api/oauth/init	开始 OAuth 登录流程
POST	/api/oauth/callback	完成 OAuth 登录
DELETE	/api/accounts/:id	删除账号
POST	/api/accounts/:id/pause	暂停账号
POST	/api/accounts/:id/resume	恢复账号
GET	/api/stats	获取统计信息
GET	/api/analytics	获取分析数据
GET	/health	健康检查

技术栈

• Runtime: Bun >= 1.2.8
• Backend: TypeScript, SQLite (WAL mode)
• Frontend: React 19, Tailwind CSS, shadcn/ui, Recharts
• Auth: OAuth 2.0 PKCE
• Architecture: Monorepo (Bun workspaces)

致谢

• ccflare — 本项目基于 ccflare 修改
• Anthropic — Claude API

License

MIT