算力猫
← 返回教程列表

接入软件

Codex CLI

在 Codex 的配置文件里加一个自定义提供方。

约 8 分钟适合:用 Codex CLI 的开发者

开始之前

  • 已装好 Codex CLI
  • 一把 Key
  • 模型广场里带「Responses」接口标签的模型:Codex 走 /v1/responses 接口

步骤 1 · STEP 0x01

把 Key 放进环境变量

Codex 不把 Key 直接写进配置,而是从你指定名字的环境变量里读。这里用 RELAY_API_KEY,名字可以自己取。

bash
export RELAY_API_KEY=<你的 Key>
terminal
$ export RELAY_API_KEY=<你的 Key>
完整 Key 只在创建时显示一次,关闭页面就看不到了。没来得及保存?吊销它,再创建一把新的。

去创建 Key →

步骤 2 · STEP 0x02

在配置文件里加一个提供方

编辑用户目录下的 .codex/config.toml(即 ~/.codex/config.toml,Windows 在用户目录的 .codex 文件夹里)。提供方的名字自己取,openai、ollama 等保留名不能用。

toml
model = "<模型名>"
model_provider = "relay"

[model_providers.relay]
name = "算力猫"
base_url = "https://api.suanlimao.shop/v1"
env_key = "RELAY_API_KEY"
wire_api = "responses"
terminal
$ cat ~/.codex/config.tomlmodel = "<模型名>"model_provider = "relay"…
  • model:从模型广场复制的、带 Responses 标签的模型名。
  • base_url:接入地址,带 /v1。
  • env_key:存放 Key 的环境变量名,要和上一步一致。
  • wire_api = "responses":告诉 Codex 用 Responses 接口。
提供方要写在用户级的 ~/.codex/config.toml。项目里的 .codex/config.toml 不会读取 model_provider、model_providers 这些键。

打开模型广场 →

步骤 3 · STEP 0x03

运行并试一句

terminal
$ codex> 你好(正常回答即成功)
同一个终端里设置了环境变量才能被 Codex 读到;换了新窗口要重新设置,或者写进 shell 配置文件。

✓ 怎么确认成功了

  • Codex 能正常回答,控制台「用量」页出现这次请求。

常见问题

提示找不到环境变量?

env_key 写的名字和你 export 的名字必须完全一样,并且是在运行 codex 的同一个终端里设置的。

提示 404 或不支持 responses?

这个模型没有开通 Responses 接口。换一个带 Responses 标签的模型,或者联系客服了解何时开通。

不想用 Responses,能用 chat 接口吗?

Codex 官方配置里的示例都是 wire_api = "responses",文档没有说明其他取值,我们也只按这个写。

相关教程

还是不行?

先看排错教程;仍然解决不了,提交工单时附上 request_id、时间、模型和报错原文(不要贴 Key)。