Kilo Code 接入 CCSub：Custom provider 怎么添加、Base URL 怎么填

Kilo Code 是 VS Code 里的开源编程 Agent 插件。2026 年的新版扩展基于 OpenCode 重写，配置方式和旧版、和 Roo Code 都不一样：不再是一个 API Provider 下拉框，而是在 Providers 页面添加「Custom provider」，配置最终写进 kilo.json。本文按 2026 年 10 月的新版界面编写。

在界面上添加 Custom provider

打开 Kilo Code 的设置（齿轮图标）→ Providers 标签页，滚到最底部，点 Custom provider。对话框按下面填：

填完点 Submit。之后在对话框的型号选择里，就能看到 ccsub 下面的型号。model 可填 claude-sonnet-5 等，全部可用型号 ID 见 型号列表。

选哪个 Provider API

• OpenAI Compatible：请求 /chat/completions，可以点 Fetch models 从 https://www.ccsub.net/api/v1/models 自动拉取型号列表，最省事。
• Anthropic Messages：请求 /messages，Fetch models 不可用，要点 Add model 手动输入型号 ID。
• OpenAI Responses：CCSub 也提供 /responses 接口，但一般用前两种就够了。

不确定选哪个的话，建议先用 OpenAI Compatible：型号可以一键拉取，不容易填错 ID，claude- 和 gpt- 开头的型号都能在这里调用。等跑通之后，如果你更习惯 Anthropic 协议，再添加一个 Anthropic Messages 方式的提供方，两个提供方可以共存，用同一把 Key，在型号选择里按需切换。

用配置文件管理（kilo.json）

对话框里不能设置型号的 token 上限，不填时默认是 0，可能影响上下文管理。需要的话直接编辑配置文件：

示例（Anthropic Messages 方式，limit 里的数值按你的需要调整）：

{
  "provider": {
    "ccsub": {
      "npm": "@ai-sdk/anthropic",
      "name": "CCSub",
      "options": {
        "baseURL": "https://www.ccsub.net/api/v1",
        "apiKey": "{env:CCSUB_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "claude-sonnet-5",
          "limit": { "context": 200000, "output": 32000 }
        }
      }
    }
  },
  "model": "ccsub/claude-sonnet-5"
}

{env:CCSUB_API_KEY} 表示从环境变量读 Key，只在全局配置里有效，写在项目的 kilo.json 里不会被替换。型号引用格式是 provider ID/型号 ID。

从 Roo Code 迁移过来

Roo Code 团队在 2026 年 4 月宣布停止维护，GitHub 仓库已归档，Kilo 官方也发布了从 Roo Code 迁移的指南。如果你之前在 Roo Code 里配过 CCSub，迁移时注意两处不同：

Key 可以继续用原来那一把，不需要重新创建。

验证

选中 ccsub 下的型号，让 Kilo Code 做个小任务，然后到 CCSub 控制台的「使用记录」里找这条请求。Kilo Code 的配置格式和 OpenCode 基本一致，更多字段说明见 OpenCode 接入教程；想用传统的下拉框式配置，可以看 Cline 接入教程。