企业官网建设流程全解析

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 扩展，最后给出一套验证改动和常见报错的排查方法。命令全部来自仓库自身配置，直接复制就能跑。

先说清楚这个项目长什么样：这是一个 monorepo，CLI 核心（AI 代理运行时、会话、HTTP 服务、TUI）是绝对主角，VS Code 扩展、JetBrains 插件、官网文档等全是它的客户端。所以新手路线就两条主线：先把 CLI 跑起来，再把 VS Code 扩展拉起来。

先把工具链对号：只有 Bun 是硬门槛

整个仓库只认一个包管理器：Bun。根 package.json 里的packageManager字段钉死了版本：

"packageManager": "bun@1.3.14"

其他依赖看你要不要碰哪条产品线：

装完验证一下版本：bun --version，低于 1.3.14 就升级。不用装 Node，也不要用 pnpm——仓库里没有 Node 脚本，锁文件是bun.lock。

然后拉代码：

git clone https://gitcode.com/GitHub_Trending/ki/kilocode cd kilocode bun install

bun install结束时会自动跑两个 postinstall 钩子：修复 node-pty 在特定平台的兼容问题、给仓库配置 git 冲突显示样式（merge.conflictStyle=zdiff3，上游合并流程依赖它）。所以看到安装日志末尾闪过这两步是正常现象，不用干预。

第一条路：一条命令把 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_URL=http://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。它是个陷阱，专门防止你把所有包的测试混在一起跑。测试归谁所有，就在谁的目录里跑。

卡住的地方，逐个排掉

想再往里走一步

• AGENTS.md：monorepo 结构说明 + 各产品线的质量检查清单，贡献前必读
• 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