企业官网建设流程全解析

Kilo Code 教程：10 分钟装好并跑通第一个任务

【免费下载链接】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 和命令行三个入口里，可选 500+ 模型并支持任务中途切换，替你写代码、跑终端命令、审查改动。这篇带你从零装好它，再一步步跑完第一个真实任务。

2 分钟装好：VS Code、JetBrains、CLI 三个入口

你只需要装一个入口，不是三个。哪个顺手用哪个，任务在哪边写都行。

VS Code 扩展（最多人走这条路）：按Ctrl+Shift+X打开扩展面板，搜索 "Kilo Code"。注意当前版本走预发布渠道，要点开 Install 按钮旁边的下拉箭头，选Install Pre-Release Version——这只是市场分发渠道的标签，扩展本身是稳定版。前提是你的 VS Code 在 1.84.0 以上。

命令行：习惯终端的话直接装 CLI，一条命令的事：

npm install -g @kilocode/cli

装完进任意项目目录敲kilo启动交互界面；第一次使用先跑kilo auth login完成登录。

JetBrains：在任意 JetBrains IDE 里打开Settings → Plugins，搜索 "Kilo Code" 安装。

装好了怎么确认？VS Code 侧边栏出现 Kilo Code 图标，点开能看到聊天输入框；CLI 则是在任意目录运行kilo能进入交互界面。满足任意一条就可以开工了。

第一次跑通：用 hello.txt 走完整流程

别一上来就丢大任务。官方快速上手给的最小例子，5 步能走完：

1. 点开 Kilo Code 面板，看到聊天输入框。
2. 用自然语言写任务，不用记任何指令格式，比如：创建一个文件叫 hello.txt，内容是 Hello, world!
3. 按 Enter 发送。
4. Kilo Code 分析请求后提出动作，逐条给你看工具名和参数，你批准或拒绝。
5. 不满意就继续追加指令，它会迭代到任务完成为止。

第 4 步的默认规则值得记住：大多数工具自动放行，只有 shell 命令、外部目录访问和敏感文件读取会弹确认。也就是说，它会先给你看要执行的命令长什么样，你点允许它才动手——这个权限范围后面随时可调。

跑通 hello.txt 之后，可以换两个同样简单的任务练手："写一个 Python 函数，把两个数相加"，或者"建一个标题为 Kilo test 的 HTML 页面"。都通过后，流程你就摸熟了。完整分步说明见 quickstart 文档。

切换角色代理：Code、Plan、Ask、Debug 各管什么

Kilo Code 内置5 个角色代理：Code（默认，写代码改代码）、Plan（先出方案不写码）、Ask（只答问、不动任何文件）、Debug（排查问题）、Review（审查改动，覆盖性能、安全、风格、测试覆盖）。什么时候用：新功能先用 Plan 拿到实现方案，确认后切 Code 落地；接手陌生代码时切 Ask 读项目，它只有只读权限，改不坏东西；测试挂了切 Debug 定位。

怎么切：聊天面板顶部有角色下拉框；在输入框敲/agents打开选择器；用快捷键Ctrl+.（macOS 是Cmd+.）在角色间循环，加 Shift 反方向。CLI 里按 Tab 和 Shift+Tab 前后切换。

模型是另一条切换轴。它提供500+ 模型，按模型厂商原价计费、零加价，起步不需要自备 API Key，任务进行到一半也可以随时换——长推理用强模型，批量小改动换快模型，按任务匹配延迟和成本。

检查点与放行范围：AI 改乱了能一键退回去

检查点（Checkpoints）。什么时候用：让 AI 大动一个关键文件之前心里没底的时候。它默认开启，底层是 git 快照，快照仓库存在项目目录外面，你项目的.git历史完全不被碰，并且遵守.gitignore。用法：每轮对话改了文件都会显示可折叠的 diff 摘要；悬停在任意一条用户消息上会出现Revert to here按钮，点它工作区回到该消息发送前的状态，后续消息被隐藏。注意回滚粒度是按用户消息，不是按每一步——一条回复里 AI 分多次改文件，回滚会一次全退。想反悔还有 Redo 和 Redo All 逐步恢复，回滚在你发新消息之前都是无损的。

放行范围（Auto-Approve）。什么时候用：嫌每次弹确认烦，或者觉得默认放得太宽的时候。用法：设置（齿轮图标）里打开Auto-Approve标签页，把每个工具单独设为 Allow、Ask、Deny 三档；CLI 用户改kilo.jsonc里的permission配置项。

接进 CI/CD：一条命令无人值守修测试

有经验的团队可以把 CLI 塞进流水线。一次性非交互任务用kilo run：

kilo run "add error handling to src/api.ts"

加--auto后关闭所有确认提示，让代理无需人工批准直接执行，专为 CI/CD 设计：

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

这条只在可信环境里用——它在生产机上跑等于把 shell 全权交出去。

往深走还有两块：Settings 的 Providers 标签页可以加Custom provider，或者在kilo.jsonc里写provider.<id>.models把本地 LM Studio、Ollama 模型接进来，模型引用格式是provider_id/model_id；MCP marketplace 则负责接外部服务器扩展代理能力。

合上这篇文章，接着做这两件事

1. 还没跑过的话，把 hello.txt 最小任务走完，确认批准、回滚、换角色的手感。
2. 挑一个真实小需求，走 "Plan 出方案 → 你确认 → Code 落地" 的组合，比一次性上大任务更容易建立判断力。

想改配置细节看 checkpoints 文档，想给项目提代码或文档，从 CONTRIBUTING.md 入手即可。

【免费下载链接】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