接入 Cursor

将 Cursor 连接到 TokenCode,用统一的 OpenAI 兼容端点调用编程助手和通用大模型。

安装 Cursor

从 Cursor 官网下载安装客户端。安装后打开 Cursor Settings,进入 Models 页面。

配置接入凭证

Models 页面开启:

  1. OpenAI API Key
  2. Override OpenAI Base URL

然后填写:

配置项
API Key TokenCode API Key
Base URL https://tokencode.dev/v1
Model 模型列表中的模型 ID

常用模型示例:

text
gpt-5.5
claude-sonnet-4-6
gemini-2.5-pro
deepseek-chat
qwen2.5-coder-32b

保存后,在聊天面板关闭 Auto 模式,并从模型下拉列表中选择你添加的模型。

验证配置

新建一个空项目或打开已有项目,在 Cursor Chat 中输入:

text
请用一句话确认你已经通过 TokenCode 连接成功。

如果模型正常回复,说明配置已生效。

常见问题

无法调用已添加的模型

如果出现以下提示:

  • The model xxx does not work with your current plan or api key.
  • Named models unavailable Free plans can only use Auto.

通常是 Cursor 当前套餐不支持自定义模型。请使用 Cursor Pro 或支持自定义模型的套餐。

配置完成后找不到模型

请在聊天面板关闭 Auto 模式,再从模型下拉列表中选择手动添加的模型。

连接失败或 Unauthorized

请检查:

  1. Base URL 是否为 https://tokencode.dev/v1
  2. API Key 是否填写完整。
  3. 模型 ID 是否在 TokenCode 模型列表中存在。
  4. 模型名是否与 Cursor 内置模型名冲突;如冲突,可在 TokenCode 侧配置模型别名后再填入别名。