开始之前
准备 Base URL、API Key 和实时模型 ID。教程中出现的具体模型名只作为格式示例，使用前请到模型目录确认。
Base URL
https://api.zhumeng.email/v1API Key
sk-relay-你的密钥模型 ID
your-model-id配置步骤
共 5 步- 1
打开 Windsurf 设置
快捷键 Cmd/Ctrl + , 打开 Settings 面板。 左侧选择 "Cascade"（或顶部搜索 "Provider"）。
- 2
添加自定义模型 Provider
在 "Model Provider" 区域点击 "Add custom provider" 或 "Manage providers"，选择 "OpenAI Compatible"。
Windsurf 不同版本（稳定版 / Next）的菜单位置略有差异；找不到就用 Cmd/Ctrl + Shift + P 搜索 "Add Model Provider"。
- 3
填写 Provider 信息
在弹出的表单里逐项填入。
textProvider Name: Relay Base URL: https://api.zhumeng.email/v1 API Key: sk-relay-你的密钥 - 4
勾选要使用的模型
保存 provider 后，Windsurf 会调一次 /v1/models 拉取你这个 Key 能用的模型列表。 勾选 gpt-5.5 / claude-opus-4-8 等需要的模型。
若列表为空，说明 Base URL 或 API Key 配置错；可在浏览器访问 https://api.zhumeng.email/v1/models 验证 Key 是否生效。
- 5
在 Cascade 里切换模型
回到主界面，右下角 Cascade 输入框上方的模型下拉选择 Relay 提供的模型，开始对话。 Write / Chat / Legacy 三种模式都支持。
验证接入
成功标准
在 Cascade 里输入 "用 Python 写一个 fibonacci 函数"，能流畅返回代码即接入成功。
注意事项
- Windsurf 的 Cascade Agent 大量依赖工具调用（function calling）；推荐选用 gpt-5.5 / claude-opus-4-8 等强工具调用能力的模型，避免选用纯对话模型。
- 若启用了 Relay 模型后无法触发 Agent 动作（如自动改文件），先在 Settings → Cascade → Tools 确认 "Custom Provider Tools" 已开启。
- 原生 Codeium 服务（Free / Pro）和 Relay 自定义 Provider 是并列的，可随时切回去；切换不影响订阅状态。