Skip to content
BranchesTags

Repository files navigation

CodexManager — 本地桌面端与服务进程的 Codex 账号池管理器
官网 · 赞助商 		中文
English
Русский
한국어 		GitHub Stars
AtomGit Stars
Gitee Stars 		认可社区  LINUX DO   旋武社区

CodexManager 已加入 旋武社区，这是由开放原子开源基金会孵化运营的 Rust 技术社区。

源码说明
本产品完全由本人指挥+AI打造 Codex（98%） Gemini (2%) 如果在使用过程中产生问题请友好交流，因为开源只是觉得有人能用的上，基本功能也没什么问题，不喜勿喷。其次是本人没有足够的环境来验证每个包都有没有问题，本人也要上班(我只是个穷逼买不起mac之类的)，本人只保证win的桌面端的可用性，如果其他端有问题，请在充分测试后提交 Issues，有时间我自会处理。最后感谢各位使用者反馈的各个平台问题和参与的部分测试。 		免责声明
本项目仅用于学习与开发目的；使用者必须遵守相关平台的服务条款（例如 OpenAI、Anthropic）；作者不提供或分发任何账号、API Key 或代理服务，也不对本软件的具体使用方式负责；请勿使用本项目绕过速率限制或服务限制。

赞助商

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

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

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

PatewayAI 官方高质量模型 API 中继服务

感谢 PatewayAI 对本项目的赞助！

PatewayAI 专注于官方高质量模型 API 中继，完整支持 Claude、Codex 系列，并提供透明计费与企业级服务。

经济模式低至 0.5 折！通过此链接注册可获试用额度，还可参与不定时活动领取免费额度，双向推荐奖励最高达 150 美元。

VMCard VMCard 企业级虚拟卡发卡平台，面向 AI 账号平台、AI API 服务商及规模化订阅团队，提供专属美国 Visa 卡段、API 批量发卡及企业级用卡管理。
全网最低结算汇率，满足企业长期、规模化支付需求。商务合作：@Vmcardio_yuki
88API 88API 全模型聚合平台
🧠 聚合 GPT、Claude、Gemini、Grok、DeepSeek、Kimi、GLM 等语言与编程模型；
🎨 图片模型：GPT-Image、Gemini、Grok 等；
🎬 视频模型：Seedance、Veo、MiniMax Hailuo H3、Kling、Grok 等；
🎙️ 语音能力：Whisper、TTS 等。从文案、出图、改图，到视频生成与配音。
🎁 新用户注册送体验额度，可以检测模型能力。站内有人工客服值守！
👉 海外企业资质运营，稳定不跑路，提供正规发票，充值比例 1:1。
FennoAI FennoAI 面向企业研发团队和开发者提供高稳定、高性能的 API 中转服务，兼容 OpenAI 与 Anthropic 协议，可无缝接入 Codex、Claude Code、OpenCode 等主流 AI 编程工具。平台具备企业级稳定性，可支撑千亿 Token/日的调用规模，并支持境内外主体公对公结算及开票。Codex-Manager 用户通过专属链接购买订阅，仅需 1.99 美元即可获得价值 50 美元的 Coding Plan 额度；邀请好友购买最高可获得 20% 返佣，邀请越多，奖励越高。
七牛云 AI 七牛云 AI 是七牛云（02567.HK）旗下企业级大模型 MaaS 平台，一站式调用全球 150+ 主流模型，兼容全球主流模型厂商协议，覆盖文本、图像、音频、视频、文件处理等全模态处理能力，服务超过 169 万企业及开发者用户。七牛云 AI 为 Codex-Manager 用户提供专属福利：通过专属链接注册，企业用户免费领取 1200 万 Token，开发者免费领取 300 万 Token。
AI夏末 AIXiamo AIXiamo 官网｜国内 ChatGPT Plus / Pro 本人账号正规充值
Codex 额度不够，Plus 还是 Pro？ 日常使用和普通 Codex 选 Plus；经常触顶或高频长任务，再比较 Pro 5x / 20x。
赞助方教程：2026 ChatGPT Plus / Pro 国内充值与套餐选择完整指南
支持支付宝、无需海外银行卡；不索取密码、验证码或恢复码，订单可查、中文售后，充值不成功经核验后全额退款。持续运营三年多，线上线下累计服务数万名用户；另有 Claude Pro / Max、Gemini（Google AI Pro）、Grok / SuperGrok 等主流 AI 会员。
欢迎企业采购对接；已完成订单支持申请开具发票，请先联系售后确认。
星思研中转站 星思研中转站 为 Claude Code、Codex 等模型调用场景提供稳定中转与配套服务，适合需要高可用接口、便捷接入和持续交付支持的开发者与团队。可前往官网了解最新方案。

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

☕ 支持项目 (Support)

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

支付宝 (Alipay) 微信支付 (WeChat)
支付宝赞助码 微信赞助码

Star History

Codex Manager Star History Chart

首页导览

你要做什么 直接进入
首次启动、部署、Docker、macOS 放行 运行与部署指南
配置 Codex CLI / ccswitch 接入、auth.json 与 config.toml 运行与部署指南
不登陆 Codex，使用 ChatGPT /api/auth/session 导入账号 不登陆 Codex 使用 ChatGPT 的 /api/auth/session 在软件中的使用
配置端口、代理、数据库、Web 密码、环境变量 环境变量与运行配置
排查账号不命中、导入失败、挑战拦截、请求异常 FAQ 与账号命中规则
排查后台任务账号跳过、禁用与停用原因 后台任务账号跳过说明
管理模型、价格、路由、instructions policy 与本地缓存导出 模型目录 V2 管理与计费说明
插件中心最小接入、快速对接 插件中心最小接入说明
对接插件中心、查看接口清单、市场模式与 Rhai 接口 插件中心对接与接口清单
系统全部可对接内部接口 系统内部接口总表
本地构建、打包、发版、脚本调用 构建发布与脚本说明

功能概览

  • 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选
  • 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
  • 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review / Spark 等官方附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间
  • 授权登录：支持 chatgpt.com 浏览器授权与 Device Code 登录；浏览器授权仍可手动粘贴回调地址完成解析
  • 平台 Key：随机生成或自定义固定 Key、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 / Standard / Fast / Ultrafast / Flex）；可绑定自定义账号分组，并与账号计划筛选取交集后仅在授权池内轮转
  • 模型管理：模型目录 V2 是唯一运行时真相源；支持 builtin/custom、整数三价与长上下文阶梯价、账号池/聚合 API route、instructions policy、本地 JSON preview/commit，以及桌面/Web 主动导出 Codex 缓存
  • 聚合 API：管理第三方最小转发上游，支持创建、编辑、余额和基于已配置 V2 route 的连通性测试；不会自动发现供应商模型，管理员可主动拉取并选择性关联到模型目录 V2，不维护旧供应商模型池
  • 插件中心：路由为 /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、请求总超时与流式空闲超时等调用链路
  • 图片生成：默认按官方 Codex 行为为 /v1/responses 自动注入 image_generation tool，并支持显式 tool 透传、/v1/images/generations 与 /v1/images/edits 兼容入口，默认图片工具模型为 gpt-image-2

截图

仪表盘 账号管理 平台 Key 聚合 API 插件中心 日志视图 设置页

快速开始

  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 官方目录，本地网关使用 CodexManager 管理目录下独立生成的 catalog
  • 插件中心：/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

常用文档

专题页面

页面 内容
运行与部署指南 首次启动、Docker、Service 版、macOS 放行
环境变量与运行配置 应用配置、代理、监听地址、数据库、Web 安全
FAQ 与账号命中规则 账号命中、挑战拦截、导入导出、常见异常
不登陆 Codex 使用 ChatGPT 的 /api/auth/session 在软件中的使用 浏览器复制 ChatGPT session JSON 后，通过批量导入加入账号池
后台任务账号跳过说明 后台任务过滤、禁用账号、workspace 停用原因
最小排障手册 快速定位服务启动、请求转发、模型刷新异常
插件中心对接与接口清单 插件中心路由、市场模式、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

鸣谢与参考项目

联系方式

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

About

一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。

Resources

Readme
MIT license

Contributing

Contributing

Security policy

Security policy
Activity

Stars

3.0k stars

Watchers

9 watching

Forks

400 forks
Report repository

Releases

Packages

Used by

Contributors

Languages