跳转到主要内容
只需一个 Capriole AI API Key,就能在 Kilo Code 中使用 GPT-6.2 Astra、Claude Fable 5.1、Opus 5.5 和 Gemini 4 Carbon,价格比官方 API 最多低 92%。

Kilo Code 是什么

Kilo Code 是适用于 VS Code 和终端的 AI 编程智能体。这套配置把 Capriole AI 添加为一个自定义提供商,其中每个模型都使用 Capriole AI 为该模型系列提供的 API 协议。

前置条件

开始前请确保你已经拥有以下内容。
  • Capriole AI 账户,可在此处注册
  • Premium 方案(每月 USD 9,还包含无限网页聊天)或 Team 方案,获取 API Key 需要其中之一,可在此处订阅
  • Capriole AI API Key,可在此处获取

安装

Kilo CLI

验证安装。

VS Code 扩展

在 VS Code 的扩展视图中安装 Kilo Code。该扩展与 CLI 读取同一个全局配置文件。

配置

模型验证

使用下方配置,Kilo CLI 7.8.15 经 Capriole AI 调用“支持的模型”一节中的每个模型,都通过了文件读取、文件写入和最终答案检查。 创建或更新 ~/.config/kilo/kilo.jsonc。
各项设置的作用如下。
  • npm: "@ai-sdk/openai-compatible" 是该提供商的默认包,因此 Gemini、Grok、GLM 和 Kimi 使用 Chat Completions。
  • 每个 GPT 模型都用 @ai-sdk/openai 覆盖 provider.npm,从而使用 Responses API。每个 Claude 模型都用 @ai-sdk/anthropic 覆盖它,从而使用 Anthropic Messages。
  • {env:CAPRIOLE_AI_API_KEY} 从环境变量读取你的 API Key。Authorization 请求头让每个包都以 Bearer Token 形式发送 Key。
  • tool_call: true 允许模型调用 Kilo 的工具。
  • limit 设置每个模型的上下文窗口和输出上限。没有它时,Kilo 会把两者都视为 0,不会压缩长会话。
请把这个提供商保存在全局配置中。Kilo 不会解析项目级配置中的 {env:...} 引用。 编辑文件后运行 kilo config check。

运行 Kilo Code

设置 API Key,然后在项目目录中启动 Kilo。
也可以指定模型启动。
如需执行一次性请求,请把提示词传给 kilo run。

支持的模型

模型引用格式为 capriole-ai/<model-id>。 openai-latest、claude-latest 和 google-latest 始终指向各自系列中我们最新的旗舰模型,目前分别是 GPT-6.2 Astra、Claude Fable 5.1 和 Gemini 4 Carbon。

故障排除

为什么 Kilo Code 返回身份验证错误

运行 kilo 前,确认已在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY,并确认提供商位于 ~/.config/kilo/kilo.jsonc 中,而不是项目配置中。

为什么 Claude 请求因 Unsupported Claude Messages model 失败

使用 @ai-sdk/anthropic 的 Claude 模型需要不带前缀的 Claude ID,例如 claude-opus-5-5。带 anthropic/ 前缀的 ID 用于 Chat Completions。

为什么 Kilo Code 提示缺少模型

确认所选模型使用 capriole-ai/<model-id> 格式,并确认 provider.capriole-ai.models 中有对应条目。运行 kilo models capriole-ai 可以列出 Kilo 已加载的模型。

为什么工具调用失败

确认模型条目包含 "tool_call": true。

说明

  • Kilo Code在你的电脑上运行编程工具,Capriole AI 负责处理模型请求。
  • 如需添加其他 Capriole AI 模型,请复制同一系列中某个模型的条目并修改 ID。GET https://api.caprioletech.com/v1/models 会列出所有模型 ID。
  • Gemini 4 Carbon 的思考时间比 Gemini 4 Argon 长,每一轮可能更慢、用的 token 更多。想要更快的回应,请使用 google/gemini-4-argon。
  • 想在其他编程智能体中使用同一个 API Key,请参阅使用一个 API Key 配置编程智能体。
  • 官方参考资料包括 Kilo CLI、Kilo 自定义模型、Kilo 设置和 OpenCode 提供商。
最后修改于 2026年11月18日