Skip to content

通过答鸭 API 使用 Codex CLI

Codex CLI 是 OpenAI 推出的开源编程助手工具,可以在本地终端中读取、修改和运行代码。
接入答鸭 API 后,您可以使用答鸭提供的模型,而不仅限于 OpenAI 官方 API。

3 步快速开始

第 1 步:安装 Codex CLI

先安装 Node.js LTS,安装完成后重新打开终端,再执行:

bash
npm install -g @openai/codex --registry=https://registry.npmmirror.com

安装完成后,检查是否成功:

bash
codex --version

如果能看到版本号,就表示安装成功。

Windows 提示找不到 codex

请先关闭并重新打开 PowerShell。
如果仍然无效,请检查 npm 全局安装目录是否已加入 PATH

第 2 步:创建 auth.json

这一步只需要做一件事:创建一个文件,填入您的 API Key。

请在下面位置创建文件:

  • WindowsC:\Users\您的用户名\.codex\auth.json
  • macOS / Linux~/.codex/auth.json

文件内容如下:

json
{
  "OPENAI_API_KEY": "sk-替换为您的API_Key"
}

您的 API Key 可在 答鸭控制台 获取。

如果您不方便手动创建文件,也可以直接用下面命令打开编辑:

powershell
mkdir $env:USERPROFILE\.codex -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.codex\auth.json
bash
mkdir -p ~/.codex
nano ~/.codex/auth.json

保存后即可。

第 3 步:创建 config.toml

这一步只需要再做一件事:创建第二个文件,填入连接答鸭 API 的配置。

请在下面位置创建文件:

  • WindowsC:\Users\您的用户名\.codex\config.toml
  • macOS / Linux~/.codex/config.toml

文件内容如下:

toml
model_provider = "dayaai"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"

[model_providers.dayaai]
name = "dayaai"
base_url = "https://api.dayaai.com/v1"
wire_api = "responses"
requires_openai_auth = false

如果您想直接打开这个文件编辑,可以使用:

powershell
notepad $env:USERPROFILE\.codex\config.toml
bash
nano ~/.codex/config.toml

实际上只需要这两个文件

这两个文件都放在 .codex 文件夹中:

text
.codex/
├─ auth.json
└─ config.toml
  • auth.json:保存 API Key
  • config.toml:保存连接配置

也就是说,配置 Codex CLI 的过程,本质上就是:创建这两个文件,并填入对应内容。

开始使用

配置完成后,进入您的项目目录,运行:

powershell
cd D:\my-project
codex
bash
cd ~/my-project
codex

后续使用时,只要直接输入 codex 即可,无需重复设置 API Key。

支持的模型

您可以修改 config.toml 中的 model 字段,切换为答鸭 API 支持的其他模型,例如:

toml
model = "gpt-5.5"

支持 Responses 协议的模型列表请查看:

故障排除

API Key 无效或未授权

请检查:

  • auth.json 是否放在正确位置
  • 文件内容是否为合法 JSON
  • 键名是否写成 "OPENAI_API_KEY"
  • API Key 是否已激活
  • API Key 是否填写完整
无法连接到答鸭 API

请检查:

  • 网络是否正常
  • config.toml 中的 base_url 是否为 https://api.dayaai.com/v1
  • 防火墙是否阻止了连接
  • 可尝试执行以下命令测试:
bash
curl https://api.dayaai.com/v1/models
已填写 API Key,但仍提示未配置

请检查:

  • auth.json 路径是否正确
  • Windows 路径应为:C:\Users\您的用户名\.codex\auth.json
  • macOS / Linux 路径应为:~/.codex/auth.json
  • JSON 格式是否正确
  • 保存后是否重新打开了终端
修改配置后不生效

请检查:

  • config.toml 路径是否正确
  • Windows 路径应为:C:\Users\您的用户名\.codex\config.toml
  • macOS / Linux 路径应为:~/.codex/config.toml
  • TOML 格式是否正确
  • 保存后是否重新打开了终端
模型不可用

请检查:

  • 模型名称是否拼写正确
  • 当前模型是否支持 Responses 协议
  • 账户是否有权限访问该模型
  • 可在 答鸭模型列表 中确认

进阶配置

您可以根据任务需求切换不同模型,只需要修改 config.toml 中的 model 字段即可。

toml
model_provider = "dayaai"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"

[model_providers.dayaai]
name = "dayaai"
base_url = "https://api.dayaai.com/v1"
wire_api = "responses"
requires_openai_auth = false
toml
model_provider = "dayaai"
model = "gpt-5.4-mini"
model_reasoning_effort = "xhigh"

[model_providers.dayaai]
name = "dayaai"
base_url = "https://api.dayaai.com/v1"
wire_api = "responses"
requires_openai_auth = false

联系我们

如果您在安装或使用过程中遇到问题,欢迎随时联系我们。

  • 客服微信:dayaai_com
  • 客户交流群:添加客服微信后拉群,或在 dayaai.com 首页扫码加入
  • 技术支持邮箱cs@dayaai.com