# Codex 接入指南

## 使用前提

安装官方 Codex CLI，先执行 codex --version。模型必须实际支持 Responses API、流式输出和工具调用；仅支持 Chat Completions 不足以证明能用于 Codex，名称里包含 codex 也不能代替协议验证。下面已预留对接配置，实际供应商的完整行为仍需验收。

## 创建独立 profile

Codex 0.134.0 及以上版本，将下方 TOML 保存为 ~/.codex/u9ai.config.toml；Windows 默认位置是 %USERPROFILE%\.codex\u9ai.config.toml。在本机替换模型占位符，并在终端设置密钥环境变量。不要覆盖原有 config.toml 或 auth.json。

```toml
model = "YOUR_RESPONSES_MODEL_ID"
model_provider = "u9ai"

[model_providers.u9ai]
name = "U9 AI"
base_url = "https://u9ai.ai/v1"
env_key = "U9AI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
```

```bash
export U9AI_API_KEY="YOUR_U9AI_API_KEY"
codex --profile u9ai
```

```powershell
$env:U9AI_API_KEY = "YOUR_U9AI_API_KEY"
codex --profile u9ai
```
## 新旧版本差异

当前新版使用独立 profile 文件，配置写在顶层，不再读取 config.toml 中旧的 [profiles.u9ai] 表。旧版 profile 规则不同，请升级或按对应版本的官方文档调整。项目里的 AGENTS.md 只是开发指令，不会配置服务商或密钥。当前 Codex 会忽略项目 .codex/config.toml 中的服务商认证覆盖，因此这个 profile 应放在用户目录。

## 验收与恢复原配置

先按[快速开始](/zh-CN/docs/quickstart)验证只读 /models 查询，再使用可用的 Responses 模型，在空测试目录发送短问题。流式输出及完整工具调用往返通过后，再用于日常开发。检查请求记录和消费，测试可能扣费。不带 --profile u9ai 启动 codex 即使用原默认配置；如果实际服务商不符，还需检查项目或命令行覆盖设置。

下载[完整接入 MD](/zh-CN/docs/codex.md)及 [AGENTS.md 项目指令模板](/zh-CN/docs/AGENTS.md)，合并到已有规则，不要直接覆盖。

[官方高级配置](https://learn.chatgpt.com/docs/config-file/config-advanced) · [官方配置参考](https://developers.openai.com/codex/config-reference/)。本页于 2026-10-24 核对官方文档，升级后应再次检查版本差异。