CodexManager 配置教程（V0.1.4）

字数 1363，阅读大约需 7 分钟

CodexManager 配置教程（V0.1.4）

适用场景：使用 CodexManager 做账号池管理与网关转发，统一支持 Codex、Claude Code、Azure OpenAI。
推荐阅读顺序：先完成「一、软件端配置」，再完成「二、Codex 配置」或「三、Claude Code 配置」。

docker部署、软件浏览器启动更详细的介绍请移步开源地址：

https://github.com/qxcnm/Codex-Manager

---

一、软件端配置

1）打开软件并检查端口

• • 首次启动后，先确认服务状态正常。

• • 如果端口冲突，可在界面中修改端口，保存后重启服务。

• • 如果服务启动失败，建议先关闭全局代理，改为规则模式后再重试。

2）账号管理

账号管理支持以下操作：

3）设置

1. 

2. 1. 更新配置
   用于自动检测更新相关配置。

3. 2. 网关策略
   用于配置账号轮转规则：

• • 顺序优先模式：按账号 sort 升序构建候选并依次尝试（如 0 -> 1 -> 2 -> 3）。

• • 顺序优先不是“固定命中 0 号”，当前序账号不可用时会自动切换下一个。

• • 常见跳过原因：

• • 账号状态不是 可用

• • 账号缺少 token

• • 用量判定不可用（如主窗口已用尽、用量字段缺失）

• • 处于 cooldown 或触发并发软上限

• • 均衡轮询模式会按 Key + 模型 维度轮换起点，不保证从最小 sort 开始。

• • 排障建议查看数据库同目录 gateway-trace.log：

• • CANDIDATE_POOL：候选顺序

• • CANDIDATE_START / CANDIDATE_SKIP：实际尝试与跳过原因

• • REQUEST_FINAL：最终命中账号

1. 3. 视觉性能
   可关闭 blur、backdrop-filter 等高开销效果，低配设备建议关闭以提升流畅度。

2. 4. 后台任务
   可配置账号用量刷新、网关保活、令牌刷新等任务。

3. 5. Worker 参数
   可调整普通请求与流式请求的并发因子、最小并发等参数。

4. 6. 主题设置
   支持：科技蓝、商务金、薄荷绿、晚霞橙、葡萄紫、海湾青、松林绿、玫瑰粉、石板灰、极光青。

4）平台密钥

密钥类型共 3 类：

5）请求日志

用于记录账号请求日志、平台密钥请求日志以及错误信息，建议排障时优先查看。

---

二、Codex 配置

1）直接修改本地文件（推荐）

1. 

2. 1. 打开目录：C:\Users\xxxx\.codex
   如果看不到 .codex，请先在资源管理器开启“显示隐藏的项目”。

3. 2. 修改 auth.json
   将「一、4）平台密钥」中生成的密钥填入：

{
  "OPENAI_API_KEY": "你的平台密钥"
}

1. 3. 修改 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"

1. 4. 重启 Codex 客户端后生效。

完成后，VS Code、Cursor、Kiro、Antigravity 等常见 Codex 插件通常可直接使用。

2）使用 cc-switch 配置

1. 

2. 1. API Key 填入平台密钥。

3. 2. toml 配置使用与上面一致的内容。

4. 3. 保存后重启 Codex 客户端。

---

三、Claude Code 配置

1）直接修改本地文件（推荐）

1. 

2. 1. 打开目录：C:\Users\xxxx\.claude
   如果目录不可见，请先开启“显示隐藏的项目”。

3. 2. 修改 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
}

1. 3. 保存后即可使用。

完成后，VS Code、Cursor、Kiro、Antigravity 等常见 Claude Code 插件通常可直接使用。

2）使用 cc-switch 配置

1. 

2. 1. 配置平台密钥。

3. 2. 配置请求地址。

4. 3. API 格式选择“原生”。

5. 4. 模型可填写 gpt-5.3-codex（或你实际可用模型）。

6. 5. JSON 配置使用上面的 settings.json 内容。

---

四、总结

至此，CodexManager 的软件端、Codex 客户端、Claude Code 客户端配置全部完成。
如果你在接入中遇到问题，建议按以下顺序排查：

1. 1. 平台密钥是否可用。

2. 2. 本地端口与代理是否冲突。

3. 3. gateway-trace.log 与请求日志是否有明确报错。

4. 4. 客户端配置文件路径与字段是否填写正确。

5. 群聊：

6.