Cline 接入 CCSub:Anthropic 和 OpenAI Compatible 两种 base_url 填法
Cline 接第三方 API 两种方式:Anthropic 勾选 Use custom base URL 填 https://www.ccsub.net,或 OpenAI Compatible 填 https://www.ccsub.net/api/v1。附 Model ID 与费用显示问题。
复制即用的配置
把下面三项填进工具里即可。API Key 在控制台「API 密钥」页面创建。
- Anthropic:Base URL
https://www.ccsub.net(勾选 Use custom base URL 后填写)- OpenAI Compatible:Base URL
https://www.ccsub.net/api/v1- API Key
sk-你的CCSub密钥- Model / Model ID
claude-sonnet-5
model 可填 claude-sonnet-5 等,全部可用型号 ID 见 型号列表。 还没有 Key? 先注册账号。
配置步骤速览
- 1
安装 Cline 并创建 CCSub Key
在 VS Code 扩展市场安装 Cline,在 CCSub 控制台「API 密钥」页面创建 sk- 开头的 Key。
- 2
打开 API Configuration
点开 Cline 侧边栏,点右上角齿轮进入设置,切到 API Configuration。
- 3
选 API Provider 并填地址
选 Anthropic 时勾选 Use custom base URL,填 https://www.ccsub.net;选 OpenAI Compatible 时 Base URL 填 https://www.ccsub.net/api/v1。
- 4
填 Key 和型号
把 CCSub 的 Key 填进 API Key 栏。Anthropic 在 Model 下拉里选型号;OpenAI Compatible 在 Model ID 里选或输入型号 ID,例如 claude-sonnet-5。
- 5
验证
在 Cline 里发一个任务,到 CCSub「使用记录」核对请求和实际扣费。
Cline 是 VS Code 里的开源编程 Agent 插件,能读写文件、执行命令。它支持很多种 API Provider,接 CCSub 最常用的是两种:Anthropic(勾选自定义地址)和 OpenAI Compatible。两种方式用同一把 CCSub Key,按自己的习惯选一种即可。
设置入口
点开 VS Code 左侧的 Cline 图标,在 Cline 面板右上角点 齿轮 进入设置,切到 API Configuration,在 API Provider 下拉里选择提供方。
方式一:API Provider 选 Anthropic
- API Provider
Anthropic- Anthropic API Key
sk-你的CCSub密钥- Use custom base URL
https://www.ccsub.net勾选后出现输入框,默认提示是 https://api.anthropic.com- Model
claude-sonnet-5从下拉列表里选
只填域名就行:Cline 发现地址没有路径时会自动补 /v1,最终请求 https://www.ccsub.net/v1/messages。这种方式的缺点是 Model 只能从 Cline 内置的列表里选,不能手动输入。如果你要用的型号 ID 不在列表里,改用方式二。
方式二:API Provider 选 OpenAI Compatible
- API Provider
OpenAI Compatible- Base URL
https://www.ccsub.net/api/v1Cline 会在后面拼 /chat/completions- OpenAI Compatible API Key
sk-你的CCSub密钥- Model ID
claude-sonnet-5下拉列表来自 CCSub 的型号接口,也可以选 Use custom model ID 手动输入
Model ID 的下拉列表是 Cline 请求 https://www.ccsub.net/api/v1/models 拉回来的,所以地址填对了,列表里就能直接看到 CCSub 的型号。model 可填 claude-sonnet-5 等,全部可用型号 ID 见 型号列表。
MODEL CONFIGURATION 要不要填
OpenAI Compatible 下面有一个可以展开的 MODEL CONFIGURATION,里面有 Supports Images、Context Window Size、Max Output Tokens、Input Price / Output Price、Temperature 等。几点说明:
- 价格默认是 0,所以 Cline 面板里显示的花费一直是 0,这不代表没扣费。实际费用看 CCSub 控制台的「使用记录」;想让 Cline 显示得更接近,可以把 型号列表 上对应型号的单价填进去。
- Supports Images:要在对话里发截图,就把它勾上。
- Custom Headers:一般不需要填。
Plan 和 Act 可以分开配。 在 API Configuration 里勾选 Use different models for Plan and Act modes,会出现 Plan Mode 和 Act Mode 两个标签,各自选 Provider 和型号。两边都可以接 CCSub,用同一把 Key。
两种方式怎么选
- 地址
- Anthropic 填 https://www.ccsub.net;OpenAI Compatible 填 https://www.ccsub.net/api/v1
- 型号怎么选
- Anthropic 只能从 Cline 内置列表里选;OpenAI Compatible 能拉取 CCSub 的列表,也能手动输入
- 费用显示
- Anthropic 按 Cline 自带的型号信息估算;OpenAI Compatible 默认单价为 0,需要自己填
- 适合谁
- 只用常见 Claude 型号选 Anthropic;想用列表外的型号、或 GPT 型号选 OpenAI Compatible
不管选哪种,Cline 面板里显示的花费都只是估算,真实扣费以 CCSub「使用记录」为准。同一把 Key 可以同时用在两种方式上,也可以在 Plan / Act 里各用一种。
版本问题
Cline 4.1.22 有一个问题:Anthropic 方式配了自定义地址后请求会返回 400。这个问题在 4.1.23 修复了,遇到时先把插件升级到最新版。
验证
配置保存后,在 Cline 里随便发一个任务,比如「列出当前目录的文件」。然后打开 CCSub 控制台的「使用记录」,能看到这次请求和真实的扣费,就说明接通了。同类插件的配置可以对照 Kilo Code 接入教程 和 Continue 接入教程。
常见报错和排查
400 错误,只在 Anthropic + 自定义地址时出现
原因:Cline 4.1.22 版本的一个问题导致自定义 Anthropic 地址返回 400,4.1.23 已修复。
处理:把 Cline 升级到 4.1.23 或更新版本。
Model ID 下拉是空的
原因:Base URL 填错,Cline 请求 {Base URL}/models 没拿到列表。
处理:Base URL 改成 https://www.ccsub.net/api/v1;也可以选 Use custom model ID 手动输入型号 ID。
401 authentication_error: Missing or invalid API key
原因:Key 填到了别的 Provider 的输入框,或复制时带了空格。
处理:确认当前选中的 API Provider 和填 Key 的输入框一致,重新粘贴。
404 Unknown model
原因:手动输入的型号 ID 有拼写错误。
处理:对照 /zh/models 里的 ID 重新填写,型号 ID 用连字符。
常见问题
选 Anthropic 还是 OpenAI Compatible?
都可以。Anthropic 方式的型号只能从 Cline 内置的下拉列表里选;OpenAI Compatible 的 Model ID 可以从 CCSub 拉取的列表里选,也可以手动输入,型号更灵活。
Anthropic 方式的地址要不要带 /v1?
不用。填 https://www.ccsub.net 即可,只写域名时 Cline 会自己补上 /v1。填 https://www.ccsub.net/v1 也能用,但不要写成 /api/v1/v1 这种多一层的路径。
Cline 里显示的费用一直是 0?
OpenAI Compatible 的 MODEL CONFIGURATION 里价格默认是 0,Cline 就按 0 显示。实际扣费以 CCSub 控制台「使用记录」为准,也可以把单价手动填进 Input / Output Price。
Plan 和 Act 能用不同型号吗?
可以。勾选 Use different models for Plan and Act modes,会出现 Plan Mode 和 Act Mode 两个标签,分别选型号即可,两边可以都用 CCSub。
model 应该填什么?
model 可填 claude-sonnet-5 等,全部可用型号 ID 见 CCSub 型号列表页。