获取 Ace Data Cloud API Key
- 打开 控制台 → 应用列表，完成登录。
- 按计费方式选择应用：使用 Coding Plan 时进入 Coding Application；按量使用时选择有对应服务权限的通用/服务应用。Coding 套餐与通用余额分别管理。
- 复制该应用的 API Key / API Token，不要复制 Application ID 或
platform-管理 Token。下文 API Key 字段只填写密钥本身，不含Bearer前缀。 - 确认应用有效且有额度。活动和免费额度以控制台实时显示为准。
$env:ACEDATACLOUD_API_KEY = "YOUR_ACEDATACLOUD_API_KEY"；使用 Windows 自带 curl 时写 curl.exe。/v1/models 是模型发现入口，目录中出现某个模型不等于当前 Key 有对应 API 权限。还要核对所选协议、应用范围和客户端能力。
下文 MODEL_ID 必须替换为具体模型 ID。不要把真实 Key 提交到 Git、贴进日志或截图。
安装与环境
按 官方 CLI 安装文档 安装。例如：ACEDATACLOUD_API_KEY。Windows 使用 PowerShell 的 $env:ACEDATACLOUD_API_KEY；需要 WSL 时在 WSL 内独立安装、配置。
用户级 Provider 配置
编辑~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml），合并：
/v1/responses。不要配置成 Chat Completions；也不要在 Base URL 后重复添加 /responses。自定义 Provider 要放在用户级配置，项目级配置不能替代它。
env_key 指定本例的凭据来源；不要同时向同一 Provider 拼入 CC Switch 的 requires_openai_auth = true 配置。已有 ChatGPT 登录可以保留，不需要删除整个 auth.json。如果使用 CC Switch，按它的独立教程统一管理 Provider 与密钥。
首次验证
在测试目录运行codex，确认模型是 gpt-5.4-mini，再完成下方任务。
已安装 CLI 时，可在可信测试仓库用以下命令分离 API 配置问题与 IDE 问题：
< /dev/null 是 Bash/zsh 示例，避免 CLI 等待标准输入；PowerShell 可直接执行前面的命令。此测试不应使用生产项目或跳过所有权限检查。
实战与验收
先新建一个测试目录，在fixture.txt 写入 hello from Ace Data Cloud，然后让客户端执行：
读取 fixture.txt，逐字引用其内容并解释文件用途。不要修改任何文件。检查是否真的读取文件、是否引用正确内容；然后到 平台使用历史 按时间核对请求。对不支持文件工具的聊天模式，先附加该文件，再提同样的问题。不要用一次简单聊天成功推断编辑、图片、工具、自动补全全部可用。