Skip to main content

Kilo Code 是什么

Kilo Code 是用于 IDE 和终端的 AI 编程助手。它可以通过 Kilo 的 OpenAI 兼容提供商使用 Capriole AI,并把请求发送到 Capriole AI 的 Chat Completions 兼容 API。

前置条件

开始前请确保你已经拥有以下内容。
  • Capriole AI 账户,可在此处注册
  • Capriole AI API Key,可在此处获取
  • 已在 VS Code 中安装 Kilo Code,或已安装 Kilo CLI

安装

VS Code 扩展

从 VS Code Extensions 视图安装 Kilo Code。搜索 Kilo Code,然后安装 Pre-release 版本。

Kilo CLI

配置

创建或更新 Kilo 配置文件。
  • 全局配置 ~/.config/kilo/kilo.jsonc
  • 项目配置位于项目根目录中的 kilo.jsonc.kilo/kilo.jsonc
使用以下 OpenAI 兼容提供商配置。

运行 Kilo Code

设置 API Key,然后在项目目录中启动 Kilo。
使用指定模型启动。
使用 Gemini 3.5 Flash 发送一次性请求。
发送一次性 CLI 请求时,把 Prompt 传给 kilo run

支持的模型

新的 Kilo Code 配置请先使用 openai-latest。需要让 Capriole AI 路由到我们推荐的旗舰 Claude 或 Gemini 模型时,请使用 claude-latestgoogle-latest;需要准确的模型版本时,请使用具体模型 ID。 Kilo 文档采用与 Capriole AI 模型选择器相同的模型系列顺序,依次为 OpenAI、Anthropic 和 Google。公共 API 集成不包含 Fable 5 Thinking 和 Opus 5 Thinking 等仅用于 Browser Chat 的预设。
  • openai-latest
  • openai/gpt-5.6-terra
  • openai/gpt-5.6-luna
  • openai/gpt-5.5
  • openai/gpt-5.4-mini
  • claude-latest
  • anthropic/claude-fable-5
  • anthropic/claude-opus-5
  • anthropic/claude-opus-4-8
  • anthropic/claude-opus-4-7
  • anthropic/claude-opus-4-6
  • anthropic/claude-sonnet-4-6
  • google-latest
  • google/gemini-3.1-pro-preview
  • google/gemini-3.5-flash
  • xai/grok-4.5
  • zai/glm-5.2
  • moonshot/kimi-k3
在 Kilo Code 中使用 Gemini 3.5 Flash 时,请保留 "tool_call": false。Capriole AI 支持该模型的简单 Chat Completions 工具调用,Kilo Code 也能在此设置下运行本地工具工作流,但启用原生 Gemini 函数声明仍可能遇到 Gemini 较窄的 OpenAPI Schema 子集限制。 需要测试其他模型时,也可以配置 GET /v1/models 返回的公共 Chat Completions 兼容模型 ID。将模型用于代码编辑工作流前,请先验证工具调用。

故障排除

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

运行 kilo 前,确认已在同一个 Shell 中导出 CAPRIOLE_AI_API_KEY

应该编辑哪个配置文件

当前 Kilo CLI 和 VS Code 扩展使用 ~/.config/kilo/kilo.jsonc。编辑后运行 kilo config check

为什么请求出现端点错误

确认 baseURLhttps://api.caprioletech.com/v1。Kilo 会向 /v1/chat/completions 发送 Chat Completions 请求。

为什么 Kilo Code 提示缺少模型

确认所选模型使用 openai-compatible/<model-id> 格式,并且 provider.openai-compatible.models 包含对应的模型条目。例如,openai-compatible/openai-latest 映射到 openai-latest 配置 Key。

为什么工具调用失败

对于 GPT、Claude、Gemini 3.1 Pro 和 latest 别名条目,请确认模型条目包含 "tool_call": true。Kilo Code 在本地执行工具,并向 Capriole AI 发送后续 Chat Completions 请求。 对于 Gemini 3.5 Flash,请保留 "tool_call": false。Gemini 支持函数调用,但函数声明只能使用受支持的 OpenAPI Schema 子集。部分原生工具 Schema 超出了该子集。

说明

  • Capriole AI 通过 POST /v1/chat/completions 支持 Kilo Code。
  • Kilo Code 在本地执行编程工具。Capriole AI 只处理模型请求。
  • Kilo Code 7.3.16 可以使用 Kimi K3 完成流式 Bash 工具调用和后续助手轮次。
  • 先保持提供商配置精简。只有确实需要客户端侧上下文管理时,才添加 Kilo 模型限制或其他模型选项。
  • 官方参考资料包括 Kilo OpenAI Compatible 提供商Kilo 设置Kilo 自定义模型Kilo CLIGemini 函数调用
最后修改于 2026年8月18日