在 Windsurf IDE 中配置 DeepSeek V3 (Cascade)

Windsurf 是由 Codeium 推出的新一代 AI 编辑器，其核心引擎 Cascade 能够深度理解整个代码库。虽然 Windsurf 官方已集成 DeepSeek，但通过自定义配置，你可以使用自己的 API Key (BYOK)，大幅降低成本。

为什么选择 DeepSeek + Windsurf?

• Cascade Flow: Windsurf 的核心 Agent 能力，不再是简单的补全，而是能够执行多步任务。
• DeepSeek V3: 性能接近 Claude 3.5 Sonnet，但 API 价格仅为 1/50。
• BYOK (Bring Your Own Key): 使用自己的 DeepSeek API Key，无需订阅 Windsurf Pro 也能体验强大的模型。

配置步骤

目前 Windsurf 支持添加 "OpenAI 兼容" 的自定义模型。

1. 打开设置: 点击右下角的齿轮图标，或按 Cmd + ,。
2. 搜索 "Provider": 在搜索框输入 model provider 或直接找到 Cascade 设置项。
3. 添加自定义模型:
   • Provider: 选择 OpenAI Compatible。
   • Base URL: https://api.deepseek.com
   • API Key: sk-your-deepseek-key
   • Model Name: deepseek-chat (对应 V3)

注意: 如果界面中未找到直接的 "Add Custom Model" 入口，可以尝试修改 ~/.codeium/windsurf/config.json (路径可能随版本变化，建议优先检查 UI 设置)。

使用技巧

• Flow 模式: 在对话框右侧切换到 "Flow" 模式，Cascade 会自动读写文件。DeepSeek V3 在此模式下表现出色，能够精准理解复杂的重构指令。
• 上下文管理: DeepSeek V3 支持 64k/128k 上下文，可以放心地将多个文件 @ 进对话框。

常见问题

Q: 为什么我只能用 Codeium 的默认模型？ A: 确保在 Cascade 的模型下拉菜单中选中了你刚刚添加的 deepseek-chat。

Q: 速度慢怎么办？ A: 官方 API 在高峰期可能稍慢，可以尝试切换 Base URL 为 SiliconFlow: https://api.siliconflow.cn/v1，模型名改为 deepseek-ai/DeepSeek-V3。