安装 Kilo Code 并接入 TeamoRouter

Kilo Code 是开源的 AI 编程 Agent，主要用在 VSCode 里（也有命令行版本）。它支持添加自定义提供商，并且可以为每个提供商选择 API 协议，所以用一个 TeamoRouter API Key 就能在 Kilo Code 里跑各家模型。

下面的字段名按 Kilo Code 官方文档核对（2026-11-03，Kilo Code 7.8）。本页的每种接法我们都用 Kilo 命令行 7.8.18 实际连通过，命令行和 VSCode 扩展用的是同一套配置。

一、安装 Kilo Code

1. 打开 VSCode，按 ⌘ + Shift + X（Windows / Linux 为 Ctrl + Shift + X）打开扩展面板。
2. 搜索「Kilo Code」。
3. 点「Install」旁边的下拉箭头，选「Install Pre-Release Version」。Kilo 目前把新版扩展放在预发布通道，官方推荐所有用户安装这一版。
4. 点击左侧边栏的 Kilo Code 图标，打开对话面板。

用不了微软扩展市场的编辑器（VSCodium、Windsurf 等）可以从 Open VSX 安装。第一次打开时 Kilo Code 会提示登录免费的 Kilo 账号；用 TeamoRouter 不需要在 Kilo 充值。

二、获取 TeamoRouter API Key

访问 TeamoRouter 控制台 注册账号并创建一个 API Key，复制备用。

三、把 TeamoRouter 添加为自定义提供商

Kilo Code 可以为每个自定义提供商选择 API 协议。协议要按模型系列选，所以用到几个系列，就把 TeamoRouter 添加几次：

添加步骤：

1. 在 Kilo Code 面板点齿轮图标打开「Settings」，进入「Providers」标签页。
2. 滚到最下面，点「Custom provider」。
3. 按以下字段填写，以 Claude 为例：
   • 「Provider ID」：teamorouter-claude（不重复即可；另外两个可以叫 teamorouter-gpt 和 teamorouter）
   • 「Display name」：TeamoRouter Claude
   • 「Provider API」：选「Anthropic Messages」
   • 「Base URL」：https://api.teamorouter.com/v1（保留 /v1）
   • 「API key」：粘贴你在 TeamoRouter 控制台 创建的 key
   • 「Models」：从 Kilo Code 拉到的列表里勾选，或者手动添加模型 ID，例如 claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5。这个提供商下只放 Claude 模型
   • 「Headers」：留空
4. 点「Submit」保存。用 GPT 或其他模型的话，再分别按「OpenAI Responses」「OpenAI Compatible」各添加一次。

可用的模型 ID：

也可以直接改 kilo.json

VSCode 扩展和命令行都把提供商保存在 kilo.json 里（~/.config/kilo/kilo.json 对所有项目生效，项目目录下的 kilo.json 只对该项目生效）。不想点对话框，可以直接粘贴配置。下面是我们实测用的配置：

{
  "provider": {
    "teamorouter-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "TeamoRouter Claude",
      "options": { "baseURL": "https://api.teamorouter.com/v1", "apiKey": "你的 TeamoRouter API Key" },
      "models": {
        "claude-opus-5-5": { "name": "Claude Opus 5.5", "limit": { "context": 200000, "output": 16384 } },
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5", "limit": { "context": 200000, "output": 16384 } }
      }
    },
    "teamorouter-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "TeamoRouter GPT",
      "options": { "baseURL": "https://api.teamorouter.com/v1", "apiKey": "你的 TeamoRouter API Key" },
      "models": {
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 200000, "output": 16384 } }
      }
    },
    "teamorouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TeamoRouter",
      "options": { "baseURL": "https://api.teamorouter.com/v1", "apiKey": "你的 TeamoRouter API Key" },
      "models": {
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro", "limit": { "context": 128000, "output": 8192 } }
      }
    }
  },
  "model": "teamorouter-claude/claude-sonnet-5-5"
}

limit 告诉 Kilo Code 能用多长上下文、一次最多输出多少，它据此判断什么时候压缩长对话。

四、开始使用

1. 在 Kilo Code 对话面板打开模型选择器，选一个 TeamoRouter 的模型。
2. 用自然语言描述任务，例如「给 src/api.ts 加上错误处理」，按回车发送。
3. Kilo Code 会读文件、改代码，执行终端命令前会先问你。想调整哪些操作需要确认，到「Settings」→「Auto-Approve」里改。

常见报错

• 402「钱包余额不足」：TeamoRouter 余额为 0，充值后重试。
• 401 或「Invalid API Key」：检查 key 是否完整粘贴、前后没有空格，以及是否已在控制台删除。
• 404 或「Model Not Found」：检查模型 ID 拼写，以及模型是否放在了对应的提供商下（Claude 在 Anthropic Messages 下，GPT 在 OpenAI Responses 下）。
• 填完 Base URL 没有模型列表：确认 Base URL 以 /v1 结尾，再点「Fetch models」。拉不到也可以手动输入模型 ID。
• 连接失败：确认你的网络能打开 https://api.teamorouter.com，以及 VSCode 的代理设置正确。