Cursor 接入 CCSub:Override OpenAI Base URL 和自定义模型怎么设置
Cursor 用自定义 API:Settings → Models → API Keys 填 OpenAI Key,打开 Override OpenAI Base URL 填 https://www.ccsub.net/api/v1。附 claude- 型号名不走自定义地址等坑。
复制即用的配置
把下面三项填进工具里即可。API Key 在控制台「API 密钥」页面创建。
- OpenAI API Key
sk-你的CCSub密钥(填完要打开 Use OpenAI API Key 开关)- Override OpenAI Base URL
https://www.ccsub.net/api/v1(末尾不要加斜杠)- 自定义模型名
gpt-5.5(不要用 claude- 开头的名字)
model 可填 claude-sonnet-5 等,全部可用型号 ID 见 型号列表。 还没有 Key? 先注册账号。
配置步骤速览
- 1
创建 CCSub API Key
注册 CCSub,在控制台「API 密钥」页面创建 sk- 开头的 Key。
- 2
打开 Cursor 的 API Keys 设置
打开 Cursor Settings → Models,滚到底部展开 API Keys。
- 3
填 OpenAI API Key 并打开开关
在 OpenAI API Key 里粘贴 CCSub 的 Key,并打开 Use OpenAI API Key 开关;只粘贴不开开关,请求不会带上 Key。
- 4
打开 Override OpenAI Base URL
打开 Override OpenAI Base URL,填入 https://www.ccsub.net/api/v1。
- 5
添加自定义模型并在对话里选用
在 Models 页添加要用的型号名(例如 gpt-5.5),在 Chat / Agent 的模型下拉里选中它发一句话,再到 CCSub「使用记录」核对。
Cursor 是基于 VS Code 的 AI 代码编辑器。它接第三方接口的方式只有一种:在 OpenAI API Key 那一栏打开「Override OpenAI Base URL」,把请求改发到你填的地址。Anthropic 和 Google 那几栏 Key 都不能改地址,所以 Cursor 接 CCSub 走的是 OpenAI 兼容协议。
设置入口
打开 Cursor Settings → Models,滚到页面最底部,展开 API Keys。按下面填写:
- OpenAI API Key
sk-你的CCSub密钥粘贴后打开 Use OpenAI API Key 开关- Override OpenAI Base URL
https://www.ccsub.net/api/v1打开开关后填写,末尾不要加斜杠
这里有两个开关,很多人只做了一半:
- Use OpenAI API Key:粘贴 Key 之后要单独打开。Cursor 的某次更新加了这个开关,已有配置升级后默认是关的。不打开的话请求不带 Key,会报
Model name is not valid。 - Override OpenAI Base URL:打开后输入框才生效。Cursor 会在地址后面拼
/chat/completions,所以地址要带/api/v1(https://www.ccsub.net/v1也可以)。
添加自定义型号
在 Models 页面添加你要用的型号名。model 可填 gpt-5.5 等,全部可用型号 ID 见 型号列表。如果名字和 Cursor 内置的型号相同(比如 gpt-5.5 本来就在 Cursor 的列表里),直接启用内置的那一项即可,覆盖地址打开后它的请求同样会发到 CCSub。
哪些功能会走 CCSub
- Chat 和 Agent:选中你添加的型号后,请求会发到 CCSub,在「使用记录」里能看到。
- Tab 补全:不会。Cursor 官方说明自定义 Key 只用于聊天类模型,Tab 补全始终用 Cursor 自己的模型。
- Cursor 自家的模型:覆盖地址对除 Claude、Gemini 之外的所有型号生效,Cursor 自家的模型在覆盖打开时会提示
This model does not support custom API keys。要用它们,先把 Override OpenAI Base URL 关掉。
请求是从 Cursor 服务器发出的
这一点和其他工具不一样:用自定义地址时,请求由 Cursor 的服务器转发,而不是从你的电脑直接发出。带来两个结果:
- 本机的代理软件不影响 Cursor 调用 CCSub,不需要为此开代理。
- 地址必须公网可访问,
localhost、内网地址都用不了。CCSub 的地址是公网地址,没有这个问题。
另外,Cursor 只调用 /chat/completions 接口。团队版、企业版的管理员可以禁止成员使用个人 API Key,如果设置页里看不到这些选项,找团队管理员确认。
验证
在 Chat 或 Agent 面板的模型下拉里选中你添加的型号,发一句话。然后打开 CCSub 控制台的「使用记录」,能看到这条请求就说明接入成功。如果要在 VS Code 里用插件的方式接入,见 Cline 接入教程 和 Continue 接入教程。
常见报错和排查
Model name is not valid
原因:OpenAI API Key 填了,但 Use OpenAI API Key 开关没打开,请求没带 Key。Cursor 某次更新加了这个开关,老用户升级后默认是关闭的。
处理:回到 Settings → Models → API Keys,打开 Use OpenAI API Key 开关。
This model does not support custom API keys
原因:覆盖地址打开时选了 Cursor 自家的模型。
处理:改选你添加的自定义型号;要用 Cursor 自带模型就先关闭 Override OpenAI Base URL。
自定义型号提示已存在 / already available
原因:填的名字和 Cursor 内置的型号名冲突。
处理:直接在模型列表里启用同名的内置型号即可,覆盖地址打开时它也会走 CCSub;或者换一个 CCSub 支持的型号 ID。
401 authentication_error: Invalid or disabled API key
原因:Key 粘贴错误,或在 CCSub 控制台被禁用。
处理:重新复制 Key,确认它在控制台是启用状态。
常见问题
Cursor 里能用 claude- 开头的型号走 CCSub 吗?
不行。Cursor 按型号名判断用哪一栏的 Key:以 claude- 开头的会走 Anthropic API Key 那一栏,而那一栏不能改地址,请求不会发到 CCSub。在 Cursor 里通过 CCSub 调用时,model 填 gpt-5.5 这类 OpenAI 系型号 ID。
Tab 补全会走 CCSub 吗?
不会。Cursor 官方说明自定义 API Key 只用于聊天类模型,Tab 补全始终使用 Cursor 自带的模型。
Override OpenAI Base URL 要带 /v1 吗?
要。填 https://www.ccsub.net/api/v1,Cursor 会在后面拼 /chat/completions。末尾不要加斜杠。
打开覆盖地址后,Cursor 自带的模型报错了?
覆盖地址对除 Claude、Gemini 以外的所有型号生效,包括 Cursor 自家的模型,这些模型会提示不支持自定义 Key。想用 Cursor 自带模型时,先把 Override OpenAI Base URL 关掉。
需要在本机开代理吗?
不需要。使用自定义地址时,请求是从 Cursor 的服务器发出的,不是从你的电脑发出,所以本机代理不影响,地址也必须是公网可访问的,CCSub 的地址满足这个条件。