CCX：多模型 AI API 代理网关

项目简介

CCX 是一个高性能 AI API 代理与协议转换网关，面向需要统一接入多家模型服务的开发者。它将 Claude Messages、OpenAI Chat Completions、OpenAI Images、OpenAI Embeddings、Codex Responses 与 Gemini API 汇集到同一个后端入口，并提供内置 Web 管理台，用于渠道管理、测试、日志查看和监控。

主要功能

• 前后端一体化架构，单端口部署，前端资源内嵌，便于以单个二进制运行。
• 使用 PROXY_ACCESS_KEY 与可选的 ADMIN_ACCESS_KEY 进行双密钥认证。
• Web 管理台支持渠道编排、渠道测试、日志与实时监控。
• 支持 Claude Messages、OpenAI Chat Completions、OpenAI Images、OpenAI Embeddings、Codex Responses 和 Gemini API。
• 智能调度：支持优先级、提升窗口、健康检查、故障转移与熔断恢复。
• 上下文路由：根据模型实际上下文窗口和最大输出能力筛选候选渠道。
• 每个渠道可配置 API Key 轮换、代理、自定义请求头、模型白名单与路由前缀。
• 支持 Responses 会话跟踪，便于多轮工作流。
• 断路器默认采用温和策略（v2.9.37 起）。

统一入口的主要路由如下：

/                            -> Web UI
/api/*                       -> Admin API
/v1/messages                 -> Claude Messages proxy
/v1/chat/completions         -> OpenAI Chat proxy
/v1/responses                -> Codex Responses proxy
/v1/images/{...}             -> OpenAI Images proxy
/v1/embeddings               -> OpenAI Embeddings proxy
/v1/models                   -> Models API
/v1beta/models/*             -> Gemini proxy

安装与使用

CCX Desktop

提供带图形界面的桌面端，用于管理渠道、密钥和 Agent 配置。

• Windows：在 Microsoft Store 搜索 CCX Desktop 安装，也可从 GitHub Releases 下载 setup.exe。
• macOS：brew tap BenedictKing/ccx && brew install --cask ccx-desktop，或从 Releases 下载 .dmg。
• Linux：从 GitHub Releases 下载 .AppImage，赋予可执行权限后运行。

二进制运行

从 Releases 下载最新二进制，在二进制同目录创建 .env：

PROXY_ACCESS_KEY=your-proxy-access-key
PORT=3688
ENABLE_WEB_UI=true
APP_UI_LANGUAGE=en

启动后打开 Web UI，地址以实际 PORT 配置为准。

Docker

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

从源码构建

需要 Go 1.25+、Bun 和 Make（macOS 可先执行 xcode-select --install）。

git clone https://github.com/BenedictKing/ccx
cd ccx
cp backend-go/.env.example backend-go/.env
make install
make run

注意事项

• 管理端和代理端密钥应使用足够复杂的值，并按需设置 ADMIN_ACCESS_KEY。
• 在 Windows 上从 cmd、PowerShell、WSL 或 Docker 访问时，如果 localhost 无法连接，可改用宿主机 IPv4 地址。
• 未设置 BIND_HOST 时，CCX 默认监听所有网络接口；仅本机访问可设置 BIND_HOST=127.0.0.1。
• Images 接口包括 POST /v1/images/generations、POST /v1/images/edits 与 POST /v1/images/variations。

---

本作品整理自 GitHub 开源项目 BenedictKing/ccx，原作者 @BenedictKing，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。