本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：
- 我的帖子已经打上 开源推广 标签： 是
- 我的开源项目完整开源，无未开源部分： 是
- 我的开源项目已链接认可 LINUX DO 社区： 是
- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是
- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是
以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出
纯手工文档
整个项目是纯AI（使用codex-98%、Gemini-2%）搓出来的。
CodexManager 配置教程（V0.1.4）
项目地址
相关帖子：
更新日志（持续更新帖子）：
CodexManager 最近的更新（持续更新） - 开发调优 / 开发调优, Lv1 - LINUX DO
适用场景：使用 CodexManager 做账号池管理与网关转发，统一支持 Codex、Claude Code、Azure OpenAI。
推荐阅读顺序：先完成「一、软件端配置」，再完成「二、Codex 配置」或「三、Claude Code 配置」。
一、软件端配置
1）打开软件并检查端口
- 首次启动后，先确认服务状态正常。
- 如果端口冲突，可在界面中修改端口，保存后重启服务。
- 如果服务启动失败，建议先关闭全局代理，改为规则模式后再重试。
2）账号管理
账号管理支持以下操作：
-
添加账号
所有字段均为非必填，可直接点击登录（会拉起浏览器登录 OpenAI）。登录成功后，程序会自动解析 token 并填充关键字段。 -
导入账号
支持导入登录后保存的auth.json，兼容多种常见格式（包括官方auth.json与常见渠道格式），可一键识别关键字段。 -
刷新所有
系统会轮转刷新全部账号用量；后台定时任务也会持续刷新。 -
一键移除不可用免费账号
可快速清理不可用的免费渠道账号。 -
导出用户
可将全部账号导出为auth.json文件（每个用户一个文件）。
3）设置
-
更新配置
用于自动检测更新相关配置。 -
网关策略
用于配置账号轮转规则：
- 顺序优先模式：按账号
sort升序构建候选并依次尝试（如0 -> 1 -> 2 -> 3）。 - 顺序优先不是“固定命中 0 号”，当前序账号不可用时会自动切换下一个。
- 常见跳过原因：
- 账号状态不是
可用 - 账号缺少 token
- 用量判定不可用（如主窗口已用尽、用量字段缺失）
- 处于 cooldown 或触发并发软上限
- 账号状态不是
- 均衡轮询模式会按
Key + 模型维度轮换起点，不保证从最小sort开始。 - 排障建议查看数据库同目录
gateway-trace.log：CANDIDATE_POOL：候选顺序CANDIDATE_START/CANDIDATE_SKIP：实际尝试与跳过原因REQUEST_FINAL：最终命中账号
-
视觉性能
可关闭blur、backdrop-filter等高开销效果，低配设备建议关闭以提升流畅度。 -
后台任务
可配置账号用量刷新、网关保活、令牌刷新等任务。 -
Worker 参数
可调整普通请求与流式请求的并发因子、最小并发等参数。 -
主题设置
支持：科技蓝、商务金、薄荷绿、晚霞橙、葡萄紫、海湾青、松林绿、玫瑰粉、石板灰、极光青。
4）平台密钥
密钥类型共 3 类：
-
OpenAI 兼容
用于 Codex 网关请求，按网关策略轮转账号。 -
Azure OpenAI 兼容
用于将 Codex 入栈请求转发到 Azure OpenAI。 -
Claude Code 兼容
用于将 Claude Code 入栈请求转发到 OpenAI 风格接口，并兼容工具调用转换。
5）请求日志
用于记录账号请求日志、平台密钥请求日志以及错误信息，建议排障时优先查看。
二、Codex 配置
1）直接修改本地文件（推荐）
-
打开目录：
C:\Users\xxxx\.codex
如果看不到.codex，请先在资源管理器开启“显示隐藏的项目”。 -
修改
auth.json
将「一、4）平台密钥」中生成的密钥填入：
{
"OPENAI_API_KEY": "你的平台密钥"
}
- 修改
config.toml
可直接使用以下示例：
# 使用自定义提供方（不是内置 openai / oss）
model_provider = "custom"
# 使用的模型名称（由你自己的服务决定是否真的存在）
model = "gpt-5.3-codex"
# 模型推理强度：medium = 性能 / 深度平衡
model_reasoning_effort = "medium"
# 自定义模型提供方定义
[model_providers.custom]
# 提供方名称（仅用于标识）
name = "custom"
# 使用 Responses API 协议（现代接口）
wire_api = "responses"
# 要求使用 OpenAI 的认证流程（即使是本地反代）
requires_openai_auth = true
# 模型服务地址（本地反代 / 网关 / mock server）
base_url = "http://localhost:48760/v1"
- 重启 Codex 客户端后生效。
完成后，VS Code、Cursor、Kiro、Antigravity 等常见 Codex 插件通常可直接使用。
2）使用 cc-switch 配置
API Key填入平台密钥。toml配置使用与上面一致的内容。- 保存后重启 Codex 客户端。
三、Claude Code 配置
1）直接修改本地文件（推荐）
-
打开目录：
C:\Users\xxxx\.claude
如果目录不可见，请先开启“显示隐藏的项目”。 -
修改
settings.json，填入以下内容（平台密钥来自「一、4）平台密钥」）：
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的平台密钥",
"ANTHROPIC_BASE_URL": "http://localhost:48760",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gpt-5.3-codex",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "gpt-5.3-codex",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.3-codex",
"ANTHROPIC_MODEL": "gpt-5.3-codex",
"ANTHROPIC_REASONING_MODEL": "gpt-5.3-codex"
},
"includeCoAuthoredBy": false
}
- 保存后即可使用。
完成后，VS Code、Cursor、Kiro、Antigravity 等常见 Claude Code 插件通常可直接使用。
2）使用 cc-switch 配置
- 配置平台密钥。
- 配置请求地址。
- API 格式选择“原生”。
- 模型可填写
gpt-5.3-codex（或你实际可用模型）。 - JSON 配置使用上面的
settings.json内容。
四、总结
至此，CodexManager 的软件端、Codex 客户端、Claude Code 客户端配置全部完成。
如果你在接入中遇到问题，建议按以下顺序排查：
- 平台密钥是否可用。
- 本地端口与代理是否冲突。
gateway-trace.log与请求日志是否有明确报错。- 客户端配置文件路径与字段是否填写正确。
