Kilo 开源 AI 编程代理完整指南安装、Agent 体系与 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 是一个面向 VS Code、JetBrains 与 CLI 的开源 AI 编程代理定位为一体化 agentic engineering 平台。本文基于仓库内的阿拉伯语 READMEtranslations/README.ar.md整理其核心使用方式从 VS Code / CLI / JetBrains / 云端四种运行形态的安装与选型到内置 Code、Plan、Ask、Debug、Review 五类 Agent 的职责划分再到面向 CI/CD 的kilo run --auto全自主模式并结合仓库源码揭示底层实现原理。读完本文你将掌握 Kilo 的完整安装路径、Agent 切换策略以及如何在受信任环境中安全地运行无人值守的自动化任务。项目概览一个代理三种界面开放定价Kilo 的核心承诺是在你工作的地方与你相遇同一个代理可以运行在 VS Code 扩展、JetBrains 插件、CLI 终端三种界面中也可以完全托管在云端。它在源码层面被组织为多个相互独立的包monorepo例如承载命令行主体的 packages/opencodeKilo CLI 即源于对 OpenCode 的 fork、承载 VS Code 扩展的 packages/kilo-vscode、以及承载 JetBrains 插件的 packages/kilo-jetbrains。关于模型选择README 中明确了两点关键事实500 模型可选创建账户后即可访问包括 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro Preview 在内的 500 多个模型任务中途可切换模型无需中断会话即可更换模型以便把延迟、成本与推理能力匹配到当前任务零加成定价按模型提供商的原始费率计费Kilo 不附加任何加价且无需 API Key 即可开始自带账户内模型访问。安装与运行形态选型README 按运行形态给出了六种安装入口。选择时主要取决于你的开发环境与自动化需求形态入口适用场景VS Code 扩展直接安装扩展或从 VS Code Marketplace 获取日常 IDE 内结对编程、内联补全CLInpm / curl / pnpm / bun / Homebrew / AUR终端工作流、脚本与 CI/CDJetBrains 插件JetBrains Marketplace 或 IDE 内Settings → Plugins搜索 Kilo CodeIntelliJ / PyCharm 等 JetBrains 系 IDECloud Agent网页端直接运行无本地机器的云端会话Code Reviews网页端配置对 Pull Request 做自动化 AI 代码评审KiloClaw网页端配置常驻型 AI 代理CLI 安装的六种方式README 提供了等价的多种安装命令可按包管理器偏好任选其一# 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 # Homebrew (macOS / Linux) brew install Kilo-Org/tap/kilo # Arch Linux (AUR) paru -S kilo-bin安装完成后在任意项目目录下直接运行kilo即可启动交互式会话。从 GitHub Releases 下载二进制对于需要固定版本或离线分发的场景可以从 Releases 页面下载预编译二进制README 给出了平台与产物对照表平台文件Windows多数 PCkilo-windows-x64.zipmacOSApple Siliconkilo-darwin-arm64.zipmacOSIntelkilo-darwin-x64.zipLinux x64kilo-linux-x64.tar.gzLinux ARMkilo-linux-arm64.tar.gzREADME 同时说明了几个易混淆的构建产物x64-baseline是为不支持 AVX 指令集的老 CPU 提供的兼容构建musl是静态链接构建面向 Alpine 或不含 glibc 的精简 Docker 镜像kilo-vscode-*.vsix是 VS Code 扩展安装包而非 CLISource code源码归档则用于从源码自行构建。JetBrains 插件安装在任意 JetBrains IDE 中打开Settings → Plugins搜索 Kilo Code 即可安装也可以直接从 JetBrains Marketplace 获取插件。该插件对应的仓库源码位于 packages/kilo-jetbrains采用 Kotlin 编写后端与前端均为.kt文件并配有独立的 RELEASING.md 说明发布流程。Agent 体系五种内置代理的职责分工Kilo 内置了多个专职 Agent你可以在任务进行中按需切换也可以创建自己的自定义 Agent。README 中列出的五个内置 Agent 及其职责如下Code默认 Agent负责把自然语言指令落地为代码实现与修改Plan在写任何代码之前先设计架构、编写实现方案Ask仅回答关于代码库的问题不触碰任何文件Debug排查问题并追踪根因Review评审你的改动从性能、安全、代码风格与测试覆盖率等多个维度暴露问题。从源码结构可以印证这套 Agent 体系的实现方式核心包中 Agent 配置由 packages/core/src/config/plugin/agent.ts 承载它从{agent,agents}/**/*.md与{mode,modes}/*.md等路径发现 Agent 定义文档并支持model、variant、system、description、mode、permissions等配置键——这正是自定义 Agent 的入口。换言之Agent 不仅是运行时概念更是一等配置对象开发者可以像写 Markdown 一样声明新 Agent。CLI 侧的选择逻辑同样印证了这一点在 packages/opencode/src/cli/cmd/run.ts 中kilo run --agent name会先查询 Agent 服务本地模式或远端服务器attach 模式若名称不存在或该 Agent 是 subagent 而非主 Agent则回退到默认 Agent 并给出警告。核心能力Kilo 到底能做什么README 的 What it does 一节概括了六项核心能力结合仓库源码可以进一步理解其实现落点跨多文件代码生成从自然语言生成/修改代码可一次作用于多个文件内联自动补全以 ghost-text 幽灵文本形式给出建议按 Tab 键接受。对应实现位于 VS Code 扩展包中packages/kilo-vscode 的补全相关服务自检查Self-checkingAgent 会自行审视并纠正自己的产出形成执行—检查—修正闭环终端与浏览器控制代理可以执行终端命令并自动化网页操作从而打通写代码—跑测试—修 bug的完整链路MCP 市场发现并接入 MCPModel Context Protocol服务器以扩展代理能力。VS Code 扩展中由 MarketplacePanelProvider.ts 提供市场面板支持500 模型与中途切换任务进行中按需换模型匹配延迟、成本与推理强度。自主模式用kilo run --auto构建 CI/CD 流水线Kilo 的自主模式是为 CI/CD 场景设计的kilo run加上--auto后进入完全无人值守运行全程不产生任何交互式提示。kilo run --auto run tests and fix any failures源码层面的行为拆解从 packages/opencode/src/cli/cmd/run.ts 的源码可以看到--auto的真实行为边界权限自动批准--auto标志的描述本身即注明 auto-approve permissions that are not explicitly denied (dangerous!)。在事件循环中当收到permission.asked事件时若args.auto为真客户端会直接调用client.permission.reply({ requestID, reply: once })自动放行本次请求见 run.ts而不会暂停等待人工确认默认拒绝非交互询问非交互模式非--interactive下会话规则会以 deny 方式屏蔽question、suggest、plan_enter、plan_exit四类请求见 run.ts保证无人值守时流程不被卡住子代理权限联动--auto模式下子 AgentTask发起的权限请求同样会被自动放行避免 subagent 因等待授权而挂起对应代码注释中提到的 #11903 问题修复。安全边界只在可信环境使用README 给出了明确的警告--auto会关闭所有权限提示允许代理不经确认执行任何操作因此只应在受信任的环境中使用。实践建议在 CI/CD 流水线中将运行环境限定为隔离的 runner 或一次性容器为代理会话提供最小必要权限与可回滚的工作副本如 git worktree先以非--auto模式或 Plan Agent验证任务指令的边界再在流水线中启用全自主执行可结合kilo run的--format json输出原始事件流把工具调用记录接入流水线日志与审计。kilo run还支持--continue/--session恢复历史会话、--model指定provider/model格式的模型、--agent指定 Agent、--file附带文件等参数详见 run.ts 的 yargs 定义这些都可以与--auto组合出灵活的自动化任务。参与贡献与开源协议贡献指南从 CONTRIBUTING.md 开始了解环境搭建、代码规范与如何提交 Pull RequestVS Code 扩展与 CLI 的发布流程见 RELEASING.mdJetBrains 插件发布流程见 packages/kilo-jetbrains/RELEASING.md行为准则参与前请阅读 CODE_OF_CONDUCT.md许可证MIT 协议允许自由使用、修改与分发含商业用途前提是保留署名与许可证声明详见 LICENSE。常见问题Kilo CLI 的由来一个高频问题在 README 的 FAQ 中有明确回答Kilo CLI 是 OpenCode 的 fork针对 Kilo agentic engineering 平台进行了增强仓库内kilocode_change注释标记即为这些适配改动的痕迹例如 run.ts 顶部对三种运行模式的说明。这也是为什么 CLI 主体源码位于 packages/opencode 目录之下。小结Kilo 以一个代理、多种界面、开放定价的方式降低了 AI 编程代理的接入门槛VS Code / JetBrains / CLI / 云端四种形态覆盖了从 IDE 结对到 CI/CD 无人值守的完整场景内置的 Code、Plan、Ask、Debug、Review 五类 Agent 让复杂任务可以按阶段切换角色而kilo run --auto配合权限规则则为自动化流水线提供了明确的运行范式。无论你是想在日常开发中借助多模型切换提升效率还是希望在 CI 中落地自主修复任务都可以从本文的安装与配置路径直接起步。【免费下载链接】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），仅供参考 Kilo 开源 AI 编程代理完整指南：安装、Agent 体系与 CI/CD 自主模式实战
Kilo 开源 AI 编程代理完整指南安装、Agent 体系与 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 是一个面向 VS Code、JetBrains 与 CLI 的开源 AI 编程代理定位为一体化 agentic engineering 平台。本文基于仓库内的阿拉伯语 READMEtranslations/README.ar.md整理其核心使用方式从 VS Code / CLI / JetBrains / 云端四种运行形态的安装与选型到内置 Code、Plan、Ask、Debug、Review 五类 Agent 的职责划分再到面向 CI/CD 的kilo run --auto全自主模式并结合仓库源码揭示底层实现原理。读完本文你将掌握 Kilo 的完整安装路径、Agent 切换策略以及如何在受信任环境中安全地运行无人值守的自动化任务。项目概览一个代理三种界面开放定价Kilo 的核心承诺是在你工作的地方与你相遇同一个代理可以运行在 VS Code 扩展、JetBrains 插件、CLI 终端三种界面中也可以完全托管在云端。它在源码层面被组织为多个相互独立的包monorepo例如承载命令行主体的 packages/opencodeKilo CLI 即源于对 OpenCode 的 fork、承载 VS Code 扩展的 packages/kilo-vscode、以及承载 JetBrains 插件的 packages/kilo-jetbrains。关于模型选择README 中明确了两点关键事实500 模型可选创建账户后即可访问包括 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro Preview 在内的 500 多个模型任务中途可切换模型无需中断会话即可更换模型以便把延迟、成本与推理能力匹配到当前任务零加成定价按模型提供商的原始费率计费Kilo 不附加任何加价且无需 API Key 即可开始自带账户内模型访问。安装与运行形态选型README 按运行形态给出了六种安装入口。选择时主要取决于你的开发环境与自动化需求形态入口适用场景VS Code 扩展直接安装扩展或从 VS Code Marketplace 获取日常 IDE 内结对编程、内联补全CLInpm / curl / pnpm / bun / Homebrew / AUR终端工作流、脚本与 CI/CDJetBrains 插件JetBrains Marketplace 或 IDE 内Settings → Plugins搜索 Kilo CodeIntelliJ / PyCharm 等 JetBrains 系 IDECloud Agent网页端直接运行无本地机器的云端会话Code Reviews网页端配置对 Pull Request 做自动化 AI 代码评审KiloClaw网页端配置常驻型 AI 代理CLI 安装的六种方式README 提供了等价的多种安装命令可按包管理器偏好任选其一# 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 # Homebrew (macOS / Linux) brew install Kilo-Org/tap/kilo # Arch Linux (AUR) paru -S kilo-bin安装完成后在任意项目目录下直接运行kilo即可启动交互式会话。从 GitHub Releases 下载二进制对于需要固定版本或离线分发的场景可以从 Releases 页面下载预编译二进制README 给出了平台与产物对照表平台文件Windows多数 PCkilo-windows-x64.zipmacOSApple Siliconkilo-darwin-arm64.zipmacOSIntelkilo-darwin-x64.zipLinux x64kilo-linux-x64.tar.gzLinux ARMkilo-linux-arm64.tar.gzREADME 同时说明了几个易混淆的构建产物x64-baseline是为不支持 AVX 指令集的老 CPU 提供的兼容构建musl是静态链接构建面向 Alpine 或不含 glibc 的精简 Docker 镜像kilo-vscode-*.vsix是 VS Code 扩展安装包而非 CLISource code源码归档则用于从源码自行构建。JetBrains 插件安装在任意 JetBrains IDE 中打开Settings → Plugins搜索 Kilo Code 即可安装也可以直接从 JetBrains Marketplace 获取插件。该插件对应的仓库源码位于 packages/kilo-jetbrains采用 Kotlin 编写后端与前端均为.kt文件并配有独立的 RELEASING.md 说明发布流程。Agent 体系五种内置代理的职责分工Kilo 内置了多个专职 Agent你可以在任务进行中按需切换也可以创建自己的自定义 Agent。README 中列出的五个内置 Agent 及其职责如下Code默认 Agent负责把自然语言指令落地为代码实现与修改Plan在写任何代码之前先设计架构、编写实现方案Ask仅回答关于代码库的问题不触碰任何文件Debug排查问题并追踪根因Review评审你的改动从性能、安全、代码风格与测试覆盖率等多个维度暴露问题。从源码结构可以印证这套 Agent 体系的实现方式核心包中 Agent 配置由 packages/core/src/config/plugin/agent.ts 承载它从{agent,agents}/**/*.md与{mode,modes}/*.md等路径发现 Agent 定义文档并支持model、variant、system、description、mode、permissions等配置键——这正是自定义 Agent 的入口。换言之Agent 不仅是运行时概念更是一等配置对象开发者可以像写 Markdown 一样声明新 Agent。CLI 侧的选择逻辑同样印证了这一点在 packages/opencode/src/cli/cmd/run.ts 中kilo run --agent name会先查询 Agent 服务本地模式或远端服务器attach 模式若名称不存在或该 Agent 是 subagent 而非主 Agent则回退到默认 Agent 并给出警告。核心能力Kilo 到底能做什么README 的 What it does 一节概括了六项核心能力结合仓库源码可以进一步理解其实现落点跨多文件代码生成从自然语言生成/修改代码可一次作用于多个文件内联自动补全以 ghost-text 幽灵文本形式给出建议按 Tab 键接受。对应实现位于 VS Code 扩展包中packages/kilo-vscode 的补全相关服务自检查Self-checkingAgent 会自行审视并纠正自己的产出形成执行—检查—修正闭环终端与浏览器控制代理可以执行终端命令并自动化网页操作从而打通写代码—跑测试—修 bug的完整链路MCP 市场发现并接入 MCPModel Context Protocol服务器以扩展代理能力。VS Code 扩展中由 MarketplacePanelProvider.ts 提供市场面板支持500 模型与中途切换任务进行中按需换模型匹配延迟、成本与推理强度。自主模式用kilo run --auto构建 CI/CD 流水线Kilo 的自主模式是为 CI/CD 场景设计的kilo run加上--auto后进入完全无人值守运行全程不产生任何交互式提示。kilo run --auto run tests and fix any failures源码层面的行为拆解从 packages/opencode/src/cli/cmd/run.ts 的源码可以看到--auto的真实行为边界权限自动批准--auto标志的描述本身即注明 auto-approve permissions that are not explicitly denied (dangerous!)。在事件循环中当收到permission.asked事件时若args.auto为真客户端会直接调用client.permission.reply({ requestID, reply: once })自动放行本次请求见 run.ts而不会暂停等待人工确认默认拒绝非交互询问非交互模式非--interactive下会话规则会以 deny 方式屏蔽question、suggest、plan_enter、plan_exit四类请求见 run.ts保证无人值守时流程不被卡住子代理权限联动--auto模式下子 AgentTask发起的权限请求同样会被自动放行避免 subagent 因等待授权而挂起对应代码注释中提到的 #11903 问题修复。安全边界只在可信环境使用README 给出了明确的警告--auto会关闭所有权限提示允许代理不经确认执行任何操作因此只应在受信任的环境中使用。实践建议在 CI/CD 流水线中将运行环境限定为隔离的 runner 或一次性容器为代理会话提供最小必要权限与可回滚的工作副本如 git worktree先以非--auto模式或 Plan Agent验证任务指令的边界再在流水线中启用全自主执行可结合kilo run的--format json输出原始事件流把工具调用记录接入流水线日志与审计。kilo run还支持--continue/--session恢复历史会话、--model指定provider/model格式的模型、--agent指定 Agent、--file附带文件等参数详见 run.ts 的 yargs 定义这些都可以与--auto组合出灵活的自动化任务。参与贡献与开源协议贡献指南从 CONTRIBUTING.md 开始了解环境搭建、代码规范与如何提交 Pull RequestVS Code 扩展与 CLI 的发布流程见 RELEASING.mdJetBrains 插件发布流程见 packages/kilo-jetbrains/RELEASING.md行为准则参与前请阅读 CODE_OF_CONDUCT.md许可证MIT 协议允许自由使用、修改与分发含商业用途前提是保留署名与许可证声明详见 LICENSE。常见问题Kilo CLI 的由来一个高频问题在 README 的 FAQ 中有明确回答Kilo CLI 是 OpenCode 的 fork针对 Kilo agentic engineering 平台进行了增强仓库内kilocode_change注释标记即为这些适配改动的痕迹例如 run.ts 顶部对三种运行模式的说明。这也是为什么 CLI 主体源码位于 packages/opencode 目录之下。小结Kilo 以一个代理、多种界面、开放定价的方式降低了 AI 编程代理的接入门槛VS Code / JetBrains / CLI / 云端四种形态覆盖了从 IDE 结对到 CI/CD 无人值守的完整场景内置的 Code、Plan、Ask、Debug、Review 五类 Agent 让复杂任务可以按阶段切换角色而kilo run --auto配合权限规则则为自动化流水线提供了明确的运行范式。无论你是想在日常开发中借助多模型切换提升效率还是希望在 CI 中落地自主修复任务都可以从本文的安装与配置路径直接起步。【免费下载链接】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），仅供参考