跳到主要内容

Codex

Codex 支持在配置文件中定义自定义模型服务提供方。当 Codex 需要将 Responses API 请求发送到 AISIX 而非直接调用模型服务提供方时，请使用自定义服务提供方。

本指南将 Codex 指向 AISIX 代理 API 根路径，并使用 AISIX 调用方 API Key 认证。Codex 的自定义模型值应填写 AISIX 模型别名。

前置条件​

开始前，请准备以下内容：

  • 已安装 Codex，且可以读取 ~/.codex/config.toml。
  • 一个代理监听器可用的运行中 AISIX 网关。
  • 一个 AISIX 调用方 API Key。
  • 一个调用方 API Key 可访问且支持 Responses API 的模型别名。

如果你的组织已经部署 AISIX，请向管理团队获取网关 URL、模型别名和调用方 API Key。否则，请按照开源 AISIX 网关快速上手或 AISIX Cloud 快速上手完成部署，也可以联系 API7申请 Hybrid Cloud 访问权限。

配置 Codex​

在运行 Codex 的环境中设置调用方 API Key：

# 请替换为实际值
export AISIX_API_KEY="YOUR_CALLER_API_KEY"

在 ~/.codex/config.toml 中添加 AISIX 模型服务提供方：

~/.codex/config.toml
model = "gpt-4o-prod" # 使用 AISIX 模型别名，而不是上游服务提供方模型 ID。
model_provider = "aisix"

[model_providers.aisix]
name = "AISIX AI Gateway"
base_url = "http://127.0.0.1:3000/v1" # 将 Codex 指向 AISIX 代理 API 根路径。
env_key = "AISIX_API_KEY" # 从环境变量读取 AISIX 调用方 API Key。
wire_api = "responses"

验证集成​

在已设置 AISIX_API_KEY 的 Shell 中启动 Codex：

codex

提出一个需要模型响应的简短问题。

请求成功后，请确认以下结果：

  • Codex 输出模型响应。
  • AISIX 为所选模型别名记录一条成功的 POST /v1/responses 请求。

AISIX 会验证调用方 API Key、检查模型访问权限、解析模型别名、应用策略，并将请求分发到别名背后的上游服务提供方。

排查 Codex 请求​

如果 Codex 无法连接 AISIX，请检查以下内容：

现象检查项
认证失败确认 AISIX_API_KEY 已在运行 Codex 的同一 Shell 或环境中设置。
找不到模型确认 config.toml 中的 model 是调用方 API Key 可见的 AISIX 模型别名。
Responses 请求失败确认所选模型别名可用于 AISIX Responses API。某些服务提供方支持的别名并不支持全部 OpenAI Responses 特性。
请求绕过 AISIX确认生效的 Codex 配置层中包含 model_provider = "aisix"。

有关端点行为和服务提供方边界，请参阅 Responses API。

后续步骤​