返回项目

CCG Gateway

如同时用 Claude Code / Codex / Gemini CLI 多账号多服务商还经常手动切换配置,或想在一个桌面端统一管理请求日志、会话和备份,可以采用这个仓库。

CCG Gateway 是一个为 Claude Code、Codex、Gemini CLI 三种编码 CLI 打造的桌面端管理工具。作者原文定位是:「智能 AI 模型网关 | 统一代理 · 负载均衡 · 故障转移」。

它要解决的问题来自重度用户的实际痛点:同时在用 Claude Code、Codex、Gemini CLI,每个工具下还有多个账号和服务商,切换配置靠手动改环境变量或配置文件。服务商挂了要手动切,请求出了问题没有统一日志,会话分散在不同终端里找不回来。CCG Gateway 把这些东西收进一个桌面应用,在 CLI 和服务商之间做一层代理层。

核心功能

网关层

  • 统一代理 Claude Code、Codex、Gemini CLI 的请求
  • 按优先级配置服务商,主服务商故障时自动故障转移到备用
  • 负载均衡(多账号轮询),避免单账号配额打满
  • 服务商失效后自动拉黑一段时间,避免反复重试

管理层

  • 仪表盘:请求量、成功率、token 消耗趋势
  • 服务商 / 账号管理:拖拽调整优先级、模型映射
  • 请求日志:每一次 CLI 调用的完整请求和响应留底
  • 会话管理:按项目分组保存会话历史,可以翻回去看
  • MCP / 提示词 / Skill / 插件的集中配置

可用性

  • 本地备份 + WebDAV 云备份,跨设备同步配置
  • 主题切换
  • 支持热重载开发

适用场景

  • 同时用两个及以上编码 CLI(Claude Code + Codex / Gemini)
  • 有多个账号或多个服务商(官方 + 三方代理)要轮换
  • 关心请求日志和成本,希望知道钱花在哪
  • 会话历史需要跨会话翻查
  • 多设备办公,需要配置同步

不适用的情况

  • 只用一个 CLI 的一个账号,直接配环境变量就够了
  • 不需要请求日志和历史,只追求最简配置
  • 只用网页版 Claude / ChatGPT / Gemini,不用 CLI

安装

推荐从 Releases 下载对应系统的安装包:https://github.com/mos1128/ccg-gateway/releases

主要语言是 Rust(核心)+ Vue + TypeScript(界面),所以是一个独立桌面应用,不依赖 Node / Python 环境。

从源码运行(开发者):

bash
git clone https://github.com/mos1128/ccg-gateway.git
cd ccg-gateway
dev.bat   # Windows 热重载开发

使用方式

装完之后的典型流程:

  1. 在应用里配置好你的服务商(Anthropic 官方 API、三方代理、Gemini 等)
  2. 每个 CLI 指向 CCG Gateway 的本地端点,不再直连服务商
  3. 所有请求经过网关,故障转移和负载均衡自动生效
  4. 在仪表盘和日志页面查看运行状况

License:MIT。

语言

Rust

分类

Vibe Coding

许可证

MIT

更新时间

4/14/2026

标签

claude-codecodexgemini-cligatewayload-balancingfailoverproxydesktop-appmulti-accountrequest-log
~/安装方式

# source

$git clone https://github.com/mos1128/ccg-gateway.git
$下载安装包:https://github.com/mos1128/ccg-gateway/releases

# usage

$在应用里配置服务商
$CLI 指向 CCG Gateway 本地端点
$dev.bat(源码热重载)