Windsurf 能否使用第三方 API？支持范围与替代方案

很多人希望在 Windsurf 中填写自己的 API Key，再把 Cascade 请求切到 OpenAI 兼容网关、自建模型或统一的企业模型平台。这个需求通常包含三个不同问题：

1. 能否选择 Windsurf 已经提供的不同模型？
2. 能否填写 OpenAI、Anthropic 等官方 Provider 的自有 Key？
3. 能否同时自定义 Base URL，把请求发往任意第三方 API？

根据截至 2026 年 7 月 17 日可查到的 Windsurf / Devin Desktop 官方文档，最稳妥的结论是：

Cascade 支持在产品提供的模型选择器中切换模型，但官方公开文档没有提供一个面向普通用户、可填写任意 Base URL 与 Model ID 的通用 OpenAI 兼容 API 入口。

网络代理、企业部署和模型选择也不等于“自定义模型 Provider”。如果你的核心要求是接入 Nbility、LiteLLM、vLLM 或其他 OpenAI 兼容网关，应选择明确支持自定义 Provider 的编程助手，而不是依赖未公开或旧版本的设置。

先看结论：哪些能力支持，哪些不要混淆

需求	当前公开支持情况	说明
在 Cascade 中切换模型	支持	从产品提供的模型选择器中选择，具体模型和成本以客户端为准
使用 Windsurf / Devin Desktop 内置模型	支持	包括官方当前列出的 SWE、Claude、GPT 等模型，范围会变化
填写任意 OpenAI 兼容 Base URL	未见官方通用入口	不应根据旧截图或内部设置推断长期支持
填写任意 Model ID	未见官方通用入口	模型通常来自产品模型选择器，而不是自由文本配置
配置 HTTP/HTTPS Proxy	支持	解决企业网络访问问题，不会把 Cascade 改成第三方模型客户端
用其他扩展连接第三方 API	可行	在编辑器生态允许的范围内使用 Cline、Roo Code 等扩展
改用支持自定义 Provider 的工具	可行	OpenCode、Cline、Roo Code 等有更明确的自定义 API 路径

这里最容易发生的误判是：看到“Models”“Proxy”或企业网络配置，就认为一定能填写自己的 API Endpoint。实际上这三者属于不同层级。

Cascade 的模型选择器是什么

Windsurf 官方模型文档说明，用户可以在 Cascade 输入框下方打开模型下拉菜单，在可用模型之间切换。官方同时提醒，最新价格与可用性应以客户端中的模型选择器为准。

这意味着：

• 模型清单由产品当前提供；
• 不同方案、组织策略或发布时间可能看到不同选项；
• 模型的 Token 成本或配额规则可能变化；
• 选择器中能看到模型，不代表可以替换其底层 API 地址；
• 选择器中没有模型，也不代表填写一个字符串就能调用。

因此，“支持 Claude 或 GPT”与“支持你的 Claude / OpenAI API Key”不是同一个结论；“支持多模型”也与“支持任意 OpenAI 兼容网关”不同。

为什么不能把 Proxy 当成自定义 Base URL

官方文档提供了系统代理检测和手动 HTTP/HTTPS Proxy 配置，用于企业网络、VPN、防火墙或远程开发环境。代理设置解决的是：

Devin Desktop / Windsurf
        ↓
企业 HTTP(S) Proxy
        ↓
产品需要访问的外部服务

它不是：

Cascade
   ↓
你的 OpenAI 兼容 Base URL
   ↓
自定义模型

代理服务器通常负责转发网络流量。它不会自动完成以下工作：

• 把 Cascade 的私有请求格式转换成 /v1/chat/completions；
• 将内置模型名映射到你的 Model ID；
• 注入第三方 API Key；
• 兼容工具调用、流式响应和 Agent 状态；
• 绕过产品授权、计费或模型策略。

不要把 MITM、DNS 重写或抓包转发作为“接入第三方 API”的办法。这类方案脆弱，可能违反服务条款，还会扩大源代码、凭据和会话内容的泄露风险。

为什么旧教程可能说 Windsurf 支持 BYOK

搜索时可能遇到旧版本截图、论坛回答或非官方教程，展示 Provider Key、API Key 或某种模型覆盖设置。判断这些信息是否仍然有效，需要检查：

1. 页面是否来自当前官方文档；
2. 描述的是 Windsurf Editor、旧插件，还是现在的 Devin Desktop；
3. 功能是否只适用于某个历史版本、方案或企业账户；
4. 设置是“选择官方模型”，还是“自定义 Base URL”；
5. 是否明确承诺支持 OpenAI 兼容协议和任意 Model ID。

如果当前客户端没有对应入口，官方文档也没有配置字段，就不应建议用户修改内部数据库、隐藏配置或扩展文件。升级后这些办法可能立即失效。

企业版是否能接自建模型

企业采购经常涉及代理、SSO、审计、网络控制、数据保留与安全策略，但这些能力不能自动推出“支持任意自建模型”。

如果企业必须接入自有网关，应在采购或 PoC 阶段向官方确认，并要求书面说明：

• 支持哪些 Provider；
• 是否能自定义 API Base URL；
• 是否支持 OpenAI Chat Completions 或 Responses API；
• Model ID 如何配置；
• Cascade、Tab、Command 和其他功能分别走哪条数据路径；
• 源代码、Prompt、遥测和请求日志如何保留；
• 工具调用、流式输出和上下文缓存是否兼容；
• 功能属于哪个方案，是否有额外合同要求。

在得到明确答复前，不要把网络代理或“可联系销售”写成已经支持自建模型。

需要第三方 API 时有哪些替代方案

首选：通过官方支持的 ACP 接入第三方 Agent

Devin Desktop 当前正式支持 Agent Client Protocol（ACP）。这不是给 Cascade 更换模型后端，而是让独立 Agent 出现在 Agent Command Center 中。官方列出的示例包括 OpenCode、Codex CLI、Claude Agent、Gemini CLI 和 Junie，也允许团队注册自建 ACP Agent。

调用链可以设计为：

Devin Desktop
    ↓ ACP
OpenCode / 自建 Agent
    ↓
第三方或企业 OpenAI 兼容 API

在这条路径中，外部 Agent 自行处理 API Key、Base URL、模型选择、费用与隐私条款。它既保留了 Devin Desktop 的 Agent 入口，也避免拦截 Cascade 流量。官方文档说明 Pro、Max 和 Teams 可使用第三方 Agent；Enterprise 需要联系客户团队启用。

如果企业已有内部 LLM Gateway，还可以实现自定义 ACP Agent，并通过本地或团队 Registry 分发。需要明确的是：这是接入一个独立 Agent，不是把 Cascade 或 Devin Local 的后端替换为企业模型。

方案一：Windsurf 继续负责 Cascade，第三方 API 放在其他客户端

如果你喜欢 Windsurf 的编辑器体验，可以继续使用其内置模型，同时在终端运行支持自定义 Provider 的工具，例如 OpenCode 或 Codex CLI。

优点：

• 不修改 Windsurf 内部行为；
• 两套调用链容易分别排错；
• 可以逐步评估第三方模型质量。

代价是上下文和工作流不完全共享，需要明确哪些修改由哪个 Agent 负责。

方案二：在编辑器中安装支持自定义 API 的扩展

如果当前编辑器允许安装所需扩展，可以选择 Cline 或 Roo Code。这些工具有明确的 OpenAI Compatible Provider 配置，通常需要：

Base URL: https://api.nbility.ai/v1
API Key:  ***
Model ID: YOUR_MODEL_ID

可参考：

• Cline 接入自定义 API：模型配置、权限与成本控制
• Roo Code 接入自定义 API：Claude、GPT 和 Gemini 怎么选

需要注意：扩展能否安装、是否完整兼容以及扩展市场策略可能随产品版本变化。Agent 的终端、文件写入和自动审批权限也要单独设置。

方案三：改用原生支持自定义 Provider 的编程助手

如果“必须使用自有 API、统一网关或本地模型”是硬性要求，选型时应优先考虑公开配置能力：

工具	适合场景	自定义 API 特点
OpenCode	终端 Agent、多 Provider	可配置自定义 Provider 和 OpenAI 兼容接口
Cline	VS Code Agent	有 OpenAI Compatible 配置和权限控制
Roo Code	VS Code 多配置工作流	支持 Provider Profiles 与 OpenAI Compatible
Codex CLI	终端编程任务	可配置 OpenAI 兼容 Provider，需核对功能协议
Cursor	集成式编辑器	有 BYOK，但支持范围与 Base URL 能力需要按当前 UI 核对

进一步对比可看 Claude Code、Codex、Cursor 和 OpenCode 有什么区别。

方案四：把第三方 API 用于普通聊天或内部工具

如果需求只是让开发者查询代码、生成测试或解释错误，不一定非要嵌入 Cascade。可以做一个内部 Web 工具、CLI 或 IDE 侧边栏，把 OpenAI 兼容请求限制在明确范围内。

这比拦截 Windsurf 流量更可控，也更容易实现：

• API Key 隔离；
• 模型白名单；
• 请求审计；
• 预算限制；
• 敏感目录过滤；
• 失败重试与备用模型。

选择替代工具时要验证什么

“可以填 Base URL”只是第一步。真正的 AI 编程助手还依赖：

1. 流式输出；
2. Tool Calling；
3. 文件读取和增量修改；
4. 长上下文与上下文压缩；
5. 多轮工具结果回传；
6. 超时、限流和错误恢复；
7. 模型是否稳定遵循补丁或编辑格式。

建议先使用最小任务验证：

读取 package.json，说明项目框架和测试命令，不要修改文件。

再测试受控写入：

在新的临时测试文件中添加一个最小用例，不安装依赖，不修改其他文件。

最后才开放终端、批量改动或自动审批。Chat 能返回文字，不等于 Agent 工作流完整兼容。

通过 Nbility 使用 OpenAI 兼容模型

如果你选择支持自定义 Provider 的客户端，可以从 Nbility 模型广场复制准确 Model ID，并使用版本根地址：

https://api.nbility.ai/v1

不要把 Base URL 写成完整端点：

https://api.nbility.ai/v1/chat/completions

客户端通常会自行拼接路由。配置前可先阅读什么是 OpenAI 兼容 API，遇到状态码问题则参考 AI API 错误码排查指南。

真实 Key 不应写入仓库、截图或共享配置。为编程助手创建独立 Key，并设置预算、权限、日志与轮换策略。

常见误区与排查

模型选择器里没有目标模型

先更新客户端并检查账户方案、组织策略和当前模型清单。不要用展示名称猜测隐藏 Model ID。官方明确建议以 Cascade 中的模型选择器确认最新可用性。

配置了 HTTP Proxy，但模型没有变化

这是正常现象。Proxy 只改变网络出口，不改变 Cascade 的 Provider、模型或计费来源。

找不到 Base URL 输入框

如果当前官方文档和设置界面都没有该入口，应视为未提供通用自定义 Endpoint，而不是继续寻找隐藏配置。改用明确支持 OpenAI Compatible 的工具。

第三方扩展无法安装或运行

检查当前产品的扩展市场、版本兼容性和组织策略。必要时在标准 VS Code 中运行扩展，或改用终端客户端。

第三方 API 的 Chat 正常，但 Agent 失败

检查 Tool Calling、流式响应、上下文长度以及模型编辑能力。404 还可能来自 Base URL 错误或客户端调用了网关不支持的 /responses。可参考 OpenAI 兼容 API 配置基础。

FAQ

Windsurf 可以填写自己的 OpenAI API Key 吗？

当前公开文档重点描述产品提供的模型选择器，没有给出面向普通用户的通用 OpenAI BYOK 配置流程。应以当前客户端和官方文档为准，不依赖旧截图。

Windsurf 可以连接 Nbility、LiteLLM 或 vLLM 吗？

当前没有公开的任意 Base URL + Model ID 通用配置入口。可在 Windsurf 旁边运行 OpenCode 等终端工具，或使用 Cline、Roo Code 等支持 OpenAI Compatible Provider 的客户端。

HTTP Proxy 能把请求转到自定义模型吗？

不能。官方代理设置用于企业网络连通性，不是自定义模型 Provider。强行拦截和改写流量既不稳定，也可能带来安全与合规问题。

企业版一定支持自建模型吗？

不能这样推断。企业网络、安全和管理功能不等于自定义模型接入。应让官方针对 Base URL、协议、数据路径和具体产品功能提供书面确认。

使用其他扩展会替代 Cascade 吗？

不会自动替代。它们是独立 Agent，拥有自己的模型、上下文、权限和用量。团队应避免让多个 Agent 同时修改同一文件。

总结

Windsurf 的模型选择能力很强，但“可以选择多个模型”不等于“可以接入任意第三方 API”。截至本文核对日期，官方公开文档没有提供普通用户可配置任意 OpenAI 兼容 Base URL 与 Model ID 的通用流程。

最稳妥的决策方式是：

1. 只需要 Cascade 现有模型：直接使用模型选择器；
2. 只是企业网络受限：配置官方 HTTP/HTTPS Proxy；
3. 必须调用第三方 OpenAI 兼容 API：使用 Cline、Roo Code、OpenCode 等明确支持自定义 Provider 的工具；
4. 企业需要自建模型：在 PoC 前让官方书面确认协议、功能范围和数据路径；
5. 不要通过流量拦截或隐藏设置强行改写 Cascade。

这样既能保留喜欢的编辑器体验，也不会把网络代理、模型选择和第三方 API 接入混为一谈。

参考资料

• Devin Desktop / Windsurf AI Models
• Windsurf Proxy Configuration
• Devin Desktop Advanced Configuration
• Agent Client Protocol in Devin Desktop
• Building a Custom ACP Agent
• Windsurf Plugins Cascade Models