ccflare 🛡️

跟踪每一次请求。深入底层。再也不用担心速率限制了。

终极 Claude API 代理，可在多个账户之间实现智能负载均衡。全面掌握每一次请求、响应和速率限制情况。

https://github.com/user-attachments/assets/c859872f-ca5e-4f8b-b6a0-7cc7461fe62a

为什么选择 ccflare？

• 🚀 零速率限制错误 - 自动将请求分配到多个账户
• 📊 请求级分析 - 实时跟踪延迟、令牌使用量和成本
• 🔍 深度调试 - 完整的请求/响应日志记录和错误追踪
• ⚡ <10ms 开销 - 对您的 API 调用性能影响极小
• 💸 免费且开源 - 您可以自行运行、修改，并完全掌控自己的基础设施

快速开始

# 克隆并安装
git clone https://github.com/snipeship/ccflare
cd ccflare
bun install

# 启动 ccflare（TUI + 服务器）
bun run ccflare

# 配置 Claude SDK
export ANTHROPIC_BASE_URL=http://localhost:8080

功能特性

🎯 智能负载均衡

• 基于会话 - 维持对话上下文（5 小时会话）

📈 实时分析

• 按请求跟踪令牌使用量
• 监控响应时间
• 检测并警告速率限制
• 成本估算与预算管理

🛠️ 开发者工具

• 交互式 TUI (bun run ccflare)
• Web 控制面板 (http://localhost:8080/dashboard)
• 用于账户管理的 CLI
• 用于自动化的 REST API

🔒 生产就绪

• 账户之间的自动故障转移
• OAuth 令牌刷新处理
• SQLite 数据库用于持久化
• 可配置的重试逻辑

文档

完整文档位于 docs/：

• 入门指南
• 架构
• API 参考
• 配置
• 负载均衡策略

截图

实时控制面板	请求日志
分析与使用跟踪

系统要求

• Bun >= 1.2.8
• Claude API 账户（免费版、专业版或团队版）

贡献

我们欢迎任何贡献！请参阅 CONTRIBUTING.md 获取相关指南。

许可证

MIT - 详情请参阅 LICENSE

---

专为持续交付的开发者打造 ❤️

ccflare 快速上手指南

ccflare 是一款专为 Claude API 设计的开源代理工具，支持多账号智能负载均衡、实时请求分析和深度调试，助您彻底告别速率限制（Rate Limit）错误。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 运行时环境：需安装 Bun (版本 >= 1.2.8)。
  • 国内加速建议：如果官方安装脚本下载缓慢，可使用国内镜像源安装：

    curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/bun/install.sh | bash
    

• API 凭证：拥有一个或多个 Claude API 账号（Free、Pro 或 Team 版均可）。
• 操作系统：支持 Linux、macOS 及 Windows (WSL)。

安装步骤

通过以下命令克隆项目并安装依赖：

# 1. 克隆仓库
git clone https://github.com/snipeship/ccflare
cd ccflare

# 2. 安装依赖 (使用 Bun)
bun install

基本使用

1. 启动服务

运行以下命令启动 ccflare，它将同时开启终端用户界面 (TUI) 和本地服务器：

bun run ccflare

启动后，您可以在终端查看实时状态，或访问 Web 仪表盘：

• Web 仪表盘地址: http://localhost:8080/dashboard

2. 配置客户端

将您的 Claude SDK 或 HTTP 请求的 BASE_URL 指向本地代理地址即可。

环境变量配置示例：

export ANTHROPIC_BASE_URL=http://localhost:8080

代码调用示例 (Python/Node.js 等通用逻辑)：

在初始化 Claude 客户端时，指定 base_url 为 http://localhost:8080，并在环境变量中填入您的多个 API Key（ccflare 会自动处理轮询和故障转移）。

现在，您的所有请求将通过 ccflare 进行智能分发，自动规避单账号的速率限制，并记录详细的延迟、Token 消耗及成本数据。