如何將 Claude Code 配置為使用 WaveSpeed LLM(OpenAI 相容端點)
在五分鐘內將 Claude Code 指向 WaveSpeed LLM。透過單一 OpenAI 相容端點使用 Claude、GPT、Gemini 及 290+ 種其他模型——無需 Anthropic 金鑰。
無需 Anthropic 金鑰使用 Claude Code
Claude Code 是 Anthropic 官方的 CLI 編碼工具——但你不必將請求路由至 Anthropic 的 API。如果你已擁有 WaveSpeed 帳戶,可以將 Claude Code 指向 WaveSpeed LLM,透過單一相容 OpenAI 的端點存取 Claude Opus 4.6、GPT-5.2、Gemini 3、DeepSeek 以及超過 290 個其他模型。
本指南涵蓋你所需的確切環境變數、基礎 URL 及模型 ID 格式。
為何透過 WaveSpeed 路由 Claude Code
- 一份帳單,多種模型。 Claude、GPT、Gemini、Llama、Qwen——全部透過你的 WaveSpeed 帳戶計費。
- OpenAI 相容,隨處可用。 無需分別管理 Anthropic API 金鑰、OpenAI 金鑰和 Google 金鑰。
- 無冷啟動問題。 高負載下延遲穩定,與 Anthropic 原生 API 相同。
- 模型可攜性。 只需更改一個環境變數,即可在同一工作階段中從 Claude Opus 切換至 GPT-5.2。
所需條件
| 欄位 | 值 |
|---|---|
| 基礎 URL | https://llm.wavespeed.ai/v1 |
| API 金鑰 | 你的 WaveSpeed API 金鑰 |
| 協議 | OpenAI Chat Completions |
| 模型 ID 格式 | vendor/model(例如 anthropic/claude-opus-4.6) |
步驟一:安裝 Claude Code
如果尚未安裝:
npm install -g @anthropic-ai/claude-code
步驟二:取得 WaveSpeed API 金鑰
- 登入 wavespeed.ai。
- 開啟儀表板 → API Keys。
- 建立新金鑰並複製。
步驟三:設定 Claude Code 使用 WaveSpeed
Claude Code 支援透過環境變數設定自訂 OpenAI 相容端點。啟動前請設定以下變數:
macOS / Linux
export ANTHROPIC_BASE_URL="https://llm.wavespeed.ai/v1"
export ANTHROPIC_API_KEY="YOUR_WAVESPEED_API_KEY"
export ANTHROPIC_MODEL="anthropic/claude-opus-4.6"
Windows(PowerShell)
$env:ANTHROPIC_BASE_URL = "https://llm.wavespeed.ai/v1"
$env:ANTHROPIC_API_KEY = "YOUR_WAVESPEED_API_KEY"
$env:ANTHROPIC_MODEL = "anthropic/claude-opus-4.6"
若要使設定持久化,請將其加入 ~/.zshrc、~/.bashrc 或 Windows 環境變數中。
步驟四:啟動 Claude Code
claude
Claude Code 將使用你設定的模型,透過 WaveSpeed LLM 路由所有請求。你將看到正常的串流回應——與 Anthropic 原生 API 無任何差異。
在專案中途切換模型
由於超過 290 個模型共用同一端點,切換只需一行修改。開啟新的 shell 並使用不同的模型:
export ANTHROPIC_MODEL="openai/gpt-5.2-pro"
claude
或嘗試開源替代方案:
export ANTHROPIC_MODEL="deepseek/deepseek-v4"
claude
當你想比較不同模型處理同一程式碼庫的方式時非常實用。
Claude Code 推薦模型
並非每個模型都針對代理編碼進行了調優。以下模型效果良好:
| 模型 ID | 最適用場景 |
|---|---|
anthropic/claude-opus-4.6 | 預設——最強的長上下文編碼與工具使用能力 |
anthropic/claude-sonnet-4.6 | 更快、更經濟的 Claude,適合日常任務 |
openai/gpt-5.2-pro | 頂級替代推理效能 |
openai/gpt-5.2-chat | 速度與品質均衡 |
deepseek/deepseek-v4 | 強大的開源程式設計模型,成本最低 |
疑難排解
「Invalid API key」/ 401 錯誤
確保 ANTHROPIC_API_KEY 設定為你的 WaveSpeed 金鑰,而非 Anthropic 金鑰。Claude Code 會將其作為 Bearer Token 發送至 ANTHROPIC_BASE_URL 所指向的端點。
「Model not found」錯誤
務必包含廠商前綴。anthropic/claude-opus-4.6 可正常使用;claude-opus-4.6 則不行。
請求仍路由至 api.anthropic.com
ANTHROPIC_BASE_URL 必須在啟動 claude 的同一 shell 中設定。請使用以下命令確認:
echo $ANTHROPIC_BASE_URL
若為空值,請重新匯出或重新載入 shell 設定檔。
工具使用 / 函數呼叫無法運作
確保你選擇的模型支援工具。anthropic/claude-opus-4.6 和 openai/gpt-5.2-pro 均支援;部分較小型的模型則不支援。
定價
你按所選模型的 WaveSpeed 每 Token 費率付費——不收取額外的 Claude Code 費用。在 wavespeed.ai/llm 比較定價。Claude Opus 4.6 的費率為輸入 $5/M、輸出 $25/M。較小型模型低於 $1/M。
此設定的運作原理
Claude Code 的 ANTHROPIC_BASE_URL 覆蓋功能,是為了讓團隊能透過代理、閘道及企業驗證層進行路由而設計的。WaveSpeed LLM 是一個相容 OpenAI 的閘道,而當 Claude Code 指向此類閘道時,它可以順暢地使用 OpenAI Chat Completions——因此覆蓋設定可完美運作。
立即開始編碼
只需三個環境變數,你就能透過一份帳單在超過 290 個模型上執行 Claude Code。
取得你的 WaveSpeed API 金鑰,在幾分鐘內將 Claude Code 指向 https://llm.wavespeed.ai/v1。
