切换主题
Codex App
Codex 包含桌面端、CLI 和 IDE 扩展等本地使用方式。它们共享 Codex 的用户级配置层，因此可以先在 CLI 中验证本站 Provider，再在桌面端打开同一项目。
- Codex 入口：https://chatgpt.com/codex
- Codex App 文档：https://learn.chatgpt.com/docs/app
- Codex CLI 文档：https://learn.chatgpt.com/docs/codex/cli
- 配置文档：https://learn.chatgpt.com/docs/config-file/config-basic
推荐路线
先完成 Codex CLI 的最小验证，再让 Codex App 复用同一份 ~/.codex/config.toml。这样更容易区分模型、认证和桌面端环境变量问题。
平台与配置目录
| 环境与配置目录 | 说明 |
|---|---|
macOS / Linux / WSL：~/.codex | CLI、IDE 扩展和桌面端本地任务共享用户配置层 |
Windows 原生：%USERPROFILE%\.codex | 与 WSL 内的 ~/.codex 是两套独立目录 |
Windows 原生桌面端和 WSL CLI 不会自动共享配置。你在哪个环境运行 Codex，就在对应环境中配置。
配置本站 Provider
编辑用户级 ~/.codex/config.toml：
toml
model = "your-model-id"
model_provider = "dddai"
[model_providers.dddai]
name = "DDD AI"
base_url = "https://dddai.dev/v1"
env_key = "DDDAI_API_KEY"
wire_api = "responses"把 your-model-id 替换为当前账号和 API Key 实际可用、且支持 Responses API 的模型 ID。
配置位置
Provider、认证和 Base URL 应写在用户级 ~/.codex/config.toml。Codex 会忽略项目级 .codex/config.toml 中用于重定向 Provider 或认证的设置，这也是为了避免不受信任仓库偷偷改写请求目标。
提供 API Key
macOS / Linux / WSL
bash
export DDDAI_API_KEY="sk-your-api-key"Windows PowerShell
powershell
$env:DDDAI_API_KEY = "sk-your-api-key"不要把 API Key 直接写入 config.toml、项目仓库或脚本。Codex 会根据 env_key 从进程环境读取密钥。
先用 CLI 验证
bash
codex --version
codex进入一个非关键测试项目，先执行只读任务，例如：
text
总结这个目录的结构，不要修改文件。确认请求成功后，到 使用日志 核对模型、API Key 和消耗。
在桌面端使用
- 在 Codex App 中打开 Settings > Configuration > Open config.toml，确认读取的是同一份用户配置。
- 确保桌面端进程能够读取
DDDAI_API_KEY。第一次验证可从已设置变量的终端启动 Codex App。 - 打开一个非关键测试项目，先运行只读任务。
- 确认模型响应和使用日志正常后，再允许编辑或命令执行。
权限与安全建议
- 保留 Codex 默认沙箱和审批设置，先不要为了接入模型而放宽文件、命令或网络权限。
- 第一次测试使用非敏感仓库，不要把生产密钥、客户数据或私有凭据交给新 Provider 验证。
- Provider 配置放在用户级，项目内只保留与仓库行为相关的
.codex/config.toml。 - 当前模型不支持 Responses API 或工具调用时，换用正常授权的兼容模型，不要尝试绕过接口限制。
常见问题
CLI 成功，桌面端认证失败
桌面端进程可能没有读取到 DDDAI_API_KEY。从设置过变量的终端启动，或使用系统级安全凭据方式提供变量。
配置后仍然使用默认 Provider
确认 model_provider = "dddai" 位于用户级配置文件，并完全重启 Codex。
返回 404 或 Responses 相关错误
确认 Base URL 为 https://dddai.dev/v1，并选择支持 Responses API 的模型。也可以先在 Responses 格式 页面验证接口。