Kilo Code 配置指南

开源 AI 编程代理，支持 VS Code / JetBrains / CLI，接入小麦API 使用 500+ 模型

官方网站：https://kilo.ai | GitHub：https://github.com/Kilo-Org/kilocode | 文档：https://kilo.ai/docs

📋 简介

Kilo Code 是一款开源的 AI 编程代理，可以在 VS Code、JetBrains IDE 和命令行中使用。它支持通过 OpenAI 兼容接口接入自定义 API，配置小麦API 后即可使用 Claude、GPT、Gemini 等全系列模型进行代码生成、调试和重构。

⚠️ 适用环境

• VS Code：通过扩展安装
• JetBrains：通过插件安装
• CLI：命令行使用

✨ 功能特点

• ✅ 多模式工作 — Architect、Code、Debug 等专用模式
• ✅ Orchestrator 模式 — 自动拆分复杂任务，协调子代理并行执行
• ✅ 500+ 模型 — 通过 OpenAI 兼容接口接入任意模型
• ✅ 自定义代理 — 通过 .kilo/agents/*.md 定义专用代理
• ✅ 跨平台 — VS Code、JetBrains、CLI 共享同一套配置

🛠️ 安装 Kilo Code

VS Code

1. 打开 VS Code，按 Ctrl + Shift + X 打开扩展面板
2. 搜索 Kilo Code
3. 点击安装

JetBrains

1. 打开 Settings → Plugins → Marketplace
2. 搜索 Kilo Code
3. 点击 Install，重启 IDE

CLI

npm install -g @anthropic-ai/kilo

🔑 获取小麦API Key

1. 登录 小麦API 控制台
2. 创建一个新的 Key（令牌组选 auto）
3. 复制保存好 Key（格式如 sk-xxxx）

💡 提示

如果还没有账号，先去 注册，然后 创建 Key。

⚙️ 配置小麦API

Kilo Code 支持通过 UI 和配置文件两种方式设置，推荐先用 UI 配置。

方式一：通过 UI 配置（推荐）

1. 打开 Kilo Code 面板，选择「Use your own API key」
2. 在 Provider 下拉菜单中选择 OpenAI Compatible
3. 填写以下信息：

字段	值
Base URL	https://xiaomai.win/v1
API Key	你的小麦API Key（sk-xxxx）
Model	填写模型 ID，如 claude-sonnet-4-20250514

4. 点击保存

💡 常用模型 ID

• claude-sonnet-4-20250514 — Claude Sonnet 4
• claude-opus-4-20250514 — Claude Opus 4
• gemini-2.5-pro — Gemini 2.5 Pro
• gpt-5.4 — GPT-5.4

方式二：通过配置文件

Kilo Code 使用 kilo.jsonc 配置文件：

💡 配置文件在哪？

• 全局配置：~/.config/kilo/kilo.jsonc
• Windows：C:\Users\用户名\.config\kilo\kilo.jsonc
• 项目级配置：项目根目录的 kilo.jsonc（优先级更高）

🚨 安全提醒

不要把包含 API Key 的配置文件提交到 Git 仓库。建议使用环境变量存储密钥。

💬 开始使用

配置完成后：

1. 在 VS Code 中打开 Kilo Code 面板
2. 选择工作模式（Code、Architect、Debug 等）
3. 输入你的需求，Kilo Code 会自动读写文件、运行命令

工作模式说明

• Code — 日常编码，直接修改文件
• Architect — 架构设计，先规划再执行
• Debug — 调试模式，分析错误并修复
• Orchestrator — 复杂任务自动拆分，多代理协作

常见问题

提示 API Key 无效？

• 确认 Key 是否正确复制（格式 sk-xxxx）
• 确认账户余额是否充足
• 确认 Base URL 填的是 https://xiaomai.win/v1

模型请求失败？

• 检查网络是否能访问 https://xiaomai.win
• 确认模型 ID 拼写正确
• 尝试换一个模型测试

更多问题

请查看 FAQ 或联系售后支持。