AI 编辑器OpenAI 协议

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- 型号名不走自定义地址等坑。

最后更新:Cursor 官网

复制即用的配置

把下面三项填进工具里即可。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. 1

    创建 CCSub API Key

    注册 CCSub,在控制台「API 密钥」页面创建 sk- 开头的 Key。

  2. 2

    打开 Cursor 的 API Keys 设置

    打开 Cursor Settings → Models,滚到底部展开 API Keys。

  3. 3

    填 OpenAI API Key 并打开开关

    在 OpenAI API Key 里粘贴 CCSub 的 Key,并打开 Use OpenAI API Key 开关;只粘贴不开开关,请求不会带上 Key。

  4. 4

    打开 Override OpenAI Base URL

    打开 Override OpenAI Base URL,填入 https://www.ccsub.net/api/v1。

  5. 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。按下面填写:

Cursor 接入 CCSub
OpenAI API Key
sk-你的CCSub密钥粘贴后打开 Use OpenAI API Key 开关
Override OpenAI Base URL
https://www.ccsub.net/api/v1打开开关后填写,末尾不要加斜杠

这里有两个开关,很多人只做了一半:

  1. Use OpenAI API Key:粘贴 Key 之后要单独打开。Cursor 的某次更新加了这个开关,已有配置升级后默认是关的。不打开的话请求不带 Key,会报 Model name is not valid。
  2. 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。

型号名不要以 claude- 开头。 Cursor 按型号名的前缀决定用哪一栏的 Key:claude- 开头的型号会走 Anthropic API Key 那一栏,而那一栏不支持改地址,请求根本不会到 CCSub。这是 Cursor 自身的限制,在 Cursor 里请使用 OpenAI 系的型号 ID。想在编辑器里调用 claude- 型号,可以改用 Cline 或 Zed,它们支持给 Anthropic 协议单独填地址。

哪些功能会走 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 的地址满足这个条件。

查看全部工具接入教程

还没有 CCSub 账号?

注册后在控制台创建 API Key,把上面的配置填进工具即可开始使用。按量付费的余额不过期,用多少扣多少。