Cursor 使用第三方 AI 接口

Cursor 自带的模型接入走官方订阅，如果想使用 STJAPI 这类第三方接口，需要借助 cursor-byok 这类辅助工具完成配置。本页介绍使用 cursor-byok 对接第三方 AI 接口的最小流程。

1. 准备工作

开始前确认两件事：

1. 本机已安装 Cursor 并能正常启动。建议先在 Cursor 内检查更新，过旧的版本可能与辅助工具不兼容。
2. 已在 STJAPI 控制台 创建令牌，并确认令牌分组包含你打算在 Cursor 中使用的模型。分组与模型的对应关系见 STJAPI 账户与网络设置。

2. 下载工具

项目地址：leookun/cursor-byok

下载地址：cursor-byok Releases

下载和系统匹配的发行包后启动工具。Windows 用户注意区分 x64 与 arm64 安装包；macOS 用户按芯片类型选择 Apple Silicon 或 Intel 版本。

3. 填写服务信息

在配置页面中填写服务地址、令牌和需要使用的模型。令牌请从 STJAPI 控制台创建，并选择正确的分组。服务地址以 STJAPI 控制台或 cursor-byok 页面显示的接入地址为准，不要把控制台网址直接当作 API 地址，也不要自行追加路径。

填写模型时有三个常见坑：

1. 模型名称要写全称。使用接口返回的模型 ID，例如带版本号后缀的完整名称，不要凭印象简写。
2. 一次不要勾选过多模型。先配置 1 到 2 个主力模型验证连通，再按需增加，出错时更容易定位是哪一项配置的问题。
3. 令牌分组要对应。分组不匹配时通常表现为请求返回模型不存在或无权限，而不是连接失败。

4. 保存并测试

保存设置后，在 Cursor 中发起一个简单对话或代码补全请求。如果提示连接失败：

1. 检查地址、令牌和模型名称是否完整。
2. 确认令牌分组与预期模型一致。
3. 按 STJAPI 账户与网络设置 检查网络连接。

首次验证建议只发送一条短消息，并在 STJAPI 控制台确认对应令牌出现用量记录。

5. 常见问题排查

现象	优先检查
401 / 无权限	令牌是否复制完整、是否已过期、分组是否正确
模型不存在或 404	模型 ID 是否写全、令牌分组是否包含该模型
请求超时	是否开了代理并命中错误出口，见 连接异常
补全可用但对话不可用（或相反）	两类功能可能走不同模型配置，逐一核对
工具更新后失效	Cursor 升级可能改变内部接口，查看 cursor-byok 项目页是否有新版本

6. 使用建议

1. 辅助工具是外挂方案。Cursor 官方更新可能随时改变内部行为，重要工作不要完全依赖单一第三方接入，保留一条备用通道。
2. 控制用量。Cursor 的 Tab 补全触发频率高，接入计费接口后建议在设置里适当调低补全灵敏度，避免小请求大量消耗令牌额度。
3. 令牌安全。配置工具会把令牌写入本地文件，不要把包含令牌的配置文件截图、提交或同步到公共仓库；换机或弃用时先在控制台撤销对应令牌。

接入完成后，可以继续阅读《通用 AI 编程方法论》和《效率与省钱技巧》，把工具用在刀刃上。