Kilo Code v7 JetBrains 插件安装全指南：Marketplace 与 Bundled Core 两种部署方式详解

Kilo Code v7 JetBrains 插件安装全指南：Marketplace 与 Bundled Core 两种部署方式详解

【免费下载链接】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 v7 是 Kilo 开源编码 Agent 面向 JetBrains 系列 IDE 的原生插件版本，采用原生 JetBrains 界面、无需 Node.js 即可运行，并针对 JetBrains 远程开发（Remote Development）的分屏模式做了专门优化。本文围绕 packages/kilo-docs/markdoc/partials/install-jetbrains.md 的完整安装流程展开，覆盖从 JetBrains Marketplace 的标准安装、启用插件自动更新，到面向企业内网/离线环境的 Bundled Kilo Core 自定义仓库安装，并深入源码说明两种构建在运行时上的本质差异，帮助你在不同网络与安全约束下快速落地。

Kilo Code v7：原生 JetBrains 体验的编码 Agent

Kilo Code v7 for JetBrains 是当前仓库中 JetBrains 客户端（packages/kilo-jetbrains）对应的正式版本。相比通过终端或外部工具间接使用 AI 编码 Agent 的方式，v7 插件直接嵌入 JetBrains 的原生界面，与 IDE 的编辑区、工具窗口、代码高亮与项目模型深度集成。

其几个关键特性决定了安装方式的选择：

• 原生 JetBrains 界面：对话、代码编辑建议与工具执行都以 JetBrains 原生 UI 呈现，交互体验与 IDE 本身一致；
• 远程开发分屏模式支持：在 JetBrains Remote Development（Gateway / 远程 IDE）场景下可以正常工作，这对云端开发环境、远程服务器工作流的开发者尤为重要；
• 不需要 Node.js：Kilo Core 运行时以独立二进制交付，无需在系统上预装 Node.js 环境。

插件本身会随每个版本持续改进，因此官方建议启用插件的自动更新，以第一时间获得修复与新特性。

方式一：从 JetBrains Marketplace 标准安装（推荐）

对绝大多数开发者而言，从 JetBrains 官方插件市场安装是最简单、维护成本最低的方式，具体步骤如下：

1. 打开 IntelliJ IDEA 或其他 JetBrains IDE（支持的 IDE 列表见下文）；
2. 进入Settings → Plugins（macOS 上为Preferences → Plugins）；
3. 在Marketplace标签页的搜索框中输入Kilo Code；
4. 点击Install按钮安装（若已安装旧版本则显示Update），安装完成后按提示重启 IDE；
5. 可选但推荐：进入Settings → Appearance & Behavior → System Settings → Updates，勾选启用Update plugins automatically（自动更新插件）。

启用自动更新后，Kilo Code 的修复与改进会在发布后自动下发到你的 IDE，无需手动检查版本。

说明：Marketplace 构建是官方默认推荐的方式，它保持了较小的插件体积，Kilo Core 运行时会在首次连接时按需下载（详见下文“运行时下载机制”）。

方式二：使用 Bundled Kilo Core 构建安装（离线/受限网络）

当你的 IDE 在安装后无法下载 Kilo Core 运行时，就需要使用 Bundled Kilo Core 构建。典型场景包括：

• 锁定的企业网络（locked-down corporate networks）：对外部下载域名有严格白名单；
• 严格代理或 TLS 检查环境（strict proxy or TLS inspection）：下载请求被中间设备拦截或改写；
• 离线开发环境（offline development environments）：物理隔离、无法访问公网；
• 企业策略禁止应用在运行时下载可执行文件（corporate policy blocks downloading executables at runtime）。

Bundled 构建与 Marketplace 构建的区别

从源码视角看，两种构建的差异非常清晰。仓库中的发布计划文档 packages/kilo-jetbrains/docs/bundled-release-plan.md 明确说明：

• Marketplace 构建：保持精简，插件 ZIP 体积小，Kilo Core 运行时在首次使用时从 GitHub Releases 下载；
• Bundled 构建：将 Kilo Core 直接内嵌（bundle）进插件包，首次启动无需单独下载运行时，但安装包体积更大。

之所以存在 Bundled 构建，还有一个直接原因：JetBrains Marketplace 对插件 ZIP 有 400 MB 的大小上限，而 Kilo Core 需要覆盖六个平台的二进制，因此 Bundled 构建无法通过 Marketplace 分发，只能走自定义插件仓库（custom plugin repository）渠道，由 GitHub Pages 托管updatePlugins.xml描述文件。

在同一 tag、同一源码、kilo.cli.pinned=true的前提下，两种构建唯一的构建差异是 Gradle 属性-Pkilo.cli.bundled=true；kilo.properties在两种构建间保持字节级一致，唯一区别是kilo-cli.zip是否被嵌入 backend jar。

添加自定义插件仓库并安装

Bundled 构建的安装步骤如下：

1. 打开Settings → Plugins；

2. 点击右上角的齿轮图标，选择Manage Plugin Repositories...（管理插件仓库）；

3. 点击+添加 Kilo Code 的仓库 URL：

   https://kilo-org.github.io/kilocode/jetbrains/updatePlugins.xml

4. 点击OK保存，然后回到Settings → Plugins，从插件列表中找到Kilo Code执行安装或更新；

5. 若提示需要重启 IDE，重启即可。

该仓库 URL 由 GitHub Pages 静态托管，updatePlugins.xml仅在 stable（稳定版）发布时更新，指向已签名 Bundled ZIP 的下载地址，RC 版本不会污染稳定渠道。

验证插件正在使用 Bundled Core

重启 IDE 后，打开Kilo Code工具窗口，点击右上角...菜单并选择Core，菜单底部应显示Bundled Core及其版本号与当前架构（如Bundled Core v7.4.20与平台架构信息）。

确认显示Bundled Core即说明插件未走运行时下载路径，而是直接从内嵌资源中解压并启动了 Kilo Core。

Bundled Core 的运行时实现原理

在运行时判定是否使用内嵌 Core，前端服务 packages/kilo-jetbrains/frontend/src/main/kotlin/ai/kilocode/client/app/KiloAppService.kt 中的bundled: Boolean?状态负责标记“当前运行的 Core 是随插件内嵌（true）还是下载获得（false）”，并通过cliBundled()RPC 调用向 backend 查询，最终在Core菜单中展示 Bundled Core 状态。

底层分发逻辑位于 packages/kilo-jetbrains/backend/src/main/kotlin/ai/kilocode/backend/cli/KiloCliDownloader.kt，从源码结构可以推断其完整的下载与校验管线：

1. 缓存检查：按<IDE 系统目录>/kilo/cli/<version>/<platform>/bin/kilo[.exe]布局查找缓存，.complete标记文件内写入sha256:<64 hex>摘要，摘要格式不合法或可执行文件缺失时视为缓存无效；
2. 摘要解析：优先使用插件内置的 Kilo CLI 校验和（KiloCliChecksums），缺失时回退到调用 GitHub Releases API 拉取资产元数据中的 digest；
3. 下载与校验：从 GitHub Releases 下载对应平台的归档，计算 SHA-256 并与摘要比对，不匹配则删除并抛错；
4. 安全解压：解压时对每个归档条目做路径穿越检查（Archive entry escapes target directory），非 Windows 平台对kilo与bwrap可执行位自动赋权；
5. 文件锁与原子替换：通过文件锁（FileLock，超时 30 秒）防止并发安装冲突，先写入临时 staging 目录，再通过“备份-重命名”方式原子替换缓存目录；
6. 旧版本清理（prune）：每次插件更新都会 pin 新的 CLI 版本，成功解析后仅保留当前版本，避免旧版本在 IDE 系统目录中无限累积。

Bundled 构建下的差异在于：kilo-cli.zip以 backend 资源形式嵌入插件包，运行时会检测到该资源的存在并直接解压当前平台子树（<platform>/bin/kilo[.exe]）到磁盘，而不是走网络下载路径——这也是它能在离线/受限网络下工作的根本原因。同时，Bundled 构建覆盖六个平台：darwin-arm64、darwin-x64、linux-arm64、linux-x64、windows-arm64、windows-x64，解压时只提取当前平台对应子树，避免在用户磁盘上保留全部六个平台的二进制。

从源码构建 Bundled 插件（面向维护者）

如果你需要自行构建 Bundled 变体，packages/kilo-jetbrains/docs/bundled-release-plan.md 给出了官方构建命令：

./gradlew clean buildPlugin signPlugin verifyPluginSignature verifyPlugin \ -Pproduction=true -Pkilo.version=<version> -Pkilo.channel=default \ -Pkilo.cli.bundled=true

其中kilo.cli.bundled是仅用于构建的属性（默认false），打包任务会从 GitHub Releases 下载全部六个平台的 pin 版本 CLI 资产、用发布元数据中的 SHA-256 校验，再组装为kilo-cli.zip嵌入 backend 资源。签名并校验通过后，产物上传到对应jetbrains/v<version>的 GitHub Release，stable 版本随后更新 GitHub Pages 上的updatePlugins.xml。

普通开发环境下的构建/运行方式可参考 packages/kilo-jetbrains/README.md：开发构建使用bun run build（等效./gradlew buildPlugin），生产构建使用bun run build:production，产物位于build/distributions/，也可通过Settings → Plugins → Install Plugin from Disk直接安装。

如果你曾使用 v7 EAP 版本

如果你之前通过 Early Access Program（EAP）仓库体验过 v7 的早期版本，正式版发布后需要注意清理：

• 正式版 v7 插件已可通过 JetBrains Marketplace 默认渠道获取；
• 请从Settings → Plugins → Manage Plugin Repositories中删除 EAP 仓库 URL；
• 若不删除，IDE 可能持续接收 EAP 更新渠道的版本，而不是切换回稳定的 Marketplace 渠道。

该信息以 info 类型 callout 的形式标注在原文档中，属于 v7 从 EAP 转正后必须执行的收尾动作，避免长期停留在预发布版本上。

支持的 IDE

Kilo Code v7 for JetBrains 插件支持以下 JetBrains 系 IDE：

• IntelliJ IDEA
• WebStorm
• PyCharm
• PhpStorm
• GoLand
• Rider
• CLion
• RubyMine
• DataGrip

以上覆盖了 JetBrains 旗下主流的 JVM、前端、Python、PHP、Go、.NET、C/C++、Ruby 与数据库开发工具，各 IDE 的安装入口均为Settings → Plugins，流程完全一致。

安装后的常见验证与排查要点

安装完成并重启 IDE 后，建议按以下顺序做快速验证：

1. 打开工具窗口：在右侧工具窗口栏找到Kilo Code图标，确认能正常打开对话面板；
2. 确认 Core 状态：通过... → Core菜单查看当前使用的 Core 类型与版本——网络正常环境下显示下载版（带版本号与架构），离线/Bundled 安装显示Bundled Core；
3. 网络受限环境的兜底：若 Marketplace 安装后 Core 一直无法就绪、反复提示下载失败，且网络策略不允许运行时下载可执行文件，请改用方式二的自定义仓库 Bundled 安装；
4. EAP 残留检查：若 IDE 持续停留在 EAP 版本，回到Manage Plugin Repositories移除 EAP 仓库 URL。

如果遇到下载类问题，KiloCliDownloader.kt 会输出包含缓存路径、平台、期望摘要与 GitHub API 速率限制信息的详细日志（如Kilo CLI path diagnostics行），可在 IDE 日志目录中定位kilo.log进行排查，判断是网络阻断、摘要校验失败还是缓存目录不可写。

小结

Kilo Code v7 for JetBrains 的安装路径可以总结为两条主线：

• 默认路径（Marketplace）：适合绝大多数开发者，安装包精简、自动更新，Core 在首次使用时按需下载；
• 离线/受限路径（Bundled Core 自定义仓库）：适合企业内网、严格代理、离线环境或禁止运行时下载可执行文件的场景，插件包内嵌六个平台的 Kilo Core，首次启动无需联网。

理解两条路径背后的构建与运行时差异（-Pkilo.cli.bundled=true、kilo-cli.zip资源检测、SHA-256 校验与平台子树解压），能帮助你在任何网络约束下都选对安装方式，并能在 Core 无法就绪时快速定位是网络问题还是配置问题。

【免费下载链接】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