文档目录
接入 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,见 接口格式。步骤
- 打开 Cursor 的设置,进入 Models 页。
- 在 OpenAI API Key 一栏填入你的密钥
sk-xxxxxxxx。 - 打开 Override OpenAI Base URL(覆盖 OpenAI 地址),填入
Base URL
https://tokenwayapi.com/v1 - 点“Add Model”(添加模型),输入你要用的模型名,必须和 模型定价 页完全一致,例如
gpt-6.1-sol、deepseek-v4.1-flash。 - 点“Verify”验证,通过后在对话框里选择这个模型即可。
界面可能随版本变化
Cursor 的设置项名称会随版本调整,上面是常见写法;核心就是三样:OpenAI 密钥、覆盖后的 Base URL(带
/v1)、手动添加的模型名。哪些功能支持自定义模型,取决于你的 Cursor 版本和套餐,以 Cursor 官方说明为准。怎么确认接通了
- Verify 通过后,在对话框里选择刚添加的模型,发一句简单的话,能正常回复就说明接通了。
- 打开控制台的 使用记录,应该能看到刚才这一笔:模型名、输入输出 token 和扣费。
常见问题
| 现象 | 原因和处理 |
|---|---|
| Verify 失败 | 先用 用 curl 测试 里的 Chat Completions 示例,拿同样的地址和密钥测一下,确认不是密钥或余额问题;再检查 Base URL 是否带了 /v1、末尾有没有多余的空格或斜杠。 |
找不到模型 / 404 | 检查模型名拼写,必须是价格页里列出的名字。 |
400:不支持 xxx 接口 | 填的是 Claude 模型名,Cursor 不能用 Claude,换成 GPT 或其他系列的模型。 |
401 | 密钥填错或已停用,到 API 密钥 页确认。 |
402 | 余额不足,见 充值购买。 |
| 连不上或很慢 | API 密钥 页里还有备用接入地址,把 Base URL 换成备用地址(带 /v1)试试;到 服务状态 看线路是否正常。 |
其他错误见 错误码。
选好模型,核对费用再接入
查看当前模型的价格与参数,用自己的输入、输出和缓存用量估算成本;遇到报错时按错误码排查。