Cursor 自定义 API：改 Base URL

能改的只有 OpenAI 通道

Cursor 的设置里，OpenAI 这一栏有两个输入框：API Key 和 Override OpenAI Base URL；Anthropic 那一栏只有 Key，没有地址覆盖。想让请求走二五云API，模型必须从 OpenAI 兼容通道发出去，也就是把 Claude 或 GLM 的模型名填进 OpenAI 通道，而不是填进 Anthropic 栏。

Cursor 会把地址拼成 {base_url}/chat/completions，所以 base 只写到 /v1。Tab 补全、代码库索引、部分内联编辑用的是 Cursor 自己的模型服务，不经过你填的 Key，这部分改不了，也不该指望它走中转。Key 只影响对话类请求，想让补全也走中转，目前没有可用的入口。

配置步骤

1. 按 Ctrl+Shift+J 打开 Cursor Settings，切到 Models。
2. 在 OpenAI API Key 里填 sk-... 形式的密钥。
3. 打开 Override OpenAI Base URL，填 https://ai.idcidiot.com/v1。
4. 点 Add model，手填模型 ID，比如 claude-sonnet-5、claude-opus-5、claude-fable-5。
5. 关闭设置，在聊天窗口的模型下拉里选中刚加的那个。

加模型之前先确认这个 ID 在站点上真的存在，省得在 Cursor 里反复试：

curl -s https://ai.idcidiot.com/v1/models \
  -H "Authorization: Bearer $YUN25_API_KEY" \
| jq -r '.data[].id' | grep claude

地址末尾不要带 /chat/completions，Cursor 自己会拼。带全路径的结果是 /v1/chat/completions/chat/completions，返回 404 或者一段 HTML，很容易被误判成 Key 有问题。

设置保存后不用重启，新建一个对话就会用新配置。想确认请求真的走了中转，最快的办法是去站点的用量日志看有没有新记录；没有记录，说明还在用 Cursor 自己的通道。

模型名要对得上

Cursor 内置列表按官方 ID 写，站点上的模型名有自己的后缀，必须手填。claude-sonnet-5 和 claude-sonnet-5-5 是两个不同的模型，claude-fable-5 和 claude-fable-5-1 也是。填错时 Cursor 一般直接报 model not found 或 400，不会自动回退到别的模型。

同一个模型在不同分组的价格不一样。Cursor 分组 0.6 倍，专门给这类客户端用，claude-sonnet-5 和 claude-opus-5 都在这个分组里，不用去 Claude Max 分组挤。

Cursor 把模型名原样放进请求体的 model 字段，不做任何映射，站点上叫什么就填什么。不确定某个 ID 是否存在时，去模型页搜一下，或者用 curl 请求 /v1/models 看返回列表。

常见的坑

• 两个 Key 栏都填了：请求会走先匹配到的 provider，症状是改了地址没反应。
• 401：Key 复制时带了换行，或者 Cursor 按 Anthropic 的方式发到了别的头。
• 429：Cursor 一次会并发好几个请求，分组额度小时很容易撞上，换额度宽的分组或降低触发频率。
• 图片与工具调用：Cursor 发什么字段取决于版本，遇到 400 先用纯文本模型确认链路通。
• 计费：自定义 Key 的消耗记在站点账上，Cursor 那边的订阅额度不一定抵扣，两边分开看。
• 打开 Output 面板能看到实际请求的 URL 和状态码，比猜快得多。
• 换了 Key 却没换地址：请求仍然打到默认后端，站点日志里看不到记录。
• 本机代理改写请求头：个别代理会删掉 Authorization，表现是随机 401。
• 团队版的工作区策略可能禁用自定义 Base URL，个人设置里能填，请求仍然走默认通道。

价格

claude-sonnet-5 的 model_ratio 是 1.5，Cursor 分组 0.6 倍，输入价 = 1.5 × 2 × 0.6 = $1.8/百万 token，输出按 completion_ratio 5 折算为 $9/百万 token。claude-opus-5 同分组是 $3/$15，上下文都是 1,000,000 token。一次跨五个文件的改动，输入约 4 万 token、输出 3 千，按 sonnet 算约 $0.072 + $0.027 = $0.10。

完整倍率见 价格页，模型清单在 /model/。偶尔用几次的话按量计费更灵活，天天大量改动再考虑包月方案。Cursor 分组目前只覆盖 Claude 系模型，claude-sonnet-5、claude-opus-5、claude-fable-5 都在里面；GLM 和 Gemini 的可用分组里没有 Cursor，想用它们得换客户端。按天算，一天 30 次这样的改动大约 $3；同样的量放到 Claude Max 分组（0.85 倍）会贵四成左右。

配完先发一句“你好”，能出字再打开项目。Models 里可以把用不到的内置模型取消勾选，自定义模型排在列表底部，改个容易认的名字，手滑选错的概率会低很多。