Cursor 接入指南

1. 适用版本与验证日期

尚未实测。这份配置依据工具自己的文档。

需要账号、API key 和正余额。没有余额时请求返回 HTTP 402（insufficient_quota）。

Cursor Settings → Models → API Keys

OpenAI API Key: sk-atr-YOUR_KEY
Override OpenAI Base URL: https://api.tokenwave.dev/v1
Add model: claude-sonnet-5-5

这些模型能用于 Cursor。上面的示例使用你在这里选的模型。

打开聊天，选你添加的模型并发送一条消息。chat-completions 模型用 Ask 模式，带 Responses 接口的模型用 Agent 模式。

发送这句提示：“Reply with the single word ready.”然后打开请求记录页：一分钟内会看到这条请求，含模型、token 数和费用。

Agent 模式需要 Responses 接口。Tab 补全不使用自定义 key。Cursor 需要经公网访问网关，我们的网关满足。Cursor 是否接受官方 ID 作自定义模型名尚未验证。

症状	原因	修复
401 Unauthorized	key 填错、已吊销，或带了多余空格。	到 API keys 页重新复制完整的 key，并确认它是有效状态。
403 Forbidden	这个 key 不能用该模型，或账户受限。	到 API keys 页检查 key 允许的模型，或换一个 key。
404 Not Found	基础地址不对：/v1 重复或缺失。	原样使用示例里的地址。Claude Code 不带 /v1，其他工具带 /v1。
model not found	模型 ID 写错，或你的 key 不能用它。	从目录复制 ID，或用 GET /v1/models 查看 key 可用的模型。
400 Extra inputs are not permitted	工具发了所选线路不接受的字段，多见于经转换的接口。	选一个提供该工具原生接口的模型（见模型页的卡片），或升级工具。
返回 HTML 页面或 “Attention Required”，不是 JSON	网关前面的网页防火墙拦截了请求体。	重试一次。反复出现时，带上时间和请求 ID 联系支持。
我传的某个参数好像没有生效	网关只转发该接口已知支持的字段，其余字段会被丢弃（不会报错）。	查看响应头 x-atr-ignored-fields：它列出了没有被转发的顶层字段。去掉这些字段，确实需要时联系支持。

在 Settings → Models 里清空 OpenAI API Key 与 Override OpenAI Base URL，并删除你添加的模型。