Kilo Code 开源 AI 编程 Agent 完全指南安装部署、内置 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 是当前仓库Kilo所构建的开源 AI 编程 Agent它同时运行在 VS Code、JetBrains 与命令行CLI三种环境中让开发者可以在编辑器内直接完成多文件代码生成、代码库问答、调试与评审。本文以项目官方 README 为骨架结合仓库源码CLI 实现、Agent 定义与权限系统深入讲解安装方式、内置 Agents、核心能力以及面向 CI/CD 的kilo run --auto自治模式帮助你快速上手并理解其底层工作原理。项目定位一个 Agent 覆盖三种工作环境Kilo Code 是一个开源的 AI 编程 Agent核心理念是在你工作的地方工作无论是 VS Code、JetBrains 还是 CLI对应 packages/opencode都可以使用同一套 Agent 能力。它采用开放源码与开放定价模式提供500 模型可选任务中途可随时切换模型按模型供应商的原价付费零加价zero markup无需 API 密钥即可开始使用。仓库的包结构直观反映了这一多端战略packages/kilo-vscode 是 VS Code 扩展含src与webview-uipackages/kilo-jetbrains 是 JetBrains 插件Kotlin 实现的backend、frontend与shared三模块而 packages/opencode 则承载了 CLI 主体src/cli与src/agent。安装与启动选择你的运行环境Kilo 官方支持五种运行形态你可以根据使用场景选择其一或组合使用。VS Code 扩展直接在 VS Code 中安装 Kilo Code 扩展Marketplace 扩展 ID 为kilocode.kilo-code安装后创建账户即可访问 500 模型。扩展的实现位于 packages/kilo-vscode/src其中包含了编辑器集成、会话管理与 Webview UI。CLI六种安装方式CLI 包名为kilocode/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 # Homebrew (macOS / Linux) brew install Kilo-Org/tap/kilo # Arch Linux (AUR) paru -S kilo-bin安装完成后在任意项目目录下运行kilo即可启动交互式 TUI终端界面。从仓库源码看CLI 的命令入口位于 packages/opencode/src/cli核心交互命令kilo run定义在 packages/opencode/src/cli/cmd/run.ts。JetBrains 插件在任意 JetBrains IDE 中通过Settings → Plugins搜索 Kilo Code 即可安装。插件为原生 Kotlin 实现代码位于 packages/kilo-jetbrains其发布流程独立维护在 packages/kilo-jetbrains/RELEASING.md。从 GitHub Releases 下载二进制CLI对于不便使用包管理器的环境官方提供预编译二进制按平台选择对应文件平台文件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归档用于从源码自行编译。Cloud Agent 与 Code Reviews除了本地安装Kilo 还提供了云端形态Cloud Agent 允许不依赖本地机器、直接从 Web 运行 KiloCode Reviews 可为你的 pull request 配置自动化的 AI 代码评审。此外KiloClaw 支持运行一个常驻的持续活跃 AI Agent。这些云端能力与本地 CLI、IDE 插件互补构成完整的 Agent 使用链路。内置 Agents按任务切换角色Kilo 内置了多个专业化 Agents你可以在会话中根据任务类型切换也可以创建自定义 Agents。官方文档中列出的五种角色如下Agent定位适用场景Code默认 Agent根据自然语言描述实现与编辑代码Plan规划 Agent在写代码之前设计架构、编写实现计划Ask问答 Agent回答代码库相关问题不修改任何文件Debug调试 Agent诊断与追踪问题Review评审 Agent检查变更发现性能、安全、风格与测试覆盖问题从源码层面看这些角色的行为差异主要由权限系统与系统提示词共同决定。在 packages/opencode/src/agent/agent.ts 中可以看到内置 agent 的定义build即 Code默认 Agentquestion、suggest、plan_enter均被允许拥有完整的工具执行权限plan通过权限配置禁用所有编辑工具edit: { *: deny }仅允许在.opencode/plans/*.md等计划目录内写入从权限层面强制实现先规划后编码general / explore作为 subagent 使用explore 专门用于快速检索代码库grep、glob、list、read允许其余工具默认拒绝。Ask 与 Debug 则有独立的系统提示词文件packages/opencode/src/agent/prompt/ask.txt 声明其为只读助手明确禁止修改代码库、禁止执行写命令即使项目配置如 AGENTS.md要求写代码也必须服从只读约束并建议在需要实现时切换 Agentpackages/opencode/src/agent/prompt/debug.txt 则定义了系统化调试方法论先反思 5–7 种可能的故障来源、收敛到 1–2 个最可能的根因、在修复前通过日志或诊断输出验证假设、修复前先向用户确认诊断结论并优先采用最小化修复而非大规模重构。核心能力Kilo Code 的能力矩阵覆盖了从写代码到管环境的完整 Agent 工作流多文件代码生成从自然语言直接生成横跨多个文件的代码变更内联自动补全以 ghost-text幽灵文本形式给出补全建议按 Tab 键接受自检Self-checkingAgent 会自动审查并修正自己的工作成果终端与浏览器控制直接运行命令、自动化网页操作相关工具实现位于 packages/opencode/src/tool如bash.ts、webfetch.tsMCP marketplace查找并接入 MCPModel Context Protocol服务器扩展 Agent 能力边界500 模型中途切换任务进行中即可按延迟、成本与推理深度需求切换模型CLI 中通过--model以provider/model格式指定详见下文。自治模式CI/CDkilo run --autoKilo CLI 为 CI/CD 流水线提供了完全自治的执行模式无需任何人工确认kilo run --auto run tests and fix any failures该命令会启动一个非交互式会话执行运行测试并修复所有失败这类复合任务。--auto会关闭全部权限确认提示允许 Agent 不经确认执行任何操作因此只能在受信任的环境中启用。在源码层面--auto选项定义于 packages/opencode/src/cli/cmd/run.ts其描述为auto-approve permissions that are not explicitly denied (dangerous!)自动批准未被显式拒绝的权限危险。运行时逻辑中可以看到kilo run会创建KiloRunAuto追踪对象来标记自治会话run.ts 中注释说明--auto与--yolo均会跳过权限确认当子任务或主任务请求权限时在--auto模式下会自动批准而对于被配置为拒绝deny的权限则会自动拒绝并将会话标记为失败最终输出类似run ended with an auto-rejected permission; pass --auto for autonomous use的提示——这意味着自治模式下默认允许、显式拒绝生效权限白名单仍然是一道安全边界。除--auto外kilo run还提供了丰富的选项以适配不同自动化场景详见 packages/opencode/src/cli/cmd/run.ts--command指定要执行的命令其余参数作为消息参数传递--continue/--session继续上一次会话或指定会话 ID--fork可在继续前分叉会话--model以provider/model格式指定模型--agent选择要使用的 Agent--format输出格式default为格式化输出json输出原始 JSON 事件流便于流水线解析--file附加文件到消息--title设置会话标题--attach附加到运行中的 Kilo 服务器如http://localhost:4096并支持--port、--password、--username等服务器连接参数--dir指定运行目录--variant指定模型推理强度如 high、max、minimal--thinking等选项控制推理行为。这些选项让kilo run可以灵活嵌入脚本与 CI 流水线实现提交即自动修复的闭环。参与贡献与许可证Kilo 欢迎开发者、写作者等各类贡献者参与。环境搭建、编码规范与提交 PR 的流程见 CONTRIBUTING.mdVS Code 扩展与 CLI 的发布流程见 RELEASING.mdJetBrains 插件的发布流程见 packages/kilo-jetbrains/RELEASING.md。参与前请阅读 CODE_OF_CONDUCT.md。项目采用MIT 许可证见 LICENSE允许自由使用、修改与分发包括商用前提是保留署名与许可证声明。FAQKilo CLI 的由来Kilo CLI 是 OpenCode 的一个 fork在原基础上针对 Kilo 的 Agent 工程化平台进行了扩展仓库中大量// kilocode_change标记即体现了这一演进过程并深度集成 Kilo 的模型生态、权限体系与云端能力。【免费下载链接】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），仅供参考