Kilo Code 教程:安装、免费额度与 Roo Code 迁移
接棒 Roo Code 社区的 AI 编码代理:在 VS Code 里装好扩展、领取 $20 赠送额度、用自己的 API key 直连 DeepSeek,并在你的 Roo 配置彻底失效前完成迁移。
太长不看版
- Roo Code 于 2026 年 4 月 21 日官宣关停,VS Code 扩展 5 月 15 日下线——Roo 的官方分支 Kilo Code 成为其 300 万安装量的官方迁移去处。
- 扩展开源,自带 API key(BYOK)永久免费;新账户首次充值送 $20 赠送额度,另有免信用卡的 14 天企业版试用。
- DeepSeek 可直连:Settings → Providers 里填入 DeepSeek API key,base URL 用 https://api.deepseek.com,模型选 deepseek-flash 或 deepseek-v4-pro。
- 迁移是半自动的:先改名 Roo 的配置文件,再让迁移向导转换,写一个最小 kilo.jsonc——并且每个 API key 都要重新认证,因为 key 不会自动迁移。
Just Signed Up? Your first 14 minutes with Kilo Code
上手演示视频:Kilo (official)14:02
How to Migrate from Roo to Kilo
迁移演示视频:Kilo (official)2:07
上手演示录制于 2025 年 6 月,是 OpenCode 重构版(2026 年 4 月 2 日 GA)之前的旧版界面——菜单位置有变,但流程一致。迁移视频则为现行版界面。
截图取自 Kilo 官方 YouTube 视频帧,均署名并在每一步回链原视频时间点。本文文字为本站原创。
Kilo Code 安装与迁移,一步一步来
1 · 认识 Kilo Code(Roo 用户为何搬过来)
- 1
先懂背景:Roo Code 正在关停
2026 年 4 月 21 日,Roo Code 团队宣布关停扩展、全面转向 Roomote;VS Code 扩展于 5 月 15 日下线,GitHub 仓库转为只读归档。Roo 的分支 Kilo Code 发布了官方告别文,成为这约 300 万安装量的落脚点。
关停公告截图,Kilo 的维护者已经在评论区回应看原视频 0:04 处 - 2
认识五种交互模式
Kilo Code 内置五种模式:Code 负责写代码和实现功能,Architect 先规划再动手,Ask 负责解释,Debug 排查报错,Orchestrator 把大任务拆成子任务逐个击破。你也可以自定义模式——Roo 的自定义模式在迁移时会映射到这里。
模式选择器就在 Kilo Code 面板输入框上方看原视频 0:22 处 - 3
看看一条提示词能做出什么
在官方上手演示里,一条写清了应用用途、数据结构、排序搜索行为和 UI 设计的提示词,直接生成了一个可用的笔记整理应用(单文件 HTML),并自动在浏览器里打开。整个生成只花了约 3 美分的 API 额度。
成品笔记整理应用:卡片、标签、搜索和排序,一条提示词搞定看原视频 5:06 处 - 4
让 Architect 模式反过来问你
不知道该写什么需求时,Architect 模式会先采访你:以国际象棋游戏为例,它依次询问规则深度、单人还是双人、AI 强度,并给出可点击的选项。定稿计划(含架构图)会先写入 markdown 文件,再交给 Code 模式实现。
Architect 模式把模糊想法变成一个个可回答的问题看原视频 8:12 处
2 · 安装扩展,领取 $20 额度
- 5
安装 Kilo Code 扩展
在 VS Code 扩展市场搜索 "Kilo Code",或直接运行图中的命令:code --install-extension kilocode.Kilo-Code。扩展开源,覆盖 VS Code、JetBrains 和独立 CLI。
官方迁移视频里的一行式终端安装命令看原视频 0:10 处 - 6
领取注册赠送额度
注册后你会得到一个 Kilo Code 官方托管的 API 配置,自带免费额度——下方演示截图里写着 "$20 for free",kilo.ai/pricing 目前仍标注首次充值送 $20 赠送额度,外加免信用卡的 14 天企业版试用。自带 key(BYOK)则永久免费。
Settings → Providers:默认的 Kilo Code 配置和它的 $20 注册额度看原视频 1:18 处
3 · 用自己的 key 直连 DeepSeek
- 7
为自己的 key 新建一个配置档
打开 Settings → Providers,点 + 新建配置档(New Configuration Profile),起个名字——"DeepSeek" 或 "OpenRouter"——之后就能在主面板里一键切换,不影响内置配置。
新建名为 OpenRouter 的第二个配置档看原视频 1:46 处 - 8
填入 API key 并选模型
选择服务商类型、粘贴 API key、选模型。DeepSeek 直连按 kilo.ai/docs/ai-providers/deepseek 的指引:base URL 填 https://api.deepseek.com,日常编码选 deepseek-flash,重度推理选 deepseek-v4-pro。key 会安全存入 VS Code 的 SecretStorage。
服务商类型、API key、模型——DeepSeek 官方 Kilo 指南填的就是这三项看原视频 1:52 处
4 · 从 Roo Code 迁移
- 9
改名 Roo 的工作区文件(每个仓库都要)
迁移向导不读 Roo 前缀的文件,所以先用 Kilo 迁移指南里的命令改名:.roorules → AGENTS.md、.roo/rules/* → .kilo/rules/、.roomodes → .kilocodemodes、.roo/mcp.json → .kilocode/mcp.json、.rooignore → .kilocodeignore。动手前记得先备份 Roo 的 globalStorage 目录。
官方移植脚本:每个仓库五条复制/改名命令看原视频 0:34 处 - 10
写一个最小的 kilo.jsonc
kilo.jsonc 取代 Roo 的工具组权限——所有操作只有 allow、ask、deny 三种,可加路径通配。照迁移指南里的最小示例抄,填上模型,并在 instructions 里列出规则文件。
kilo.jsonc:模型选择加上针对读、写、终端命令的权限看原视频 1:10 处 - 11
用 kilo config check 校验
在终端运行 kilo config check,确认迁移后的配置能解析、引用的文件都在。首次启动扩展时,迁移向导也会自动转换遗留文件——.kilocodemodes 变成规范的 agent markdown 文件,.kilo/rules 作为回退保留。
一条命令确认迁移后的配置没问题看原视频 1:15 处 - 12
验证,然后停用 Roo(别卸载)
打开一个仓库,选 Code 代理,让它列出已加载的自定义 agent 和规则——答案应点名你迁移过来的 agent、规则、模型和权限。确认无误后,在扩展面板停用 Roo,保留一周左右作为回退,再考虑卸载。
验证答案列出了 Kilo 加载的每个 agent、规则、模型和权限看原视频 1:36 处
一图看懂 Kilo Code 与 Roo Code 的区别
| 维度 | Kilo Code | Roo Code |
|---|---|---|
| 现状 | 活跃运营,是 Roo 用户的官方迁移去向 | 2026 年 4 月 21 日官宣关停,扩展自 5 月 15 日起停用 |
| 血缘 | Roo Code 的分支(Roo 又源自 Cline),由独立公司接续开发 | Cline 的分支;原团队转做 Roomote |
| 现行扩展 | 基于 OpenCode server 重构(2026 年 4 月 2 日 GA),另有 JetBrains、CLI 和云端版本 | 遗留 v5.x 版线停更;GitHub 仓库只读归档 |
| 迁移路径 | 改名 + 向导流程,kilo.jsonc 权限,服务商需重新认证 | 无——工作区文件留在 .roo 路径;账单问题联系 billing@roocode.com |