2026年4月14日 1 分钟阅读

Codex-Manager:多账号池管理与本地网关转发工具

tinyash 0 条评论

项目简介

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 技术栈,包含三个核心组件:

  1. codexmanager-service:提供本地 OpenAI 兼容网关
  2. codexmanager-web:提供浏览器管理页面
  3. codexmanager-start:一键拉起 service + web

快速开始

安装与启动

  1. GitHub Releases 下载对应平台的安装包
  2. 安装并启动桌面端
  3. 点击”启动服务”
  4. 进入”账号管理”,添加账号并完成授权

数据库位置

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 账号需要轮流使用时:

  1. 批量导入所有账号
  2. 设置账号优先级和分组
  3. 配置轮换策略
  4. 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 或代理服务
  • 请勿使用本项目绕过速率限制或服务限制

社区与支持

总结

Codex-Manager 是一个功能完整的 AI 账号管理工具,特别适合需要管理多个 AI 账号的开发者团队。它的本地网关能力让各种 AI CLI 工具可以统一接入,用量监控和账号轮换功能则有效提升了账号使用效率。

如果你正在寻找一个可靠的 Codex 账号管理方案,Codex-Manager 值得尝试。

发表评论

你的邮箱地址不会被公开,带 * 的为必填项。