Codex-Manager:多账号池管理与本地网关转发工具
项目简介
Codex-Manager 是一个专为 Codex CLI 设计的账号管理与切换工具,提供本地网关转发能力。它解决了开发者在使用多个 AI 账号时的痛点:统一管理账号、用量监控、平台 Key 绑定,以及为各种 CLI 工具提供统一的 OpenAI 兼容入口。
项目地址:https://github.com/qxcnm/Codex-Manager
官网:https://qxnm.top
核心功能
1. 账号池管理
- 批量导入/导出:支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
- 分组与标签:对账号进行分组管理,添加标签和备注
- 封禁识别:自动识别封禁账号并筛选
- 用量展示:支持标准 5 小时 +7 日窗口,显示各额度的剩余百分比与重置时间
2. 平台 Key 管理
- 生成、禁用、删除平台 Key
- 模型绑定、推理等级、服务等级配置(跟随请求/Fast/Flex)
- 调用日志查看
3. 本地网关服务
Codex-Manager 的核心价值在于提供本地网关能力:
- 统一入口:为 Codex CLI、Gemini CLI、Claude Code 和第三方工具提供统一的 OpenAI 兼容 API 入口
- Gemini 转发:Gemini 请求可转发到
/v1/responses,兼容 SSE、tools、MCP、skill 等调用链路 - 自动服务:本地服务自动拉起,可自定义端口与监听地址
4. 插件中心
- 路由为
/plugins/ - 支持内置精选、企业私有、自定义源三种市场模式
- 提供插件清单、任务、日志与 Rhai 对接接口
5. 模型管理
- 维护结构化模型目录
- 远端并入、自定义模型
- visibility / supportedInApi 管理
- 桌面端 Codex 缓存同步 / Web 端缓存缓存导出
架构设计
├─ apps/ # 前端与 Tauri 桌面端 │ ├─ src/ │ ├─ src-tauri/ │ └─ dist/ ├─ crates/ # Rust core/service │ ├─ core │ ├─ service │ ├─ start # Service 版本一键启动器 │ └─ web # Service 版本 Web UI ├─ docs/ # 正式文档目录 ├─ scripts/ # 构建与发布脚本 └─ README.md
项目采用 Tauri + Rust 技术栈,包含三个核心组件:
- codexmanager-service:提供本地 OpenAI 兼容网关
- codexmanager-web:提供浏览器管理页面
- codexmanager-start:一键拉起 service + web
快速开始
安装与启动
- 从 GitHub Releases 下载对应平台的安装包
- 安装并启动桌面端
- 点击”启动服务”
- 进入”账号管理”,添加账号并完成授权
数据库位置
SQLite 数据库默认存储在应用数据目录下:
- Windows:
%APPDATA%\com.codexmanager.desktop\codexmanager.db - macOS:
~/Library/Application Support/com.codexmanager.desktop/codexmanager.db - Linux:
~/.local/share/com.codexmanager.desktop/codexmanager.db
配置说明
如需调整数据库、代理、监听地址等运行配置,可通过环境变量进行设置。详细配置参考 环境变量与运行配置文档。
典型使用场景
场景 1:多账号轮换
当你有多个 OpenAI 账号需要轮流使用时:
- 批量导入所有账号
- 设置账号优先级和分组
- 配置轮换策略
- CLI 工具通过本地网关访问,自动轮换账号
场景 2:用量监控
实时查看各账号的用量情况:
- 剩余百分比
- 重置时间
- 5 小时窗口和 7 日窗口的用量统计
场景 3:统一 API 入口
为多个 AI CLI 工具提供统一入口:
# 配置 Codex CLI 使用本地网关 export OPENAI_BASE_URL=http://localhost:8080/v1 # 配置 Gemini CLI 使用本地网关 export GEMINI_API_URL=http://localhost:8080/v1/responses # 配置 Claude Code 使用本地网关 export ANTHROPIC_BASE_URL=http://localhost:8080/v1
与 OpenCowork 的组合使用
Codex-Manager 推荐与 OpenCowork 搭配使用:
- OpenCowork:承接本地文件操作、多 Agent 协作、消息平台接入与桌面执行能力
- CodexManager:统一管理 Codex 账号、用量、平台 Key 与本地网关入口
两者形成互补组合,适合希望将”执行工作台/办公协同”和”账号池管理/网关入口”拆分的场景。
注意事项
- 本项目仅用于学习与开发目的
- 使用者必须遵守相关平台的服务条款(OpenAI、Anthropic 等)
- 作者不提供或分发任何账号、API Key 或代理服务
- 请勿使用本项目绕过速率限制或服务限制
社区与支持
- LinuxDo 讨论帖:https://linux.do/t/topic/1688401
- Telegram 群:https://t.me/+OdpFa9GvjxhjMDhl
- 微信公众号:七线牛马
总结
Codex-Manager 是一个功能完整的 AI 账号管理工具,特别适合需要管理多个 AI 账号的开发者团队。它的本地网关能力让各种 AI CLI 工具可以统一接入,用量监控和账号轮换功能则有效提升了账号使用效率。
如果你正在寻找一个可靠的 Codex 账号管理方案,Codex-Manager 值得尝试。