Client 2 / Codex

把 Codex CLI 接到 OpenEasyAPI

Codex 走 OpenAI 兼容协议：https://openeasyapi.com/v1 是 base URL，gpt-6.1-sol 是模型名，令牌放 OPENAI_API_KEY。三处写对就能跑通。

Codex CLIopenai_base_urlgpt-6.1-solOPENAI_API_KEY

安装写配置验证命令常见问题

Install

安装 Codex CLI

需要 Node.js 20+，装完先确认版本号能正常输出。

Install

npm install -g @openai/codex
codex --version

💡

提示

Codex 的配置分两层：用户级 ~/.codex/config.toml 和项目级 .codex/config.toml。本页只改用户级配置，项目级留空即可。

Config

两件事：模型名 + base URL

配置文件是 ~/.codex/config.toml；文件不存在就直接新建。openai_base_url 必须带 /v1。

~/.codex/config.toml

#:schema https://developers.openai.com/codex/config-schema.json
model = "gpt-6.1-sol"
openai_base_url = "https://openeasyapi.com/v1"

💡

提示

openai_base_url 写 https://openeasyapi.com/v1，末尾不要多写 /responses 或 /chat/completions，客户端会自己拼。

⚠️

注意

model 用当前在售的 gpt-6.1-sol；换成别家模型名会直接 400，可用型号以模型广场为准。

Auth

设置 OPENAI_API_KEY

令牌来自控制台创建的 API Key（team-gpt 分组，sk- 开头）。

macOS / Linux

export OPENAI_API_KEY="sk-你的令牌"

# 写入 ~/.zshrc 或 ~/.bashrc 可持久生效
echo 'export OPENAI_API_KEY="sk-你的令牌"' >> ~/.zshrc

Windows PowerShell

$env:OPENAI_API_KEY = "sk-你的令牌"

# 永久生效（新开的终端也会带上）
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的令牌", [System.EnvironmentVariableTarget]::User)

💡

提示

设置完先 echo $OPENAI_API_KEY（PowerShell 用 $env:OPENAI_API_KEY）确认没有多余空格和换行，再往下走。

Verify

两条验证命令，任选一条先跑通

建议先用 curl 确认 base URL 和令牌没问题，再回到 Codex 里跑 exec。

curl 直连 /v1/responses

在任意终端执行，成功时 HTTP 状态是 200：

curl 验证

curl -sS -i https://openeasyapi.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "reply OK"
  }'

成功响应片段（关注 status 和 output[0].content[0].text）：

成功响应

HTTP/2 200
{
  "id": "resp_...",
  "object": "response",
  "model": "gpt-6.1-sol",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{ "type": "output_text", "text": "OK" }]
    }
  ]
}

用 Codex CLI 验证

进入项目目录后执行 codex exec（非交互模式），模型回 OK 就说明配置链路已经通了：

Codex exec

codex exec "reply OK"

预期输出

$ codex exec "reply OK"
OK

⚠️

注意

401 检查 OPENAI_API_KEY；404 检查 openai_base_url 是否少了 /v1；400 model_not_found 检查 model 是否写成 gpt-6.1-sol；403 insufficient_gpt_quota 是余额/额度不足，先充值。

💡

提示

同一把 team-gpt 的 Key 也可以用 /v1/chat/completions 调用，成功响应结构见 OpenAI SDK 页；本页的 /v1/responses 示例是同一网关的 Responses 形态。

Troubleshooting

常见问题

Codex 报错信息里通常会直接带出 base URL 和模型名，先看这两项。

⚠️

注意

改了配置不生效：确认改的是 ~/.codex/config.toml，不是项目目录下的同名文件。

⚠️

注意

只有 Codex 报错、curl 正常：多半是 OPENAI_API_KEY 没进到 Codex 的进程环境里，重开终端再试。

💡

提示

想用脚本或 SDK 调同样的接口：继续看 OpenAI SDK 页。

💡

提示

不想手改 toml：用 CC Switch 图形化切换配置。

Claude Code

OpenAI SDK