Cursor

这条接入路径能做什么Copy Anchor Link

在 macOS、Windows 或 Linux 的 Cursor 桌面编辑器中，用 TokenLab 处理受支持的聊天请求。Cursor 官方把 OpenAI BYOK 的范围限定为标准、非推理聊天模型；Tab 补全仍使用 Cursor 自己的模型。修改 OpenAI Base URL 不代表 Cursor 能使用 TokenLab 的所有模型或协议。详见 Cursor API Key 限制。

如果只需要 TokenLab 的图像、视频等 API 工具，可以保留当前聊天提供商，单独接入 MCP。Skill 为 Agent 提供 API 使用说明，不会切换聊天提供商。

把任务交给现有 AgentCopy Anchor Link

阅读 https://tokenlab.sh/docs/zh/integrations/cursor，核对我安装的版本和操作系统。
确认我需要 TokenLab 主模型、MCP 工具还是 API Skill。
保留已有账户、提供商配置和权限，说明改动后如何恢复。
不要在聊天中索要或填写 API key；由我在本地填写，并操作必要的界面步骤。
先说明一次小验证的费用，只有我明确选择这次测试后，才协助执行并核对 TokenLab 请求记录。

打开正确的设置Copy Anchor Link

1. 从 Cursor 下载页安装或更新桌面编辑器。本页不配置 Cursor CLI 或 Cloud Agents。
2. 从命令面板打开 Cursor Settings，或按 Cmd/Ctrl + Shift + J。Cmd/Ctrl + , 打开的是编辑器通用设置。
3. 进入 Models，先记录已有 OpenAI key 和 Base URL 的配置，以便恢复；保留其他提供商设置。
4. 在 OpenAI API Key 中本地填写并保存 TokenLab key。不要把 key 发到 Agent 聊天中，也不要提交到项目。
5. 启用 Override OpenAI Base URL，填写：

https://api.tokenlab.sh/v1

Cursor 的 BYOK 请求仍会经过其服务端组装提示词，并不是编辑器直接连接 TokenLab。

选择受支持的模型Copy Anchor Link

从当前 TokenLab 模型目录复制精确模型 ID，并确认 Cursor 的 OpenAI BYOK 路径接受它。TokenLab 将模型列为 chat，并不能证明 Cursor 支持该模型。

首次文本检查可用 gpt-4.1-mini 作为非推理 OpenAI 聊天模型的示例，使用前确认它仍在售。在 Models 中启用已有条目；没有时使用 Add model，然后在聊天选择器里选中该精确模型。不要换一种拼写重复添加内置模型，也不要假设 Claude 或 Gemini 条目会经过 OpenAI override。Cursor 官方的自定义模型说明解释了这些路由限制。

验证一次小请求Copy Anchor Link

用所选模型新建聊天，发送：

只回复 TOKENLAB_CONNECTION_OK。不要使用工具，也不要修改文件。

这次模型请求会计费。除了检查回复，还应在 TokenLab 请求记录中核对相同模型、时间和状态。保存成功、模型出现在列表里，或收到回复但没有对应 TokenLab 记录，都不能确认这条路由已经接通。

失败时检查什么Copy Anchor Link

• **模型缺失或被拒绝：**核对精确 ID 和 Cursor 当前的 BYOK 支持范围。有内置条目时直接使用；重启不能让不受支持的模型变得兼容。
• **鉴权失败：**重新在 OpenAI 字段填写 TokenLab key，并检查 Base URL。余额或额度错误与无效 key 不同，应按返回错误和对应请求记录定位。
• **没有 TokenLab 请求记录：**核对聊天选择的模型与 override，再查看 Cursor 的错误。Tab 补全等 Cursor 自营功能不能作为这条连接的验证。
• **其他提供商不可用：**恢复原 OpenAI 设置或关闭 override，再新建聊天；不要为了修复这条路径改动无关提供商的 key。

单独添加工具或使用说明Copy Anchor Link

TokenLab MCP 添加可调用工具。通过 Cursor 的 MCP 设置或 .cursor/mcp.json 配置；先确认工具能被发现，再按需执行会计费的生成。安装 MCP 不会替换主聊天模型。

TokenLab Skills 提供 API 使用说明。项目级安装时，把完整 Skill 目录放到 .cursor/skills/tokenlab-api-integration/，保留 SKILL.md 及其引用文件，在 Customize → Skills 中检查是否识别。Skill 不会提供 key，也不会安装 MCP server。不同 Cursor 版本的入口以官方 MCP 和 Skills 文档为准。