Codex 接入 EchoCode Code

OpenAI Codex CLI 通过 EchoCode 的 OpenAI 兼容网关接入 EchoCode Code。

前置条件

1. 已完成 快速开始。
2. 已在 EchoCode 控制台创建适用于 Codex 的 API Key。
3. 本机已安装 Node.js、npm 和 Codex CLI。

npm i -g @openai/codex@latest
codex

配置文件

Windows：

%userprofile%\.codex\auth.json
%userprofile%\.codex\config.toml

macOS / Linux：

~/.codex/auth.json
~/.codex/config.toml

写入 API Key

auth.json 写入一个 JSON 对象，字段名为 OPENAI_API_KEY，字段值为 EchoCode 控制台复制的 API Key。

写入 Codex 网关

config.toml 写入 EchoCode Code 供应商：

disable_response_storage = true
model_provider = "echocode-code"

[features]
web_search_request = true

[model_providers.echocode-code]
name = "echocode-code"
base_url = "https://echocode.pro"
requires_openai_auth = true
wire_api = "responses"

EchoCode 控制台「API Keys」页面的「使用 Key」弹窗会按 Key 的模型分组生成 Codex 配置；弹窗中出现的 model、model_reasoning_effort、model_verbosity 字段可以一并写入 config.toml。

验证

1. 关闭旧终端并重新打开。
2. 执行：

codex

3. 发送一条简短测试消息。
4. 回到 EchoCode 控制台查看用量记录。

常见问题

• 401：API Key 未写入、复制不完整或 Key 已停用。
• 404 / model not found：Key 所属模型分组与 Codex 请求模型不匹配。
• 网络超时：检查代理、DNS、企业证书和本机防火墙。
• 配置被覆盖：使用 CC Switch 管理供应商，避免手动改写多个 live 文件。