Skip to content

Codex Desktop

Codex Desktop 和 Codex CLI 一样,推荐走 OpenAI Responses API。生产地址是:

text
https://ai.enodot.shop

OpenAI 兼容 Base URL 通常填写:

text
https://ai.enodot.shop/v1

Codex Desktop 设置示意图

配置步骤

  1. 打开 Codex Desktop。
  2. 进入 Settings / Provider / Model Provider。
  3. 选择 OpenAI Compatible 或 Custom OpenAI。
  4. API Key 填写你的 Enodot API Key。
  5. Base URL 填写 https://ai.enodot.shop/v1
  6. Model 填写 gpt-5.5,或填写控制台可见的 OpenAI 模型。
  7. 保存后新建一个对话,发送 只回复 ok 测试。

如果客户端有单独的 Responses API 开关,请保持开启。Codex 类工具更适合 Responses API,而不是传统 Chat Completions。

配置项对照

Codex Desktop 字段应填内容
ProviderOpenAI Compatible / Custom OpenAI
API Key你的 Enodot API Key
Base URLhttps://ai.enodot.shop/v1
Modelgpt-5.5

自测请求

如果 Desktop 内报错,先用终端验证同一个 Key:

bash
export ENODOT_API_KEY="你的 Enodot API Key"

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

curl 成功但 Desktop 失败,优先检查 Desktop 的 Base URL 是否被自动追加了 /v1

旧对话记录

更换提供商通常不会删除本机旧对话。切换前建议先看 Codex 旧对话迁移,备份本机数据目录后再改 Provider。

常见问题

模型列表为空

先确认 Key 绑定的分组支持 OpenAI 协议或默认聚合路由。再用 /v1/models 测试 Key 是否能列出模型。

能列模型但不能发消息

模型可能不支持当前端点,或 Desktop 实际发的是 Chat Completions。优先选择支持 Responses 的模型,例如 gpt-5.5

请求一直重连

复制最后一次错误里的 request id、模型名、请求时间。用户侧先换一个新对话或稍后重试;如果持续出现,需要支持侧按 request id 查上游错误。

Enodot 提供 AI API 接入管理与开发者网关服务。