Codex Desktop 接入第三方 API 快速教程：配置 responses 接口

Codex Desktop 会读取用户目录下的 .codex 配置。只要写好 auth.json 和 config.toml，就可以让桌面端通过 NixAPI 调用 OpenAI 兼容模型。

这篇教程适合已经安装好 Codex Desktop 的用户。全程不需要改代码，只需要创建两个配置文件并重启应用。

---

准备工作

你需要：

1. 已安装 Codex Desktop
2. 一个 NixAPI API Key
3. 能编辑用户目录下隐藏文件的权限

如果还没有 Key，先进入 NixAPI 控制台 创建。NixAPI 当前有限时充值兑换率：￥0.80 = $1.00，做代码类长上下文任务前可以先检查余额。

---

第一步：找到 .codex 配置目录

Codex Desktop 使用和 Codex CLI 相同的用户级配置目录：

• Windows：C:\Users\你的用户名\.codex\
• macOS：~/.codex/

如果看不到 .codex：

• Windows：在文件资源管理器中开启「显示隐藏的项目」
• macOS：在 Finder 中按 Command + Shift + . 显示隐藏文件

如果目录不存在，可以手动创建。macOS 也可以用终端：

mkdir -p ~/.codex
touch ~/.codex/auth.json ~/.codex/config.toml

Windows 用户创建文件时要特别注意扩展名，避免变成 auth.json.txt。

---

第二步：写入 auth.json

打开 .codex/auth.json，写入：

{
  "OPENAI_API_KEY": "nix-your-api-key"
}

把 nix-your-api-key 替换为你的真实 NixAPI API Key。Key 前后不要带空格。

---

第三步：写入 config.toml

打开 .codex/config.toml，写入：

model = "gpt-5.4"
model_provider = "nixapi"
model_reasoning_effort = "medium"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.nixapi]
name = "NixAPI"
base_url = "https://nixapi.com/v1"
wire_api = "responses"
requires_openai_auth = true

这里有两个字段最关键：

• base_url 必须是 https://nixapi.com/v1
• wire_api 必须是 responses

Codex Desktop 使用 responses 协议。如果把 wire_api 写成 chat，或者漏掉 /v1，很容易出现 404、unknown endpoint 或空响应。

model 可以换成其他模型，例如：

• gpt-5.4
• claude-sonnet-4-20250514
• claude-opus-4-7
• gemini-3-pro-preview
• deepseek-v4

实际可用模型请以 NixAPI 支持的模型列表页 为准。

---

第四步：重启 Codex Desktop

保存两个文件后，完全退出 Codex Desktop：

• macOS：使用 Command + Q
• Windows：确认托盘中的 Codex Desktop 也已退出

重新打开应用，发送一句简单测试：

你好，请说明你当前可以如何帮助我写代码。

如果能正常回复，说明 Codex Desktop 已经接入 NixAPI。

---

常见问题

1. 应用仍然要求登录官方账号

通常是配置文件没有被读取。检查路径、文件名和扩展名，尤其是 Windows 上的 .json.txt 问题。

2. 报 404 或 Unknown endpoint

检查 config.toml 中是否同时满足：

base_url = "https://nixapi.com/v1"
wire_api = "responses"

这两个字段任何一个写错，都可能导致接口不匹配。

3. 提示模型不存在

模型 ID 拼写不准确。打开 NixAPI 模型价格页 复制模型名，再更新 model 字段。

4. Windows 沙盒权限报错

如果 Codex Desktop 在执行命令时持续提示权限不足，可以在 config.toml 追加：

[windows]
sandbox = "elevated"

保存后完全重启应用。

5. 改完配置没有生效

关掉窗口不一定等于退出应用。确认后台进程、托盘或 Dock 中没有继续运行，再重新打开。

---

小结

Codex Desktop 接入 NixAPI 的核心配置是 auth.json 中的 OPENAI_API_KEY，以及 config.toml 中的 base_url = "https://nixapi.com/v1" 和 wire_api = "responses"。配置完成后，你可以按任务类型切换模型，把桌面端代码助手接入统一的 NixAPI 模型入口。