BenedictKing GitHub avatar

ccx

Go
多模型API代理BenedictKing最近推送 2026年11月19日
模型推理与部署MIT3,98532045 issues7 天 +3

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

统一转发 Claude、OpenAI、Codex、Gemini 请求的 Go 语言 API 代理网关。

CCX 是一个用 Go 编写的高性能 AI API 代理与协议转换网关,把 Claude Messages、OpenAI Chat、OpenAI Images、OpenAI Embeddings、Codex Responses 和 Gemini 等接口收敛到同一个入口。它自带 Web 管理后台,提供渠道编排、故障转移、多密钥管理和模型路由,前后端打包成单个二进制,单端口即可部署。

推荐指数

4.0

功能完整、部署简单的多模型 API 网关,适合需要统一接入和容灾的开发者。

近 7 天

+3

新增 Star

总 Star 排名

#1472

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

创建于

2026

2026年1月31日

核心亮点

  • 1多协议统一入口

    一个端口同时代理 Claude、OpenAI、Codex 和 Gemini 系列接口。

  • 2内置管理后台

    Web 控制台可管理渠道、测试连通性、查看日志和流量监控。

  • 3智能调度容灾

    按优先级调度,带健康检查、故障转移和熔断恢复。

  • 4多密钥与路由

    每个渠道支持密钥轮换、代理、自定义请求头、模型白名单和路由前缀。

  • 5单二进制部署

    前端资源内嵌,编译后一个可执行文件即可运行。

适用场景

  • 多模型统一接入

    例如:客户端只改 base URL,就能在 Claude 和 Gemini 之间切换调用。

  • 上游容灾

    例如:某个渠道密钥失效或超时时,自动切换到备用渠道继续请求。

  • 团队密钥管理

    例如:用管理后台给不同渠道配置多把 API Key 并轮换使用。

  • 桌面端快速使用

    例如:在 Windows 或 macOS 安装 CCX Desktop,用图形界面管理渠道和密钥。

它是怎么工作的

  1. 第 1 步

    启动服务

    运行二进制或 Docker 容器,默认监听 3000 端口。

  2. 第 2 步

    配置访问密钥

    通过 PROXY_ACCESS_KEY 等环境变量设置鉴权。

  3. 第 3 步

    添加渠道

    在 Web 后台配置上游服务类型、API Key 和模型映射。

  4. 第 4 步

    客户端请求

    请求打到 /v1/messages、/v1/chat/completions 等路径。

  5. 第 5 步

    调度转发

    按优先级和健康状态选渠道,失败时自动切换。

快速上手

  1. 1

    Docker 启动

    拉取镜像并映射 3000 端口,设置访问密钥。

    docker run -d --name ccx -p 3000:3000 -e PROXY_ACCESS_KEY=your-proxy-access-key -e APP_UI_LANGUAGE=en -v $(pwd)/.config:/app/.config crpi-i19l8zl0ugidq97v.cn-hangzhou.personal.cr.aliyuncs.com/bene/ccx:latest
  2. 2

    二进制启动

    下载 Release 二进制,在同目录创建 .env 后运行。

  3. 3

    打开后台

    浏览器访问 http://localhost:3000 进入 Web 管理界面。

  4. 4

    桌面端安装

    macOS 可用 Homebrew 安装图形界面版本。

    brew tap BenedictKing/ccx && brew install --cask ccx-desktop

适合谁

  • 需要统一接入多家模型 API 的开发者
  • 要自建代理做密钥管理和容灾的团队
  • 希望用图形界面管理渠道的个人用户

不太适合

  • 只需要调用单一官方 API 的简单场景
  • 不想自行部署和维护服务的用户

成熟度

  • 活跃度最近一次推送在 2026 年 11 月,star 近 4000,更新较活跃。
  • 文档README 覆盖架构、部署方式和截图,并有独立文档目录。
  • 社区有 321 个 fork 和 44 个开放 issue,社区规模中等。
  • 上手难度提供 Docker、二进制和桌面端三种方式,单端口部署门槛低。

同类项目怎么选

  • LiteLLMPython 实现,侧重多模型统一调用和计费统计,CCX 是 Go 单二进制并自带管理后台。
  • one-api同样做多模型 API 聚合分发,CCX 更强调协议转换、渠道调度和故障转移。

使用前注意

  • · 采用 MIT 许可,可商用但需保留版权声明。
  • · 代理会经手上游 API Key,需妥善保管 PROXY_ACCESS_KEY 和管理密钥。
  • · 默认监听所有网卡,仅本机使用时应设置 BIND_HOST=127.0.0.1。
  • · Windows 下 localhost 可能不通,需改用主机 IPv4 地址访问。

主题标签

claudecodexgemini