在同时使用 Codex CLI、Codex App 和 IDE 集成时,账号额度耗尽、授权失效或上游服务返回 401429,都可能中断当前工作。频繁退出登录、修改配置和重启客户端也比较麻烦。

Codex Conduit 是一个运行在本机的桌面网关,用来集中管理多个 ChatGPT 订阅账号和 OpenAI 兼容服务,并根据账号健康状态、剩余额度和路由策略选择上游。

项目地址:GitHub - cherrylfrei-max/codex-conduit: Codex Conduit — Multi-account routing, automatic failover, quota monitoring, and a local gateway for Codex CLI and Codex App. · GitHub

工作方式

Codex CLI / Codex App / IDE
              |
              v
     Codex Conduit 本地网关
              |
       账号与服务商路由
              |
              v
ChatGPT OAuth / OpenAI 兼容服务

启用本地代理后,Codex 请求会先发送到本机的 Codex Conduit。程序根据当前设置选择账号或第三方服务,再将请求转发到对应上游。当当前账号出现授权失效、限流或额度耗尽时,可以按照配置切换到其他健康账号。

主要功能

  • 多账号集中管理:统一管理 ChatGPT 订阅账号、OpenAI API Key 和兼容 OpenAI 协议的第三方服务。
  • 本地请求路由:Codex CLI、Codex App 和支持的 IDE 集成通过本地网关访问上游。
  • 自动故障转移:识别 401429 和额度耗尽等情况,并按策略选择可用账号。
  • 额度与健康状态监控:查看五小时额度、每周额度、服务商余额和账号状态。
  • 配置保护:启用代理前备份 ~/.codex/config.toml,关闭代理时尝试恢复原配置。
  • 协议兼容:第三方服务可使用 /v1/responses/chat/completions 接口。

快速开始

  1. GitHub Releases 下载适合当前系统的安装包。
  2. 添加 ChatGPT 订阅账号时,在 OpenAI 官方页面完成 OAuth 授权,无需在 Codex Conduit 中输入 OpenAI 密码。
  3. 如有需要,添加 OpenAI 兼容服务并配置 API Key、Base URL 和上游协议。
  4. 在 Dashboard 中启用 Local Proxy,然后重启 Codex CLI、Codex App 或相关 IDE。

安全与使用边界

Codex Conduit 在本机处理账号令牌、API Key 和代理配置,因此应像保护开发环境中的其他密钥一样保护运行设备。不要把真实密钥粘贴到 Issue、日志或截图中,也不要安装来源不明的构建版本。

多账号路由和故障转移应当用于合法的可用性管理。使用不同账号和第三方服务时,仍需遵守相应平台的服务条款、账号政策和计费规则。

当前 GitHub 仓库主要用于项目文档、版本发布和已公开代码,完整源码尚未全部公开。安装前可先阅读项目说明和 Release 信息,再根据自己的使用环境进行评估。

 

Logo

AtomGit AI 社区提供模型库、数据集、Agent、Token等资源

更多推荐