Devin Desktop（原 Windsurf）接入与兼容性说明

产品已更名

Windsurf 已于 2026 年 6 月 2 日由 Cognition 更名为 Devin Desktop，以应用内更新推送，原有设置、项目和扩展随之迁移；windsurf.com 已永久重定向到 devin.ai/desktop。原内置 Agent Cascade 已由 Devin Local 取代，Devin Desktop 还可以通过 ACP（Agent Client Protocol）运行 Claude Code、Codex 等外部 Agent。本页沿用原地址 /guide/windsurf。

Devin Desktop 的 BYOK 功能只面向官方界面列出的 Provider 和模型。当前官方资料没有提供通用的 OpenAI Compatible / Custom Provider Base URL，因此不能把 Zivv 直连写成稳定支持方案。

最近核验：2026-10-23。本次复核确认 Windsurf 已更名为 Devin Desktop，仍未发现稳定的通用 Custom Provider Base URL 入口；如果后续官方新增，本页会在复核后更新。

当前结论

配置方式	状态
使用 Devin Desktop 内置模型	官方支持
为官方列出的 Provider 填写其原生 Key	以当前官方界面和文档为准
填写任意 OpenAI Compatible Base URL	当前未提供稳定官方入口
使用 Zivv Key 冒充 OpenAI 官方 Key	不推荐，验证和功能可能失败
通过 ACP 运行已配置 Zivv 的外部 Agent	实验性，本站未实测

因此，当前不提供“在 Devin Desktop 中填写 https://zivv.pro/v1 即可直连”的确定性教程。

推荐替代方案

需要通过 Zivv 使用 AI 编程助手时，选择官方明确支持自定义网关的工具：

1. Claude Code — 使用 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN
2. Codex CLI — 使用 model_providers 和 Responses API
3. Codex 桌面端 — 与 Codex CLI 共享 Provider 配置
4. OpenAI SDK — 直接控制 Base URL、模型和请求格式

实验性：在 Devin Desktop 中运行外部 Agent

Devin Desktop 可以通过 ACP 运行 Claude Code、Codex 等外部 Agent。外部 Agent 读取的是它自己的配置，因此理论上可以沿用上面指南中的 Zivv 配置；图形应用不一定继承终端环境变量，Claude Code 建议写入 ~/.claude/settings.json。这条路径未经本站核验：

1. 先在终端按对应指南配置，确认该 Agent 能通过 Zivv 正常工作。
2. 再在 Devin Desktop 中选择该外部 Agent，发送“只回复 pong”。
3. 在 用量日志 确认请求确实到达 Zivv；没有记录说明该会话并未使用你的本地配置。

如果未来出现 Custom Provider

只有当 Devin Desktop 官方文档或当前设置页明确提供以下字段时，才进行兼容性测试：

Base URL: https://zivv.pro/v1
API Key:  sk-你的Key
Model:    模型广场中的模型 ID

测试顺序：

1. 先用普通 Chat 发送“只回复 pong”。
2. 在 用量日志 检查实际请求路径和模型。
3. 再测试流式输出和工具调用。
4. 最后测试 Devin Local、索引和后台任务。

即使普通 Chat 可用，也不能推断 Devin Local、自动补全、索引和后台代理都使用自定义 Provider。

常见误区

在 BYOK 输入框粘贴 Zivv Key

BYOK 输入框通常按对应官方 Provider 验证，Zivv Key 不是 OpenAI 或 Anthropic 官方 Key，可能直接验证失败。

从旧教程寻找隐藏的 Base URL 设置

旧版 Windsurf 截图、实验开关或修改内部配置的方法都可能随更新失效，也可能绕过客户端安全机制。本页不推荐此类方案。

把普通 Chat 成功当成全功能兼容

Devin Desktop 的内置 Agent、自动补全、检索和后台能力可能依赖自有服务及特定模型，不能用一次对话成功证明完整兼容。

官方资料

• Devin Desktop FAQ
• Devin Desktop 更新日志
• 文档版本维护策略