3 步跑通 Kilo Code 本地开发环境：从 clone 到 CLI 与 VS Code 扩展全可用

3 步跑通 Kilo Code 本地开发环境从 clone 到 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场景切入clone 完仓库之后做什么你刚把仓库拉到本地——Kilo Code 是一个 AI 编码智能体coding agent平台同一个仓库里同时维护 CLIpackages/opencode和 VS Code 扩展packages/kilo-vscode。接下来的目标很明确依赖装好、CLI 能在终端跑起来、扩展能在开发宿主里加载。整条链路只需要一个运行时Bun不需要 pnpm也不需要 Node 作为主运行时Node 20 只被 Nix flake 顺带打包。环境体检开工前核对这几项依赖版本线用在哪自查命令Bun≥ 1.3.14运行时代码、装依赖、跑全部脚本根package.json锁定packageManager: bun1.3.14bun --versionGit任意较新版版本控制Husky 的 pre-push 钩子会校验 Bun 版本并跑 typecheckgit --versionVS Code≥ 1.105.1仅开发 VS Code 扩展时需要扩展engines.vscode字段约束code --versionJava 2121仅当你要跑 JetBrains 插件检查才需要VS Code/CLI 开发可跳过java -versionNix可选启用 flakes走声明式环境路线时用nix --version兼容性方面macOS、Linux、Windows 都能走原生路线扩展启动脚本会自动探测三个平台的 VS CodeNix flake 声明了aarch64-linux、x86_64-linux、aarch64-darwin、x86_64-darwin四个系统的 devShell也就是说 Nix 路线覆盖 macOS 和 LinuxWindows 用户建议直接走原生路线。选路指南按你的场景挑一条 判断只有一条主线你是否需要把依赖版本钉死在声明式环境里。如果你是 macOS/Linux 日常写代码原生 Bun 路线最短如果你希望新机器上一分钟进同一个环境走 Nix 路线仓库根目录的.envrc配了use flake装了 direnv 的话cd进仓库会自动进壳。实施路线路线 A原生 Bun 路线日常开发全平台准备安装 Bun 1.3.14 及以上。装完顺手确认版本对得上后面 pre-push 钩子会拿它和package.json比对。执行克隆仓库并安装依赖一条命令链走完git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode bun installbun install的 postinstall 会自动执行packages/core的 node-pty 修复脚本和script/setup-git.ts挂 Husky 钩子不需要你手动补步骤。确认跑仓库级检查确认工具链完整bun run lint bun run typecheck不碰 JetBrains 的话第二条可加过滤器跳过它对 Java 21 的依赖bun turbo typecheck --filter!kilocode/kilo-jetbrains。路线 BNix 声明式环境路线macOS / Linux准备启用 flakes在 nix 配置里加experimental-features nix-command flakes。仓库 flake 已把 Bun、Node 20、ripgrep、Playwright 浏览器、JDK 21 全部打进 devShell机器上不用单独装任何一项。执行进仓库即进壳git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode nix develop依赖已在 flake 中固化进壳后可直接跑命令没有 direnv 就手动nix develop一次。确认在 shell 里核对关键二进制就位bun --version which kilo-dev ripgrepkilo-dev是 flake 提供的入口脚本等价于bun dev指向packages/opencode源码。冒烟验证最小三个动作 验证目标是环境能用不是测功能。按顺序做三个动作CLI 能起来在仓库根目录运行bun dev --help输出完整的子命令列表即通过直接bun dev会启动 TUI方向键能移动就是活的。扩展能加载bun run extension会在一个独立的 Extension Development Host 里构建并启动 VS Code 扩展。通过标准宿主窗口里 Kilo Code 侧边栏正常渲染Output 面板选 Kilo Code 通道无红色报错。嫌它污染主配置就改用bun run extension:isolated:clean状态全部隔离在仓库内.kilo-dev/。检查能过bun run typecheck无错误即为绿灯。⚠️ 不要在仓库根目录直接跑bun test——根脚本被故意设计成直接失败退出bunfig.toml的 test root 指向不存在目录测试一律去归属包内跑比如cd packages/opencode bun test。故障速查现象在前五条高频错误现象bun install中途在 node-pty 相关原生编译处报错定位Bun 版本低于 1.3.14或 lockfile 与实际版本错位修复升级 Bun 到 1.3.14删掉node_modules后重新bun install现象根目录bun test秒退且返回非零定位这是预期行为不是环境坏了修复进对应包目录跑如cd packages/opencode bun test ./path/to/file.test.ts现象bun run typecheck结果和源码现状对不上改了没报错/没改却报错定位Turbo 缓存未失效修复bun turbo typecheck --force强制绕过缓存现象bun run extension起不来开发宿主或宿主里扩展静默失败定位本机 VS Code 低于 1.105.1或上一次隔离状态残留修复升级 VS Code仍不行就bun run extension:isolated:clean清掉.kilo-dev/重来再查 Output 面板的 Kilo Code 通道现象typecheck 挂在kilocode/kilo-jetbrains上提示 Java 相关错误定位没装 Java 21而你跑的是包含 JetBrains 包的默认过滤修复不碰 JetBrains 就加--filter!kilocode/kilo-jetbrains要碰就按 CONTRIBUTING.md 装 Java 21收尾到这里Bun 装好、依赖装好、CLI 和扩展都能在本地跑起来环境就搭完了。想改代码前先读一遍 CONTRIBUTING.md 里的护栏约定Kilo 改动要打// kilocode_change标记、服务端端点变更要重新生成 SDK要验证后端行为看 TESTING.md扩展相关实现都集中在 packages/kilo-vscode/。【免费下载链接】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），仅供参考