Agent 接入指南
將 Codex 接入 WaveSpeed LLM API
本指南說明如何透過 ~/.codex/config.toml、OpenAI Responses API、/v1/responses、base URL https://llm.wavespeed.ai/v1 和預設模型 deepseek/deepseek-v4-flash 將 Codex 接入 WaveSpeed AI。複製上方設定,匯出 API key,執行 agent,然後在 Logs 中驗證請求。
建立 WaveSpeed Access Key
在本機匯出所需金鑰
將設定貼到
~/.codex/config.toml執行 codex 並查看 Logs
這個 Codex 設定會配置什麼
協定
OpenAI Responses API
Endpoint
/v1/responses
模型
deepseek/deepseek-v4-flash
上方可複製設定就是推薦方案下唯一需要編輯的 Codex 檔案:~/.codex/config.toml。API key 建議保留在 shell 環境變數中,避免提交到程式碼倉庫。
常見問題排查
API key 沒有生效
請在運行 Codex 的同一個 shell 中導出 WAVESPEED_API_KEY。如果寫入 shell profile,需要重新加載終端後再啟動 agent。
請求出現協議或 endpoint 錯誤
確認 Codex 使用的是 OpenAI Responses API 和 endpoint /v1/responses。協議不匹配是 404 或 payload 錯誤最常見的原因。
選擇的模型不可用
先確認模型 ID 存在於 WaveSpeed Models,再將完整 ID 粘貼到 ~/.codex/config.toml。也可以先使用本頁展示的默認模型。
Logs 中沒有請求記錄
確認 Codex 使用的是 WaveSpeed base URL 和當前 API key。然後從本地 agent 發送一個新 prompt,並刷新 Logs。
這個 Codex 指南可以被搜尋到嗎?
可以。這個頁面設計成可索引的接入指南,用來承接搜尋 Codex custom provider、OpenAI-compatible endpoint、base URL 和本機 agent 設定流程的使用者。