Windsurf 配置说明
Windsurf 是 Codeium 推出的 AI 原生 IDE，提供强大的代码生成和编辑能力。
重要说明
ClaudeHub 不适用于 Windsurf
Windsurf 不支持自定义 API 地址，无法使用 ClaudeHub 等第三方 API 服务。
Windsurf 的 BYOK（Bring Your Own Key）功能仅支持原生 API Key，需要直接从 Anthropic 官网获取密钥。
Windsurf 的 API 配置方式
BYOK 功能（仅支持原生密钥）
Windsurf 近期开放了 BYOK 功能，允许用户使用自己的 Anthropic API Key：
- 访问 Windsurf Provider API Keys
- 选择 Anthropic 提供商
- 填写从 Anthropic 官网 获取的 API Key
- 重启 Windsurf 使配置生效
支持的模型
使用 BYOK 后可以使用以下模型：
| 模型 | 说明 |
|---|---|
| Claude 4 Sonnet | 日常编程 |
| Claude 4 Sonnet (Thinking) | 带思考的 Sonnet |
| Claude 4 Opus | 复杂任务 |
| Claude 4 Opus (Thinking) | 带思考的 Opus |
如何找到这些模型
默认情况下这些模型不会显示，需要在模型选择器中搜索 "opus" 或 "sonnet-4" 才能找到。
替代方案
如果你希望使用 ClaudeHub API，建议选择以下支持自定义 API 地址的工具：
| 工具 | 支持自定义 API | 推荐指数 |
|---|---|---|
| Cursor | ✅ OpenAI 配置支持 | ⭐⭐⭐⭐⭐ |
| Cline | ✅ 完整支持 | ⭐⭐⭐⭐⭐ |
| Claude Code | ✅ 环境变量配置 | ⭐⭐⭐⭐⭐ |
功能介绍
尽管无法使用 ClaudeHub，Windsurf 本身仍是一款优秀的 AI IDE：
Cascade（AI 对话）
Cascade 是 Windsurf 的核心 AI 功能：
- 在 IDE 右侧找到 Cascade 面板
- 输入任务描述
- AI 会分析代码并提供建议
工作模式：
- Write 模式：直接将生成代码写入项目文件
- Chat 模式：对话交流，获取建议
代码补全
Windsurf 会自动提供智能代码补全（使用 Codeium 内置模型）。
使用 .windsurfrules
在项目根目录创建 .windsurfrules 文件，定义项目规范：
# 技术栈
- React 18 + TypeScript
- Tailwind CSS
- Vite
# 代码规范
- 使用函数式组件
- 遵循 ESLint 规则