Cursor 接入

AI 代码编辑器。通过 Cursor 的 BYOK（自带密钥）能力，把 Chat / Agent 面板的模型请求指向 ByteSeek。

先看清 Cursor 的边界（官方口径）

Cursor 官方文档明确：自定义 Key 只作用于对话类模型，Tab 补全始终使用 Cursor 内置模型。Chat / Agent / Edit 能否配合自定义端点，取决于你的 Cursor 套餐（见下方支持范围表）。想让编码 Agent 全链路、无套餐门槛地走 ByteSeek，用 Claude Code、Codex 或 OpenCode 这类终端工具。

前置条件

已安装较新版本的 Cursor（BYOK 入口在不同版本/套餐下的开放情况可能不同，以你客户端实际显示为准）
已在API 密钥页面创建支持 OpenAI 格式的 Key

配置步骤（IDE）

快捷键 Ctrl + Shift + J（macOS 为 Cmd + Shift + J）打开 Cursor Settings，进入 Models 页；
在 OpenAI API Key 字段填入你的 sk- 密钥——字段名叫 OpenAI，但这把 Key 会发给你下面填的自定义端点；
勾选 Override OpenAI Base URL，填入：

https://tokens.byteseek.ai/v1

注意：带 /v1、末尾不带斜杠。Cursor 会自动在后面拼接 /chat/completions。

在模型列表点 + Add Model，手动输入要用的模型 ID（到模型广场复制，需属于该 Key 绑定的分组）；建议同时取消勾选同名/同系列的官方内置模型，避免请求被路由到官方通道；
点 Verify 验证连接；
到 Chat 面板的模型下拉里选中刚添加的模型，发一条消息确认走通。到使用记录页面能看到这笔请求即为成功。

各入口的支持情况（以官方为准）

入口	是否走 ByteSeek	说明
Chat（Ask 模式）	✅	BYOK 基础能力；官方答复确认无付费订阅时也仅 Ask 可用
Agent / Edit（含 Inline Edit `Cmd+K`）	✅ 需付费订阅	官方答复（2026-07）：BYOK 自定义模型用于 Agent / Chat / Edit 需要有效的 Pro 及以上订阅；无订阅时会报错 “Agent and Edit rely on custom models that cannot be billed to an API key”，只剩 Ask 可用
Tab 补全	❌	官方文档明确：始终使用 Cursor 内置模型，不走自定义 Key
Cursor CLI（`cursor-agent`）	❌	CLI 不提供自定义 Base URL 配置，`CURSOR_API_KEY` 是 Cursor 官方账号密钥，模型走 Cursor 官方通道；终端场景请改用 Claude Code / Codex / OpenCode

Cursor 各版本对 BYOK 的开放范围时有调整，若与上表不符，以 Cursor 官方文档与客户端实际行为为准。

注意事项

请求由 Cursor 服务端转发：官方文档说明所有请求都会经 Cursor 后端完成最终提示词组装（Key 加密传输、不落盘），因此自定义端点必须公网可达（ByteSeek 端点满足）；本地代理类地址无法直接使用。
零数据保留不适用：官方文档明确，使用自定义 Key 时 Cursor 的 Zero Data Retention 政策不生效，数据处理遵循你所接服务方的政策（即 ByteSeek 的隐私政策与上游厂商政策）。
连接报错：部分网络环境下 HTTP/2 兼容性差，可到 Settings → Network → HTTP Compatibility Mode 切换为 HTTP/1.1 再试。
已知版本 bug：3.15.6 版本中 OpenAI API Key 与 Override Base URL 输入框鼠标点击无法聚焦（官方论坛已确认并修复中）——先点击旁边区域，再按 Tab 键把焦点切进输入框即可输入；升级到更新版本后恢复正常。
费用：BYOK 请求由 ByteSeek 按量计费（见计费说明）；Cursor 自身订阅照常独立计费，两者互不抵扣。

常见问题

症状	原因与处理
Verify 失败（401）	Key 填错或不完整；重新从API 密钥页面复制
Verify 失败（404）	Base URL 写错：确认为 `https://tokens.byteseek.ai/v1`，带 `/v1`、末尾无斜杠
模型报错 / 无响应	模型 ID 拼错或不在 Key 绑定的分组内，以模型广场为准
配置后仍走官方模型	确认已勾选 Override 开关、对话面板里选中的是你手动添加的模型，改完重启 Cursor
报 “Agent and Edit rely on custom models…”	无有效付费订阅时 BYOK 只支持 Ask 模式；开通 Pro 及以上订阅，或切到 Ask 模式使用
模型选择后自动跳回 Auto/default	订阅失效或用量状态异常时客户端会禁用自定义模型；到 Cursor 后台确认订阅状态
403	分组限定客户端或不含该模型，见错误码清单

#Cursor 接入

#前置条件

#配置步骤（IDE）

#各入口的支持情况（以官方为准）

#注意事项

#常见问题