Kilo Code 本地构建实战：Bun 3 条路径跑通 CLI、VS Code 扩展与 Nix 环境

Kilo Code 本地构建实战Bun 3 条路径跑通 CLI、VS Code 扩展与 Nix 环境【免费下载链接】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/kilocodeKilo Code 是开源的 AI 编码智能体平台你可以在本地把它构建出来命令行里的 Kilo CLI、VS Code 里的 Kilo Code 扩展或者用 Nix 锁定版本的开发环境。本文给你一套可直接复制的本地部署与构建命令装完依赖、构建产物、验证运行每一步都告诉你应该看到什么。先把 CLI 跑起来最快路径不管最后走哪条路第一步都一样装 Bun装依赖启动。Kilo Code 的包管理器是 Bun根目录package.json里写死bun1.3.14不是 pnpm 也不是 npm别装错。# 安装 Bun 1.3.14 curl -fsSL https://bun.sh/install | bash # 克隆仓库 git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode # 安装依赖postinstall 会自动修复 node-pty 并初始化 git 钩子 bun install # 启动本地 CLI bun devbun dev会在packages/opencode目录下启动 Kilo CLI 的终端界面TUI。看到 TUI 启动、可以输入对话就说明本地环境已经可用了。原理说明bun dev是本地开发版的kilo命令两者跑的是同一套 CLI 接口。改完代码直接bun dev就能看到效果不需要重新打包。选你的路按人群分你主要用终端写代码 →路径 ACLI 终端路径上面的命令就是它你要改 VS Code 扩展的代码 →路径 BVS Code 扩展路径你是 NixOS / 用 Nix 管理工具链 →路径 CNix Flake 路径三条路径共享同一个前提仓库已经 clone、依赖已经装好。下面的版本要求对三条路径通用。环境与版本要求依赖项版本为什么是这个版本验证命令Bun1.3.14根package.json的packageManager字段锁定lockfile 与之配套bun --versionJava21JetBrains 插件packages/kilo-jetbrains/的 typecheck 和测试依赖它java -versionVS Code1.105.1packages/kilo-vscode/package.json的engines.vscode要求code --versionNix支持 Flakesflake.nix声明的开发环境入口仅路径 C 需要nix --version不碰 JetBrains 插件可以跳过 Java后面会给你一条绕过命令。路径 ACLI 终端路径适合日常开发与贡献者适用谁想跑起 Kilo CLI、改packages/opencode/里的智能体逻辑、或者提交 PR 的贡献者。原理一句话Bun 直接把 TypeScript 源码当入口跑跳过编译步骤装依赖即可运行。命令就是最快路径那四步。装完后做两个自检# 自检 1查看 CLI 全部命令应列出 dev/serve 等子命令 bun dev --help # 自检 2对另一个目录运行例如让 CLI 指向仓库根目录 bun dev .两个自检点--help输出了命令列表、TUI 能正常拉起路径 A 就通了。想以后在任意目录都能用这个本地版本仓库提供了一键注册脚本./bin/kilodev dev-setup它会检测你的 shell确认后往 rc 文件写入别名可重复执行只改一次。之后在任何项目目录里敲kilodev就能打开 TUI。坑点提醒不要在仓库根目录跑bun test。根目录的 test 脚本是故意失败退出的——所有测试都在各自拥有它的包里跑例如 CLI 的测试要进packages/opencode/再执行bun test。路径 BVS Code 扩展路径适合扩展开发者适用谁要改packages/kilo-vscode/里的扩展代码或 webview 界面的人。原理一句话仓库自带一个启动脚本launch.ts它先构建扩展、再自动拉起一个独立的 VS Code 开发宿主实例加载本地扩展免去手工装 VSIX 和配 F5。先确认本机 VS Code 满足engines要求1.105.1然后# 一键构建 启动开发宿主自动检测 macOS/Linux/Windows 上的 VS Code bun run extension如果不想污染自己主用的 VS Code 配置用隔离模式。它会用.kilo-dev/目录里独立的 IDE 实例和 Kilo 状态装的扩展、登录、会话、缓存都只留在仓库里# 隔离模式状态跨次启动保留 bun run extension:isolated # 清掉 .kilo-dev/ 再启动模拟全新安装 bun run extension:isolated:clean也可以指定要打开的目录bun run extension:isolated -- ../sample-project。需要发布用的 VSIX 时在扩展包目录里构建cd packages/kilo-vscode bun run package自检点开发宿主窗口自动弹出后活动栏出现 Kilo Code 图标侧边栏能看到 Kilo Code 面板bun run package结束时终端输出.vsix文件路径。构建脚本内部会先准备本地 CLI 二进制和 SDK再跑类型检查、lint 和生产 bundle全绿才算构建完成。路径 CNix Flake 路径适合 NixOS 与可复现环境需求适用谁NixOS 用户或希望所有工具链Bun、Node、JDK、Playwright、ripgrep……都锁定到仓库flake.lock版本、换台机器也能原样重建的人。原理一句话仓库根目录的flake.nix声明了一个 devShell进入 shell 时 Nix 把 Bun、Node 20、Java 21 等工具一次性装好并自动设好KILO_ROOT等环境变量。首次使用先在/etc/nix/nix.conf打开 flakes# 启用 flake 实验特性 echo experimental-features nix-command flakes | sudo tee -a /etc/nix/nix.conf sudo systemctl restart nix-daemon然后在仓库根目录进入开发环境# 进入 flake dev shell首次会按 flake.lock 解析依赖 nix develop进入后做自检# 应输出 flake 里构建的 Bun 版本而不是你系统里的 bun --version # devShell 内置的开发入口等价于 bun dev但跑在 flake 环境里 kilo-dev --help坑点提醒在 dev shell 里直接bun dev会报KILO_ROOT is not set。kilo-dev这个入口脚本依赖 shell 启动时设置的KILO_ROOT所以优先用它或者手动export KILO_ROOT$PWD后再跑。卡住了对着这张表自查现象原因一句话修复命令bun install报 lockfile 相关错误本机 Bun 版本和packageManager锁定的 1.3.14 不一致curl -fsSL https://bun.sh/install | bash bun --version安装卡在node-pty等原生模块编译编译工具链缺失或缓存损坏bun install --force根目录跑bun test直接失败退出根 test 脚本是故意失败的测试必须进包内跑cd packages/opencode bun test全量 typecheck 在 JetBrains 包上报 Java 错误本机没有 Java 21而 turbo 默认包含该包bun turbo typecheck --filter!kilocode/kilo-jetbrainsbun run extension提示找不到 VS Code未装 VS Code 或不在自动检测范围安装 VS Code≥1.105.1后重试或给launch.ts传--app-path PATHbun run package卡在 bundle/类型检查扩展包内部依赖未构建完整回仓库根目录重跑bun install再cd packages/kilo-vscode bun run packagenix develop 后跑bun dev报KILO_ROOT is not setdev shell 的入口脚本依赖该环境变量kilo-dev或export KILO_ROOT$PWD后再运行收尾三条路径其实就一件事Bun 装依赖然后选一个入口bun dev、bun run extension、kilo-dev跑起来。跑通之后建议从这几处继续贡献规范与检查清单CONTRIBUTING.md本地后端与 curl 验证方法TESTING.md开发环境官方文档packages/kilo-docs/pages/contributing/development-environment.mdCLI 核心源码packages/opencode/src/【免费下载链接】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），仅供参考