跳到主要内容

使用 Cursor

本文说明如何在 Cursor 中使用 ClawdRouter。Cursor 通过 OpenAI 兼容配置调用服务，适用于 Windows、macOS 和 Linux 桌面版 Cursor。

准备工作​

  • 已安装最新版 Cursor。
  • API Key。
  • 可调用的模型 ID。
注意

请勿在截图、代码仓库或公开位置展示真实 API Key。

1. 打开模型设置​

  1. 启动 Cursor。
  2. 按 Ctrl + Shift + j 打开设置。
  3. 进入 Models。
  4. 展开 API Keys。

2. 配置 API Key 和请求地址​

  1. 开启 OpenAI API Key。
  2. 在 API Key 输入框中粘贴真实 API Key。
  3. 开启 Override OpenAI Base URL。
  4. 将地址填写为：
__DOCS_API_ORIGIN__/v1

保存设置后，关闭并重新打开 Cursor。

3. 添加模型​

  1. 仍在 Models 页面中，点击 + Add model。
  2. 输入你有权限调用的模型 ID：YOUR_MODEL_ID。
  3. 保存模型。

模型 ID 必须与服务端提供的名称完全一致。

4. 选择模型并开始使用​

  1. 打开 Cursor 的 Chat 或 Agent 面板。
  2. 打开模型选择器。
  3. 选择刚刚添加的 YOUR_MODEL_ID。
  4. 输入一个简单的编码需求，例如“解释当前项目的目录结构”。

常见问题​

显示 Invalid API key​

请重新粘贴 API Key，确认没有包含空格或换行符，并检查 Base URL 是否已开启覆盖。

模型没有出现在选择器中​

请重新添加模型 ID，确认名称正确且当前 API Key 有该模型权限，然后重启 Cursor。

请求返回 401、403 或 404​

状态码处理方式
401API Key 缺失或无效，请重新设置。
403API Key 无该模型调用权限，请更换模型或 Key。
404模型 ID 或 Base URL 填写错误，请逐字检查。

Agent 或工具调用失败​

请确认已使用 OpenAI API Key 配置并开启 Base URL 覆盖。部分 Cursor 内置功能不使用自定义 API Key；请以 Chat 或 Agent 面板中手动选择的模型为准。

修改配置后没有生效​

完全退出 Cursor 后重新打开，再重新选择模型。

相关链接​