将 Claude API 接入 Windsurf
配置只需几分钟。Windsurf 会通过 Claude API Tech 的 OpenAI 兼容 endpoint 发送请求，用量会显示在控制台中。
W
Windsurf 的前身是 Codeium，它是一款带有 Cascade agent 的 AI IDE。本指南适用于提供 OpenAI Compatible 或 Custom Provider 选项的版本。
Windsurf 官方网站 ↗时间
2 到 3 分钟
Provider
OpenAI Compatible
认证
API 密钥
开始之前
- 创建 Claude API Tech 密钥，或打开现有密钥。
- 如果 Settings 中没有 OpenAI Compatible 或 Custom Provider，请更新 Windsurf。
- 不要把 API 密钥放入代码仓库、项目 settings.json 或公开截图。
配置
1
打开 Settings
macOS 按 Cmd + ,，Windows 和 Linux 按 Ctrl + ,。也可以点击左下角的齿轮图标打开 Settings。
macOS ⌘ ,Windows / Linux Ctrl ,
2
找到 AI provider
在 Settings 中搜索 AI 或 API。打开 provider 区域并选择 OpenAI Compatible。如果没有该选项，请查找包含 Base URL 和 API Key 字段的 Custom Provider。
3
填写 endpoint 和密钥
完整复制下方 Base URL。在 API Key 中粘贴控制台里的密钥。密钥前后存在空格会导致认证失败。
W
OpenAI APIWindsurf 配置值
Windsurf
4
保存并测试
应用设置并完全退出 Windsurf。重新打开后，在任意项目中启动 Cascade 并发送简短测试请求。
替代方式：settings.json
也可以通过 settings.json 文件手动配置 Windsurf：
settings.json
{
"ai.provider": "openai-compatible",
"ai.baseUrl": "https://api.llm-gate.tech/v1",
"ai.apiKey": "sk-cs2-YOUR_API_KEY"
}确认连接
以下三项都通过时，连接即配置完成：
✓
Cascade 返回回答
测试请求完成且没有 provider 错误。
✓
出现 usage
Claude API Tech 控制台中可以看到该请求。
✓
模型可用
响应中没有 unknown model 或 model not found 错误。
连接失败时
| 现象 | 检查内容 |
|---|---|
| 401 或 403 | 重新复制 API 密钥并删除空格。 |
| 404 或 endpoint 错误 | Base URL 必须完全等于 https://api.llm-gate.tech/v1。 |
| Unknown model | 从支持模型列表中选择准确的 ID。 |
| 设置未生效 | 完全退出 Windsurf，然后重新打开。 |
| 没有 Custom Provider | 更新 Windsurf，并确认当前版本或账户是否提供该选项。 |