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

赞助商

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

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

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

感谢 PatewayAI 对本项目的赞助！

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

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

---

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

☕ 支持项目 (Support)

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

Star History

首页导览

功能概览

• 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选
• 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
• 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review / Spark 等官方附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间
• 额度重置自动唤醒：默认在已耗尽的 5 小时额度到达重置时间后发送简短预热消息，支持按账号或批量开启、关闭，减少等待下一轮额度刷新的时间。
• 授权登录：支持 chatgpt.com 浏览器授权与 Device Code 登录；浏览器授权仍可手动粘贴回调地址完成解析
• 平台 Key：随机生成或自定义固定 Key、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 / Standard / Fast / Ultrafast / Flex）；可绑定自定义账号分组，并与账号计划筛选取交集后仅在授权池内轮转
• 模型管理：模型目录 V2 是唯一运行时真相源；支持 builtin/custom、整数三价与长上下文阶梯价、账号池/聚合 API route、instructions policy、本地 JSON preview/commit，以及勾选模型后应用到 Codex 的 model_catalog_json
• 当前 builtin 目录共 12 条记录：gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-6-luna、GPT-5.6 三款模型、gpt-5.5、gpt-image-2 和两个 Image 2.5 变体共 11 款模型默认可见；只有 codex-auto-review 默认隐藏
• gpt-5.4 与 gpt-5.4-mini 已于 2026-08-31 从 ChatGPT 登录的 Codex 退役，gpt-5.2 也已在该登录方式下 deprecated；通用 API 模型不受此清理影响。revision 9 会清理未定制的对应 builtin；带有用户编辑、价格阶梯、路由或权限关联的数据会转为 custom 保留，需要 API Key 继续使用时也可显式添加同名 custom 模型
• 聚合 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 兼容入口；Images API 兼容入口默认主模型为 gpt-6-luna，默认图片工具模型仍为 gpt-image-2，并可显式选择两个 Image 2.5 变体

截图

快速开始

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 写入弹窗所示的日志目录。
• 如需调整数据库、代理、监听地址等运行配置，可继续查看 环境变量与运行配置。
• Service 可选 SeaORM MySQL/PostgreSQL 后端，需编译对应驱动；旧 SQLite 可只读导出并事务导入空目标库，详见 数据库切换与离线导入。本地隔离数据库验收不代表生产验收，当前范围见 迁移实证记录。
• Docker 镜像默认使用 TZ=Asia/Shanghai；compose 示例会优先沿用部署环境里的 TZ，没有设置时回退到 Asia/Shanghai，其他地区部署时请改成对应 IANA 时区。

页面展示

桌面端

• 账号管理：集中导入、导出、刷新账号与用量，支持低配额 / 封禁筛选与重置时间展示
• 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志
• Codex 接入方式：支持 OpenAI 账号直连、可安全映射到 Responses 的聚合 API 直连，以及通过 CodexManager 本地网关接入；直连聚合 API 不经过本地网关，因此不会写入网关请求日志
• 模型管理：桌面端和 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 保活、主题、自动更新、后台行为
• 基础设置中的“移除 requires_openai_auth”默认开启，保持托管网关的图片/actor 扩展认证行为。关闭后仅在切换到网关、重复应用或启动同步时保留 cm provider 已有的值，不会恢复此前删除的字段；保留 true 可能禁用 Codex 图片扩展。此设置不影响直连聚合 API，也不改写其他 provider。

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

专题页面

目录结构

.
├─ 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 群