Codex

本页适用于：

• Codex CLI
• VS Code 中的 Codex 插件
• 其他基于 OpenAI Responses / Chat Completions 的 Codex 接入方式

当前接入值

• Provider：OpenAI
• 主 Base URL：https://sub2api.mycodexhub.xyz
• 备用 Base URL：https://docs.mycodexhub.xyz
• wire_api：responses
• API Key 文件：~/.codex/auth.json
• 可用模型：
  • gpt-5.3-codex
  • gpt-5.3-codex-spark
  • gpt-5.4
  • gpt-5.4-mini
  • gpt-5.5
  • gpt-image-2

核心原则

Codex 走的是 OpenAI-compatible 链路，不是 Claude 协议。
本页按 Codex CLI 常见配置给出正式写法：base_url 填根域名，由客户端按 responses 协议发起请求。

1. 安装 Codex CLI

npm install -g @openai/codex

检查版本：

codex --version

2. 配置 ~/.codex/config.toml

文件路径：

• Windows：~/.codex/config.toml
• macOS / Linux：~/.codex/config.toml

示例配置：

model_provider = "OpenAI"
model = "gpt-5.3-codex"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://sub2api.mycodexhub.xyz"
wire_api = "responses"
requires_openai_auth = true

TIP

本页以 base_url = "https://sub2api.mycodexhub.xyz" 为准。
不要手动把 base_url 写成 https://sub2api.mycodexhub.xyz/v1/chat/completions。

3. 配置 ~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-替换为你的API密钥"
}

4. 重启并验证

保存配置后，重新打开终端，再执行：

codex

如果你只想做快速连通性测试，也可以先试最小请求：

codex "输出一句：连接测试成功"

5. 用户最容易出错的地方

Base URL 写错

常见错误：

• 少了协议头
• 多了多余路径
• 把根域名写成了完整 endpoint

正确 / 错误对照：

正确：https://sub2api.mycodexhub.xyz
错误：https://sub2api.mycodexhub.xyz/
错误：https://sub2api.mycodexhub.xyz/v1/chat/completions

模型名写错

当前可用模型请直接从本页顶部列表中选择。
不要填写未开放的模型名。

混用了 Claude 和 Codex 的配置方式

• Claude Code 常见是 Anthropic-compatible
• Codex 常见是 OpenAI-compatible
• 不要把 Claude 页面里的配置直接照抄到 Codex

6. 快速对照表

场景	应该填写什么
Provider	OpenAI
API Key	sk-...
Base URL	https://sub2api.mycodexhub.xyz
备用 Base URL	https://docs.mycodexhub.xyz
wire_api	responses
模型	从当前开放模型列表中选择

7. 常见错误

401 Unauthorized

• Key 错误
• auth.json 没放对位置
• 配置文件和认证文件不匹配

404 Not Found

• Base URL 路径错误
• 把 Claude 接口地址拿来给 Codex 用

模型不存在

• 模型 ID 写错
• 当前 Key 无权访问该模型

响应异常或兼容性差

建议先用 API 调用示例 中的 curl 或 SDK 方式做最小验证，再排查客户端行为差异。