Home

CodexManager Wiki

CodexManager 是一个面向 Codex、Claude Code、Gemini CLI 和 OpenAI 兼容客户端的本地账号池管理器与网关转发工具。它把“账号管理、用量监控、平台 Key、本地网关、第三方上游、模型目录、插件扩展”放在一个统一的桌面端和 Service 控制台里，让个人用户、团队和自部署环境都能用同一套入口管理 AI 编程相关调用。

它解决什么问题

很多 AI 编程工具都需要 API Key、账号授权、模型名称、代理、上游地址和请求参数。随着账号、团队成员、上游中转站和客户端数量增加，常见问题会变成：

• 账号多了以后，不知道哪个账号可用、哪个低配额、哪个被限流或封禁。
• Codex CLI、Claude Code、Gemini CLI、第三方 OpenAI 客户端各自配置分散，维护成本高。
• 账号池和第三方中转上游需要统一调度，最好能账号优先、上游兜底。
• 本地服务、桌面端、Web 控制台、Docker 部署需要同一套配置和排障资料。
• 请求失败后需要看日志、路由命中、模型、平台 Key、上游响应，而不是盲猜。

CodexManager 的定位就是把这些能力统一收口到一个本地网关和管理面板。

核心能力一览

模块	能力	适合解决的问题
账号池管理	账号授权、批量导入、标签、排序、状态识别、用量刷新、低配额和封禁筛选	管理多个 Codex / ChatGPT 账号
平台 Key	为客户端生成统一 API Key，支持模型、推理等级、服务等级、额度限制和路由策略	给 CLI 或第三方客户端一个稳定入口
本地网关	提供 OpenAI 兼容接口，兼容 /v1/responses、/v1/chat/completions、SSE、tools 等链路	统一承接 Codex CLI、Claude Code、Gemini CLI 等请求
聚合 API	管理第三方最小转发上游，支持认证参数、action path、余额检测、优先级和模型覆盖	接入中转站或作为账号池兜底
模型管理	维护结构化模型目录、自定义模型、远端并入、API 可见性、Codex 缓存同步	管理客户端可见模型和默认路由模型
日志与观测	查看请求日志、状态码、耗时、模型、平台 Key、路由结果和错误信息	快速定位请求失败和路由异常
插件中心	支持内置精选、企业私有、自定义源、插件任务、日志和 Rhai 接口	扩展自动化能力和私有生态
Service / Web	服务端常驻、本地网关、Web 控制台、Docker / 服务器部署	在服务器或 NAS 上长期运行

完整模块说明见 功能详解 和 功能地图。

典型使用场景

个人桌面用户

你可以在桌面端启动服务、导入账号、刷新用量，然后创建一个平台 Key 给 Codex CLI 或 Claude Code 使用。后续只需要维护 CodexManager 内的账号和模型配置，客户端侧保持一个稳定的 Base URL 和 API Key。

推荐阅读：

• 快速开始
• 桌面端使用指南
• 账号管理指南
• 平台密钥与本地网关

服务器 / NAS / Docker 用户

你可以用 Service 模式常驻运行，Web 控制台负责管理，网关端口负责转发请求。适合家用服务器、NAS、云服务器和团队内部部署。

推荐阅读：

• Service 模式与 Web 控制台
• 运行与部署指南
• 环境变量与运行配置说明
• 配置与运维

账号池 + 聚合 API 混合路由

你可以让平台 Key 优先走账号池，当账号不可用或额度不足时再使用聚合 API 兜底。这样既能保留账号池的成本和能力优势，也能提高请求可用性。

推荐阅读：

• 平台密钥与本地网关
• 聚合 API 指南
• 聚合 API 请求规则与配置说明
• FAQ 与账号命中规则

插件和二次开发

插件作者可以通过插件中心接入市场、任务、日志和 Rhai 能力。开发者可以参考内部接口总表、架构说明和构建发布文档。

推荐阅读：

• 插件中心指南
• 插件中心对接与接口清单
• 系统内部接口总表
• 开发者指南

请求链路概览

客户端 / CLI
    │
    │  Base URL + 平台 Key
    ▼
CodexManager 本地网关
    │
    ├─ 校验平台 Key、额度、绑定模型、推理等级、路由策略
    │
    ├─ 账号池路由
    │    ├─ 可用账号筛选
    │    ├─ 额度 / 状态 / 计划类型判断
    │    └─ Codex / ChatGPT 上游请求
    │
    └─ 聚合 API 路由
         ├─ 供应商优先级
         ├─ 自定义认证参数
         ├─ action path / 模型覆盖
         └─ 第三方上游请求

请求完成后，日志模块会记录请求状态、耗时、模型、平台 Key、路由结果和错误信息，方便后续排障。

页面与模块导览

页面	用途
仪表盘	查看服务状态、账号和平台 Key 概览
账号管理	添加账号、批量导入、导出、刷新用量、处理异常账号
平台 Key	创建客户端访问凭据、配置路由策略和额度
聚合 API	管理第三方上游和余额检测
模型管理	管理模型目录、API 可见性和 Codex 缓存同步
插件中心	安装插件、查看任务、接入私有插件源
日志	查看请求日志和错误上下文
设置	配置端口、监听地址、代理、超时、主题和更新

从哪里开始

你想做什么	推荐页面
第一次使用	快速开始
理解所有功能	功能详解
部署到服务器	运行与部署指南
配置环境变量	环境变量与运行配置说明
排查问题	排障中心
查内部接口	系统内部接口总表
构建或贡献	开发者指南

重要提醒

• 本项目仅用于学习与开发目的。
• 使用者必须遵守相关平台服务条款。
• 作者不提供或分发账号、API Key 或代理服务。
• 请勿使用本项目绕过平台速率限制或服务限制。

相关仓库

• GitHub 主仓库：https://github.com/qxcnm/Codex-Manager
• AtomGit 国内托管：https://atomgit.com/qxnm/Codex-Manager
• Gitee 仓库：https://gitee.com/hongshungao/Codex-Manager