Kilo Code保姆级教程：免费开源编程助手上手实测

AI实测笔记

348人浏览 · 2026-11-06 17:29:38

AI实测笔记 · 2026-11-06 17:29:38 发布

一、Cursor 太贵、Copilot 不自由？先看看这个开源平替

最近半年，VS Code 里的 AI 编程助手换了一茬又一茬。Cursor 每月 20 美元起步，订阅到期模型就降级；GitHub Copilot 绑定微软账号，模型选择权不在自己手里；Cline、Roo Code 这类开源助手又各有各的短板——Cline 只认一个模型配置，Roo Code 的模式切换用起来总觉得差一口气。

Kilo Code 就是在这种背景下冒出来的。它是开源的（MIT 协议，代码全在 GitHub 上），本身不卖模型，按官方说法是“一个智能体，接 500 多个模型”。它最大的卖点就两句话：第一，编辑器、终端、云端用的是同一个智能体；第二，模型按提供商原价结算，中间不加价。你可以自带各家 API Key，也可以走它的网关，甚至可以接本地 Ollama、LM Studio 的模型。

这篇教程的目标很具体：半小时内，在 VS Code 里装好 Kilo Code，接上一个能用的模型，用 Architect 模式规划、Code 模式落地，亲手跑通第一次改代码。不讲概念，只讲能复现的步骤。

二、安装：三步装进 VS Code

Kilo Code 目前有三个落点：VS Code 扩展、JetBrains 插件、终端 CLI。本篇只讲最常用的 VS Code 扩展，JetBrains 和 CLI 的路子文末会提一句。

第 1 步：打开扩展市场

启动 VS Code，按 Ctrl+Shift+X（Mac 是 Cmd+Shift+X），打开左侧的扩展面板。

第 2 步：搜索并安装预发布版

在搜索框输入 Kilo Code，找到发布者为 Kilo Code 的官方扩展。注意一个细节：官方文档建议不要点默认的 Install，而是点 Install 按钮旁边的小三角，选择 Install Pre-Release Version（安装预发布版）。原因是 Kilo Code 迭代非常快，新功能和新版智能体运行时先上预发布通道，稳定版反而落后好几个版本。装完不需要另外再装 CLI，扩展自带嵌入式运行时。

第 3 步：打开 Kilo Code 侧边栏

安装完成后，VS Code 左侧活动栏会出现 Kilo Code 的图标，点开就是聊天面板。第一次打开会提示登录 Kilo 账号，用 Google 账号登录即可。登录不是强制的，但登录后才能用网关的免费模型和云端功能；只用自己的 API Key 的话，也可以跳过登录直接配提供商。

装完先别急着提问，把下面这件事做完，否则第一次对话大概率会卡在“没有可用模型”上。

三、接模型：三种花钱方式，先选免费的

Kilo Code 本身不卖算力，它只负责把你的请求发给模型。模型从哪来，有三种路子，按推荐顺序排：

路子一：Auto Free，零成本起步

在聊天框上方的模型选择器里，有三个路由档位：Auto Free（免费）、Efficient（省钱）、Frontier（最强）。新手直接选 Auto Free，Kilo 会自动路由到当前可用的免费模型上。免费模型列表不长，而且会随着各家厂商的推广活动变化，某个模型下线了也不用奇怪，换一个就是。想先体验流程、不想掏一分钱的，选这个。

路子二：自带 Key（BYOK），按量付给模型厂商

点侧边栏的齿轮图标进 Settings，找到 Providers 标签页。这里能接 Anthropic、OpenAI、Google、DeepSeek、OpenRouter 等几十家提供商，填入自己的 API Key、选好模型就能用。费用直接结算给模型厂商，Kilo 不抽成。国内用户常用的一个搭配是 OpenRouter：一个 Key 后面挂多家模型，哪个便宜用哪个。本地模型也可以走这条路：Ollama 或 LM Studio 在本地起一个 OpenAI 兼容接口，Kilo 里配成自定义提供商就能连上，代码不出内网。

路子三：Kilo 网关与 Kilo Pass，按量或包月

不想自己管 Key 的，可以走 Kilo 自己的网关，500 多个模型按提供商原价结算，不加价；也可以买 Kilo Pass 订阅，每月 19 美元起，换成带赠送额度的用量。个人用户前期完全没必要买，先用免费档和自己的 Key 把流程跑顺再说。

配置存在哪：kilo.jsonc

Kilo 的配置是可移植的 JSONC 文件：全局配置在 ~/.config/kilo/kilo.jsonc，项目级配置在项目根目录的 ./kilo.jsonc。VS Code 扩展和 CLI 共用同一套配置，换机器把文件拷过去就能接着用。这里要记一条铁律：API Key 只写进配置文件或设置界面，绝不要把它粘贴到聊天框里，更不要把带 Key 的 kilo.jsonc 提交到公开仓库。

四、第一次改代码：Architect 先规划，Code 再动手

光装好不算会用。Kilo Code 真正值钱的是它的分工模式：Ask、Code、Architect、Debug 四个核心模式，各管一个阶段。新版本正在把模式升级成可自定义的 Agent（配置文件放在 .kilo/agents/ 目录下），但四模式的思路没变，学会这个流程，换新版也不用重新学。

下面用一个真实的小任务走完整流程：给一个 Python 项目加一个“读取 CSV 并输出统计”的小脚本。项目可以是空文件夹，跟着做就行。

第 1 步：新建一个空文件夹并用 VS Code 打开

在电脑上新建文件夹，比如 kilo-first-try，用 VS Code 打开它。Kilo Code 的聊天只认当前工作区的第一个文件夹，多根工作区时以第一个为准，这一点做项目时要注意。

第 2 步：切到 Architect 模式，让它先出方案

点聊天框上方的模式切换，选 Architect。输入需求：“用 Python 写一个脚本，读取同目录下的 data.csv（包含 name, age, score 三列），输出总人数、平均年龄、平均分，缺失值跳过并在最后提示跳过了几行。”

Architect 模式的特点是只规划、不写文件。它会先读一遍项目结构（现在是空文件夹），然后给出实现方案：用什么库、函数怎么拆、异常怎么处理。先看它的方案有没有跑偏，比如它如果建议装 pandas，你可以直接追问“不用 pandas，只用标准库实现”，方案会跟着改。方案满意了再往下走，这一步多花两分钟，后面能少改三四轮。

第 3 步：切到 Code 模式，让它把代码写出来

模式切换到 Code，输入一句：“按上面的方案实现，写到 stats.py，并生成一份包含 10 行示例数据的 data.csv 供测试。”

Code 模式会真的动手改文件。写完后它会在聊天里贴出改动摘要，VS Code 里会弹出文件差异对比，你可以逐行看它改了什么，确认没问题再点接受。第一次用建议把自动批准关掉，逐项确认，熟悉之后再放开只读操作和跑测试命令的自动批准。写文件、删文件这类高危操作，长期保留人工确认。

第 4 步：跑起来验证

在终端里执行：python stats.py

如果 data.csv 是它生成的示例数据，你应该能看到总人数、平均年龄、平均分三行输出，外加跳过行数的提示。跑通了，第一次改代码就算完成。整个过程你一行代码都没亲手写，但方案是你定的、每处改动是你确认的，这才是用智能体编程该有的姿势。

第 5 步：用 Ask 模式让它讲清楚

切到 Ask 模式，问它：“解释一下 stats.py 里处理缺失值的逻辑，为什么这样写？”Ask 模式只读不写，专门用来读代码、问问题，不会动你的文件。接手别人的项目时，先用 Ask 模式问一圈再动手，能少踩很多坑。

五、报错了别慌，Debug 模式是干这个的

故意把 data.csv 里某一行的 score 改成字母，再跑一次脚本，程序会抛异常。把报错信息连同“帮我定位原因并修复”一起发给 Debug 模式，它会先读代码、复现问题，再给出根因和修复方案，而不是上来就改代码。

Debug 模式的正确用法是：先让它说清根因，再让它修。直接丢一句“报错了，修一下”，它修完你也不知道修了什么，下次同类问题还是不会。让它把根因讲明白，修复方案你看一眼再确认，这才是把工具用成自己的。

六、规则文件与 MCP：让它按你的规矩干活

只用默认配置，Kilo Code 就是个通用助手。想让它按你的习惯干活，有两个抓手：

第一，自定义 Agent 与规则。 新版本支持在项目里放 .kilo/agents/ 下的 .md 文件自定义 Agent，相当于给不同任务各配一个专属助手。更轻量的做法是写工作流模板：把常用的提示词存成 .md 文件，需要时直接调用，省得每次重复描述需求。

第二，MCP 市场。 Kilo Code 内置了 MCP（Model Context Protocol）市场，可以接各种 MCP 服务器，比如联网搜索、读数据库、调内部接口。接上之后，智能体在写代码时就能直接查线上文档、读真实数据，而不是凭记忆编接口。接 MCP 之前先想清楚权限边界：只给它读权限的服务器，别把能写生产库的 MCP 交给一个会自动执行命令的助手。

七、踩坑提醒：这五条都是真金白银换来的

第一，装预发布版，别装稳定版。 稳定版更新慢，文档里写的新功能在稳定版上可能根本找不到。按 Install 旁边的小三角选 Pre-Release，是官方文档明确建议的做法。

第二，免费模型会变，别在一棵树上吊死。 Auto Free 的免费模型列表经常调整，今天能用模型的下周可能就没了。正式干活之前，先在模型选择器里确认当前可用的免费模型，或者干脆配一个自己的 Key 做保底。

第三，自动批准别全开。 Kilo 支持按工具设精细权限，还能用 glob 模式匹配文件范围。建议是：读文件、跑测试命令可以自动放行；写文件、删文件、执行 shell 命令里的高危操作，保留人工确认。图省事全开自动批准，等于把删库的钥匙交给了模型。

第四，Key 别进聊天框。 再强调一次：API Key 只出现在设置界面和 kilo.jsonc 配置文件里。聊天记录可能会被导出、截图、分享，Key 一旦出现在聊天框里，就等于公开了。

第五，它是 Roo Code/Cline 一脉，别重复造轮子。 如果你之前用过 Cline 或 Roo Code，Kilo Code 上手几乎零成本，模式和配置思路都是同一套。这篇教程所属的系列之前写过 Cline 和 Roo Code，那两篇里讲的模型配置、规则文件思路，在 Kilo Code 上照样适用。