如何将Claude Code配置为使用WaveSpeed LLM(OpenAI兼容端点)
五分钟内将Claude Code指向WaveSpeed LLM。通过一个兼容OpenAI的端点使用Claude、GPT、Gemini及290+其他模型——无需Anthropic密钥。
无需 Anthropic 密钥使用 Claude Code
Claude Code 是 Anthropic 官方的 Claude 编程 CLI——但你不必将请求路由至 Anthropic 的 API。如果你已有 WaveSpeed 账户,可以将 Claude Code 指向 WaveSpeed LLM,通过单一 OpenAI 兼容端点访问 Claude Opus 4.6、GPT-5.2、Gemini 3、DeepSeek 以及 290 多个其他模型。
本指南涵盖你所需的确切环境变量、Base URL 和模型 ID 格式。
为何通过 WaveSpeed 路由 Claude Code
- 一个账单,多种模型。 Claude、GPT、Gemini、Llama、Qwen——全部通过你的 WaveSpeed 账户计费。
- OpenAI 兼容,随处可用。 无需分别管理 Anthropic API 密钥、OpenAI 密钥和 Google 密钥。
- 无冷启动。 负载下延迟稳定,与 Anthropic 原生 API 一致。
- 模型可移植性。 只需更改一个环境变量,即可在会话中从 Claude Opus 切换至 GPT-5.2。
所需条件
| 字段 | 值 |
|---|---|
| Base 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” 错误
务必包含 vendor 前缀。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 token,输出 $25/M token。较小模型低于 $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。
