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 管理后台,提供渠道编排、故障转移、多密钥管理和模型路由,前后端打包成单个二进制,单端口即可部署。
推荐指数
功能完整、部署简单的多模型 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 步
启动服务
运行二进制或 Docker 容器,默认监听 3000 端口。
第 2 步
配置访问密钥
通过 PROXY_ACCESS_KEY 等环境变量设置鉴权。
第 3 步
添加渠道
在 Web 后台配置上游服务类型、API Key 和模型映射。
第 4 步
客户端请求
请求打到 /v1/messages、/v1/chat/completions 等路径。
第 5 步
调度转发
按优先级和健康状态选渠道,失败时自动切换。
快速上手
- 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
二进制启动
下载 Release 二进制,在同目录创建 .env 后运行。
- 3
打开后台
浏览器访问 http://localhost:3000 进入 Web 管理界面。
- 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 地址访问。
