Kilo-Org/kilocode · 上手攻略
- 仓库：Kilo-Org/kilocode
- 链接：https://github.com/Kilo-Org/kilocode
- 分类：agent · coding（trending）
- 作者：Jay
- 更新：2026-07-07
这是什么
Kilo（kilocode）是一站式开源编程 Agent 平台，自称"the most popular open source coding agent"。它脱胎于 OpenCode，在其基础上扩展为完整的多端编程助手——支持 VS Code、JetBrains、CLI 三端运行，对接 500+ 大模型，可中途切换模型，按模型提供商定价（零溢价）。另有配套平台 kilo.ai 提供云端 Agent（KiloClaw）和自动代码评审服务。
解决的问题： 现有 AI 编程工具要么是 IDE 插件（Cursor/Windsurf）锁定平台，要么是纯 CLI 工具缺少 UI，且模型切换不灵活。Kilo 试图做"编程 Agent 的全端统一入口"，同时解决模型选择灵活性和价格透明度问题。
快速安装
Kilo 有三种安装形式：
VS Code 扩展（推荐入门）
# 方式1：VS Code 内搜索
# 打开 VS Code → Extensions → 搜索 "Kilo Code" → 安装
# 方式2：命令行安装 .vsix
code --install-extension kilocode.kilo-code
CLI（适合服务器/CI 场景）
# npm
npm install -g @kilocode/cli
# curl（一键脚本）
curl -fsSL https://kilo.ai/cli/install | bash
# pnpm
pnpm add -g @kilocode/cli
# bun
bun add -g @kilocode/cli
# Homebrew (macOS/Linux)
brew install Kilo-Org/tap/kilo
# 安装完成后验证
kilo --version
JetBrains 插件
在 Settings → Plugins → Marketplace 搜索 "Kilo Code"，或访问 JetBrains Marketplace 页面 下载。
核心用法
启动与配置
# 在项目目录运行 CLI
cd /path/to/your/project
kilo
# 全自动运行（无确认提示，适合 CI/CD）
kilo run --auto "run tests and fix any failures"
# 查看帮助
kilo --help
注意： --auto 会禁用所有权限提示，agent 可执行任意操作，仅在可信环境中使用。
内置 Agent 模式
Kilo 内置 5 种专业化 Agent（类比不同的"职业"）：
| Agent 模式 | 用途 | 文件修改 | 工具权限 |
|---|---|---|---|
| code（默认） | 写代码、改代码 | ✅ 全部 | 全部工具 |
| ask | 解释代码、概念学习 | ❌ 只读 | read + MCP（需批准） |
| plan | 系统设计、写实施计划 | 仅 .kilo/plans/ |
只读 |
| debug | 追踪 bug、系统诊断 | ✅ 全部 | 全部工具 |
| review | 代码评审（性能/安全/风格/测试覆盖） | ❌ | 全部工具 |
切换方式（VS Code/CLI）：
在对话中告诉 Kilo 切换模式，例如：/plan 或 switch to debug mode。
模型选择
Kilo 支持 500+ 模型，涵盖 GPT、Claude、Gemini 等。按官方文档，可在 kilo.jsonc 配置文件中指定模型：
// kilo.jsonc
{
"model": "claude-sonnet-4-20250514",
"provider": "anthropic",
"temperature": 0.7
}
或直接用 agent 内置命令让 AI 帮你配置："add my Ollama endpoint"。
MCP 支持
Kilo 有 MCP marketplace，可以搜索并接入 MCP 服务器扩展 agent 能力。在对话中告诉 Kilo："add this MCP server" 并提供服务器信息。
代码评审（PR 自动评审）
访问 app.kilo.ai/code-reviews 配置自动评审，绑定 GitHub/GitLab 仓库后，PR 会自动触发 AI 评审。
典型适用场景
- IDE 无缝 AI 编程：习惯 VS Code/JetBrains，不想换工具，但又想用更灵活的 Agent
- 模型灵活切换：不同任务需要不同模型（如调试用 Claude、写文档用 Gemini），Kilo 支持任务中切换
- CLI 自动化：在服务器上直接用
kilo run --auto做自动化任务，适合 DevOps/CI - 团队代码评审：配置 PR 自动评审，无需每次都手动邀请 AI
- 透明定价：不想被 IDE 厂商的模型溢价坑钱，Kilo 按提供商实际价格计费
- KiloClaw 云端 Agent：不想本地跑，可在 web 端使用托管的 AI agent
坑与注意
- CLI 基于 OpenCode fork：Kilo CLI 本质是 OpenCode 的增强版，如果你熟悉 OpenCode，上手会更快。
- 账户注册要求：VS Code 扩展和云端功能需要创建 kilo.ai 账户，纯 CLI 部分可能可离线用（未验证）。
- 500+ 模型是营销说法：实际可用的模型取决于服务商 API 稳定性，部分小众模型可能存在兼容问题。
- Review agent 不在 CLI/VS Code 中内置：文档提到 VS Code 和 CLI 不包含内置 Review agent，代码评审需通过 web 端配置。
- Orchestrator 已废弃：旧版有 orchestrator agent，但文档明确说已废弃，不要用了。
- 自主运行风险：
kilo run --auto相当于给 Agent 完全信任，生产环境慎用，建议先用普通模式测试。 - 中文文档有限：主要文档是英文，中文用户可能需要借助翻译。
与同类对比
| 工具 | Stars | 特点 | 价格 |
|---|---|---|---|
| Kilo | 25,671 ⭐ | 三端统一 + 500+ 模型 + 透明定价 | 按模型提供商定价 |
| Cursor | 闭源 | 最流行的 AI IDE，但锁定平台 | 订阅制（溢价明显） |
| Windsurf | 闭源 | Codeium 自家模型为主 | 订阅制 |
| Claude Code (Anthropic) | 官方 CLI | 纯 CLI，最新模型直接用 | 按 API 计价 |
| OpenCode | 较低 | Kilo 的上游，更轻量 | 按 API 计价 |
| GitHub Copilot | 闭源 | IDE 深度集成 | 订阅制 |
Kilo 的核心差异化： 跨 IDE + 跨模型 + 零溢价的组合目前在开源领域较为少见，适合对灵活性和成本敏感的用户。
一句话结论
如果你既想用 Claude Code 风格的 Agent 能力，又不想被某个 IDE 绑定，还想自己控制用哪个模型付多少钱——Kilo 是目前最接近"全开源全链路"的选择。