AIAI 工具图鉴
← 返回全部文章
·约 12 分钟

CCX：多协议 AI API 代理网关

本文目录
  1. 什么是 CCX？
  2. 核心功能一览
  3. 快速上手：1 分钟部署
  4. 竞品对比
  5. 核心功能详解
  6. 1. 渠道编排与可视化面板
  7. 核心功能详解
  8. 2. 流量监控与日志
  9. 核心功能详解
  10. 3. 渠道配置管理
  11. 用户群体总结
  12. 定价与协议
  13. 总结

CCX：多协议 AI API 代理网关

CCX-封面.png

单二进制部署 | 统一管理 Claude/OpenAI/Codex/Gemini

⭐ 2,591 🍴 185 | MIT | Go 语言

什么是 CCX？

高性能 AI API 代理与协议转换网关

  • 同时对接 Claude、OpenAI、Codex、Gemini 等多 AI 服务
  • 需维护多套 API 协议和鉴权方式 → 收敛到单一入口
  • 内置 Web 管理面板进行渠道配置、密钥管理、故障转移
  • Go 语言编写，单二进制零依赖部署

核心定位：一套接口接入全网主流大模型

核心功能一览

CCX-功能对比.png

功能模块 描述 核心价值
多协议代理 统一 Claude/OpenAI/Codex/Gemini API 一套接口全搞定
可视化面板 Web UI 图形化渠道管理 告别手动改配置
智能调度 优先级/故障转移/熔断 生产级高可用
多Key轮换 自动轮换 API Key 突破 Rate Limit
单二进制部署 Go 语言一体化架构 零依赖开箱即用
日志监控 实时请求量/成功率/延迟 可观测性强

快速上手：1 分钟部署

方式一：二进制直接运行

# 创建 .env 文件
PORT=3000
PROXY_ACCESS_KEY=your-proxy-access-key
ADMIN_ACCESS_KEY=your-admin-secret-key
APP_UI_LANGUAGE=zh-CN

# 直接运行
./ccx  # Linux/macOS 或 ccx.exe Windows
# 访问 http://localhost:3000

方式二：Docker

docker run -d --name ccx -p 3000:3000 \
  -e PROXY_ACCESS_KEY=your-proxy-access-key \
  crpi-i19l8zl0ugidq97v.cn-hangzhou.personal.cr.aliyuncs.com/bene/ccx:latest

竞品对比

CCX-竞品对比.png

对比维度 CCX OneAPI CodexBridge
多协议支持 Claude/OpenAI/Codex/Gemini OpenAI兼容为主 仅Codex
可视化面板 内置Web UI 部分版本支持 无
部署方式 单二进制即可运行 需Docker+数据库 需Python环境
故障转移 智能熔断+自动切换 基本切换 不支持
日志监控 实时请求量/成功率/延迟 基础日志 无
语言 Go 高性能 Python/Java Python

核心优势：原生多协议 + 单二进制部署 + 可视化面板

核心功能详解

1. 渠道编排与可视化面板

channel-orchestration.png 功能说明：Web 管理面板提供直观的渠道编排界面，拖拽调整优先级，实时查看渠道状态

输入要求：上游 API Key、模型映射关系、优先级权重

输出效果：自动化渠道调度，按优先级依次尝试，失败自动转移

适用场景：

  • 团队统一管理多个 AI 服务商的 API Key
  • 不同模型使用不同渠道分发
  • 临时停用某个渠道无需改代码

核心功能详解

2. 流量监控与日志

traffic-stats.png 功能说明：实时监控每个渠道的请求量、成功率和平均延迟，支持按模型维度统计

输入要求：无需额外配置，启动后自动采集

输出效果：可视化仪表板，展示渠道状态、熔断状态、请求趋势

适用场景：

  • 运维团队监控 API 服务健康状态
  • 成本分析：哪个模型用量最多、哪个渠道最稳定
  • 排查问题：查看失败请求的具体原因

核心功能详解

3. 渠道配置管理

add-channel-modal.png 功能说明：新增、编辑、删除上游渠道，独立配置 API 端点、Key、模型映射、超时时间

输入要求：上游服务商名称、API 地址、认证密钥

输出效果：自动生成渠道配置，支持热重载无需重启

适用场景：

  • 快速接入新的大模型服务商
  • 同一个模型配置多个 API Key 轮换使用
  • 生产环境和测试环境使用不同渠道

用户群体总结

  • ✅ AI 应用开发者：统一管理多个大模型 API，减少适配代码量
  • ✅ DevOps/运维团队：集中监控 API 调用状态，保障服务高可用
  • ✅ 独立开发者：一个二进制文件搞定，无需折腾 Docker 和数据库
  • ✅ 小型团队：共享 API Key，统一管理白名单和配额
  • ❌ 单模型轻量使用：官方 SDK 更直接简单

定价与协议

完全免费开源，MIT 协议，可商用无限制

  • GitHub Releases 提供 Linux/macOS/Windows 二进制文件
  • 支持 Docker 和 Docker Compose 部署
  • 通过 SignPath Foundation 代码签名，安全有保障

特别适合：正在寻找 OneAPI 替代品的用户

GitHub 仓库： BenedictKing/ccx

总结

  • 核心价值：将分散的 AI API 调用收敛到一个统一代理层
  • 最大优势：单二进制零依赖部署 + 原生多协议支持（Claude + OpenAI + Codex + Gemini）
  • 推荐指数：⭐⭐⭐⭐（4星）
  • 适合人群：同时使用多个 AI 服务的开发者和团队

立即体验： CCX 官方文档