U9 AI · DOCUMENTATION

Codex 接入指南

使用独立 profile 配置 Responses API，保留原有默认服务商。

使用前提#

安装官方 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。

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

export U9AI_API_KEY="YOUR_U9AI_API_KEY"
codex --profile u9ai

$env:U9AI_API_KEY = "YOUR_U9AI_API_KEY"
codex --profile u9ai

新旧版本差异#

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

验收与恢复原配置#

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

下载完整接入 MD及 AGENTS.md 项目指令模板，合并到已有规则，不要直接覆盖。

官方高级配置 · 官方配置参考。本页于 2026-10-24 核对官方文档，升级后应再次检查版本差异。