Cursor / Windsurf 配置

Cursor 和 Windsurf 是流行的 AI 编程 IDE。本指南介绍如何在这些 IDE 中配置 TopRouter API。

Cursor 配置

方式一：通过设置界面

1. 打开 Cursor
2. 进入 Settings → Models
3. 找到 OpenAI API Key 设置项
4. 配置以下信息：

配置项	值
API Key	您的 TopRouter API Key
Base URL	https://toprouter.cc

5. 添加需要使用的模型名称
6. 保存设置

方式二：通过环境变量

在启动 Cursor 前设置环境变量：

export OPENAI_BASE_URL="https://toprouter.cc"
export OPENAI_API_KEY="your-api-key"

然后从终端启动 Cursor：

# macOS
open -a Cursor

# 或直接在项目目录启动
cursor .

Cursor 推荐模型

功能	推荐模型	模型 ID
Tab 补全	GPT-5.5 Instant	openai/gpt-5.5-instant
Chat 对话	Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet
Composer	Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet
复杂重构	Claude 4.8 Opus	anthropic/claude-4.8-opus

Windsurf 配置

配置步骤

1. 打开 Windsurf
2. 进入 Settings → AI Configuration（或 Cascade Settings）
3. 设置 API 代理：

配置项	值
API Key	您的 TopRouter API Key
API Base URL	https://toprouter.cc

4. 选择或添加要使用的模型
5. 保存并重启

环境变量方式

export OPENAI_BASE_URL="https://toprouter.cc"
export OPENAI_API_KEY="your-api-key"

Windsurf 推荐模型

功能	推荐模型	模型 ID
Cascade	Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet
代码补全	GPT-5.5 Instant	openai/gpt-5.5-instant
代码审查	GPT-5.5	gpt-5.5

通用配置技巧

使用 .env 文件

在项目根目录创建 .env 文件：

OPENAI_BASE_URL=https://toprouter.cc
OPENAI_API_KEY=your-api-key

⚠️ 安全提示

确保 .env 文件已添加到 .gitignore，避免将 API Key 提交到版本控制系统。

# .gitignore
.env
.env.local

模型切换建议

• 日常编码：使用 anthropic/claude-4.6-sonnet 或 gpt-5.5，平衡性能与速度
• 代码补全：使用 openai/gpt-5.5-instant 或 gpt-4.1-nano，快速响应
• 复杂任务：使用 anthropic/claude-4.8-opus 或 openai/o3，强大推理能力

常见问题

IDE 无法连接到 TopRouter？

1. 确认 Base URL 为 https://toprouter.cc
2. 确认 API Key 正确
3. 检查是否有代理或防火墙阻止连接
4. 尝试重启 IDE

代码补全速度慢？

• 使用轻量模型如 openai/gpt-5.5-instant 进行代码补全
• 检查网络延迟
• 减小补全的上下文窗口大小

支持多种模型同时使用吗？

可以。在 IDE 中为不同功能配置不同的模型，例如代码补全用轻量模型，对话用强力模型。

📖 相关文档

• Claude Code 接入 — CLI 工具配置
• Cherry Studio 配置 — 桌面客户端配置
• 模型列表 — 查看所有可用模型