Windsurf

它是什么

Windsurf 是 Codeium 的旗舰 AI 原生 IDE —— 2024 年发的 VS Code fork，重押 Cascade：一个看着你工作、跑命令、跨文件改、主动建议下一步的自治编码模式。Cursor 把自己定位在 Cmd-K composer 加 tab 补全周边，Windsurf 则更进一步，走 "agent 替你开 IDE" 的路线。

2025 年中 OpenAI 宣布收购 Windsurf（同期 Codeium 核心企业业务被拆离），所以未来走向跟 OpenAI 产品策略绑定。截至 2026 年中，Windsurf 仍独立发版，定价坚挺。

什么时候应该用：

• 想要全 agent 驱动的 IDE，不是聊天面板加补全
• 看重免费档（Windsurf 的 Cascade 免费配额是真能用的）
• 想要 IDE + 自治 agent 一个二进制，不是 VS Code + 插件

它为什么突出

怎么装

# 下载 macOS / Linux / Windows 版
# https://windsurf.com/download

# macOS 上 Homebrew
brew install --cask windsurf

装完邮箱或 Google 登。免费档立刻起效。Pro 大约 $15/月（OpenAI 收购后可能变）。仓库根放 .windsurfrules 给 Cascade 项目特定指令。

在 Windsurf 里装啥

Windsurf 读 .windsurfrules（项目）和 Memories（工作区持久上下文）。三个 TokRepo pack 起手：

• .windsurfrules 模板 —— 调过适配 Cascade 规划风格的项目规则
• Cascade Memories pack —— 主流框架约定的引导记忆
• MCP 服务器全家桶 —— Postgres / GitHub / Filesystem，跟 Claude Code 共用

tokrepo install 装好你的 .windsurfrules 加 Memories 就跟 Codeium 发布会 demo 的基线对齐。

常见坑

• 长任务里 Cascade 跑偏 —— 没 .windsurfrules 约束，Cascade 会比你要求改得多。范围一定要钉在规则里
• 免费档 agent loop 撞限速 —— 慷慨但非无限。长重构留给 Pro 或者分块跑
• Memories 攒噪音 —— Memories 跨会话累积。定期用 Memories 面板修，否则 Cascade 会引用过期上下文
• MCP server 配置位置 —— Windsurf 用 ~/.codeium/windsurf/mcp_config.json，不是 .claude/。别软链，用 tokrepo migrate
• 收购后不确定性 —— OpenAI 把 Windsurf 跟 Codex CLI / ChatGPT 整合后，定价、免费档、功能路线可能变。别造假设当前 Pro 档功能不变的团队工作流

常见误解

很多人把 Windsurf 跟 Cursor 弄混 —— 都是围绕 AI agent 的 VS Code fork —— 但设计哲学不同。Cursor 押 显式调用（你按 Cmd-K、你问、你接受）。Windsurf 押 自治（Cascade 一直在想一直在提议）。两年竞争后两家都吸收了对方的点子（Cursor 加了 agent 模式，Windsurf 加了显式 composer），差距在收窄。现在最大差异是 OpenAI 收购：被收购后 Windsurf 大概率会跟 OpenAI 模型和 Codex CLI 约定靠拢，Cursor 仍独立多供应商。