Codex CLI

Codex CLI 使用 OpenAI 兼容接口。Enodot 的 OpenAI Base URL 是：

https://ai.enodot.shop/v1

你需要准备

• 一个 Enodot API Key。
• 这个 Key 可以访问 OpenAI 协议分组，或可以访问“默认聚合路由”。
• 一个当前可用的 OpenAI 模型，例如 gpt-5.5 或 gpt-5.4-mini。

临时环境变量

macOS / Linux / WSL：

export OPENAI_API_KEY="你的 Enodot API Key"
export OPENAI_BASE_URL="https://ai.enodot.shop/v1"
codex

Windows PowerShell：

$env:OPENAI_API_KEY="你的 Enodot API Key"
$env:OPENAI_BASE_URL="https://ai.enodot.shop/v1"
codex

临时环境变量只对当前终端窗口有效。关闭终端后，需要重新设置。

写入长期配置

如果你用 zsh：

printf '\nexport OPENAI_API_KEY="你的 Enodot API Key"\n' >> ~/.zshrc
printf 'export OPENAI_BASE_URL="https://ai.enodot.shop/v1"\n' >> ~/.zshrc
source ~/.zshrc

如果你用 bash：

printf '\nexport OPENAI_API_KEY="你的 Enodot API Key"\n' >> ~/.bashrc
printf 'export OPENAI_BASE_URL="https://ai.enodot.shop/v1"\n' >> ~/.bashrc
source ~/.bashrc

配置文件方式

不同 Codex CLI 版本的配置文件字段可能不同。你只需要找到这三项：

配置项	填写
API Key	你的 Enodot API Key
Base URL	https://ai.enodot.shop/v1
Model	gpt-5.5 或控制台可见模型

概念示例：

api_key = "你的 Enodot API Key"
base_url = "https://ai.enodot.shop/v1"
model = "gpt-5.5"

如果你的版本启动后报路径包含 /v1/v1/，把 Base URL 改成：

https://ai.enodot.shop

先用 curl 验证

curl https://ai.enodot.shop/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

再测 Responses：

curl https://ai.enodot.shop/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "只回复 ok"
  }'

这两步成功后，再启动 Codex CLI。这样可以把“Key/模型/地址问题”和“Codex 客户端配置问题”分开排查。

推荐模型

场景	模型
默认编码与代理任务	gpt-5.5
更省额度或快速任务	gpt-5.4-mini

实际可用模型以控制台和 /v1/models 返回为准。

常见问题

401 Unauthorized

API Key 填错、复制时多了空格，或 Key 已失效。重新在控制台复制 Key。

404 Not Found

通常是 Base URL 写错。OpenAI 兼容配置优先使用：

https://ai.enodot.shop/v1

429 或额度不足

当前 Key、用户余额或服务分组额度不足。到控制台查看余额、Key 用量和订阅状态。

502 Bad Gateway

网关收到请求，但上游暂时失败。先重试一次；如果连续失败，把错误里的 request id、模型名和时间发给支持。