前置条件
- 1已安装 Windsurf（Windows / macOS / Linux 均有客户端）
- 2已注册 DeepSeek 开放平台并创建 API Key
- 3了解在 IDE 设置里修改配置项
常见问题
QWindsurf 自带的免费模型和 DeepSeek 怎么选？
Windsurf 免费额度对轻度用户够用，写 demo、问问题、小改动都覆盖；但额度用完要么订阅要么等刷新，不可控。自己的 DeepSeek Key 按量计费，每百万 token 一两元量级，重度使用月成本通常也是几十元，而且模型版本自己定、用量明细在开放平台逐次可查。建议：轻度体验用自带，每天靠 AI 写代码超过一小时的切 Key。
QAPI Base 到底带不带 /v1？
两个地址 DeepSeek 都接受——官方文档明确 base_url 可以是 https://api.deepseek.com，也兼容 https://api.deepseek.com/v1。所以填 https://api.deepseek.com 如果客户端不自动拼路径就补 /v1。判断方法很简单：保存后发一条测试消息，报 404 就是路径不对，换个形式重试，两个总有一个对。
QCascade 模式用 DeepSeek 效果如何？
Cascade 是 Windsurf 的 Agent 模式，能自己读文件、跑命令、改多文件。接 DeepSeek 后日常任务（加接口、写测试、改配置）完成度不错，但要注意两点：一是复杂任务建议先用 DeepSeek Reasoner 在 Chat 里过方案再让 Cascade 执行，思维链能提前暴露方案问题；二是 Cascade 会创建和修改文件，重要项目先提交 Git 再让它跑，出问题能回滚。同类方案也可以对比 DeepSeek V4.1 Flash 接入 VS Code 完整指南 里的 Cline 路线。