Kilo Code 是一个开源 AI 编程 Agent，同时覆盖 VS Code、JetBrains 和 CLI 三端。截至本文写作时在 GitHub 上收获约 2.8 万 Star，main 分支几乎每天都有提交。它主打「500+ 模型随便切、按供应商原价付费零加价、不需要 API Key 就能开始」。
为什么值得用？第一，它注册一个 Kilo 账号就能直接用 GPT-6 Astra、Claude Fable 5.1、Gemini 3.8 Flash、Grok 4.6、DeepSeek V4.1 Flash 等主流模型，按供应商原价结算，不用自己一个个去申请 API Key。第二，它内置 Code / Plan / Ask / Debug 四个专职 Agent，按任务切换。第三，CLI 版支持 kilo run --auto 全自动跑 CI/CD，无人值守。本文从零开始，把 Kilo Code 在 VS Code 和 CLI 上装好、配好模型、跑通第一个任务。
一、项目介绍与适用场景
Kilo Code 是一个「IDE 扩展 + CLI + 桌面云」三形态的 AI 编程 Agent：
- VS Code 用户：装扩展后，在编辑器侧边栏直接和 Agent 对话，它跨文件改代码、跑命令。
- JetBrains 用户：插件市场装 Kilo Code 插件，享受同样体验。
- 终端党：用 CLI 版
kilo命令，在任意项目目录里跑。 - CI/CD 用户：用
kilo run --auto "..."全自动跑，接进流水线。 - 团队：用 Cloud Agent（app.kilo.ai/cloud）在网页上跑 Agent，不需要本地机器。
二、核心功能逐条拆解
- 四专职 Agent：Code（默认写代码）、Plan（写架构计划）、Ask（只问不改文件）、Debug（排查问题），可自建自定义 Agent。
- 500+ 模型：注册即用，按供应商原价零加价；任务中途可切模型。
- 内联补全：Ghost-text 风格的 tab 接受补全。
- 自检查：Agent 写完代码自己 review、自己修。
- 终端与浏览器控制：跑命令、操作浏览器。
- Kilo Marketplace：装社区 Agent、Skill、MCP 服务器、插件。
- Cloud Agent：网页版 app.kilo.ai/cloud，不需要本地机器。
- Code Reviews：在 app.kilo.ai/code-reviews 给 PR 配自动 AI review。
- 自主 CI/CD：
kilo run --auto "跑测试修失败"全自动无人值守。
三、全套官方链接
| 类型 | 链接 |
|---|---|
| GitHub 仓库 | https://github.com/Kilo-Org/kilocode |
| 官方文档 | https://kilo.ai/docs |
| VS Code 扩展 | https://marketplace.visualstudio.com/items?itemName=kilocode.Kilo-Code |
| JetBrains 插件 | https://plugins.jetbrains.com/plugin/28350-kilo-code |
| CLI npm | https://www.npmjs.com/package/@kilocode/cli |
| Cloud Agent | https://app.kilo.ai/cloud |
| License | MIT |
四、硬件与环境前置要求
- VS Code 扩展：VS Code 1.80+。
- JetBrains 插件：JetBrains 2023.3+。
- CLI 版：Node.js 18+（npm 安装）；或用官方 curl 脚本（自带 Node 运行时）。
- 账号：注册一个 Kilo 账号即可开始用，不需要单独申请各模型 API Key。
- 硬件：本体 < 200MB，模型推理在云端。
五、多平台安装步骤
5.1 VS Code 扩展
在 VS Code 扩展市场搜 Kilo Code，发布者是 Kilo-Org，扩展 ID kilocode.Kilo-Code。或直接点 https://marketplace.visualstudio.com/items?itemName=kilocode.Kilo-Code。
装完点侧边栏 Kilo 图标，注册账号就能用 500+ 模型。
5.2 CLI 安装（全平台）
官方 README 给出五种方式：
# 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
Arch Linux AUR：
paru -S kilo-bin
5.3 GitHub Releases 二进制
官方 README 给出的资产表：
| 平台 | 文件名 |
|---|---|
| Windows x64 | kilo-windows-x64.zip |
| macOS Apple Silicon | kilo-darwin-arm64.zip |
| macOS Intel | kilo-darwin-x64.zip |
| Linux x64 | kilo-linux-x64.tar.gz |
| Linux ARM | kilo-linux-arm64.tar.gz |
官方备注：x64-baseline 是给老 CPU（无 AVX）的兼容版；musl 是静态链接版，给 Alpine 或最小 Docker 镜像用；kilo-vscode-*.vsix 是 VS Code 扩展包，不是 CLI。
5.4 JetBrains 插件
在 JetBrains IDE 的 Settings → Plugins 搜 Kilo Code，或从 https://plugins.jetbrains.com/plugin/28350-kilo-code 下载。
六、配置文件全部参数解释
6.1 启动
cd your-project
kilo
首次启动引导你注册 / 登录 Kilo 账号。
6.2 四个 Agent 切换
| Agent | 用途 | 是否改文件 |
|---|---|---|
| Code | 默认写代码 | 是 |
| Plan | 写架构计划 | 否 |
| Ask | 问问题 | 否 |
| Debug | 排查问题 | 视情况 |
在 VS Code 侧边栏顶部下拉切换；CLI 版用对应子命令或交互切换。
6.3 自主 CI/CD
官方 README 原文：
kilo run --auto "run tests and fix any failures"
--auto 自动批准所有权限提示（除非规则显式拒绝）。官方 WARNING：只在可信环境用。
6.4 模型切换
500+ 模型在对话界面里随时切换；任务中途切模型保留上下文。
七、启动、后台与日常使用
7.1 启动
CLI：kilo。VS Code：点侧边栏图标。
7.2 后台常驻
CLI 版交互式用 tmux 包；kilo run --auto 是一次性 headless 任务，适合直接挂 CI。
7.3 修改端口
Kilo 是客户端，不监听端口；接本地 Ollama 时在 provider 设置里改 Base URL。
八、功能实操教程
第 1 步：npm install -g @kilocode/cli 装好 CLI。
第 2 步：cd 到一个项目，敲 kilo。按提示注册 / 登录 Kilo 账号。
第 3 步：在模型列表里选一个（比如 Claude Fable 5.1 或 Gemini 3.8 Flash）。
第 4 步：切到 Plan Agent，输入「帮我规划一下怎么给这个项目加用户登录」。它只读代码、列计划、不改文件。
第 5 步：切到 Code Agent，说「按刚才的计划实现」。它开始跨文件改代码，每次改动弹 diff 让你确认。
第 6 步：让它跑测试——「跑一下 npm test，失败的自己修」。它会执行命令、看报错、迭代修复。
第 7 步：试 CI 模式——kilo run --auto "run tests and fix any failures"。全自动无人值守。
第 8 步：试 VS Code 扩展——在 VS Code 里装扩展，登录同一账号，配置和 CLI 同步。
九、全套报错故障排查
报错 1： kilo: command not found
原因分析：npm 全局 bin 不在 PATH。
解决方案：echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。
报错 2： 启动后登录失败。 原因分析：网络访问 Kilo 服务不通。 解决方案：检查网络；国内网络可能需要代理。
报错 3： 选了模型后 401。 原因分析：账号没余额或没登录。 解决方案：重新登录；在 Kilo 控制台看余额。
报错 4： --auto 模式下命令被拒绝。
原因分析：官方 README 说 --auto 是「auto-approve unless a rule explicitly denies」，某些高危命令仍被规则拒绝。
解决方案：看输出里的拒绝原因；如果是规则限制，临时关掉对应规则或手动跑。
报错 5： 老 CPU 上二进制跑不起来。
原因分析：官方备注——老 CPU 无 AVX 指令集。
解决方案：下载 kilo-*-x64-baseline.zip 兼容版。
十、升级、回滚与卸载
升级：npm update -g @kilocode/cli；VS Code 扩展自动更新；brew 版 brew upgrade kilo。
备份建议：CLI 配置在 ~/.kilo/；VS Code 扩展配置跟随 VS Code profile。
回滚：npm install -g @kilocode/cli@具体旧版本。
卸载：npm uninstall -g @kilocode/cli；VS Code 扩展里 Disable → Uninstall。
十一、商用许可与合规风险提示
Kilo Code 采用 MIT（README 原文："MIT. You're free to use, modify, and distribute this code, including commercially, as long as you keep the attribution and license notices."），可自由商用、二次开发。注意：
- CLI 是 OpenCode 的 fork：README FAQ 明确「Kilo CLI is a fork of OpenCode, enhanced to work within the Kilo agentic engineering platform」。MIT 兼容，无法律问题，但要保留原作者署名。
- 模型费用走 Kilo 账号：按供应商原价零加价，但你和 Kilo 签的是 Kilo 的服务条款，不是直接和 Anthropic / OpenAI 签约；团队商用前看 Kilo 的 ToS。
- 代码隐私：通过 Kilo 中转的代码会经过 Kilo 服务器；敏感项目走自己的 API Key 直连模式（在设置里切）。
--auto模式：官方 WARNING 只在可信环境用，否则 Agent 可能误删文件或跑危险命令。
参考链接
- GitHub 仓库：https://github.com/Kilo-Org/kilocode
- 官方文档：https://kilo.ai/docs
- VS Code 扩展：https://marketplace.visualstudio.com/items?itemName=kilocode.Kilo-Code
- JetBrains 插件：https://plugins.jetbrains.com/plugin/28350-kilo-code
- CLI npm：https://www.npmjs.com/package/@kilocode/cli
- Releases：https://github.com/Kilo-Org/kilocode/releases