Cursor 与 Windsurf 接入指南
在 Cursor 与 Windsurf (Cascade) 新一代 AI 原生 IDE 中配置 疾旋Token，享受超低延迟与全项目代码推理。
Cursor 与 Windsurf 是目前全球开发者最青睐的新一代 AI 原生集成开发环境 (IDE)。它们摆脱了传统单文件补全插件的局限，能够对整个工作区代码库建立实时语义索引，并驱动智能体进行多文件协同重构。
通过配置 疾旋Token 自定义 API，您无需受制于官方高昂的订阅限额，按需畅享 GPT-5.6-sol 与 GPT-5.6-terra 的极速代码推理。
🎯 Cursor 配置步骤
打开 Cursor 模型设置面板
- 启动 Cursor 编辑器。
- 点击右上角的 ⚙️ 齿轮图标（或按快捷键
Ctrl + Shift + J/Cmd + Shift + J）进入 Cursor Settings。 - 在左侧导航菜单中选择 「Models」。
配置 OpenAI API Key 与 Base URL
- 找到 「OpenAI API Key」 区域，填入您的 疾旋Token 密钥
sk-your-astrumflow-token-key，并点击 Verify。 - 开启 「Override OpenAI Base URL」 开关，在输入框中填入：
https://token.astrumflow.com/v1 - 点击 Save 保存。
路径格式要求：接口地址末尾必须包含 /v1（即 https://token.astrumflow.com/v1），请勿省略或拼接多余子路径。
添加并启用疾旋Token 旗舰模型
在 Model Names 列表中，点击 + Add Model 逐一添加以下模型标识：
GPT-5.6-sol（推荐主力推理，超强长程架构与深度重构）GPT-5.6-terra（高性能日常全栈编程首选）GPT-5.6-luna（极速行内解释与快速注释）
添加完成后，开启对应模型的开关，并根据需要关闭未订阅的默认官方模型。
开启全场景智能编程
返回代码编辑区，即可使用 Cursor 的完整 AI 功能套件：
- Chat 对话面板 (
Ctrl + L/Cmd + L)：在顶部模型下拉框中选择GPT-5.6-sol进行上下文对话。 - 行内代码编辑 (
Ctrl + K/Cmd + K)：选中代码片段直接下发重构指令。 - Composer 全项目多文件生成 (
Ctrl + I/Cmd + I)：一键生成跨文件架构修改方案。
💡 Cursor 常见排错与避坑提示
输入框焦点问题解决方法
在部分版本的 Cursor 中，若点击 API Key 或 Base URL 输入框无法获得光标焦点，可以先鼠标点击邻近的开关控件，然后按下键盘的 Tab 键将焦点跳转至输入框内，即可直接按 Ctrl + V（或 Cmd + V）粘贴内容并保存。
🌊 Windsurf (Codeium Cascade) 配置步骤
Windsurf 由 Codeium 开发，其核心 Cascade 智能体工作流同样深度支持自定义 OpenAI 兼容接口。
打开 Windsurf AI 设置
- 启动 Windsurf 编辑器。
- 按
Ctrl + ,/Cmd + ,打开 Settings，在搜索框中输入Cascade或AI Settings。
选择自定义兼容协议并填写参数
在 Provider 下拉列表中选择 「Custom / OpenAI Compatible」，并填入以下信息：
- Base URL：
https://token.astrumflow.com/v1 - API Key：
sk-your-astrumflow-token-key - Model Name：
GPT-5.6-sol
保存并开始使用
保存配置后，在右侧 Cascade 对话面板中即可直接呼叫疾旋Token 节点，享受流畅的代码补全与协同排错体验。
🚀 推荐 IDE 模型搭配建议
全项目跨文件重构 (Composer)
首选 GPT-5.6-sol。200K 超大上下文全面吃透模块依赖关系，代码修改严谨可靠。
日常高频 Chat & 行内 Edit
首选 GPT-5.6-terra。高吞吐低延迟，极速完成函数编写、类型推导与测试生成。