Kilo Code 安装、使用方法详细全解一、项目概述Kilo Code 定位为一个超集产品——融合了 Roo Code、Cline 等工具的优点并提供自研功能。它支持 500 AI 模型包括 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro 等通过 Kilo Gateway 统一接入。核心特点完全开源多平台支持VS Code、JetBrains、CLI、Slack、移动端、云端跨设备会话同步基于自然语言的代码生成自动任务执行终端命令、浏览器自动化等MCPModel Context Protocol支持自定义 Agent/Modes 系统二、安装方法2.1 VS Code 扩展安装方法一VS Code Marketplace推荐打开 VS Code进入扩展面板CtrlShiftX/CmdShiftX搜索 “Kilo Code”点击 “Install” 旁边的下拉箭头选择“Install Pre-Release Version”安装完成后侧边栏会出现 Kilo Code 图标注意虽然标记为 “pre-release”但这是稳定的推荐版本只是 VS Code Marketplace 的分发通道。方法二Open VSX Registry适用于 VSCodium、Gitpod、Eclipse Theia、Windsurf 等无法访问官方 Marketplace 的编辑器打开编辑器进入扩展面板CtrlShiftX/CmdShiftX确保编辑器已配置 Open VSX Registry搜索 “Kilo Code”选择并点击 Install如提示则重新加载编辑器方法三VSIX 离线安装从 GitHub Releases 页面下载 VSIX 文件在 VS Code 中扩展面板 → 菜单三个点 → “从 VSIX 安装…”选择下载的 VSIX 文件并确认安装重新加载窗口2.2 CLI 安装方法一npm 全局安装推荐npminstall-gkilocode/cli方法二npx 临时使用无需安装npx kilocode/cli方法三旧 CPU 无 AVX 支持如果你的 CPU 不支持 AVX如 Intel Xeon Nehalem、AMD Bulldozer 等CLI 可能会崩溃报错 “Illegal instruction”。需下载 baseline 版本访问 Kilo Releases 页面下载对应平台的-baseline版本Linux x64:kilo-linux-x64-baseline.tar.gzmacOS x64:kilo-darwin-x64-baseline.zipWindows x64:kilo-windows-x64-baseline.zip解压并直接运行kilo二进制文件验证安装kilo--version2.3 JetBrains 插件通过 JetBrains Plugin Marketplace 搜索 “Kilo Code” 安装。2.4 升级# CLI 自动升级kilo upgrade# 或通过 npmnpmupdate-gkilocode/cli2.5 卸载# CLI 卸载kilo uninstall# npm 卸载npmuninstall-gkilocode/cli三、使用方法详解3.1 首次配置安装后运行kilo或在 VS Code 中打开 Kilo Code 面板使用/connect命令交互式添加 AI 提供商凭据注册 Kilo 账户https://kilo.ai/支持 Google 或 GitHub 登录注册后Kilo Code 提供商自动配置可免费开始使用3.2 VS Code 扩展使用基本使用流程打开 Kilo Code— 点击 VS Code 主侧边栏的 Kilo Code 图标打开聊天面板输入任务— 用自然语言描述需求例如“Create a file named hello.txt containing ‘Hello, world!’”“Write a Python function that adds two numbers”“Create an HTML file for a simple website”发送任务— 按 Enter 发送审查和批准操作— Kilo 提出操作建议默认大部分工具自动批准仅 shell 命令、外部目录访问和敏感文件读取需要确认迭代— 继续提供反馈直到任务完成权限设置在 Settings → Auto-Approve 标签页中可将每个工具设置为Allow自动批准Ask需要确认Deny拒绝执行代码操作Code Actions在编辑器中右键选中代码可选择Add to Chat— 将选中代码含文件路径和行号添加到当前聊天会话Agent Manager— 管理 Agent3.3 CLI 使用交互式模式# 启动 TUI终端用户界面kilo# 带指定模式启动kilo--modearchitect# 带指定工作区启动kilo--workspace/path/to/project一次性执行脚本化/CI 友好# 非交互式执行任务kilo runImplement feature X# 自治模式自动批准/拒绝kilo run--autoImplement feature X自治模式行为无需用户交互所有操作根据配置自动批准或拒绝追问自动回复请自主决策任务完成或超时时自动退出退出码0成功124超时1错误会话恢复# 恢复当前工作区最近的会话kilo--continuekilo-c注意不能与自治模式或提示参数一起使用。GitHub PR 工作流# 获取并检出 PR 分支然后启动 kilokiloprnumber3.4 CLI 完整命令参考顶级命令命令说明kilo acp启动 ACPAgent Client Protocol服务器kilo mcp管理 MCP 服务器kilo [project]启动 kilo TUIkilo attach url附加到运行中的 kilo 服务器kilo run [message]以消息运行 kilokilo debug调试和故障排除工具kilo auth管理 AI 提供商和凭据kilo agent管理 agentskilo upgrade [target]升级到最新或指定版本kilo uninstall卸载 kilo 及相关文件kilo serve启动无头 kilo 服务器kilo models [provider]列出所有可用模型kilo roll-call filter批量测试文本模型连接性和延迟kilo profile显示 Kilo 账户信息kilo stats显示 token 使用量和费用统计kilo export [sessionID]导出会话数据为 JSONkilo import file从 JSON 文件或 URL 导入会话数据kilo pr number获取并检出 GitHub PR 分支kilo session管理会话kilo remote启用远程连接以实现实时会话中继kilo daemon管理本地 kilo 守护进程kilo console打开本地 Kilo 控制台kilo db数据库工具kilo config配置工具kilo plugin module安装插件并更新配置kilo help [command]显示完整 CLI 参考kilo completion生成 shell 补全脚本全局选项标志说明--help, -h显示帮助--version, -v显示版本号--print-logs将日志打印到 stderr--log-level日志级别DEBUG, INFO, WARN, ERROR交互式斜杠命令会话命令命令别名说明/sessions/resume,/continue切换会话/new/clear新会话/share-分享会话/unshare-取消分享/rename-重命名会话/timeline-跳转到消息/fork-从消息分叉/compact/summarize压缩/总结会话/undo-撤销上一条消息/redo-重做消息/copy-复制会话记录/export-导出会话记录/timestamps/toggle-timestamps显示/隐藏时间戳/thinking/toggle-thinking显示/隐藏思考块Agent 和模型命令命令说明/models切换模型/agents切换 agent/mcps切换 MCP提供商命令命令说明/connect连接/添加提供商系统命令命令别名说明/status-查看状态/themes-切换主题/help-显示帮助/editor-打开外部编辑器/exit/quit,/q退出应用Kilo Gateway 命令连接时可用命令别名说明/profile/me,/whoami查看 Kilo Gateway 配置文件/teams/team,/org,/orgs切换 Kilo Gateway 团队/remote-切换远程模式以访问 Cloud Agent内置命令命令说明/init创建/更新项目 AGENTS.md 文件/local-review审查代码更改/local-review-uncommitted审查未提交的更改3.5 Agent 模式系统Kilo Code 使用专门的 Agent旧称 Modes来处理不同开发阶段的任务。内置 AgentAgent用途工具访问code编码、重构、实现完全访问ask解释、学习、安全问答只读plan设计、架构、实现计划只读 有限写入.kilo/plans/debug排错、诊断、事故处理完全访问orchestrator遗留任务委派已废弃切换 AgentVS Code在聊天面板的下拉菜单中选择CLI使用/agents命令或kilo --mode name启动3.6 自定义 AgentCustom Modes可以创建自定义 Agent 来适应特定任务或工作流。创建方式方式一让 Kilo 自动生成推荐在聊天中告诉 KiloCreate a new agent called docs-writer that can only read files and edit Markdown files.Kilo 会在.kilo/agents/下生成 Agent 定义文件。方式二Settings UISettings → Agent Behaviour → Agents 子标签页中查看、创建和编辑 Agent 配置。方式三Markdown 文件YAML frontmatter在以下目录创建.md文件.kilo/agents/my-agent.md .kilo/agent/my-agent.md .opencode/agents/my-agent.md全局 Agent 放在~/.config/kilo/agent/my-agent.md示例.kilo/agents/docs-writer.md---description:Specialized for writing and editing technical documentationmode:primarycolor:#10B981permission:edit:*.md:allow*:denybash:deny---You are a technical documentation specialist. Your expertise includes:-Writing clear,well-structured documentation-Following markdown best practices-Creating helpful code examples Focus on clarity and completeness. Only edit Markdown files.方式四配置文件kilo.jsonc在kilo.jsonc的agent键下定义{ agent: { docs-writer: { description: Specialized for writing and editing technical documentation, mode: primary, color: #10B981, prompt: You are a technical documentation specialist..., permission: { edit: { *.md: allow, *: deny }, bash: deny } }, // 覆盖内置 agent code: { model: anthropic/claude-sonnet-4-20250514, temperature: 0.3 } } }Agent 属性属性说明nameAgent 标识符由.md文件名派生description在 Agent 选择器中显示的简短摘要model锁定特定模型格式provider/modelprompt系统提示词Markdown 正文mode角色分类primary用户可选、subagent仅其他 agent 调用、all两者均可permission每 Agent 权限覆盖color颜色十六进制或主题关键字steps最大代理迭代次数temperature/top_p采样参数variant默认模型变体hidden是否在 UI 中隐藏3.7 权限系统基本权限每个权限规则解析为allow— 无需批准运行ask— 提示确认deny— 阻止执行全局配置{ $schema: https://app.kilo.ai/config.json, permission: { *: ask, bash: allow, edit: deny } }或一键设置所有权限{ permission: allow }细粒度规则{ permission: { bash: { *: ask, git *: allow, npm *: allow, rm *: deny, grep *: allow }, edit: { *: deny, packages/web/src/content/docs/*.mdx: allow } } }规则按模式匹配评估最后匹配的规则生效。通配符*匹配零个或多个字符?匹配恰好一个字符。外部目录{ permission: { external_directory: { ~/projects/personal/**: allow } } }3.8 本地代码审查# 审查当前分支相对于基础分支的更改/local-review# 审查未提交的更改暂存 未暂存/local-review-uncommitted3.9 远程连接让 Cloud Agents Web 界面访问本地 CLI 会话# 会话中切换/remote# 默认启用添加到 ~/.config/kilo/config.json{remote_control:true}3.10 自动补全基于 FIMFill-in-the-Middle技术使用 Codestral 模型提供智能代码补全。状态栏显示补全成本跟踪。免费自动补全添加自己的 Mistral AICodestralAPI KeyMistral 提供 Codestral 免费层级。3.11 其他生产力工具Enhance Prompt优化提示词Git Commit GenerationAI 生成 Git 提交信息Voice Transcription语音转录Message Feedback消息反馈Code ActionsVS Code 右键菜单集成四、配置系统4.1 配置文件范围路径全局~/.config/kilo/kilo.jsonc项目./kilo.jsonc或项目根目录TUI 设置~/.config/kilo/tui.jsonc全局或.kilo/tui.jsonc项目项目级配置优先于全局设置。4.2 关键配置选项{ $schema: https://app.kilo.ai/config.json, model: anthropic/claude-sonnet-4-20250514, provider: { anthropic: { options: { apiKey: {env:ANTHROPIC_API_KEY} } } }, mcp: { /* MCP 服务器配置 */ }, permission: { /* 权限设置 */ }, instructions: [CONTRIBUTING.md, .cursor/rules/*.md], formatter: true, lsp: false, disabled_providers: [], enabled_providers: [] }4.3 环境变量配置文件中引用环境变量{ provider: { openai: { options: { apiKey: {env:OPENAI_API_KEY} } } } }CLI 环境变量覆盖KILO_PROVIDER覆盖活动提供商 IDKILO_API_KEY覆盖 API KeyKILO_ORG_ID指定组织用于 CI 环境4.4 CLI 通知和声音{ attention: { enabled: true, notifications: true, sound: true, volume: 0.4, sounds: { question: ./sounds/question.mp3, permission: ./sounds/permission.mp3, error: ./sounds/error.mp3, done: ./sounds/done.mp3 } } }支持的声音名称default,question,permission,error,done,subagent_done4.5 配置优先级Agent 配置从低到高合并内置原生Agent 默认值全局配置~/.config/kilo/kilo.jsonc项目配置项目根目录kilo.jsonc.kilo//.opencode/目录配置和 Agent.md文件环境变量覆盖KILO_CONFIG_CONTENT同名 Agent 在不同级别出现时属性是合并而非完全替换。五、AI 提供商和模型5.1 支持的提供商40Anthropic、OpenAI、Google Gemini、Mistral、DeepSeek、xAI (Grok)、OpenRouter、Glama、Google Vertex AI、AWS Bedrock、阿里云、Cloudflare、Groq、Cerebras、Fireworks AI、Ollama、LM Studio 等。5.2 Kilo 内置提供商注册 https://kilo.ai/ 账户即可使用免费模型立即可用充值后使用高级模型支持 Google/GitHub 登录5.3 免费使用Auto Free模型选择器中选择自动路由到最佳免费模型。警告可能路由到记录提示/输出的提供商如 NVIDIA 免费端点不要提交个人/机密数据。其他免费模型模型选择器中输入筛选免费模型有明确标签。5.4 自定义模型对于不在内置列表中的模型在配置文件的provider.provider_id.models下注册。六、高级功能6.1 MCPModel Context Protocol支持通过 MCP 扩展 Agent 能力支持 MCP Server Marketplace 查找和使用 MCP 服务器。配置在kilo.jsonc的mcp键下。6.2 Workflows可重复使用的提示模板以.md文件形式存在可自定义为斜杠命令。6.3 Skills加载专业领域知识的可复用包SKILL.md文件。6.4 代码库索引支持代码库索引Codebase Indexing让 AI 理解整个项目结构。6.5 上下文压缩Context Condensing当上下文过长时自动压缩/总结。6.6 .kilocodeignore类似 .gitignore指定哪些文件/目录不被 Kilo 索引。6.7 Cloud Agent云端 Agent 服务支持远程连接本地 CLI 会话。6.8 App Builder在云端构建应用。6.9 Mobile AppsiOS/Android 移动应用跨设备同步会话。6.10 Slack 集成在 Slack 中直接 Kilo 进行代码问答和 PR 操作。6.11 Gas Town by KiloKilo 提供的云开发环境。七、企业使用7.1 团队/组织模式如果属于 Kilo 组织Team 或 Enterprise可将 CLI 请求路由到该组织交互式使用在 CLI 中使用/teams命令选择组织。选择会持久化到本地。非交互式使用kilo run无--org标志组织由以下来源确定优先级从高到低KILO_ORG_ID环境变量上次/teams选择的持久化结果7.2 组织网络代理配置在企业环境中通过 VS Code 设置配置代理和证书信任而不是单独的 CLI 安装。八、Windows 特殊配置ShiftEnter 支持在 Windows Terminal 中启用 ShiftEnter 插入换行而非提交消息打开%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json添加actions: [ { command: { action: sendInput, input: \u001b[13;2u }, id: User.sendInput.ShiftEnterCustom } ], keybindings: [ { keys: shiftenter, id: User.sendInput.ShiftEnterCustom } ]TUI 键盘快捷键Windows 上CtrlZ分配给输入撤销因为原生 Windows 终端不支持 POSIX 终端挂起。九、从 Cursor 迁移Kilo 提供专门的迁移指南https://kilo.ai/docs/advanced-usage/migrating-from-cursor涵盖配置迁移工作流迁移差异对比十、常见问题排查旧 CPU 崩溃使用 baseline 版本网络连接问题检查代理配置模型不可用检查 API Key 和提供商配置权限问题检查kilo.jsonc中的 permission 配置十一、社区和资源GitHub: https://github.com/Kilo-Org/kilocode文档: https://kilo.ai/docsDiscord: 社区讨论YouTube: 教程和演示贡献指南: https://kilo.ai/docs/contributing十二、总结Kilo Code 是目前最全面的开源 AI 编程助手之一主要优势模型无关支持 500 模型不绑定单一提供商多平台VS Code、JetBrains、CLI、Slack、移动端全覆盖开源完全开源可审查和定制灵活的 Agent 系统内置 自定义 Agent权限细粒度控制MCP 支持扩展能力强免费可用Auto Free 模式 开源企业就绪组织模式、团队管理、CI/CD 集成CLI 优先键盘优先的终端交互适合自动化和脚本化会话同步跨设备无缝切换主要注意事项当前版本为 1.0仍在快速迭代Auto Free 模式可能记录提示数据不适合敏感项目VS Code 扩展标记为 “pre-release” 但实际稳定
Kilo Code 安装、使用方法详细全解
发布时间：2026/6/14 14:40:55
Kilo Code 安装、使用方法详细全解一、项目概述Kilo Code 定位为一个超集产品——融合了 Roo Code、Cline 等工具的优点并提供自研功能。它支持 500 AI 模型包括 GPT-5.5、Claude Opus 4.7、Claude Sonnet 4.6、Gemini 3.1 Pro 等通过 Kilo Gateway 统一接入。核心特点完全开源多平台支持VS Code、JetBrains、CLI、Slack、移动端、云端跨设备会话同步基于自然语言的代码生成自动任务执行终端命令、浏览器自动化等MCPModel Context Protocol支持自定义 Agent/Modes 系统二、安装方法2.1 VS Code 扩展安装方法一VS Code Marketplace推荐打开 VS Code进入扩展面板CtrlShiftX/CmdShiftX搜索 “Kilo Code”点击 “Install” 旁边的下拉箭头选择“Install Pre-Release Version”安装完成后侧边栏会出现 Kilo Code 图标注意虽然标记为 “pre-release”但这是稳定的推荐版本只是 VS Code Marketplace 的分发通道。方法二Open VSX Registry适用于 VSCodium、Gitpod、Eclipse Theia、Windsurf 等无法访问官方 Marketplace 的编辑器打开编辑器进入扩展面板CtrlShiftX/CmdShiftX确保编辑器已配置 Open VSX Registry搜索 “Kilo Code”选择并点击 Install如提示则重新加载编辑器方法三VSIX 离线安装从 GitHub Releases 页面下载 VSIX 文件在 VS Code 中扩展面板 → 菜单三个点 → “从 VSIX 安装…”选择下载的 VSIX 文件并确认安装重新加载窗口2.2 CLI 安装方法一npm 全局安装推荐npminstall-gkilocode/cli方法二npx 临时使用无需安装npx kilocode/cli方法三旧 CPU 无 AVX 支持如果你的 CPU 不支持 AVX如 Intel Xeon Nehalem、AMD Bulldozer 等CLI 可能会崩溃报错 “Illegal instruction”。需下载 baseline 版本访问 Kilo Releases 页面下载对应平台的-baseline版本Linux x64:kilo-linux-x64-baseline.tar.gzmacOS x64:kilo-darwin-x64-baseline.zipWindows x64:kilo-windows-x64-baseline.zip解压并直接运行kilo二进制文件验证安装kilo--version2.3 JetBrains 插件通过 JetBrains Plugin Marketplace 搜索 “Kilo Code” 安装。2.4 升级# CLI 自动升级kilo upgrade# 或通过 npmnpmupdate-gkilocode/cli2.5 卸载# CLI 卸载kilo uninstall# npm 卸载npmuninstall-gkilocode/cli三、使用方法详解3.1 首次配置安装后运行kilo或在 VS Code 中打开 Kilo Code 面板使用/connect命令交互式添加 AI 提供商凭据注册 Kilo 账户https://kilo.ai/支持 Google 或 GitHub 登录注册后Kilo Code 提供商自动配置可免费开始使用3.2 VS Code 扩展使用基本使用流程打开 Kilo Code— 点击 VS Code 主侧边栏的 Kilo Code 图标打开聊天面板输入任务— 用自然语言描述需求例如“Create a file named hello.txt containing ‘Hello, world!’”“Write a Python function that adds two numbers”“Create an HTML file for a simple website”发送任务— 按 Enter 发送审查和批准操作— Kilo 提出操作建议默认大部分工具自动批准仅 shell 命令、外部目录访问和敏感文件读取需要确认迭代— 继续提供反馈直到任务完成权限设置在 Settings → Auto-Approve 标签页中可将每个工具设置为Allow自动批准Ask需要确认Deny拒绝执行代码操作Code Actions在编辑器中右键选中代码可选择Add to Chat— 将选中代码含文件路径和行号添加到当前聊天会话Agent Manager— 管理 Agent3.3 CLI 使用交互式模式# 启动 TUI终端用户界面kilo# 带指定模式启动kilo--modearchitect# 带指定工作区启动kilo--workspace/path/to/project一次性执行脚本化/CI 友好# 非交互式执行任务kilo runImplement feature X# 自治模式自动批准/拒绝kilo run--autoImplement feature X自治模式行为无需用户交互所有操作根据配置自动批准或拒绝追问自动回复请自主决策任务完成或超时时自动退出退出码0成功124超时1错误会话恢复# 恢复当前工作区最近的会话kilo--continuekilo-c注意不能与自治模式或提示参数一起使用。GitHub PR 工作流# 获取并检出 PR 分支然后启动 kilokiloprnumber3.4 CLI 完整命令参考顶级命令命令说明kilo acp启动 ACPAgent Client Protocol服务器kilo mcp管理 MCP 服务器kilo [project]启动 kilo TUIkilo attach url附加到运行中的 kilo 服务器kilo run [message]以消息运行 kilokilo debug调试和故障排除工具kilo auth管理 AI 提供商和凭据kilo agent管理 agentskilo upgrade [target]升级到最新或指定版本kilo uninstall卸载 kilo 及相关文件kilo serve启动无头 kilo 服务器kilo models [provider]列出所有可用模型kilo roll-call filter批量测试文本模型连接性和延迟kilo profile显示 Kilo 账户信息kilo stats显示 token 使用量和费用统计kilo export [sessionID]导出会话数据为 JSONkilo import file从 JSON 文件或 URL 导入会话数据kilo pr number获取并检出 GitHub PR 分支kilo session管理会话kilo remote启用远程连接以实现实时会话中继kilo daemon管理本地 kilo 守护进程kilo console打开本地 Kilo 控制台kilo db数据库工具kilo config配置工具kilo plugin module安装插件并更新配置kilo help [command]显示完整 CLI 参考kilo completion生成 shell 补全脚本全局选项标志说明--help, -h显示帮助--version, -v显示版本号--print-logs将日志打印到 stderr--log-level日志级别DEBUG, INFO, WARN, ERROR交互式斜杠命令会话命令命令别名说明/sessions/resume,/continue切换会话/new/clear新会话/share-分享会话/unshare-取消分享/rename-重命名会话/timeline-跳转到消息/fork-从消息分叉/compact/summarize压缩/总结会话/undo-撤销上一条消息/redo-重做消息/copy-复制会话记录/export-导出会话记录/timestamps/toggle-timestamps显示/隐藏时间戳/thinking/toggle-thinking显示/隐藏思考块Agent 和模型命令命令说明/models切换模型/agents切换 agent/mcps切换 MCP提供商命令命令说明/connect连接/添加提供商系统命令命令别名说明/status-查看状态/themes-切换主题/help-显示帮助/editor-打开外部编辑器/exit/quit,/q退出应用Kilo Gateway 命令连接时可用命令别名说明/profile/me,/whoami查看 Kilo Gateway 配置文件/teams/team,/org,/orgs切换 Kilo Gateway 团队/remote-切换远程模式以访问 Cloud Agent内置命令命令说明/init创建/更新项目 AGENTS.md 文件/local-review审查代码更改/local-review-uncommitted审查未提交的更改3.5 Agent 模式系统Kilo Code 使用专门的 Agent旧称 Modes来处理不同开发阶段的任务。内置 AgentAgent用途工具访问code编码、重构、实现完全访问ask解释、学习、安全问答只读plan设计、架构、实现计划只读 有限写入.kilo/plans/debug排错、诊断、事故处理完全访问orchestrator遗留任务委派已废弃切换 AgentVS Code在聊天面板的下拉菜单中选择CLI使用/agents命令或kilo --mode name启动3.6 自定义 AgentCustom Modes可以创建自定义 Agent 来适应特定任务或工作流。创建方式方式一让 Kilo 自动生成推荐在聊天中告诉 KiloCreate a new agent called docs-writer that can only read files and edit Markdown files.Kilo 会在.kilo/agents/下生成 Agent 定义文件。方式二Settings UISettings → Agent Behaviour → Agents 子标签页中查看、创建和编辑 Agent 配置。方式三Markdown 文件YAML frontmatter在以下目录创建.md文件.kilo/agents/my-agent.md .kilo/agent/my-agent.md .opencode/agents/my-agent.md全局 Agent 放在~/.config/kilo/agent/my-agent.md示例.kilo/agents/docs-writer.md---description:Specialized for writing and editing technical documentationmode:primarycolor:#10B981permission:edit:*.md:allow*:denybash:deny---You are a technical documentation specialist. Your expertise includes:-Writing clear,well-structured documentation-Following markdown best practices-Creating helpful code examples Focus on clarity and completeness. Only edit Markdown files.方式四配置文件kilo.jsonc在kilo.jsonc的agent键下定义{ agent: { docs-writer: { description: Specialized for writing and editing technical documentation, mode: primary, color: #10B981, prompt: You are a technical documentation specialist..., permission: { edit: { *.md: allow, *: deny }, bash: deny } }, // 覆盖内置 agent code: { model: anthropic/claude-sonnet-4-20250514, temperature: 0.3 } } }Agent 属性属性说明nameAgent 标识符由.md文件名派生description在 Agent 选择器中显示的简短摘要model锁定特定模型格式provider/modelprompt系统提示词Markdown 正文mode角色分类primary用户可选、subagent仅其他 agent 调用、all两者均可permission每 Agent 权限覆盖color颜色十六进制或主题关键字steps最大代理迭代次数temperature/top_p采样参数variant默认模型变体hidden是否在 UI 中隐藏3.7 权限系统基本权限每个权限规则解析为allow— 无需批准运行ask— 提示确认deny— 阻止执行全局配置{ $schema: https://app.kilo.ai/config.json, permission: { *: ask, bash: allow, edit: deny } }或一键设置所有权限{ permission: allow }细粒度规则{ permission: { bash: { *: ask, git *: allow, npm *: allow, rm *: deny, grep *: allow }, edit: { *: deny, packages/web/src/content/docs/*.mdx: allow } } }规则按模式匹配评估最后匹配的规则生效。通配符*匹配零个或多个字符?匹配恰好一个字符。外部目录{ permission: { external_directory: { ~/projects/personal/**: allow } } }3.8 本地代码审查# 审查当前分支相对于基础分支的更改/local-review# 审查未提交的更改暂存 未暂存/local-review-uncommitted3.9 远程连接让 Cloud Agents Web 界面访问本地 CLI 会话# 会话中切换/remote# 默认启用添加到 ~/.config/kilo/config.json{remote_control:true}3.10 自动补全基于 FIMFill-in-the-Middle技术使用 Codestral 模型提供智能代码补全。状态栏显示补全成本跟踪。免费自动补全添加自己的 Mistral AICodestralAPI KeyMistral 提供 Codestral 免费层级。3.11 其他生产力工具Enhance Prompt优化提示词Git Commit GenerationAI 生成 Git 提交信息Voice Transcription语音转录Message Feedback消息反馈Code ActionsVS Code 右键菜单集成四、配置系统4.1 配置文件范围路径全局~/.config/kilo/kilo.jsonc项目./kilo.jsonc或项目根目录TUI 设置~/.config/kilo/tui.jsonc全局或.kilo/tui.jsonc项目项目级配置优先于全局设置。4.2 关键配置选项{ $schema: https://app.kilo.ai/config.json, model: anthropic/claude-sonnet-4-20250514, provider: { anthropic: { options: { apiKey: {env:ANTHROPIC_API_KEY} } } }, mcp: { /* MCP 服务器配置 */ }, permission: { /* 权限设置 */ }, instructions: [CONTRIBUTING.md, .cursor/rules/*.md], formatter: true, lsp: false, disabled_providers: [], enabled_providers: [] }4.3 环境变量配置文件中引用环境变量{ provider: { openai: { options: { apiKey: {env:OPENAI_API_KEY} } } } }CLI 环境变量覆盖KILO_PROVIDER覆盖活动提供商 IDKILO_API_KEY覆盖 API KeyKILO_ORG_ID指定组织用于 CI 环境4.4 CLI 通知和声音{ attention: { enabled: true, notifications: true, sound: true, volume: 0.4, sounds: { question: ./sounds/question.mp3, permission: ./sounds/permission.mp3, error: ./sounds/error.mp3, done: ./sounds/done.mp3 } } }支持的声音名称default,question,permission,error,done,subagent_done4.5 配置优先级Agent 配置从低到高合并内置原生Agent 默认值全局配置~/.config/kilo/kilo.jsonc项目配置项目根目录kilo.jsonc.kilo//.opencode/目录配置和 Agent.md文件环境变量覆盖KILO_CONFIG_CONTENT同名 Agent 在不同级别出现时属性是合并而非完全替换。五、AI 提供商和模型5.1 支持的提供商40Anthropic、OpenAI、Google Gemini、Mistral、DeepSeek、xAI (Grok)、OpenRouter、Glama、Google Vertex AI、AWS Bedrock、阿里云、Cloudflare、Groq、Cerebras、Fireworks AI、Ollama、LM Studio 等。5.2 Kilo 内置提供商注册 https://kilo.ai/ 账户即可使用免费模型立即可用充值后使用高级模型支持 Google/GitHub 登录5.3 免费使用Auto Free模型选择器中选择自动路由到最佳免费模型。警告可能路由到记录提示/输出的提供商如 NVIDIA 免费端点不要提交个人/机密数据。其他免费模型模型选择器中输入筛选免费模型有明确标签。5.4 自定义模型对于不在内置列表中的模型在配置文件的provider.provider_id.models下注册。六、高级功能6.1 MCPModel Context Protocol支持通过 MCP 扩展 Agent 能力支持 MCP Server Marketplace 查找和使用 MCP 服务器。配置在kilo.jsonc的mcp键下。6.2 Workflows可重复使用的提示模板以.md文件形式存在可自定义为斜杠命令。6.3 Skills加载专业领域知识的可复用包SKILL.md文件。6.4 代码库索引支持代码库索引Codebase Indexing让 AI 理解整个项目结构。6.5 上下文压缩Context Condensing当上下文过长时自动压缩/总结。6.6 .kilocodeignore类似 .gitignore指定哪些文件/目录不被 Kilo 索引。6.7 Cloud Agent云端 Agent 服务支持远程连接本地 CLI 会话。6.8 App Builder在云端构建应用。6.9 Mobile AppsiOS/Android 移动应用跨设备同步会话。6.10 Slack 集成在 Slack 中直接 Kilo 进行代码问答和 PR 操作。6.11 Gas Town by KiloKilo 提供的云开发环境。七、企业使用7.1 团队/组织模式如果属于 Kilo 组织Team 或 Enterprise可将 CLI 请求路由到该组织交互式使用在 CLI 中使用/teams命令选择组织。选择会持久化到本地。非交互式使用kilo run无--org标志组织由以下来源确定优先级从高到低KILO_ORG_ID环境变量上次/teams选择的持久化结果7.2 组织网络代理配置在企业环境中通过 VS Code 设置配置代理和证书信任而不是单独的 CLI 安装。八、Windows 特殊配置ShiftEnter 支持在 Windows Terminal 中启用 ShiftEnter 插入换行而非提交消息打开%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json添加actions: [ { command: { action: sendInput, input: \u001b[13;2u }, id: User.sendInput.ShiftEnterCustom } ], keybindings: [ { keys: shiftenter, id: User.sendInput.ShiftEnterCustom } ]TUI 键盘快捷键Windows 上CtrlZ分配给输入撤销因为原生 Windows 终端不支持 POSIX 终端挂起。九、从 Cursor 迁移Kilo 提供专门的迁移指南https://kilo.ai/docs/advanced-usage/migrating-from-cursor涵盖配置迁移工作流迁移差异对比十、常见问题排查旧 CPU 崩溃使用 baseline 版本网络连接问题检查代理配置模型不可用检查 API Key 和提供商配置权限问题检查kilo.jsonc中的 permission 配置十一、社区和资源GitHub: https://github.com/Kilo-Org/kilocode文档: https://kilo.ai/docsDiscord: 社区讨论YouTube: 教程和演示贡献指南: https://kilo.ai/docs/contributing十二、总结Kilo Code 是目前最全面的开源 AI 编程助手之一主要优势模型无关支持 500 模型不绑定单一提供商多平台VS Code、JetBrains、CLI、Slack、移动端全覆盖开源完全开源可审查和定制灵活的 Agent 系统内置 自定义 Agent权限细粒度控制MCP 支持扩展能力强免费可用Auto Free 模式 开源企业就绪组织模式、团队管理、CI/CD 集成CLI 优先键盘优先的终端交互适合自动化和脚本化会话同步跨设备无缝切换主要注意事项当前版本为 1.0仍在快速迭代Auto Free 模式可能记录提示数据不适合敏感项目VS Code 扩展标记为 “pre-release” 但实际稳定
