> 说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何支持 OpenAI Responses 接口的网关都一样，换成你自己用的地址即可。

Codex CLI 是 OpenAI 出的命令行编程 Agent。它默认连 OpenAI 官方，但支持在配置文件里自定义 Provider，所以也能接到第三方网关上。这篇说明怎么写 `config.toml`、Key 放在哪，以及几个最容易踩的坑。

## 先知道一件事：Codex 用的是 Responses 接口

和大多数工具不同，Codex CLI 走的是 OpenAI 的 **Responses 接口**（`/v1/responses`），不是 `/v1/chat/completions`。所以你接的网关必须支持 Responses 接口，否则工具调用和流式输出会出问题。配置里的 `wire_api = "responses"` 就是告诉 Codex 用这个接口。

## 第 1 步：写配置文件

配置文件位置：

- macOS / Linux：`~/.codex/config.toml`
- Windows：`%USERPROFILE%\.codex\config.toml`

没有就新建一个，内容如下：

```toml
model = "gpt-5.5"
model_provider = "apivai"

[model_providers.apivai]
name = "APIVAI"
base_url = "https://api.apivai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
```

几个字段的意思：

| 字段 | 作用 |
|---|---|
| `model` | 默认用的模型 ID |
| `model_provider` | 用哪个 Provider，要和下面 `[model_providers.xxx]` 的名字一致 |
| `base_url` | 网关地址，**要带** `/v1`，Codex 会自己拼上 `/responses` |
| `env_key` | Key 从哪个环境变量读 |
| `wire_api` | 接口类型，填 `responses` |

## 第 2 步：设置 Key

Key 不写进配置文件，而是放在 `env_key` 指定的环境变量里。

macOS / Linux：

```bash
export OPENAI_API_KEY="你的Key"
codex "用两句话说明这个仓库是做什么的"
```

Windows PowerShell：

```powershell
$env:OPENAI_API_KEY = "你的Key"
codex "用两句话说明这个仓库是做什么的"
```

想长期生效，就把 `export` 那行写进 `~/.zshrc` / `~/.bashrc`，Windows 用「系统环境变量」设置。先用一个小问题试通，再让它改代码。

## 第 3 步：确认模型 ID

模型 ID 以网关返回的列表为准：

```bash
curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer 你的Key"
```

临时换模型不用改配置，加 `-m` 参数就行：

```bash
codex -m gpt-5.5 "给 utils.py 补上单元测试"
```

## 常见报错

- **401 Unauthorized**：Codex 没读到 Key。检查 `env_key` 写的变量名和你实际设置的是不是同一个；在新终端里运行时，确认环境变量已经生效（`echo $OPENAI_API_KEY` 看一下）。
- **404 Not Found**：`base_url` 的 `/v1` 问题。要写成 `https://api.apivai.com/v1`，不能少 `/v1`，也不要自己加 `/responses`。
- **提示找不到 Provider，或者请求没走到网关**：`model_provider` 的值和 `[model_providers.xxx]` 里的名字要完全一致；另外确认改的是正确位置的 `config.toml`（Windows 在用户目录下的 `.codex` 文件夹里）。
- **工具调用失败、输出卡住**：`wire_api` 没写或写成了 `chat`，或者你用的网关不支持 Responses 接口。
- **找不到模型**：`model` 必须是准确的模型 ID，用 `GET /v1/models` 核对，不要照抄旧教程里的名字。
- **429**：默认每个 Key 每分钟 60 次请求，Agent 连续调用时容易碰到，稍等一下或者多建几个 Key 分开用。

## 小建议

- Key 不要写进项目里的文件，也别出现在截图里；用环境变量最省心。
- Agent 类工具 token 消耗大，第一次先拿小任务试，确认费用在预期内再放开用。

有问题欢迎评论区交流。


说明：我是 APIVAI 的运营者，下面示例里的地址是 APIVAI 的。配置方法对任何支持 OpenAI Responses 接口的网关都一样，换成你自己用的地址即可。

Codex CLI 接入第三方 API：config.toml 怎么写、Key 放哪里（附 401/404 排查）

Codex CLI 接第三方网关的配置方法：config.toml 里自定义 Provider 的写法、Key 的环境变量、Responses 接口，以及 401、404、模型找不到等报错的排查。

开发工具

编程语言

后端

配置Codex CLI接入APIVAI网关需注意：使用Responses接口（/v1/responses）而非Chat接口，配置文件位于~/.codex/config.toml（Windows为%USERPROFILE%\.codex\config.toml），需设置model_provider与base_url（带/v1），Key通过环境变量OPENAI_API_KEY传入。常见问题包括401（Key未生效）、404（base_url路径错误）、工具调用失败（wire_api未设responses）。模型ID需通过GET /v1/models查询确认。

2026上云采购 | AI焕新·智启新局

apigw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

配置Codex CLI接入APIVAI网关需注意：使用Responses接口（/v1/responses）而非Chat接口，配置文件位于~/.codex/config.toml（Windows为%USERPROFILE%\.codex\config.toml），需设置model_provider与base_url（带/...

Codex CLI 接入第三方 API：config.toml 怎么写、Key 放哪里（附 401/404 排查）-腾讯云开发者社区-腾讯云

Codex CLI 接入第三方 API：config.toml 怎么写、Key 放哪里（附 401/404 排查）

Codex CLI 接入第三方 API：config.toml 怎么写、Key 放哪里（附 401/404 排查）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐