Kilo Code AI 编码代理上手指南：从五文件重构到无人值守跑测试-育师

Kilo Code AI 编码代理上手指南：从五文件重构到无人值守跑测试

【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode

你正在重构一个跨五个文件的功能，手动挪代码怕漏掉引用，改完又怕改坏。代码补全工具只能提示下一行，跑测试、审改动都得你自己来。Kilo Code AI 编码代理就是为这类任务准备的开源工具：它装在 VS Code、JetBrains 或终端里，替你写代码、执行命令、审查改动。项目采用 MIT 协议，500+ 模型可选，按厂商原价计费，起步不需要自备 API Key。

五分钟跑通：开源 AI 编码代理安装

这节解决"从下载到看到第一个结果"的问题。

推荐路径（VS Code 扩展）：按Ctrl+Shift+X打开扩展面板，搜索 "Kilo Code"。安装按钮旁有个下拉箭头，选 "Install Pre-Release Version"——这只是市场分发渠道的标签，扩展本身稳定可用。装完重启编辑器，侧边栏会出现 Kilo Code 图标。

备选路径（CLI 命令行）：习惯终端就装命令行版本，一条命令完成开源 AI 编码代理安装：

npm install -g @kilocode/cli

装完在项目目录直接运行：

kilo

会进入交互式的 TUI 界面。

两条路径都用同一个任务验收：输入"创建一个 hello.txt，内容 Hello, world!"，发送后等它完成。确认跑通的标准：聊天面板显示任务完成，且工作区里真实出现了 hello.txt。JetBrains 用户则从插件市场搜 "Kilo Code"，流程一致。

核心工作流拆解：按你的决策顺序来

这节按你实际操作时的先后顺序讲：先选角色，再描述任务，最后审批动作。

先选角色（多角色模式切换）：适合"先设计再实现"的流程。触发方式：VS Code 里点聊天面板顶部的模式下拉框；CLI 里按Tab循环切换，或输入/agents打开选择器。最短示例：Plan 模式输入"设计一个 JWT 登录 API"，拿到方案后切回 Code 模式落地。
再用自然语言描述任务：适合任何写代码、查问题、要解释的场景。不用记指令格式，动词开头说清目标即可。最短示例："给这个函数补上错误处理"。
然后审批敏感动作：适合让 AI 动手执行命令的场景。默认 shell 命令、访问项目外目录会先暂停等你确认，你会看到工具名和参数。想省事就在设置里调整，见下文安全一节。
迭代到满意为止：适合需要多轮打磨的任务。补一句反馈就继续，比如"把日志级别改成 warning"。

内置角色共五个：Code（写代码）、Plan（先出方案）、Ask（只读不改）、Debug（排查问题）、Review（审查改动），各角色的工具权限不同，切错角色最多是方案偏了，不会误改文件。

一个完整任务走查：加一个 JWT 登录接口

需求：给现有 Web 项目加/login接口，接收用户名和密码，返回 JWT 令牌，附单元测试。

操作：

切到 Plan 模式，输入需求，拿到一份含路由、校验、加密逻辑的方案。
确认方案后切到 Code 模式执行。它跨多个文件生成代码；需要装依赖时先展示终端命令，你批准后继续。
实现完成后切到 Review 模式，审查未提交的改动。
它指出密码比对用了明文，切回 Code 模式当场修掉。

结果：新增 4 个文件，测试全部跑通，Review 列出 1 个问题并已修复。全程你只干预了 3 次：1 次方案确认、1 次终端命令批准、1 次修复指令。剩下的读文件、写代码、跑测试都是它自己完成的。

安全与可控：让 AI 动手但不出事

这节回答"敢不敢让它改我的项目"。两个机制默认就开着，不用额外配置。

检查点与回滚：任务执行过程中，Kilo Code 定期给工作区存档。改乱了就在检查点列表里点"回滚到此处"，文件恢复存档版本。存档存在项目外的独立仓库里，不会污染你自己的 Git 历史。

命令审批：设置里打开 Auto-Approve 页，每个工具三档——允许、询问、拒绝。默认策略是"未匹配规则则询问"，shell 命令、外部目录访问、敏感文件读取都会先问你。

权限边界：Ask 模式的工具权限是只读的，写操作直接被拦；Plan 模式同样不能动手。所以"只问不改"不是口头承诺，是权限层面卡死的。

进阶玩法：自定义模式与 CI/CD 无人值守

适合有经验的读者，篇幅点到为止。

自定义模式：Settings → Agent Behaviour 里给每种模式单独写角色描述、指定 API 配置，把"文档撰写""安全审查"这类固定职责固化下来。
MCP 扩展：接入 MCP 服务器给代理加新能力，企业版还能按组织控制 MCP 安装范围。
任务中换模型：模型可随时切换，不用重开会话。
CI/CD 无人值守：一条命令让 CLI 跑完任务：

kilo run --auto "run tests and fix any failures"

--auto关闭所有确认提示，只在可信环境里用。

Kilo Code AI 编码代理上手指南：从五文件重构到无人值守跑测试