Windsurf 接入指南
Windsurf 是 Codeium 团队开发的 AI 原生 IDE，具有强大的 Cascade Agent。
🌟 为什么选择 Windsurf？
| 特点 | 说明 |
|---|---|
| 🌊 Cascade Agent | 深度上下文，自动执行 |
| 🔄 自动上下文 | 自动读取相关文件 |
| 🛠️ 自动执行 | 创建文件、运行命令 |
| 💻 AI 原生 | 从头设计为 AI IDE |
| 🎯 VS Code 兼容 | 导入 VS Code 设置 |
📦 安装 Windsurf
下载安装
- 访问 Windsurf 官网
- 点击 Download 下载对应系统版本
- 安装并打开 Windsurf
导入 VS Code 设置
Windsurf 可以导入 VS Code 的设置和插件：
- 打开 Windsurf
- 选择 Import from VS Code
- 选择要导入的内容
🔧 配置 Next API
方法一：图形界面配置（推荐）
- 打开 Windsurf
- 按
Cmd+,（Mac）或Ctrl+,（Windows）打开设置 - 搜索 OpenAI
- 输入以下信息：
- API Key：
sk-你的密钥 - Base URL：
https://api.nextapi.pro/v1
- API Key：
- 保存设置
方法二：配置文件
编辑 ~/.windsurf/config.json：
json
{
"openai": {
"apiKey": "sk-你的密钥",
"baseUrl": "https://api.nextapi.pro/v1"
},
"cascade": {
"model": "claude-sonnet-4-6",
"contextDepth": 10
}
}🚀 开始使用
Cascade Agent
Cascade 是 Windsurf 的核心功能，特点：
- ✅ 自动读取代码库
- ✅ 自动创建文件
- ✅ 自动运行命令
- ✅ 自动安装依赖
快捷键
| 快捷键 | 功能 |
|---|---|
Cmd+I / Ctrl+I | 打开 Cascade |
Cmd+K / Ctrl+K | AI 编辑代码 |
Cmd+L / Ctrl+L | 打开 AI Chat |
示例 1：创建新功能
- 按
Cmd+I打开 Cascade - 输入需求：
创建一个 React 组件，显示用户列表，支持搜索和排序- Cascade 会自动：
- 创建组件文件
- 安装依赖
- 添加样式
- 创建测试文件
示例 2：重构代码
- 按
Cmd+I - 输入需求：
重构这个模块，提取公共逻辑，添加单元测试- Cascade 会自动：
- 分析代码结构
- 提取公共逻辑
- 创建新文件
- 添加测试
💡 使用技巧
1. 上下文深度
Cascade 会自动读取相关文件，你可以调整深度：
json
{
"cascade": {
"contextDepth": 10 // 读取最多 10 个文件
}
}2. 选择合适的模型
| 任务 | 推荐模型 |
|---|---|
| 创建新功能 | claude-sonnet-4-6 |
| 重构代码 | gpt-4o |
| 快速修改 | gpt-4o-mini |
3. Flow 模式
Cascade 的 Flow 模式可以：
- 自动规划任务
- 自动执行步骤
- 自动验证结果
🎯 推荐配置
开发配置
json
{
"cascade": {
"model": "claude-sonnet-4-6",
"contextDepth": 15,
"flow": {
"enabled": true,
"autoExecute": true
}
}
}成本优化配置
json
{
"cascade": {
"model": "deepseek-v3.1",
"contextDepth": 5,
"limits": {
"maxTokens": 3000
}
}
}❓ 常见问题
Q: Windsurf 和 Cursor 有什么区别？
A:
| 特点 | Windsurf | Cursor |
|---|---|---|
| Cascade Agent | ✅ | ❌ |
| 自动执行 | ✅ | ❌ |
| 自动上下文 | ✅ | ❌ |
| 免费 | ✅ | ❌ |
Q: Windsurf 收费吗？
A: Windsurf 有免费版和付费版，免费版功能已经很强大。
Q: Cascade 会自动修改代码吗？
A: 是的，Cascade 会自动创建、修改文件，并运行命令。