Codex 使用哪个配置文件？

推荐使用 ~/.codex/config.toml 配置 WaveSpeed AI。该配置会将 Codex 指向 endpoint /v1/responses。

Codex 应该使用哪个协议？

Codex 应该使用 OpenAI Responses API。本页使用 endpoint /v1/responses 与该协议匹配。

如何确认 Codex 已经接入成功？

在本地运行 Codex 后打开 WaveSpeed Logs。成功的请求会带着所选模型和用量信息出现在 Logs 中。

Agent 設定

將 Codex 接入 WaveSpeed LLM API

複製推薦的 ~/.codex/config.toml 設定，將 Codex 請求路由到 /v1/responses，並在 WaveSpeed Logs 中驗證本機 agent 呼叫。

API Key 測試模型

設定檔

~/.codex/config.toml

協定

OpenAI Responses API

Endpoint

/v1/responses

快速開始

建立 WaveSpeed Access Key

在本機匯出所需金鑰

將設定貼到~/.codex/config.toml

執行 codex --profile wavespeed 並查看 Logs

模型

OpenAI 相容 Chat Completions

用量會顯示在 Dashboard 和 Logs 中

不用改 Agent 程式碼即可切換模型

編輯 ~/.codex/config.toml

# File: ~/.codex/config.toml

model = "anthropic/claude-opus-4.8"
model_provider = "wavespeed"

[model_providers.wavespeed]
name = "WaveSpeed AI"
base_url = "https://llm.wavespeed.ai/v1"
env_key = "WAVESPEED_API_KEY"
wire_api = "responses"

快速開始

建立 WaveSpeed Access Key

在本機匯出所需金鑰

將設定貼到~/.codex/config.toml

執行 codex --profile wavespeed 並查看 Logs

環境變數

export WAVESPEED_API_KEY="sk-..."

設定完成後

查看用量 Dashboard 查看請求 Logs 瀏覽模型

Agent 接入指南

将 Codex 接入 WaveSpeed LLM API

本指南說明如何透過 ~/.codex/config.toml、OpenAI Responses API、/v1/responses、base URL https://llm.wavespeed.ai/v1 和預設模型 anthropic/claude-opus-4.8 將 Codex 接入 WaveSpeed AI。複製上方設定，匯出 API key，執行 agent，然後在 Logs 中驗證請求。

建立 WaveSpeed Access Key

在本機匯出所需金鑰

將設定貼到

~/.codex/config.toml

執行 codex --profile wavespeed 並查看 Logs

這個 Codex 設定會配置什麼

協定

OpenAI Responses API

Endpoint

/v1/responses

模型

anthropic/claude-opus-4.8

上方可複製設定就是推薦方案下唯一需要編輯的 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 設定流程的使用者。

查看全部 Agent 接入指南瀏覽模型