Codex 第三方模型接入

Codex 默认使用 OpenAI 的模型，但也支持配置第三方模型接口。

支持的模型

Codex 原生支持以下 OpenAI 模型：

模型说明适用场景
o4-mini最新推理模型复杂编码和推理任务
GPT-4.1高性能通用模型日常开发
GPT-4o多模态模型需要理解图片的任务
GPT-4o-mini快速经济模型简单任务、快速迭代

切换模型

方法一：环境变量指定

~/.zshrc
export OPENAI_MODEL="o4-mini"

方法二：命令行参数

bash
codex --model o4-mini

接入第三方模型（通过 API 中转）

如果你想使用非 OpenAI 官方的模型接口，需要配置自定义 API 端点。

配置自定义 API 基础地址

~/.zshrc
# 设置自定义 API 基础地址
export OPENAI_BASE_URL="https://your-relay-domain.com/api/v1"

# 设置中转 API Key
export OPENAI_API_KEY="your-relay-api-key"

工作原理

设置 OPENAI_BASE_URL 后，Codex 会将所有 API 请求发送到你指定的地址。中转服务会代为转发到真正的模型接口。注意 Codex 使用的是 OpenAI 兼容格式，基础地址需要包含 /v1 后缀。

验证模型配置

text
> 请问你是什么模型？

如果回复的模型名称与你配置的一致，说明配置成功。

模型配置完成！

你现在已经成功配置了第三方模型接入。

下一步