工具接入

Codex 接入 OpenAI Compatible API

为 Codex 配置自定义模型提供商、Base URL、环境变量和 Responses API,并通过最小任务验证接入结果。

更新于 2026-07-11 预计阅读 8 分钟 适用于 OpenAI Compatible API

Codex 支持通过配置文件定义模型提供商。接入第三方兼容接口时,重点是 base_url、认证环境变量、模型 ID 和 wire_api。配置字段可能随 Codex 版本更新,上线前应同时核对当前官方配置参考。

开始前检查

先确认接口支持 Codex 当前使用的 API 类型。新版本通常优先使用 Responses API;只实现 Chat Completions 的兼容服务不一定能覆盖 Codex 的全部代理能力。

准备独立环境变量:

export AIFAST_API_KEY="你的_API_Key"

配置步骤

在 Codex 配置文件中增加自定义提供商。示例结构:

model = "YOUR_MODEL_ID"
model_provider = "aifast"

[model_providers.aifast]
name = "AI快站"
base_url = "https://www.aifast.club/v1"
env_key = "AIFAST_API_KEY"
wire_api = "responses"

注意:

  • YOUR_MODEL_ID 必须替换为控制台实际开放的模型 ID。
  • 如果服务只支持 Chat Completions,不要假设改一个字段就能完整支持 Codex。
  • API Key 放在环境变量中,不写入 config.toml

最小验证任务

先在临时目录运行:

创建一个 hello.txt,内容为 connection ok,然后显示 git diff。

验证四件事:

  1. Codex 能识别模型。
  2. 请求没有落到 /v1/v1
  3. 工具调用能正常返回。
  4. 文件修改范围与任务一致。

常见问题

Unsupported parameter 或响应字段缺失

这通常意味着兼容层没有完整实现 Responses API,而不是提示词问题。保存错误正文并核对接口协议。

普通问答成功,执行工具失败

Codex 代理任务依赖工具调用事件和连续响应。文本生成成功只能证明基础请求可用,不能证明完整代理链路可用。

找不到环境变量

从启动 Codex 的同一个终端执行:

test -n "$AIFAST_API_KEY" && echo "Key 已加载"

不要输出完整 Key。

下一步

在真实仓库使用前,先测试只读分析、单文件修改、多文件修改和测试命令四类任务,并保留一个可以快速切回的原提供商配置。

准备开始调用?

创建 API Key,按本文配置直接验证

注册后可在控制台查看可用模型、用量和请求记录。

注册使用 查看 API 文档