Kilo Code本地部署指南：3条路径在30分钟内跑通你的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
我也栽过跟头：依赖装完弹版本冲突，Windows 上一跑路径解析直接翻车。其实 Kilo Code 本地部署没这么折腾——原生、WSL2 虚拟化、Nix 三条路子，挑一条，半小时跑起来。
3分钟选对部署方式
| 部署方式 | 适合谁 | 复杂度 | 预计耗时 |
|---|---|---|---|
| 原生环境（Bun） | macOS / Linux 的日常贡献者 | 2档 | 20分钟 |
| WSL2 虚拟化 | Windows 用户（绕开路径坑） | 3档 | 40分钟 |
| Nix Flake | NixOS 用户、要环境可复现的人 | 4档 | 15分钟 |
三条决策规则，照着走就行：
- 你在 Windows 上？直接走 WSL2，别硬试原生。
- 机器里已经有 Nix？走 Flake，装完最省心。
- 其余 macOS / Linux？原生 Bun 路线，最短路径。
原生环境：用Bun搭出5分钟开发环境
前置检查
| 工具 | 版本 | 验证命令 |
|---|---|---|
| Bun | 1.3.14+ | bun -v |
| Git | 2.30+ | git --version |
| VS Code | 最新稳定版 | code --version |
⚠️ 一个关键提醒：这个仓库的主包管理器是Bun，不是 pnpm。拿 pnpm 来装依赖，补丁和工作区都会对不上（仓库里 18 个 patch 全靠 Bun 应用）。
核心命令
curl -fsSL https://bun.sh/install | bash git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode bun install bun dev完成标志
bun dev能在终端拉起 Kilo 的 TUI，说明运行时已经通了。想验证图形端，跑bun run extension，会开一个独立 VS Code 扩展开发宿主窗口，里面挂着本地构建的 Kilo Code 面板：
窗口里能开新会话、发指令、看工具调用，就算本地部署完成。
Windows部署绕坑：走WSL2虚拟化
Windows 原生下跑构建，路径分隔符和盘符问题会反复咬你（上游 issue #1205、#1209 都是这类坑）。稳妥做法是把整个环境塞进 WSL2。
前置检查
- Windows 10 2004+ 或 Windows 11，BIOS 已开虚拟化
- VS Code 已装 Dev Containers 扩展（
code --install-extension ms-vscode-remote.remote-containers）
核心命令
wsl --install -d Ubuntu # PowerShell 执行，装完重启# 重启后进入 WSL curl -fsSL https://bun.sh/install | bash git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode bun install完成标志
WSL 内bun dev正常响应。VS Code 里Dev Containers: Reopen in Container打开容器终端，后续调试都在这一层做，主系统不再受污染。
NixOS用户：Flake一键拉齐本地部署环境
前置检查
Nix 2.18+，且已开启 flakes（nix --version确认）。仓库根目录的 flake.nix 已经定义好 devShell，Bun、Node 20、Java 21、Playwright 全在里面，不用逐个装。
核心命令
# 没开 flakes 的话先开 echo 'experimental-features = nix-command flakes' | sudo tee -a /etc/nix/nix.conf git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode nix develop完成标志
shell 里bun -v输出 1.3.14+，bun dev直接可用。退出 shell 环境即消失，复现性拉满——同事拉同一份 flake.lock，拿到的工具链和你一模一样。
报错先查这里：排错速查表
| 报错 / 现象 | 原因 | 一条修复命令 |
|---|---|---|
根目录bun test秒退失败 | 根 test 脚本被刻意禁用，防你跑错包 | cd packages/opencode && bun test |
bun turbo typecheck报找不到 Java | JetBrains 插件检查要 Java 21 | bun turbo typecheck --filter=!@kilocode/kilo-jetbrains |
| webview 一直停在旧版本 | 扩展宿主状态缓存了 | bun run extension:isolated:clean |
bun install报版本冲突 | 本机 Bun 低于 1.3.14 | bun upgrade（升到 1.3.14+） |
| 扩展宿主起不来、面板空白 | 启动错误藏在输出面板里 | 输出面板切到 "Kilo Code" 频道看日志 |
下一步去哪
开发流程、包级测试命令、PR 证据要求都写在 CONTRIBUTING.md 和 TESTING.md 里，动手前先过一遍。改 VS Code 扩展就去 packages/kilo-vscode/，动 CLI 逻辑则看 packages/opencode/，文档站点源码在 packages/kilo-docs/。卡住了就把报错贴到项目 Discord 社区问，入口链接在 README 里。
【免费下载链接】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），仅供参考
