Skip to content

通过答鸭 API 使用 Codex 桌面端

Codex 是 OpenAI 推出的智能工作助手,除了编程、读取项目、修改代码和运行命令,也可以协助整理资料、撰写文档、分析数据和处理日常工作。接入答鸭 API 后,您可以在 Codex 中使用答鸭提供的模型。

本教程以大多数用户使用的 Codex 桌面端为主。Codex CLI 不是必需组件;如果您习惯在终端工作,可以在文末按需安装。

3 步快速开始

第 1 步:下载并安装 Codex 桌面端

Codex 桌面端包含在 OpenAI 的 ChatGPT 桌面应用中。根据您的系统打开下面的官方安装包:

Windows

请在浏览器中打开下面的地址,下载并运行官方安装程序:

https://get.microsoft.com/installer/download/9PLM9XGG6VKS?cid=website_cta_psi

该链接由 OpenAI 官方文档提供,通过 Microsoft 的安装服务获取最新版应用。安装时按页面提示完成即可,不需要先打开 Microsoft Store。

macOS

请打开下面的 OpenAI 官方直链下载 .dmg 安装包:

https://persistent.oaistatic.com/codex-app-prod/ChatGPT.dmg

下载完成后打开 ChatGPT.dmg,将应用拖入“应用程序”文件夹,再从“应用程序”中启动。

Linux

Linux 桌面端目前为预览支持,请根据发行版参考官方 Linux 安装指南

第 2 步:配置答鸭 API,接入 Codex

接入答鸭 API 只需要配置 .codex 文件夹中的两个文件,不需要修改桌面应用本身:

text
.codex/
├─ auth.json       # 保存答鸭 API Key
└─ config.toml     # 保存答鸭 API 地址、模型和运行参数

Windows 用户的目录是 C:\Users\您的用户名\.codex\,macOS / Linux 用户的目录是 ~/.codex/。如果目录还不存在,请先创建它;下面分别说明两个文件的内容。

文件一:auth.json

auth.json 只保存 API Key,内容如下:

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

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

文件路径为:

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

你也可以在命令行工具通过下面命令创建并打开:

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

保存后即可。

文件二:config.toml

config.toml 指定答鸭 API 地址、使用的模型名称和 Codex 的运行参数,内容如下:

toml
model_provider = "dayaai"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

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

文件路径为:

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

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

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

第 3 步:打开 Codex 并选择项目

  1. 启动刚刚安装的 ChatGPT 桌面应用。
  2. 如果应用提示选择登录方式,请选择使用 API Key
  3. 在应用中进入 Codex
  4. 选择或打开您的本地项目文件夹,然后发送第一条任务指令。

Codex 会读取前面配置的 auth.jsonconfig.toml,通过答鸭 API 使用配置中的模型。桌面端、CLI 和 IDE 扩展共用这套用户级配置;只使用桌面端也只需要配置这两个文件。

公司、校园网络无法打开下载链接?

本教程提供的 Windows 安装器和 macOS .dmg 都不依赖打开 chatgpt.com。如果 Windows 官方安装器仍无法访问,还可以使用:

MSIX 适合由管理员下载后通过企业软件分发工具部署。若公司网络同时屏蔽了 get.microsoft.compersistent.oaistatic.com,可以联系我们解决。

可选:安装 Codex CLI

只有希望在终端中使用 Codex 时,才需要安装 CLI。先安装 Node.js LTS,再执行:

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

安装后进入项目目录运行 codex。CLI 与桌面端共用前面创建的配置文件,无需再次配置 API Key。

如果已经安装 CLI,也可以运行 codex app 打开桌面应用。

支持的模型

您可以修改 config.toml 中的 model 字段,切换为答鸭 API 支持的其他模型,支持 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 格式是否正确
  • 保存后是否完全退出并重新打开了 Codex 桌面端
修改配置后不生效

请检查:

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

请检查:

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

进阶配置

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

toml
model_provider = "dayaai"                 # 使用下方自定义的 dayaai 提供方。
model = "gpt-5.6-sol"        # 普通任务默认使用的模型。
review_model = "gpt-5.6-sol" # 代码审查任务默认使用的模型。
model_reasoning_effort = "xhigh"          # 默认的推理强度,推荐使用xhigh,兼顾回答质量与速度

# 隐私与运行行为。
disable_response_storage = true            # 服务端不存储模型响应。
network_access = "enabled"                 # 允许 Codex 使用网络。
personality = "pragmatic"                  # 偏向简洁、实用的回答风格。

# 上下文窗口与自动压缩。
model_context_window = 1000000             # 声明的模型上下文窗口大小。需匹配模型能力,否则会经常出现429错误。
model_auto_compact_token_limit = 900000    # 接近该 token 数时自动压缩上下文。

# 命令执行权限。
approval_policy = "never"                  # 执行命令前不再询问确认。
sandbox_mode = "danger-full-access"        # 不使用文件系统沙箱限制。

# 自定义模型提供方。
[model_providers.dayaai]
name = "dayaai"                               # 提供方显示名称。
base_url = "https://api-us.dayaai.com/v1"     # 如果网络环境允许,建议使用此直连端点
# base_url = "https://api.dayaai.com/v1"      # 提供方默认的 API 基础地址。
wire_api = "responses"                        # 使用 Responses API 通信格式。
requires_openai_auth = true                   # 需要打开才会继承 auth.json 鉴权认证。

联系我们

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

  • 客户交流群:强烈建议您在 dayaai.com 首页扫码加入群聊,及时反馈问题与沟通。
  • 客服微信:dayaai_com
  • 技术支持邮箱cs@dayaai.com