CodexManager(Codex网关)开源保姆级别配置说明

qxnm 2026-03-04 16:16 1

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

我的帖子已经打上开源推广标签： 是

我的开源项目完整开源，无未开源部分： 是

我的开源项目已链接认可 LINUX DO 社区： 是

我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

纯手工文档

整个项目是纯AI（使用codex-98%、Gemini-2%）搓出来的。

CodexManager 配置教程（V0.1.4）

项目地址

一、软件端配置

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

}