U9 AI · DOCUMENTATION

Codex 串接指南

使用獨立 profile 設定 Responses API，保留原有預設供應商。

使用前提#

安裝官方 Codex CLI，先執行 codex --version。模型必須實際支援 Responses API、串流與工具呼叫；僅支援 Chat Completions 或名稱包含 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] 表。舊版規則不同，請升級或依對應版本官方文件調整。專案 AGENTS.md 僅提供開發指示，不會設定供應商或金鑰。目前 Codex 會忽略專案 .codex/config.toml 中的供應商驗證覆寫，請將此 profile 放在使用者目錄。

驗收與恢復#

先依快速開始驗證唯讀 /models 查詢，再以可用的 Responses 模型在空測試目錄發送短問題。串流與完整工具呼叫往返通過後，再用於日常開發。檢查請求紀錄與消費，測試可能扣款。不帶 --profile u9ai 啟動 codex 即使用原預設設定；若供應商不符，請檢查專案或命令列覆寫設定。

下載完整串接 MD與 AGENTS.md 專案指示範本，合併到既有規則，請勿直接覆寫。

官方進階設定 · 官方設定參考。本頁於 2026-10-24 核對官方文件，升級後應再次確認版本差異。