snipeship GitHub avatar

ccflare

TypeScript
Claude 代码代理网关snipeship最近推送 2026年4月20日
模型推理与部署MIT1,05514622 issues7 天 +1

AI 分析 · 由大模型根据 README 与仓库数据生成 · 2026年11月18日

一个多提供商原生代理,按 URL 前缀路由 Anthropic 和 OpenAI 请求,支持多账号负载均衡与故障转移。

ccflare 是一个用 TypeScript 编写的代理服务,同时代理 Anthropic 和 OpenAI 的 API 请求。它按 URL 前缀区分提供商,不做 payload 转换,保持原生格式透传。支持多账号负载均衡、限流状态跟踪、请求历史与用量分析,并提供 Dashboard 和 TUI 管理界面。

推荐指数

4.0

适合需要统一管理多个 Anthropic/OpenAI 账号并做故障转移的开发者,功能完整、文档清晰,但依赖 Bun 运行时。

近 7 天

+1

新增 Star

总 Star 排名

#3405

雷达追踪的 3,931 个 AI 仓库中

创建于

2025

2025年7月25日

核心亮点

  • 1原生透传

    不转换请求体,Anthropic 和 OpenAI 各自保持原格式。

  • 2多账号负载均衡

    支持多个账号轮询,某个账号限流时自动重试其他账号。

  • 3内置可观测性

    提供 Dashboard、请求历史、用量分析和实时日志流。

  • 4灵活认证

    同时支持 API Key 和 OAuth 账号接入。

  • 5兼容路由

    通过 /v1/ccflare/* 按模型前缀选择提供商家族。

适用场景

  • 多账号统一入口

    例如:团队有多个 Anthropic API Key,通过 ccflare 统一代理并自动轮询分配请求。

  • 限流故障转移

    例如:某个 OpenAI 账号触发限流时,ccflare 自动切换到其他可用账号重试。

  • 请求审计与用量分析

    例如:通过 Dashboard 查看最近的请求记录、各账号用量和性能统计。

  • 混合模型调用

    例如:在兼容路由下用 openai/ 前缀的模型名调用 Anthropic 提供商家族。

它是怎么工作的

  1. 第 1 步

    按前缀路由

    请求路径 /v1/anthropic/* 或 /v1/openai/* 决定转发到哪个上游。

  2. 第 2 步

    剥离前缀

    转发前将 /v1/{provider} 前缀精确剥离一次,再拼接到上游地址。

  3. 第 3 步

    账号选择

    根据负载均衡策略从对应提供商的账号池中选择一个账号。

  4. 第 4 步

    失败重试

    若当前账号被限流,自动重试同提供商下的其他账号。

  5. 第 5 步

    记录与展示

    保存请求历史、限流状态和用量数据,通过 Dashboard 或 API 查看。

快速上手

  1. 1

    克隆并安装

    克隆仓库后用 Bun 安装依赖。

    git clone https://github.com/snipeship/ccflare && cd ccflare && bun install
  2. 2

    启动服务

    启动服务器和 Dashboard,默认监听 8080 端口。

    bun run start
  3. 3

    添加账号

    通过管理 API 添加 API Key 账号,或用 TUI 交互式添加 OAuth 账号。

    curl -X POST http://localhost:8080/api/accounts -H "content-type: application/json" -d '{"name":"anthropic-main","provider":"anthropic","auth_method":"api_key","api_key":"sk-ant-..."}'
  4. 4

    指向代理

    将客户端 base URL 设为 ccflare 的提供商前缀地址。

    export ANTHROPIC_BASE_URL=http://localhost:8080/v1/anthropic

适合谁

  • 需要统一管理多个 Anthropic/OpenAI 账号的开发者
  • 希望在不改客户端代码的情况下做限流故障转移的团队
  • 需要请求历史和用量分析的个人或小团队

不太适合

  • 不想引入额外代理层的简单单账号用户
  • 无法使用 Bun 运行时的环境

成熟度

  • 活跃度2025 年 7 月创建,最近一次推送在 2026 年 4 月,仍在活跃维护。
  • 文档README 覆盖路由、账号配置、API 和示例,docs/ 目录另有架构与配置文档。
  • 社区约 1055 star、147 fork,22 个开放 issue,属于中小规模项目。
  • 上手难度需要 Bun 环境和手动配置账号,但提供 Dashboard 和 TUI 降低操作门槛。

使用前注意

  • · 依赖 Bun >= 1.2.8 运行时,不是纯 Node.js 项目。
  • · 需要自行准备 Anthropic 和/或 OpenAI 的 API Key 或 OAuth 凭证。
  • · 代理会保存请求历史与 payload,需注意数据留存和隐私。
  • · MIT 许可,可自由使用和修改。

主题标签

anthropic-apianthropic-claudeclaudeclaude-apiclaude-codecodexcodex-cli