CodexManager

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

English

本地桌面端 + 服务进程的 Codex 账号池管理器，用于统一管理账号、用量与平台 Key，并提供本地网关能力。

首页导览

你要做什么	直接进入
首次启动、部署、Docker、macOS 放行	运行与部署指南
配置端口、代理、数据库、Web 密码、环境变量	环境变量与运行配置
排查账号不命中、导入失败、挑战拦截、请求异常	FAQ 与账号命中规则
本地构建、打包、发版、脚本调用	构建发布与脚本说明

最近变更

• 当前最新版本：v0.1.6（2026-03-07）
• 当前主分支已继续补齐 Web 安全链路：codexmanager-web 的访问密码仍会持久化，但登录会话现在会绑定当前 Web 进程；关闭并重新打开后，旧 Cookie 不再继续生效，必须重新验证密码。
• 协议适配继续对齐 Codex / OpenAI 兼容生态：/v1/chat/completions 与 /v1/responses 转发链路进一步统一，tools / tool_calls 聚合、工具名缩短与响应还原链路已补齐，并覆盖 Cherry Studio、OpenClaw、Claude Code 等兼容场景。
• 网关诊断能力增强：失败响应增加结构化 errorCode / errorDetail 字段，并补充 X-CodexManager-Error-Code、X-CodexManager-Trace-Id 头；请求日志也补充了原始路径、适配路径和更多上游上下文，便于精确排障。
• 发布体系继续收敛到单一入口：release-all.yml 统一负责 Windows / macOS / Linux 一键发布；当 run_verify=false 时会自动回退到本地前端构建，不再强依赖预构建工件，同时继续复用前端产物与协议回归基线。
• 完整版本历史请查看 CHANGELOG.md。

功能概览

• 账号池管理：分组、标签、排序、备注
• 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件
• 用量展示：兼容 5 小时 + 7 日双窗口，以及仅返回 7 日单窗口的账号
• 授权登录：浏览器授权 + 手动回调解析
• 平台 Key：生成、禁用、删除、模型绑定
• 本地服务：自动拉起、可自定义端口
• 本地网关：为 CLI 和第三方工具提供统一 OpenAI 兼容入口

截图

快速开始

1. 启动桌面端，点击“启动服务”。
2. 进入“账号管理”，添加账号并完成授权。
3. 如回调失败，粘贴回调链接手动完成解析。
4. 刷新用量并确认账号状态。

页面展示

桌面端

• 账号管理：集中导入、导出、刷新账号与用量
• 平台 Key：按模型绑定平台 Key，并查看调用日志
• 设置页：统一管理端口、代理、主题、自动更新、后台行为

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 与账号命中规则	账号命中、挑战拦截、导入导出、常见异常
最小排障手册	快速定位服务启动、请求转发、模型刷新异常
构建发布与脚本说明	本地构建、Tauri 打包、Release workflow、脚本参数
发布与产物说明	各平台发版产物、命名、是否 pre-release
脚本与发布职责对照	各脚本负责什么、什么场景该用哪个
协议兼容回归清单	/v1/chat/completions、/v1/responses、tools 回归项

目录结构

.
├─ apps/                # 前端与 Tauri 桌面端
│  ├─ src/
│  ├─ src-tauri/
│  └─ dist/
├─ crates/              # Rust core/service
│  ├─ core
│  ├─ service
│  ├─ start              # Service 版本一键启动器（拉起 service + web）
│  └─ web                # Service 版本 Web UI（可内嵌静态资源 + /api/rpc 代理）
├─ docs/                # 正式文档目录
├─ scripts/             # 构建与发布脚本
├─ portable/            # 便携版输出目录
└─ README.md

鸣谢与参考项目

• CPA（CLIProxyAPI）：本项目在协议适配、请求转发与兼容行为上参考了该项目的实现思路 https://github.com/router-for-me/CLIProxyAPI
• 对应实现可见：
• crates/service/src/gateway/protocol_adapter/request_mapping.rs
• crates/service/src/gateway/upstream/transport.rs

联系方式

• Telegram 交流群：https://t.me/+8o2Eu7GPMIFjNDM1
• QQ 交流群：扫码加入
• 微信公众号：七线牛马