主题
Windsurf
Windsurf（前 Codeium）是 AI 原生 IDE，主打 Cascade Agent 多文件编辑。对第三方 API 支持有限，需要绕一下。
兼容性现状
Windsurf 的 BYOK（Bring Your Own Key）只支持官方原生 key（Anthropic / OpenAI 直连）。要走第三方网关，需要通过「OpenAI Compatible」入口绕一下。
配置方式
入口
Windsurf → 左下角齿轮 → 「Settings」 → 「AI Providers」
方式 A：OpenAI Compatible（推荐，可能可用）
找到 「OpenAI Compatible」 选项，填：
| 字段 | 值 |
|---|---|
| Base URL | https://shuro.vip/v1 |
| API Key | <您的 API Key> |
| Model ID | gpt-5.5 或 claude-opus-4-7 |
注意 model id 格式 —— 部分版本要求带 provider 前缀：
anthropic/claude-opus-4-7
openai/gpt-5.5试一下哪种格式工作。
方式 B：BYOK（只能用官方）
如果你有 Anthropic 官方 key（Max 订阅或 API credit）：
- Settings → 「Provider API Keys」
- 选 「Anthropic」
- 填官方
sk-ant-...
这条不走 Shuro，纯官方。
实测兼容性
待验证（TODO/VERIFY）
以下兼容性结论基于旧平台实测（2026-06），尚未在 Shuro 复测，仅供参考。
| 功能 | 走 Shuro (Compatible) | 走官方 BYOK |
|---|---|---|
| 基础对话 | ⚠️ 看版本 | ✅ |
| Cascade Agent | ⚠️ 部分功能 | ✅ |
| Tool use | ⚠️ 不稳定 | ✅ |
| 长上下文 | ⚠️ 视上游 | ✅ |
Windsurf 的 Cascade 用了 OpenAI-specific 协议字段，第三方网关不一定全转发。
如果 Windsurf + Shuro 不通
不建议硬上，换工具：
| 替代 | 推荐度 | 原因 |
|---|---|---|
| Cursor | ⭐⭐⭐⭐⭐ | 配第三方 API 最完善 |
| Cline | ⭐⭐⭐⭐⭐ | VS Code 插件，配置灵活 |
| Claude Code | ⭐⭐⭐⭐⭐ | CLI 但兼容性最好 |
Cursor 跟 Windsurf 体验最接近，第三方 API 配置成熟。
实际测试步骤
如果你坚持试 Windsurf + Shuro：
- 按上面方式 A 填好
- 新开一个项目
- 在 Cascade 里发简单消息 "say hi"
- 看是否返回
成功 → 配置可用；失败 → 看错误信息：
Invalid model→ 试不同的 model id 格式Authentication failed→ 检查 base_url 是否带/v1- 一直转圈 → 协议兼容性问题，换工具