CodexManager

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

English| GitHub 主仓库| 官网| 赞助商

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

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

认可社区

源码说明：

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

免责声明

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

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

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

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

赞助商

感谢以下朋友与伙伴对 CodexManager 的支持。 末端夏：感谢提供 token 支持。他的 GPT 卡网支持自助购买、自助兑换激活，稳定不到车，带质保，支持 Codex 5.4。官网：小末AI

Wonderdch、 Catch_Bat、 suxinwl、 Hermit、 Suifeng023、 HK-hub

☕ 支持项目 (Support)

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

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

Star History

首页导览

你要做什么	直接进入
首次启动、部署、Docker、macOS 放行	运行与部署指南
配置端口、代理、数据库、Web 密码、环境变量	环境变量与运行配置
排查账号不命中、导入失败、挑战拦截、请求异常	FAQ 与账号命中规则
排查后台任务账号跳过、禁用与停用原因	后台任务账号跳过说明
插件中心最小接入、快速对接	插件中心最小接入说明
对接插件中心、查看接口清单、市场模式与 Rhai 接口	插件中心对接与接口清单
系统全部可对接内部接口	系统内部接口总表
本地构建、打包、发版、脚本调用	构建发布与脚本说明

最近变更

• 当前最新版本：v0.1.17（2026-04-05，pre-release）
• 请求日志现在会同时区分“客户端显式服务等级”和“最终生效服务等级”，可以直接看出平台 Key 默认 Fast 是否真的在请求改写后生效，不会再把 auto 和最终上游行为混为一谈。
• 平台 Key 的普通协议类型已经收敛成“通配兼容 (Codex / Claude Code)”，默认按请求路径自动分流：/v1/messages* 走 Claude 语义，其它标准路径走 Codex / OpenAI 语义，不再需要为不同客户端重复维护两套 Key。
• 设置页新增“模型转发规则”，支持使用 pattern=target 做全局模型改写，例如 spark*=gpt-5.4-mini；如果平台 Key 自身绑定了固定模型，则平台 Key 绑定值优先。
• 账号页的“额度详情”悬浮卡位置也做了收口，浮层现在会按额度概览卡片的中线对齐，查看 5 小时 / 7 天 /专属额度时更贴近视觉锚点，不会再明显偏上。
• 这轮版本收口也已完成：workspace、前端包、Tauri 桌面端、锁文件、README 和 CHANGELOG 的版本说明已统一到 0.1.17。

过去几天的提交摘要

• a2c0e05：平台 Key 协议切换为按请求路径通配，并新增全局模型转发规则。
• 4389764：请求日志新增“最终生效服务等级”，区分客户端显式值与实际生效值。
• 83bdb96：补齐账号页与用量弹窗的全部额度展示，刷新后会把标准额度和附加额度一起回显。
• 41375a4：新增 /v1/responses WebSocket 请求支持，并补齐 transport-aware 请求日志链路。
• b762a65：修复 service_tier 日志口径，并为 HTTP / WS 增加客户端原始 service_tier 诊断事件。
• 7e7b76f：整理上一轮遗留的纯格式化改动，避免和功能提交混在一起。
• be73359：调整词元缩写显示保留两位小数，首页、日志和平台 Key 页的数字展示更稳定。
• dfb4494：合并 PR #86，集中修复 Anthropic SSE 工具调用参数在流式桥接中的兼容问题。
• 981bc6e：将 chat.completion 用量别名映射到 OpenAI prompt/completion tokens，减少统计口径不一致。
• 480f847：修复 completed 事件里空 edits 覆盖已流出的编辑参数问题。
• 7bbc5fc：修复 chat/completions SSE 在已有内容时未正确合并 completed 工具参数的问题。
• aa2c09c：在 Anthropic SSE 转换前先合并流式工具参数，避免完成态丢参。
• 29c3b6b：避免占位工具参数清空真实编辑载荷，继续补强流式工具调用稳定性。
• c1844b7：统一流式断连提示为“网络抖动”，减少用户误判。
• a89cd9c：保留上游原始错误文案并收敛日志提示，方便排查真实故障。
• 8d619a0：支持按选中导出账号，并优化用量刷新时的切号体验。

功能概览

• 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选
• 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
• 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review / Spark 等附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间
• 授权登录：浏览器授权 + 手动回调解析
• 平台 Key：生成、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 / Fast / Flex）
• 聚合 API：管理第三方最小转发上游，支持创建、编辑、测试连通性、供应商名称、顺序优先级，以及按 Codex / Claude 分类展示
• 插件中心：路由为 /plugins/，支持内置精选、企业私有、自定义源三种市场模式，并提供插件清单、任务、日志与 Rhai 对接接口
• 设置页：支持“系统推导”按钮、单账号并发上限，以及更保守的高并发退化策略
• 系统内部接口总表：列出当前桌面端与服务端所有可对接命令、RPC 方法、以及插件内建函数
• 本地服务：自动拉起、可自定义端口与监听地址
• 本地网关：为 CLI 和第三方工具提供统一 OpenAI 兼容入口

截图

快速开始

1. 启动桌面端，点击“启动服务”。
2. 进入“账号管理”，添加账号并完成授权。
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
• 如需调整数据库、代理、监听地址等运行配置，可继续查看 环境变量与运行配置。

页面展示

桌面端

• 账号管理：集中导入、导出、刷新账号与用量，支持低配额 / 封禁筛选与重置时间展示
• 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志
• 插件中心：/plugins/ 路由，内置精选 / 企业私有 / 自定义源市场切换，插件安装、启停、任务、日志、Rhai 对接
• 设置页：统一管理端口、监听地址、代理、主题、自动更新、后台行为

Service 版

• codexmanager-service：提供本地 OpenAI 兼容网关
• codexmanager-web：提供浏览器管理页面
• codexmanager-start：一键拉起 service + web

常用文档

• 版本历史：CHANGELOG.md
• 协作约定：CONTRIBUTING.md
• 架构说明：ARCHITECTURE.md
• 测试基线：TESTING.md
• 安全说明：SECURITY.md
• 文档索引：docs/README.md

专题页面

页面	内容
运行与部署指南	首次启动、Docker、Service 版、macOS 放行
环境变量与运行配置	应用配置、代理、监听地址、数据库、Web 安全
FAQ 与账号命中规则	账号命中、挑战拦截、导入导出、常见异常
后台任务账号跳过说明	后台任务过滤、禁用账号、workspace 停用原因
最小排障手册	快速定位服务启动、请求转发、模型刷新异常
插件中心对接与接口清单	插件中心路由、市场模式、Tauri/RPC 接口、清单字段、Rhai 内建函数
构建发布与脚本说明	本地构建、Tauri 打包、Release workflow、脚本参数
发布与产物说明	各平台发版产物、命名、是否 pre-release
脚本与发布职责对照	各脚本负责什么、什么场景该用哪个
协议兼容回归清单	/v1/chat/completions、/v1/responses、tools 回归项
当前网关与 Codex 请求头和参数差异表	当前网关参数传递、请求头和请求参数与 Codex 的对照说明
系统内部接口总表	桌面端、服务端、插件中心全部可对接内部接口
CHANGELOG.md	最新发版内容、未发版更新与完整版本历史

目录结构

.
├─ apps/                # 前端与 Tauri 桌面端
│  ├─ src/
│  ├─ src-tauri/
│  └─ dist/
├─ 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

联系方式

• 公众号：七线牛马

• 微信： ProsperGao

• 交流群：答案是项目名：CodexManager

  

• Telegram 群聊：CodexManager TG 群

CodexManager 快速上手指南

CodexManager 是一款本地桌面端与服务进程结合的 Codex 账号管理器及网关转发工具，支持统一管理账号池、用量监控、平台 Key 管理及本地 OpenAI 兼容网关能力。

1. 环境准备

系统要求

• Windows: Windows 10/11 (作者主要验证环境)
• macOS: macOS 10.15+ (需自行测试兼容性)
• Linux: 主流发行版 (需自行测试兼容性)
• 架构: x86_64 / ARM64

前置依赖

• 无需额外安装运行时环境（桌面端为独立打包应用）。
• 若使用 Docker 部署或源码构建，需安装：
  • Docker & Docker Compose
  • Node.js (前端构建)
  • Rust & Cargo (后端核心构建)

2. 安装步骤

方式一：下载桌面端（推荐）

1. 访问 GitHub Releases 页面。
2. 根据操作系统下载对应的安装包：
   • Windows: CodexManager_setup_x64.exe
   • macOS: CodexManager.dmg
   • Linux: CodexManager.AppImage 或 .deb/.rpm
3. 运行安装程序并完成安装。

方式二：Docker 部署 (Service 版)

适用于服务器环境，提供 Web 管理界面和 API 网关。

docker run -d \
  --name codexmanager \
  -p 3000:3000 \
  -v ./data:/app/data \
  -e WEB_PASSWORD=your_secure_password \
  ghcr.io/qxcnm/codexmanager:latest

注：具体镜像地址请以仓库最新 Release 说明为准，若无官方镜像可参考源码构建。

方式三：源码构建

git clone https://github.com/qxcnm/Codex-Manager.git
cd Codex-Manager

# 安装前端依赖
cd apps && npm install && npm run build

# 构建后端 (需 Rust 环境)
cd ../crates
cargo build --release

# 启动服务
./target/release/codexmanager-start

3. 基本使用

第一步：启动服务

1. 打开已安装的 CodexManager 桌面端。
2. 点击主界面的 “启动服务” 按钮。
   • 服务启动后，将在本地监听默认端口（通常为 http://127.0.0.1:3000）。
   • 此时本地网关已就绪，可作为 OpenAI 兼容接口供其他工具调用。

第二步：添加账号

1. 进入左侧菜单 “账号管理”。
2. 点击 “添加账号”，选择浏览器授权或手动输入凭证。
3. 授权流程：
   • 点击授权后会自动唤起浏览器登录。
   • 登录成功后复制回调链接，粘贴回桌面端的输入框中完成解析。
   • 若自动回调失败，请手动粘贴浏览器地址栏的完整回调 URL。

第三步：配置与验证

1. 在账号列表中点击 “刷新用量”，确认账号状态、额度剩余及重置时间。
2. 进入 “平台 Key" 页面，生成或绑定 API Key，设置推理等级（Fast/Flex）及模型绑定规则。
3. 调用测试： 使用任意支持 OpenAI 协议的客户端（如 curl、Postman 或 CLI 工具），请求本地网关：

curl http://127.0.0.1:3000/v1/chat/completions \
  -H "Authorization: Bearer YOUR_PLATFORM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

第四步：高级配置（可选）

• 插件中心：访问 /plugins/ 路由，安装精选插件或对接私有市场。
• 环境变量：如需修改监听地址、数据库路径或代理设置，请参考 环境变量与运行配置说明。

---

提示：默认数据文件存储在系统应用数据目录下（如 Windows 的 %APPDATA%），如需备份请查找 codexmanager.db 文件。