跳转到主要内容
文档目录

接入 Cursor

Cursor 接入 Tokenway:覆盖 OpenAI 地址、添加模型、验证,以及不能用 Claude 的原因。

Cursor 用 OpenAI 兼容的方式接入自定义服务,通过 https://tokenwayapi.com/v1 这个地址调用 GPT 和其他模型(DeepSeek、Kimi、Gemini 等)。

Cursor 不能用 Claude

Claude 模型只支持 Anthropic 原生格式(/v1/messages),而 Cursor 的自定义服务只会发 OpenAI 格式,所以填 Claude 模型名会返回 400。要用 Claude 请改用 Claude Code 或 Cherry Studio,见 接口格式。

步骤

  1. 打开 Cursor 的设置,进入 Models 页。
  2. 在 OpenAI API Key 一栏填入你的密钥 sk-xxxxxxxx。
  3. 打开 Override OpenAI Base URL(覆盖 OpenAI 地址),填入

    Base URL

    https://tokenwayapi.com/v1
  4. 点“Add Model”(添加模型),输入你要用的模型名,必须和 模型定价 页完全一致,例如 gpt-6.1-sol、deepseek-v4.1-flash。
  5. 点“Verify”验证,通过后在对话框里选择这个模型即可。

界面可能随版本变化

Cursor 的设置项名称会随版本调整,上面是常见写法;核心就是三样:OpenAI 密钥、覆盖后的 Base URL(带 /v1)、手动添加的模型名。哪些功能支持自定义模型,取决于你的 Cursor 版本和套餐,以 Cursor 官方说明为准。

怎么确认接通了

  1. Verify 通过后,在对话框里选择刚添加的模型,发一句简单的话,能正常回复就说明接通了。
  2. 打开控制台的 使用记录,应该能看到刚才这一笔:模型名、输入输出 token 和扣费。

常见问题

现象原因和处理
Verify 失败先用 用 curl 测试 里的 Chat Completions 示例,拿同样的地址和密钥测一下,确认不是密钥或余额问题;再检查 Base URL 是否带了 /v1、末尾有没有多余的空格或斜杠。
找不到模型 / 404检查模型名拼写,必须是价格页里列出的名字。
400:不支持 xxx 接口填的是 Claude 模型名,Cursor 不能用 Claude,换成 GPT 或其他系列的模型。
401密钥填错或已停用,到 API 密钥 页确认。
402余额不足,见 充值购买。
连不上或很慢API 密钥 页里还有备用接入地址,把 Base URL 换成备用地址(带 /v1)试试;到 服务状态 看线路是否正常。

其他错误见 错误码。

选好模型,核对费用再接入

查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。