Kilo Code 本地部署快速上手两条命令把 CLI 和 VS Code 扩展都跑起来【免费下载链接】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 本地开发环境装一个 Bun、装一次依赖然后分别拉起 CLI 核心引擎和 VS Code 扩展最后给出一套验证改动和常见报错的排查方法。命令全部来自仓库自身配置直接复制就能跑。先说清楚这个项目长什么样这是一个 monorepoCLI 核心AI 代理运行时、会话、HTTP 服务、TUI是绝对主角VS Code 扩展、JetBrains 插件、官网文档等全是它的客户端。所以新手路线就两条主线先把 CLI 跑起来再把 VS Code 扩展拉起来。先把工具链对号只有 Bun 是硬门槛整个仓库只认一个包管理器Bun。根 package.json 里的packageManager字段钉死了版本packageManager: bun1.3.14其他依赖看你要不要碰哪条产品线依赖版本什么时候需要Bun1.3.14永远需要所有命令都由它驱动VS Code1.105.1跑扩展开发宿主时Java21只有 JetBrains 插件需要装完验证一下版本bun --version低于 1.3.14 就升级。不用装 Node也不要用 pnpm——仓库里没有 Node 脚本锁文件是bun.lock。然后拉代码git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode bun installbun install结束时会自动跑两个 postinstall 钩子修复 node-pty 在特定平台的兼容问题、给仓库配置 git 冲突显示样式merge.conflictStylezdiff3上游合并流程依赖它。所以看到安装日志末尾闪过这两步是正常现象不用干预。第一条路一条命令把 CLI 拉起来依赖装好后在仓库根目录执行bun dev这一步会从 packages/opencode/src/index.ts 直接以源码方式启动 CLI一个交互式 TUI 弹出来——能打字、能发起对话说明代理引擎、会话管理、终端渲染整条链路都通了。两个高频用法bun dev ~/my-project # 默认它工作在自己所在目录想对别的项目说话就传目录 bun dev serve # 起无头 API 服务配合 curl 测后端接口CONTRIBUTING.md 里有句话值得记住开发期的bun dev就是构建产物kilo命令的本地版跑的是同一套 CLI 接口。区别只在于前者直接执行你眼前的源码后者是编译后的二进制。想连自己的后端设一个环境变量把所有网关流量指过去KILO_API_URLhttp://localhost:3000 bun dev第二条路把 VS Code 扩展拉起来想验证扩展侧的行为侧边栏对话、Agent Manager 面板别去装 Marketplace 的版本——那跑的不是你眼前的代码。用仓库自带的启动脚本bun run extension它会自动构建扩展再弹出一个开发宿主窗口加载的就是本地这份扩展。找不到 VS Code 可执行文件时加--app-path /path/to/VSCode或设VSCODE_EXEC_PATH环境变量指定。更推荐用隔离模式它把 VS Code 配置、Kilo 认证、会话、缓存全部关进仓库里的.kilo-dev/目录不碰你主 IDE 的真实配置bun run extension:isolated # 复用 .kilo-dev/上次装的东西还在 bun run extension:isolated:clean # 先清空再启动模拟全新安装这两条命令可以接一个目录参数直接打开指定项目bun run extension:isolated -- ../sample-project到这里两条主线的拓扑其实就一张图改动之后怎么确认没写挂改完代码别急着开 PR按这个顺序敲最小的一组检查# 仓库根目录lint 类型检查 bun run lint bun turbo typecheck --filter!kilocode/kilo-jetbrains # 没装 Java 就排除 JetBrains 包 # 进 CLI 包目录跑测试 cd packages/opencode bun test ./test/tool-define.test.ts # 先拿单个文件试水全量 bun test 耗时较长最后这个进包目录是硬规定根目录的test脚本被故意写成了打印do not run tests from root后退出 1。它是个陷阱专门防止你把所有包的测试混在一起跑。测试归谁所有就在谁的目录里跑。卡住的地方逐个排掉现象原因解法根目录bun test报错退出故意的测试必须进包目录跑cd packages/opencode后再bun testJetBrains 插件 typecheck 报找不到 Java该插件需要 Java 21纯前端检查可绕开turbo 命令加--filter!kilocode/kilo-jetbrains真要碰插件再装 Java 21扩展启动说找不到 VS Code自动探测失败--app-path传路径或设VSCODE_EXEC_PATH报 Bun 版本不够本地 Bun 太老对照根 package.json 的packageManager字段升级Windows 下bin/kilodev不可执行它有两个入口bash 版和kilodev.cmdWindows 用.cmd或直接把bin目录加进 PATH想再往里走一步AGENTS.mdmonorepo 结构说明 各产品线的质量检查清单贡献前必读TESTING.md如何用bun dev serve起本地后端再用 curl 打接口验证修复kilo-vscode 扩展开发说明扩展内部结构、Agent Manager 的细节把改动提交前再跑一遍bun run lint加上带 filter 的 typecheck两条全绿就可以开你的第一个 PR 了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考