# Codex 串接指南

## 使用前提

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

```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] 表。舊版規則不同，請升級或依對應版本官方文件調整。專案 AGENTS.md 僅提供開發指示，不會設定供應商或金鑰。目前 Codex 會忽略專案 .codex/config.toml 中的供應商驗證覆寫，請將此 profile 放在使用者目錄。

## 驗收與恢復

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

下載[完整串接 MD](/zh-TW/docs/codex.md)與 [AGENTS.md 專案指示範本](/zh-TW/docs/AGENTS.md)，合併到既有規則，請勿直接覆寫。

[官方進階設定](https://learn.chatgpt.com/docs/config-file/config-advanced) · [官方設定參考](https://developers.openai.com/codex/config-reference/)。本頁於 2026-10-24 核對官方文件，升級後應再次確認版本差異。