Kilo 接入

本页主流程针对 Kilo 当前架构的 VS Code 扩展，以 v7.6.2 界面为例，设置入口为 Settings → Providers → Custom provider。

RouteFast 作为自定义 API 提供商接入。GPT 使用 OpenAI-ChatGPT 分组密钥；Claude 使用 Anthropic-Claude 分组密钥。先在 密钥管理 和密钥模型目录中确认目标模型，再进行小请求测试。

1. 安装与识别界面

已安装的用户在 VS Code 的扩展面板中打开 Kilo Code 详情，记录版本号，再检查设置入口，无需为了接入先更换安装渠道。

需要安装时，从 Kilo 官方安装页 进入 VS Code Marketplace，或使用 官方 Releases 的相应平台 VSIX。官方安装页当前将新架构扩展放在 Marketplace 的 pre-release 渠道；是否采用该渠道由你的使用环境决定，本教程不要求现有用户升级。安装完成后打开 Kilo 面板。

你看到的入口	使用哪部分
Settings → Providers → Custom provider，可选三种 Provider API	下面的主流程
API Provider 下拉列表，含 OpenAI Compatible，没有新 Providers 页面	文末 Legacy 说明，不套用主流程的 JSON
独立终端中的 kilo 命令	查看官方文档的 CLI 标签；文件格式有共通之处，但没有 VS Code 点击步骤
Agent Manager、JetBrains 或 Cloud Agent	按该产品对应文档确认配置入口和运行环境，不套用本页的 VS Code 点击步骤

旧版手册已标明 Legacy VS Code/JetBrains 于 2026-07-31 结束支持。仍在使用的用户可参考文末的原有界面设置，迁移前先保留现有配置。官方 Legacy 手册

2. 新建 RouteFast 提供商

打开 Kilo 的齿轮设置，进入 Providers，滚动到 Custom provider。GPT 与 Claude 分别创建条目，避免分组密钥和协议混用。

GPT：OpenAI Responses

字段	填写值
Provider ID	routefast-gpt
Display name	RouteFast GPT
Provider API	OpenAI Responses
Base URL	https://api.routefast.ai/v1
API key	你的 OpenAI-ChatGPT 分组密钥
Model ID	gpt-5.6-terra，或当前密钥目录中的精确 ID
Model display name	自定，例如 RouteFast GPT 示例
Headers	留空，采用 API key 字段提供的鉴权

填写后点击 Submit，再从模型选择器中选择此提供商下的模型。Base URL 不要再拼接 /responses。

GUI 输入的密钥由本机 auth.json 保存，API Key 作为 JSON 字符串写入；文件权限保护不等于内容加密。默认数据目录通常为 ~/.local/share/kilo，自定义 XDG 目录会改变位置。保管好该文件及备份；如希望在使用时注入密钥，参见下方环境变量方式。

OpenAI Compatible 在这里表示 Chat Completions 适配器，并不等于 Responses。已有工作流确实需要 Chat Completions 时，可以创建独立条目选择它，Base URL 仍是 https://api.routefast.ai/v1，然后重新验证模型和参数。主流程的 GPT 示例选择 Responses。官方协议选择说明

Claude：Anthropic Messages

字段	填写值
Provider ID	routefast-claude
Display name	RouteFast Claude
Provider API	Anthropic Messages
Base URL	https://api.routefast.ai/v1
API key	你的 Anthropic-Claude 分组密钥
Model ID	claude-sonnet-5，或当前密钥目录中的精确 ID
Model display name	自定，例如 RouteFast Claude 示例
Headers	留空

RouteFast 的 Anthropic 网关根地址是 https://api.routefast.ai。此处填写 /v1 是 Kilo 这套适配器的要求：新版选择 Anthropic Messages 时使用 @ai-sdk/anthropic，适配器在 Base URL 后追加 /messages，最终应请求 /v1/messages。不要直接照抄 Claude Code 的根地址环境变量值。

3. 模型列表与名称

GPT 自定义条目可能在填写地址和密钥后拉取模型列表；只选择当前密钥实际可用的模型。自动拉取失败时，可在 Models 中手动输入已经确认的精确 ID，不必为了出现列表随意修改协议。

v7.6.2 扩展对 Anthropic Messages 不进行这项 OpenAI 模型自动拉取，所以 Claude 条目按上面的方式手动添加模型。没有自动列表并不等于 Messages 接口不可用。

完整选择名使用 provider_id/model_id，例如 routefast-gpt/gpt-5.6-terra。斜杠左边由你命名，右边在本页示例中直接采用 RouteFast 的模型 ID；显示名称只改变界面文字。不要把其他平台的带厂商前缀名称直接填作 RouteFast 模型 ID。官方 Custom Models

先不要填写未知的上下文长度、输出上限、价格或图片等能力。对于没有目录元数据的自定义模型，Kilo 可能无法自动管理上下文；因此下面的最小配置适合短请求验证。正式长会话前，向 RouteFast 确认实际限制，再设置准确的 limit.context / limit.output。客户端显示的估算费用以 RouteFast 实际记录为准。

可选：通过环境变量与文件配置

GUI 方式已经可以完成接入。希望从密码管理器或终端注入密钥时，可使用以下文件方式，保持一种明确的凭证来源。

当前架构的用户级配置位于 ~/.config/kilo/kilo.jsonc，也支持 kilo.json。~ 指运行 Kilo 的用户目录；使用远程开发或容器时，应在实际运行扩展/后端的一侧确认路径。若配置过 KILO_CONFIG 或定制的配置目录，应编辑实际加载的文件。

先备份已有文件，例如 kilo.jsonc.before-routefast-20260911；名称冲突时另取新名称。已有 GUI 配置的用户修改相同 provider 条目，不要再追加重复的 provider 或 model 键。下面展示 GPT 的完整最小配置：

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "routefast-gpt/gpt-5.6-terra",
  "provider": {
    "routefast-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "RouteFast GPT",
      "options": {
        "baseURL": "https://api.routefast.ai/v1",
        "apiKey": "{env:ROUTEFAST_GPT_API_KEY}"
      },
      "models": {
        "gpt-5.6-terra": {
          "name": "RouteFast GPT 示例"
        }
      }
    }
  }
}

若只用 Claude，则可用下面的完整文件。若两者都要用，把 routefast-claude 与 routefast-gpt 合并到同一个 provider 对象，并保留一个默认 model：

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "routefast-claude/claude-sonnet-5",
  "provider": {
    "routefast-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "RouteFast Claude",
      "options": {
        "baseURL": "https://api.routefast.ai/v1",
        "apiKey": "{env:ROUTEFAST_CLAUDE_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "RouteFast Claude 示例"
        }
      }
    }
  }
}

macOS / Linux / WSL 设置需要的变量：

export ROUTEFAST_GPT_API_KEY="sk-routefast-..."
export ROUTEFAST_CLAUDE_API_KEY="sk-routefast-..."

Windows PowerShell：

$env:ROUTEFAST_GPT_API_KEY="sk-routefast-..."
$env:ROUTEFAST_CLAUDE_API_KEY="sk-routefast-..."

把占位值替换成对应分组密钥，无需加 Bearer。环境变量只影响当前终端及随后启动的进程。完全退出 VS Code 后，从已注入变量的终端启动测试项目；若已经配置 code 命令，可使用 code /path/to/your/test-project。在一个已经运行的 VS Code 的集成终端中执行 export，通常不会把值传回父进程和扩展后端。

本例的 {env:...} 引用应保存在受信任的用户级配置。 当前 Kilo 会限制项目仓库中的配置读取环境变量；将此文件放入项目根目录可能使密钥引用被忽略并产生警告。不要为解决认证错误而把真实密钥写进项目文件。官方凭证变量规则

4. 验证连接，再使用工具

先在无敏感内容的测试目录中操作，确认当前选择是 RouteFast GPT 或 RouteFast Claude，而且模型与密钥目录一致。

1. 发送“只回复：连接测试成功，不调用工具”。等待完整回答结束，再去 RouteFast 用量记录核对调用时间、模型和费用。
2. 发送一句简短追问，确认会话能继续返回文本。
3. 文本验证通过后，放入一个无敏感内容的测试文件，请 Kilo 读取并解释它。确认实际出现工具调用及结果，再尝试只修改这个测试文件，人工检查差异。

这些请求可能产生费用。工具测试时保留操作审批；提示词中的“不修改文件”不能替代权限控制。一次文本成功仅验证本次配置的文本调用，图片、推理档位、MCP、浏览器工具和长会话需要分别验证。

若客户端不提供工具给模型，先核对所用模式及模型能力。只有确认 RouteFast 该模型支持工具后，才在相应模型配置中声明 tool_call: true，然后重新测试；该声明告诉客户端如何使用模型，不会让服务端获得原本不支持的能力。

常见问题

现象	优先检查
找不到 Providers 或 Custom provider	先辨认新版与 Legacy 界面，不要把 CLI 文件教程当作旧版 GUI 设置
401 / 403	密钥分组、是否多了空格或 Bearer、当前扩展进程是否继承变量、是否仍有旧凭证
404 或 HTML 错误页	使用 API 域名；检查最终路径是否为 /v1/responses 或 /v1/messages，排除缺少或重复 /v1
Claude 不显示自动模型列表	核对版本的 Messages 模型发现行为，手动添加密钥目录中的精确模型 ID
模型存在但无法请求	列表和显示名不是权限或实时容量保证；检查目标模型、分组和错误体
文件配置没有生效	检查用户级文件、项目配置、KILO_CONFIG、KILO_CONFIG_CONTENT 及其他已有配置文件是否覆盖
文本正常，工具或图片报错	逐项验证模型能力与客户端参数；不要同时打开所有高级开关来排查
长会话不压缩或超限	确认模型实际限制及 limit，新建短会话排查；不采用其他平台的窗口和定价数值
429 / 反复重试	按错误体区分 Key 金额额度、费用窗口、请求速率与并发；减少并行任务不一定解决金额限额，参见 限流与额度，不要持续自动重试

VS Code 中可打开 View → Output，选择 Kilo 对应输出查看错误。报障时提供版本、协议、模型、发生时间、脱敏错误和请求 ID（如有）。分享配置或日志前检查密钥及项目内容，更多说明见 故障排查。

既有 Legacy VS Code 扩展

这一段仅供仍在使用旧界面的用户，依据 官方冻结版 OpenAI Compatible 手册。主流程的 kilo.json(c) 格式不应用于 Legacy。

进入 Kilo 齿轮设置，把 API Provider 设为 OpenAI Compatible；Base URL 填 https://api.routefast.ai/v1，API Key 填 OpenAI-ChatGPT 分组密钥，Model 选择或输入已授权的精确 ID。此方式走 Chat Completions，不能因为模型是 GPT 就称其使用 Responses。保留现有配置的备份，先按前面的短文本步骤验证。

旧版 Anthropic 界面虽有自定义 Base URL，但其 SDK 与可选模型受旧版本约束，不能套用新版 Anthropic Messages 的字段及路径。本页 Claude 完整步骤限定于上文已识别的新架构界面；继续使用 Legacy 时，以其 Anthropic 手册 和实际版本为准。

恢复原配置

先切回原来的提供商和模型，再按需断开或移除本次新建的 RouteFast 条目。使用文件配置时，对照备份恢复默认 model 及相应 provider；期间修改过其他设置时按字段合并。不要只删除 provider，却保留指向它的默认模型。

从当前 shell 清除变量：

unset ROUTEFAST_GPT_API_KEY ROUTEFAST_CLAUDE_API_KEY

Windows PowerShell：

Remove-Item Env:ROUTEFAST_GPT_API_KEY -ErrorAction SilentlyContinue
Remove-Item Env:ROUTEFAST_CLAUDE_API_KEY -ErrorAction SilentlyContinue

通过 GUI 保存过密钥的，应检查对应 provider 凭证已移除；不要删除整份认证文件。系统变量、shell 启动文件或密码管理器中的持久设置需在原位置清理。完全重启客户端，再确认模型选择已恢复。

官方文档

• Kilo 安装
• Kilo Custom Models
• Kilo OpenAI Compatible、Anthropic
• Kilo v7.6.2 发布记录
• Legacy 官方手册