通过答鸭 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 文件夹中的两个文件,不需要修改桌面应用本身:
.codex/
├─ auth.json # 保存答鸭 API Key
└─ config.toml # 保存答鸭 API 地址、模型和运行参数Windows 用户的目录是 C:\Users\您的用户名\.codex\,macOS / Linux 用户的目录是 ~/.codex/。如果目录还不存在,请先创建它;下面分别说明两个文件的内容。
文件一:auth.json
auth.json 只保存 API Key,内容如下:
{
"OPENAI_API_KEY": "sk-替换为您的API_Key"
}您的 API Key 可在 答鸭控制台 获取。
文件路径为:
- Windows:
C:\Users\您的用户名\.codex\auth.json - macOS / Linux:
~/.codex/auth.json
你也可以在命令行工具通过下面命令创建并打开:
mkdir $env:USERPROFILE\.codex -ErrorAction SilentlyContinue
notepad $env:USERPROFILE\.codex\auth.jsonmkdir -p ~/.codex
nano ~/.codex/auth.json保存后即可。
文件二:config.toml
config.toml 指定答鸭 API 地址、使用的模型名称和 Codex 的运行参数,内容如下:
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文件路径为:
- Windows:
C:\Users\您的用户名\.codex\config.toml - macOS / Linux:
~/.codex/config.toml
如果您想直接打开这个文件编辑,可以使用:
notepad $env:USERPROFILE\.codex\config.tomlnano ~/.codex/config.toml第 3 步:打开 Codex 并选择项目
- 启动刚刚安装的 ChatGPT 桌面应用。
- 如果应用提示选择登录方式,请选择使用 API Key。
- 在应用中进入 Codex。
- 选择或打开您的本地项目文件夹,然后发送第一条任务指令。
Codex 会读取前面配置的 auth.json 和 config.toml,通过答鸭 API 使用配置中的模型。桌面端、CLI 和 IDE 扩展共用这套用户级配置;只使用桌面端也只需要配置这两个文件。
公司、校园网络无法打开下载链接?
本教程提供的 Windows 安装器和 macOS .dmg 都不依赖打开 chatgpt.com。如果 Windows 官方安装器仍无法访问,还可以使用:
- PowerShell:
winget install --id 9PLM9XGG6VKS -s msstore - Windows x64 官方 MSIX
- Windows Arm64 官方 MSIX
MSIX 适合由管理员下载后通过企业软件分发工具部署。若公司网络同时屏蔽了 get.microsoft.com 或 persistent.oaistatic.com,可以联系我们解决。
可选:安装 Codex CLI
只有希望在终端中使用 Codex 时,才需要安装 CLI。先安装 Node.js LTS,再执行:
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- 防火墙是否阻止了连接
- 可尝试执行以下命令测试:
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 桌面端
进阶配置
您可以根据任务需求切换不同模型,只需要修改 config.toml 中的 model 字段即可。
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
