Codex CLI 接入

Codex CLI 使用 OpenAI Responses 协议。首期开放 gpt-5.3-codex。

推荐：Meiyi Codex Setup GUI

Meiyi Codex Setup 桌面助手将作为推荐配置方式：它在本机生成 API Key，把完整 Key 保存到操作系统凭据库，并生成独立的 Codex profile；不会修改 ~/.codex/auth.json 或现有主 config.toml。

GUI 目前仍处于 Beta 开发与验收阶段，尚未正式发布。请勿从未知来源下载安装包，也不要运行 curl | sh 一类安装命令。获得公司可信渠道提供的固定版本测试包后，打开工作台的配置 Codex，按桌面助手引导完成浏览器授权。

最低支持 Codex CLI 0.134.0。自动配置使用 command-backed auth，API Key 不写入 profile、环境变量、argv 或 URL。

手动高级方案

GUI 尚不可用或需要排障时，可以手动创建独立 profile。先在 /settings 创建 API Key，并把它保存到你已有的安全凭据工具中。不要修改或覆盖 auth.json。

下面是配置结构示例；base_url 必须替换为当前 AI Hub 工作台显示的 Base URL 再追加 /v1，不要照抄示例域名：

model_provider = "meiyi_ai_hub"
model = "gpt-5.3-codex"

[model_providers.meiyi_ai_hub]
name = "Meiyi AI Hub"
base_url = "${AI_HUB_BASE_URL}/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.meiyi_ai_hub.auth]
command = "/absolute/path/to/your-secure-key-helper"
args = ["get", "meiyi-ai-hub"]
refresh_interval_ms = 0
timeout_ms = 5000

command 必须是可信 helper 的绝对路径；参数放在 args，不要使用 sh -c。helper 的 stdout 应只输出完整 Key 和换行，错误写 stderr。若没有安全的凭据 helper，请把手动方式仅作为临时排障，不要把 Key 写入 profile、shell history 或代码仓库。

将该配置保存为独立 profile 文件后，以明确的 profile 启动 Codex。不要改写主配置或全局登录状态。

验证

使用当前工作台显示的地址：

curl "$AI_HUB_BASE_URL/v1/models" \
  -H "Authorization: Bearer $AI_HUB_API_KEY"

确认返回 gpt-5.3-codex 后，再使用独立 profile 运行 Codex。

常见问题

• 401：检查 Key 是否完整、过期或已禁用。
• 403：账号已停用，请联系管理员。
• 429：达到用户或 API Key 的 RPM / 最大并发限制。
• 502 / 503：上游尚未配置、未启用或暂时不可用，请向管理员提供请求 ID。

更多信息见故障排查。