接入 Codex CLI

OpenAI 的 Codex CLI 走的是 OpenAI 兼容协议,接入只用两个环境变量。

安装

npm install -g @openai/codex

配置环境变量

export OPENAI_BASE_URL="https://aiuv.ai/v1"
export OPENAI_API_KEY="sk-YOUR_KEY"

reload:

source ~/.zshrc

跑

cd /your/project
codex

选模型

Codex 默认会用 gpt-5-codex 之类的官方 ID。在 session 里切换:

> /model claude-opus-4-7

或开 session 时指定:

codex --model gpt-5

Codex 内部对模型名做了一些假设(比如 reasoning_effort 字段)。 切到 Claude / Gemini 时如果出现"unsupported field"报错, 加 --no-reasoning 或在 ~/.codex/config.toml 里关 reasoning。

小技巧:多个 profile 切换

~/.codex/config.toml 可以预设多个 profile:

[profiles.aiuv-gpt]
base_url = "https://aiuv.ai/v1"
api_key  = "sk-YOUR_KEY"
model    = "gpt-5"

[profiles.aiuv-claude]
base_url = "https://aiuv.ai/v1"
api_key  = "sk-YOUR_KEY"
model    = "claude-opus-4-7"

切:

codex --profile aiuv-claude

故障排查

• API key 无效:确认 env var 真的设了 + key 没过期
• 流式中断:Codex 默认开流;如果代理 buffer,试 codex --no-stream
• 工具调用失败:Codex 假设上游支持 OpenAI 的 function/tool calling 格式,某些模型不支持时会报 schema 错误