AI 工具設定
Codex
使用 Felo 自訂模型 provider 設定 Codex CLI。
當你想讓 Codex CLI 使用 Felo API Platform 進行模型呼叫,同時保留原有 Codex 終端機工作流程時,請使用本指南。
開始之前
你需要一個 Felo API Platform key。同一個 key 可用於模型協議、Agent 使用者端、Search、Web Fetch、PPT、Mindmap、LiveDocs、X Search、YouTube Subtitling、Landing Page 和 SuperAgent API。
export FELO_API_KEY="YOUR_API_KEY"建議設定
| 專案 | 值 |
|---|---|
| 最適合 | CLI 編碼工作流程、程式碼審查、repo 修改和非互動式自動化 |
| 協議 | OpenAI-compatible Responses API |
| Base URL | https://openapi.felo.ai/api/v1 |
| 模型範例 | gpt-5.6-sol |
| API key | 你的 FELO_API_KEY |
設定 Codex
先設定環境變數:
export FELO_API_KEY="YOUR_API_KEY"
export OPENAI_API_KEY="$FELO_API_KEY"
export OPENAI_BASE_URL="https://openapi.felo.ai/api/v1"使用者層級 Codex 設定
在使用者層級 Codex 設定檔 ~/.codex/config.toml 中加入 Felo provider。
model_provider = "felo"
model = "gpt-5.6-sol"
[model_providers.felo]
name = "Felo API Platform"
base_url = "https://openapi.felo.ai/api/v1"
env_key = "FELO_API_KEY"
wire_api = "responses"Codex provider 設定應放在使用者層級設定中。不要把 API key 放進專案檔案。
如需做一次非互動式檢查,可以執行:
codex exec --model gpt-5.6-sol "Review this repository and list the main files"驗證設定
儲存設定後,執行一個小任務:
codex --model gpt-5.6-sol如果工具能夠啟動,並使用所選模型回覆,表示 provider 已設定完成。
疑難排解
| 問題 | 檢查專案 |
|---|---|
| 認證失敗 | 確認 key 已正確複製,並已匯出為 FELO_API_KEY |
| 工具呼叫了錯誤的 provider | 檢查目前 workspace 或 session 是否已選擇 Felo provider |
| Base URL 錯誤 | OpenAI-compatible 使用者端使用 https://openapi.felo.ai/api/v1,Anthropic-compatible 使用者端使用 https://openapi.felo.ai/api |
| 找不到模型 | 選擇一個出現在 Felo 模型列表中的模型 |
| 工具忽略本機設定 | 如果使用者端要求使用者層級設定,請把 provider 設定移到使用者層級設定中 |