CodexManager

本地桌面端 + 服务进程的 Codex 账号管理器+网关转发

English · Русский · 한국어

官网 · 赞助商

本地桌面端 + 服务进程的 Codex 账号池管理器

统一管理账号、用量与平台 Key，并提供本地网关能力。

认可社区

源码说明：

本产品完全由本人指挥+AI打造 Codex（98%） Gemini (2%) 如果在使用过程中产生问题请友好交流，因为开源只是觉得有人能用的上，基本功能也没什么问题，不喜勿喷。 其次是本人没有足够的环境来验证每个包都有没有问题，本人也要上班(我只是个穷逼买不起mac之类的)，本人只保证win的桌面端的可用性，如果其他端有问题，请在充分测试后提交 Issues，有时间我自会处理 最后感谢各位使用者反馈的各个平台问题和参与的部分测试。

免责声明

• 本项目仅用于学习与开发目的。

• 使用者必须遵守相关平台的服务条款（例如 OpenAI、Anthropic）。

• 作者不提供或分发任何账号、API Key 或代理服务，也不对本软件的具体使用方式负责。

• 请勿使用本项目绕过速率限制或服务限制。

赞助商

本项目现开放赞助合作，价格可谈。赞助方可在 README 及项目内的赞助展示区域展示品牌 Logo、简介及官方链接；具体文案、展示位置、展示周期与上线时间由双方协商确认。为保持项目调性与用户体验，合作内容需与开发者或 AI 工具生态相关，并符合相关法律法规。

** 合作洽谈：** 可通过微信、Telegram 或邮箱 18272669457@163.com 联系，添加好友时请备注“赞助合作”。

感谢以下朋友与伙伴对 CodexManager 的支持。

	FennoAI 面向企业研发团队和开发者提供高稳定、高性能的 API 中转服务，兼容 OpenAI 与 Anthropic 协议，可无缝接入 Codex、Claude Code、OpenCode 等主流 AI 编程工具。平台具备企业级稳定性，可支撑千亿 Token/日的调用规模，并支持境内外主体公对公结算及开票。Codex-Manager 用户通过专属链接购买订阅，仅需 1.99 美元即可获得价值 50 美元的 Coding Plan 额度；邀请好友购买最高可获得 20% 返佣，邀请越多，奖励越高。
	七牛云 AI 是七牛云（02567.HK）旗下企业级大模型 MaaS 平台，一站式调用全球 150+ 主流模型，兼容全球主流模型厂商协议，覆盖文本、图像、音频、视频、文件处理等全模态处理能力，服务超过 169 万企业及开发者用户。七牛云 AI 为 Codex-Manager 用户提供专属福利：通过专属链接注册，企业用户免费领取 1200 万 Token，开发者免费领取 300 万 Token。
	AIXiamo 官网｜国内 ChatGPT Plus / Pro 本人账号正规充值 Codex 额度不够，Plus 还是 Pro？ 日常使用和普通 Codex 选 Plus；经常触顶或高频长任务，再比较 Pro 5x / 20x。 支持支付宝、无需海外银行卡；不索取密码、验证码或恢复码，订单可查、中文售后，充值不成功经核验后全额退款。持续运营三年多，线上线下累计服务数万名用户；另有 Claude Pro / Max、Gemini（Google AI Pro）、Grok / SuperGrok 等主流 AI 会员。 欢迎企业采购对接；已完成订单支持申请开具发票，请先联系售后确认。
	星思研中转站 为 Claude Code、Codex 等模型调用场景提供稳定中转与配套服务，适合需要高可用接口、便捷接入和持续交付支持的开发者与团队。可前往官网了解最新方案。

其他支持者：呆头呆脑、 Wonderdch、suxinwl、Hermit、Suifeng023、HK-hub

☕ 支持项目 (Support)

如果您觉得本项目对您有所帮助，欢迎打赏作者！

支付宝 (Alipay)	微信支付 (WeChat)

Star History

首页导览

你要做什么	直接进入
首次启动、部署、Docker、macOS 放行	运行与部署指南
配置 Codex CLI / ccswitch 接入、auth.json 与 config.toml	运行与部署指南
不登陆 Codex，使用 ChatGPT /api/auth/session 导入账号	不登陆 Codex 使用 ChatGPT 的 /api/auth/session 在软件中的使用
配置端口、代理、数据库、Web 密码、环境变量	环境变量与运行配置
排查账号不命中、导入失败、挑战拦截、请求异常	FAQ 与账号命中规则
排查后台任务账号跳过、禁用与停用原因	后台任务账号跳过说明
管理官方/受管模型目录、价格、路由与 instructions policy	模型目录 V2 管理与计费说明
接入 DeepSeek 等标准 Responses API 供应商	聚合 API 请求规则与配置说明
使用固定 ChatGPT Plus 商品池、定时同步、验证与提醒	商品池维护说明
按账号或聚合 API 筛选仪表盘统计	仪表盘来源筛选与资源状态说明
插件中心最小接入、快速对接	插件中心最小接入说明
对接插件中心、查看接口清单、市场模式与 Rhai 接口	插件中心对接与接口清单
系统全部可对接内部接口	系统内部接口总表
本地构建、打包、发版、脚本调用	构建发布与脚本说明

功能概览

• 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选
• 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
• 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review / Spark 等官方附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间
• 授权登录：支持 chatgpt.com 浏览器授权与 Device Code 登录；浏览器授权仍可手动粘贴回调地址完成解析
• 平台 Key：随机生成或自定义固定 Key、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 / Fast / Flex）；可绑定自定义账号分组，并与账号计划筛选取交集后仅在授权池内轮转
• 模型管理：纯账号池遵循 OpenAI 官方 Codex 目录；聚合 API 与两种混合策略使用 CodexManager 受管 V2 目录，支持 builtin/custom、价格、route、instructions policy、本地 JSON 导入，以及可独立更新的供应商模型档案和一键导入
• 聚合 API：管理第三方最小转发上游，支持创建、编辑、余额、V2 route 连通性测试，以及标准 Responses API 兼容档案、声明式字段规则、静态请求头和按需 /models 发现缓存
• 商品池：固定同步 PriceAI 的 ChatGPT Plus 试用订阅；支持手动全量同步、按多标签定时同步、独立的 PriceAI/本地验证状态、提醒与变化记录，以及商家收藏筛选
• 仪表盘来源筛选：支持今日、账号池/聚合 API 类型和具体来源任意多选；Token、请求、费用、趋势、模型统计与账号池剩余使用同一口径
• 插件中心：路由为 /plugins/，支持内置精选、企业私有、自定义源三种市场模式，并提供插件清单、任务、日志与 Rhai 对接接口
• Skills 与插件：/skills/ 按“Skills 安装 / Codex 插件安装”分栏。Skills 安装提供内置及自定义 GitHub 技能仓库、仓库刷新与单 Skill 安装、skills.sh 搜索安装、ZIP / 目录导入和已安装管理；Codex 插件安装保留原生 Marketplace 的完整插件安装流程，.system 内置 Skill 始终只读
• 项目启动（桌面端）：收藏本机项目目录；Windows / macOS 通过 ChatGPT Codex App 打开对应工作区，“会话”继续使用本机 CodexManager profile 在新终端中打开 resume 选择器
• 设置页：支持“系统推导”按钮、单账号并发上限、上游代理、请求总超时、流式空闲超时、SSE 保活开关与间隔，以及更保守的高并发退化策略；SSE 保活默认开启，可通过 CODEXMANAGER_SSE_KEEPALIVE_ENABLED=0（或 false）关闭；实验性上游 WebSocket 可通过 CODEXMANAGER_USE_WEBSOCKET_UPSTREAM=1 开启，默认关闭
• 系统内部接口总表：列出当前桌面端与服务端所有可对接命令、RPC 方法、以及插件内建函数
• 本地服务：自动拉起、可自定义端口与监听地址
• 本地网关：为 Codex CLI、Gemini CLI、Claude Code 和第三方工具提供统一 OpenAI 兼容入口；Gemini 请求可转发到 /v1/responses，并兼容 SSE、tools、MCP、skill、请求总超时与流式空闲超时等调用链路
• 图片生成：/v1/responses 不自动注入图片工具，仍会透传客户端显式提供的官方 Codex image_generation tool；同时支持 /v1/images/generations 与 /v1/images/edits 兼容入口，默认图片工具模型为 gpt-image-2

生态搭配

OpenCowork

• 仓库地址：AIDotNet/OpenCowork
• 搭配方式：使用 OpenCowork 承接本地文件操作、多 Agent 协作、消息平台接入与桌面执行能力，再由 CodexManager 统一管理 Codex 账号、用量、平台 Key 与本地网关入口。
• 适合场景：当您希望把“执行工作台 / 办公协同”和“账号池管理 / 网关入口”拆开时，这两个项目可以形成互补组合。
• 推荐理解：OpenCowork 更偏执行与落地，CodexManager 更偏管理与网关。

截图

快速开始

1. 启动桌面端，点击“启动服务”。
2. 进入“账号管理”，选择浏览器授权或 Device Code 完成 chatgpt.com 登录。
3. 浏览器授权如回调失败，可粘贴回调链接手动完成解析。
4. 刷新用量并确认账号状态。

默认数据目录

• 桌面端默认会把 SQLite 数据库写到应用数据目录下，文件名固定为 codexmanager.db。
• Windows：%APPDATA%\\com.codexmanager.desktop\\codexmanager.db
• macOS：~/Library/Application Support/com.codexmanager.desktop/codexmanager.db
• Linux：~/.local/share/com.codexmanager.desktop/codexmanager.db
• 桌面端每次升级首次初始化数据库前，会在数据库同目录保留 codexmanager.db.pre-<版本>.bak 快照；同一版本失败重试时不会覆盖该备份。
• 设置页“桌面诊断”可启用 Debug 模式、关闭普通桌面文件日志并打开日志目录。普通运行日志限制为 512 KB 并自动覆盖；请求日志与 Token / 费用统计不受这个开关影响。
• 如果界面无法启动，可使用 CodexManager.exe --debug（macOS / Linux 为 CodexManager --debug）临时启用详细日志。启动失败会弹出具体原因，并将 startup-error.log 写入弹窗所示的日志目录。
• 如需调整数据库、代理、监听地址等运行配置，可继续查看 环境变量与运行配置。
• Docker 镜像默认使用 TZ=Asia/Shanghai；compose 示例会优先沿用部署环境里的 TZ，没有设置时回退到 Asia/Shanghai，其他地区部署时请改成对应 IANA 时区。

页面展示

桌面端

• 账号管理：集中导入、导出、刷新账号与用量，支持低配额 / 封禁筛选与重置时间展示
• 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志
• 模型管理：桌面端和 Web 端都不会写入或下载 ~/.codex/models_cache.json；账号直连和纯账号池轮转跟随 Codex 官方目录，聚合 API 与混合轮转使用 CodexManager 受管目录
• 商品池：独立 /marketplace/ 页面只保存商品报价与链接，不保存账号密码；关闭主窗口后仍随托盘服务定时同步，只有退出程序才停止
• 插件中心：/plugins/ 路由，内置精选 / 企业私有 / 自定义源市场切换，插件安装、启停、任务、日志、Rhai 对接
• Skills 与插件：/skills/ 路由以独立 Tab 管理 Skills 安装和 Codex 插件安装；Skills 可从内置/自定义 GitHub 仓库或 skills.sh 搜索后单独安装，也支持 ZIP、目录导入和安全卸载；Codex 原生 Marketplace 继续负责完整插件安装，系统 Skill 只读
• 项目启动：桌面端收藏本机目录；Windows / macOS 直接在 ChatGPT Codex App 中打开对应工作区，“会话”通过本机 CLI 继续项目；Web / Docker 不访问设备目录
• 设置页：统一管理端口、监听地址、代理、请求超时、SSE 保活、主题、自动更新、后台行为

Service 版

• codexmanager-service：提供本地 OpenAI 兼容网关
• codexmanager-web：提供浏览器管理页面，并承载 /api/runtime 与 /api/rpc 代理
• codexmanager-start：一键拉起 service + web

常用文档

• 版本历史：CHANGELOG.md
• 协作约定：CONTRIBUTING.md
• 架构说明：ARCHITECTURE.md
• 测试基线：TESTING.md
• 安全说明：SECURITY.md
• 模型目录 V2：模型目录 V2 管理与计费说明
• 文档索引：docs/zh-CN/README.md

专题页面

页面	内容
运行与部署指南	首次启动、Docker、Service 版、macOS 放行
环境变量与运行配置	应用配置、代理、监听地址、数据库、Web 安全
FAQ 与账号命中规则	账号命中、挑战拦截、导入导出、常见异常
不登陆 Codex 使用 ChatGPT 的 /api/auth/session 在软件中的使用	浏览器复制 ChatGPT session JSON 后，通过批量导入加入账号池
后台任务账号跳过说明	后台任务过滤、禁用账号、workspace 停用原因
商品池维护说明	固定 Plus 商品池、PriceAI 状态、本地验证、同步、提醒与收藏商家
仪表盘来源筛选与资源状态说明	账号/聚合 API 状态、页面顺序、来源筛选和账号池剩余口径
最小排障手册	快速定位服务启动、请求转发、模型刷新异常
插件中心对接与接口清单	插件中心路由、市场模式、Tauri/RPC 接口、清单字段、Rhai 内建函数
构建发布与脚本说明	本地构建、Tauri 打包、Release workflow、脚本参数
发布与产物说明	各平台发版产物、命名、是否 pre-release
脚本与发布职责对照	各脚本负责什么、什么场景该用哪个
当前网关与 Codex 请求头和参数差异表	当前网关参数传递、请求头和请求参数与 Codex 的对照说明
系统内部接口总表	桌面端、服务端、插件中心全部可对接内部接口
CHANGELOG.md	最新发版内容、未发版更新与完整版本历史

目录结构

.
├─ apps/                # 前端与 Tauri 桌面端
│  ├─ src/
│  ├─ src-tauri/
│  └─ out/
├─ crates/              # Rust core/service
│  ├─ core
│  ├─ service
│  ├─ start              # Service 版本一键启动器（拉起 service + web）
│  └─ web                # Service 版本 Web UI（可内嵌静态资源 + /api/rpc 代理）
├─ docs/                # 正式文档目录
├─ scripts/             # 构建与发布脚本
└─ README.md

鸣谢与参考项目

• Codex（OpenAI）：本项目在请求链路、登录语义与上游兼容行为上参考了该项目的实现与源码结构 https://github.com/openai/codex
• CLIProxyAPI（CPA）：本项目在请求链路（Responses 请求转换与工具调用约定）参考其实现与约定 https://github.com/router-for-me/CLIProxyAPI

联系方式

• 公众号：七线牛马
• 微信：加微信群请加我微信 ProsperGao，并说明来意
• Telegram 群聊：CodexManager TG 群