
Kilo Code 开源 AI 编码代理完全指南安装部署、内置 Agents 与 CI/CD 自律模式实战【免费下载链接】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 是运行在 VS Code、JetBrains 与 CLI 环境中的开源 AI 编码代理coding agent支持在 500 模型之间按需选择、任务中途切换并按模型厂商原价计费无需 API Key 即可开始使用。本文将基于仓库的日文 READMEtranslations/README.ja.md为骨架结合仓库源码系统讲解 Kilo Code 的安装部署方式、内置 Agents 体系、核心能力以及面向 CI/CD 的--auto自律模式帮助你快速上手并理解其底层实现原理。一、项目概览Kilo Code 是什么Kilo Code 是一款在工作的地方与你相遇的 AI 编码代理无论是 VS Code 扩展、JetBrains 原生插件还是 CLI 终端工具都能提供一致的 AI 辅助开发体验。它的核心定位是开源 透明定价可从 500 多个模型中选择README 中示例包括 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro Preview 等任务进行中可随时切换模型无需重新开始只按模型厂商的实际价格付费零加价zero markup起步阶段不需要任何 API Key。从仓库结构看这一一个平台、多端覆盖的架构由多个独立包协同实现CLI 主体位于 packages/opencode其包名正是发布到 npm 的kilocode/cliVS Code 扩展位于 packages/kilo-vscodepublisher 为kilocode扩展 id 为kilo-codeJetBrains 插件位于 packages/kilo-jetbrains。各包通过仓库根 package.json 中的 Bun workspace 统一管理并使用 bun 作为包管理器packageManager: bun1.3.14。二、安装与部署六种运行形态README 将 Kilo 的安装方式分为六种形态你可以根据实际工作环境选择。1. VS Code 扩展在 VS Code 中直接安装 Kilo Code 扩展或从 VS Code Marketplace 搜索kilocode.Kilo-Code获取。安装后创建账户即可访问 500 模型含 README 中提到的 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro Preview全部按厂商价格计费。扩展的工程细节可参考 packages/kilo-vscode/package.json其displayName为 Kilo Code: AI Coding Agent, Copilot, and Autocomplete类别包含 AI、Chat、Programming Languages、Testing 等官方描述涵盖了自然语言生成代码、任务自动化、终端命令执行、内联补全、浏览器自动化、自动重构以及多种自定义模式。2. CLI命令行CLI 是自动化与脚本化场景的核心入口支持多种包管理器安装方式# npm npm install -g kilocode/cli # curl官方安装脚本 curl -fsSL https://kilo.ai/cli/install | bash # pnpm pnpm add -g kilocode/cli # bun bun add -g kilocode/cli # HomebrewmacOS / Linux brew install Kilo-Org/tap/kilo # Arch LinuxAUR paru -S kilo-bin安装完成后在任意项目目录下直接运行kilo即可开始使用。从源码确认npm 包kilocode/cli在 packages/opencode/package.json 中声明了两个可执行入口kilo与kilocode均指向./bin/kilo因此两条命令等价。该包的bin字段、opencode-ai/*系列 workspace 依赖以及drizzle-orm、effect、zod等依赖共同构成了 CLI 的运行时基础。3. JetBrains 插件从 JetBrains Marketplace 安装 Kilo Code 插件或在任意 JetBrains IDE 的Settings → Plugins中搜索 Kilo Code 即可。插件源码位于 packages/kilo-jetbrains采用 Kotlin 编写backend/、frontend/与shared/三个模块其发布与构建流程记录在 packages/kilo-jetbrains/RELEASING.md。4. Cloud Agent云端代理不需要本地机器直接在浏览器中通过 Web 访问app.kilo.ai/cloud即可运行 Kilo适合临时环境、受限网络或快速体验场景。5. 代码审查Code Reviews在app.kilo.ai/code-reviews可以为 pull request 配置自动化的 AI 代码审查。仓库内对应的实现证据位于 packages/opencode/src/kilocode/review/command.ts其中注册了名为review的命令入口。6. KiloClaw常驻 AI 代理通过app.kilo.ai/claw可以启动始终在线的 AI 代理always-on agent。仓库中与 KiloClaw 相关的文档与内容位于 packages/kilo-docs/pages/kiloclaw。附从 GitHub Releases 安装 CLI 二进制除包管理器外还可以从 Releases 页面直接下载最新二进制文件各平台对应资产如下平台资产文件Windows大多数 PCkilo-windows-x64.zipmacOSApple Siliconkilo-darwin-arm64.zipmacOSIntelkilo-darwin-x64.zipLinux x64kilo-linux-x64.tar.gzLinux ARMkilo-linux-arm64.tar.gz注意事项原文明确说明x64-baseline是为没有 AVX 指令的旧 CPU 提供的兼容构建musl是针对 Alpine 或没有 glibc 的最小 Docker 镜像的静态链接构建kilo-vscode-*.vsix是 VS Code 扩展包不是 CLISource code归档用于从源码自行构建。三、内置 Agents按任务切换的特化代理Kilo 内置了多种特化 agents你可以根据任务性质在它们之间切换也可以自行构建自定义 agents。README 列出的内置代理如下Code— 默认代理。根据自然语言实现、编辑代码。Plan— 在写代码之前设计架构并制定实现计划。Ask— 不修改任何文件仅回答关于代码库的问题。Debug— 对问题进行故障排查与追踪。Review— 审查你的变更发现性能、安全、代码风格与测试覆盖率方面的问题。从源码可以印证这套代理体系的实现细节。在 packages/opencode/src/kilocode/agent/index.ts 的patchAgents函数中code代理由上游的build代理重命名而来保留向后兼容agents.code { ...agents.build, name: code }并合并了semantic_search: allow权限plan代理被加固其描述明确为 Plan mode. Can only edit plan files; all other filesystem mutations are denied.只能编辑计划文件其他所有文件系统变更都被拒绝并叠加了planEditGuard(worktree)等权限守卫debug代理以系统化调试方法论为提示词允许question、suggest、plan_enter、semantic_search等权限ask代理被只读守卫保护askEditGuard()并针对 CLI 环境将提示词中的 Mermaid 图表要求替换为纯文本/ASCII 图表说明此外还包含explore只读研究代理bash 受限为只读命令白名单与已标记deprecated的orchestrator并行委派协调者。Agent 的自定义能力同样有据可查在 packages/opencode/src/agent/agent.ts 中配置中的agent项会被逐个预处理KiloAgent.preprocessConfig支持disable、model、prompt、description、temperature、top_p、mode、color、steps、permission等字段的覆盖与合并这为编写自定义 agents 提供了明确的配置入口。四、核心功能一览README 总结了 Kilo 的六大核心能力多文件代码生成— 从自然语言生成跨多个文件的代码内联补全— ghost-text 幽灵文本建议按 Tab 即可接受自检Self-checking— 代理自行审查并修正自己的工作终端与浏览器控制— 执行命令、自动化 Web 操作MCP 市场— 发现并接入扩展代理能力的 MCP 服务器500 模型中途切换— 让延迟、成本与推理能力匹配当前任务。其中终端与浏览器控制与MCP 扩展在依赖层面有直接证据CLI 包 packages/opencode/package.json 的依赖中包含modelcontextprotocol/sdk、lydell/node-pty、bun-pty、cross-spawn等PTY 与进程控制以及ai-sdk/anthropic、ai-sdk/google、ai-sdk/openai、ai-sdk/mistral、ai-sdk/xai、openrouter/ai-sdk-provider等大量 AI provider SDK这正是500 模型、中途切换的能力来源——模型接入层通过 AI SDK 统一抽象天然支持多厂商模型混合使用。五、自律模式CI/CDkilo run --auto对于 CI/CD 流水线README 提供了完全无需人工提示的自律运行方式kilo run --auto run tests and fix any failures重要警告--auto会禁用所有权限提示允许代理在无需确认的情况下执行任何操作。请务必只在可信环境中使用。底层实现原理从源码看--auto的语义有精确的定义选项声明在 packages/opencode/src/cli/cmd/run.ts 中run子命令声明了--auto布尔选项描述为 auto-approve permissions that are not explicitly denied (dangerous!)自动批准未被显式拒绝的权限危险默认值为false。同文件还保留了隐藏的--yolo与--dangerously-skip-permissions两个别名选项skipPermissions args.yolo || args[dangerously-skip-permissions]。子会话追踪Kilo 对--auto做了更精细的处理——通过 packages/opencode/src/kilocode/cli/run-auto.ts 的KiloRunAuto模块维护一个受信任会话集合当主会话通过task工具派生子代理时如果子会话的metadata.sessionId属于已信任会话则将其加入集合从而在自律模式下也让子代理会话获得自动批准权限被自动拒绝时运行结束时还会输出 run ended with an auto-rejected permission; pass --auto for autonomous use 的提示见 run.ts。CI 适用场景--auto与kilo run的组合意味着你可以把 运行测试并修复失败 这类指令直接交给流水线实现无人值守的修复循环这正是 README 所称为 CI/CD 管道而构建的定位。六、文档、贡献与许可文档完整的配置指南与进阶内容位于仓库的 packages/kilo-docs涵盖 code-with-ai、automate、collaborate、customize、deploy-secure 等主题贡献环境搭建、编码规范与 PR 提交流程见 CONTRIBUTING.mdVS Code 扩展与 CLI 的发布流程见 RELEASING.mdJetBrains 插件的发布流程见 packages/kilo-jetbrains/RELEASING.md参与前请阅读 CODE_OF_CONDUCT.md许可证项目采用 MIT 许可见 LICENSE只要保留署名与许可声明即可用于包括商业用途在内的使用、修改与分发。七、FAQKilo CLI 的由来Kilo CLI 是从哪里来的Kilo CLI 是 OpenCode 的一个 fork并针对 Kilo agentic engineering 平台进行了增强。仓库结构对此有直接印证CLI 源码整体位于packages/opencode目录其中packages/opencode/src/kilocode/子目录集中了 Kilo 的定制实现如上面的run-auto.ts、agent/index.ts等而packages/opencode/src/其余部分保留了 OpenCode 上游的核心框架。结语从日文 README 出发可以看到Kilo Code 的定位是全场景的 AI 编码代理无论是编辑器内的交互式开发VS Code、JetBrains、终端内的自动化工作流CLI还是云端与 CI/CD 中的无人值守运行Cloud Agent、kilo run --auto都围绕500 模型、厂商原价、开源透明这三个核心承诺展开。结合 packages/opencode/src/kilocode 下的源码你可以进一步研究其 Agents 权限模型、自律模式会话追踪等底层机制甚至基于配置接口构建属于自己的自定义代理。【免费下载链接】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),仅供参考