Codex CLI

从 OpenAI 的 Codex CLI 使用 Echo Token Station 模型的设置。Codex CLI 用 Responses API 连接。

Codex CLI 是 OpenAI 的编程用 AI 工具，在终端里运行。Codex CLI 只用 Responses API（/v1/responses）连接 Echo。

验证情况：Codex CLI 0.157.1（2026-09-27，Echo 的验证环境）

开始之前

准备好 Echo 的 API 密钥和要用的模型的 ID。模型 ID 可以在模型一览查看
Codex CLI 是面向 OpenAI 模型的工具。在 Codex CLI 里使用 OpenAI 以外的模型时的运行情况，我们没有确认

设置

把 Echo 的 API 密钥放进环境变量 ECHO_API_KEY

bash

export ECHO_API_KEY="sk-..."

在 Codex CLI 的设置文件 ~/.codex/config.toml 里写上下面的内容。设置了环境变量 CODEX_HOME 时，是那个文件夹里的 config.toml

toml

model = "gpt-6-sol"
model_provider = "echo"

[model_providers.echo]
name = "Echo Token Station"
base_url = "https://token.echohub.io/v1"
env_key = "ECHO_API_KEY"
wire_api = "responses"

项目	含义
`model`	要用的模型的 ID
`model_provider`	要用的接入配置的名字。与下面 `[model_providers.echo]` 里的 `echo` 相同
`name`	在界面上显示的名字
`base_url`	接入地址。要带上 `/v1`
`env_key`	读取 API 密钥的环境变量的名字
`wire_api`	通信格式。设为 `"responses"`

wire_api 指定为 "chat" 时，Codex CLI 0.157.1 启动时会以 wire_api = "chat" is no longer supported 的错误停止。

确认能用

在设置了 ECHO_API_KEY 的终端里，进入要工作的文件夹，运行下面的命令。在不是 Git 仓库的文件夹里试时，加上 --skip-git-repo-check

bash

codex exec "Reply with the single word hi."

显示出回答就完成了。控制台的「呼び出し履歴」（调用记录）里也会出现记录

指定了 Codex CLI 不认识的模型 ID 时，会出现 Model metadata for ... not found 的警告。调用会照常继续。

不能正常使用时

症状	原因	处理方法
启动时出现 `wire_api = "chat"` is no longer supported	`wire_api` 是 `"chat"`	改成 `wire_api = "responses"`
404，返回的是 HTML 页面而不是 JSON	`base_url` 的末尾没有 `/v1`	改成 `https://token.echohub.io/v1`
401 和 `Invalid API key`	密钥错误、已停用、已过期，或使用上限已用完	在控制台确认密钥的状态
404 和 `Invalid URL (POST /v1/v1/responses)`	`base_url` 里有两个 `/v1`	改成 `https://token.echohub.io/v1`
403 和 `Insufficient balance`	余额不足	充值
503 和 `The model … does not exist or is not available`	模型 ID 错误，或 Echo 不提供的模型	确认 `model` 的模型 ID

错误正文的一览见错误与处理。

Codex CLI 会在请求里带上 store: false（不让上游 API 保存回答的指定）发送。Echo 不做修改地把这个值传给上游。

信息来源

内容	来源	确认日期
用 `config.toml` 的设置连接、`wire_api = "chat"` 的错误、不认识的模型 ID 的警告、发送 `store: false`	Echo 验证环境中的实测（Codex CLI 0.157.1）。使用与正式环境相同的中转设置，并用返回测试响应的服务器代替上游 API	2026-09-27
`model_provider` 和 `[model_providers.<id>]` 的项目（`name`、`base_url`、`env_key`、`wire_api`）、`CODEX_HOME`	https://developers.openai.com/codex/config-advanced	2026-09-27
`wire_api = "chat"` 已废止	https://github.com/openai/codex/discussions/7782	2026-09-27