Windsurf 自定义配置

本文档说明如何在 Windsurf 中使用自定义 OpenAI 兼容配置接入当前服务。

Windsurf 不同版本的 BYOK 和自定义模型配置能力并不完全一样，所以这里区分两种情况说明。

1. 先确认你的版本是否支持自定义 Base URL

在 Windsurf 的模型、订阅或 AI 设置中，查找类似这些入口：

• Models
• BYOK
• OpenAI
• Custom
• Base URL

如果你只能填写官方 API Key，但没有可编辑的 Base URL，那么这个版本通常只能走官方支持的 BYOK 模式，不能直接改到当前网关。

2. 填写自定义连接信息

如果你的版本提供自定义 OpenAI 兼容配置，则填写：

• Base URL：https://api.gemiaude.com/v1
• API Key：你的 codex_... Key
• Model ID：以 GET /v1/models 返回结果为准；如果只是先测连通性，可先试 gpt-5.4

3. 验证

保存设置后，新建一个 Cascade 对话或编码任务，确认能正常返回结果。

说明

• Base URL 应填写 <ApiBaseUrl />
• 不要写成完整的 /v1/chat/completions 或 /v1/responses 路径
• 如果当前版本只开放官方 BYOK、没有自定义 Base URL，就不能直接接这个网关
• Windsurf 官方模型说明页：https://docs.windsurf.com/windsurf/models