Skip to content

iliumangtu/Codex-Manager

BranchesTags
 
 

Repository files navigation

CodexManager Logo

CodexManager

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

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

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

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

认可社区

LINUX DO

源码说明：

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

免责声明

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

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

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

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

赞助商

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

末端夏：感谢提供 token 支持。他的 GPT 卡网支持自助购买、自助兑换激活，稳定不到车，带质保，支持 Codex 5.4。官网：[https://www.aixiamo.com/](https://www.aixiamo.com/)

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

☕ 支持项目 (Support)

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

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

Star History

Star History Chart

首页导览

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

最近变更

  • 当前最新版本：v0.1.14（2026-03-30）
  • 这一版主要围绕“更稳的服务”和“更好接入”两条线收口：入口层新增短队列等待 + 超载快速退化，设置页新增“系统推导”和“单账号并发上限”，在任何机器上都能先排队、再退化，不会轻易把进程拖死。
  • 插件中心和接入文档继续补全：README 增加了插件中心预览图，插件中心最小接入说明、完整接口清单、系统内部接口总表都已补齐，外部对接更容易。
  • 长期保留文档统一去掉了日期前缀，README 和 docs 的链接也一起切到了稳定文件名，后续维护更容易。
  • 定时脚本入口已经挂到账号页，默认每分钟执行一次，用户仍然可以自行调整；同时补了系统内部接口总表，方便宿主和插件对接。
  • 这轮版本收口也已完成：workspace、前端包、Tauri 桌面端、校验脚本和 README 的版本说明已统一到 0.1.14。

近期提交摘要

  • 8c9299f：发布版本提升到 0.1.14，workspace、前端包、Tauri 桌面端与发布校验脚本统一对齐。
  • 85022b9：完善高并发保护与文档。入口层改为短队列等待 + 超载快速退化，设置页新增系统推导和单账号并发上限。
  • a6a96d6：README 增加插件中心预览图。中英文 README 的截图预览区都补上了 plugin.png。
  • ec03f2c：去除长期文档日期前缀。长期保留的文档已统一去掉时间戳文件名，并同步修正多个 README 引用。
  • 927142a：调整定时脚本默认间隔。定时脚本默认改为每分钟执行，用户仍可手动自定义。
  • 028c8c8：增加定时脚本入口和内部接口总表。账号页新增定时脚本入口，文档补齐系统内部接口清单。
  • 885edd0：完善插件中心文档与接入说明。插件中心最小接入说明与完整接口清单已补齐。

功能概览

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

截图

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

快速开始

  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

常用文档

专题页面

页面 内容
运行与部署指南 首次启动、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 群

About

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

Resources

Readme
License

Contributing

Contributing

Security policy

Security policy
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages