設定模型供應商
推薦使用 CC Switch 完成設定 —— 一款開源的供應商管理工具，視覺化操作，無需手動編輯 JSON 或環境變數。
1. 安裝 CC Switch
macOS
brew install --cask cc-switch或前往 Releases 下載 .dmg 手動安裝。
Windows
前往 Releases 下載 .msi 安裝程式。
Linux
# Debian / Ubuntu
sudo dpkg -i CC-Switch-*.deb
# Fedora / RHEL
sudo rpm -i CC-Switch-*.rpm
# AppImage
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage支援 macOS 12+、Windows 10+、Ubuntu 22.04+ / Debian 11+ / Fedora 34+
2. 新增 OfoxAI 供應商
步驟一：新增供應商
切換到頂部 Codex 標籤頁，點擊右上角 + 按鈕。
步驟二：填寫設定
按下表填寫，點擊 + 新增 完成。
| 設定項 | 值 | 說明 |
|---|---|---|
| ❶ 供應商名稱 | ofoxai-codex | 自訂，方便識別 |
| ❷ 官網連結 | https://ofox.ai | 供應商官網 |
| ❸ API Key | 你的 OfoxAI API Key | 在 app.ofox.ai 取得 |
| ❹ 請求位址 | https://api.ofox.ai/v1 | 末尾不要加斜線 |
| ❺ API 格式 | OpenAI Compatible | 選擇 OpenAI 相容格式 |
| ❻ 寫入通用設定 | ✅ 勾選 | 寫入全域設定，所有專案生效 |
CC Switch 自動寫入設定檔，無需手動編輯任何檔案。
步驟三：啟用供應商
添加完成後回到列表，選中 ofoxai-codex，點擊使用按鈕。確認 寫入通用配置 已勾選，配置會自動寫入 config.toml。
3. 驗證設定
codex "hello"
正常返回 AI 回應即表示設定成功。
4. 指定模型
codex --model <model-id> "重構這個函式"Codex CLI 使用 OpenAI Responses API（wire_api = "responses"），並非所有模型都支援此格式。選擇模型時，請在 OfoxAI 模型廣場 確認該模型支援 Responses 協議，否則會報錯。
推薦模型請參考 OfoxAI 模型廣場 。
故障排除
Q: 提示 “Authentication error”
確認 API Key 已正確填寫，並檢查請求位址末尾無斜線。
Q: 連線逾時
確認請求位址為 https://api.ofox.ai/v1，末尾不帶斜線。
Last updated on