Kilo Code 安装、使用方法详细全解

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、移动端、云端）
• 跨设备会话同步
• 基于自然语言的代码生成
• 自动任务执行（终端命令、浏览器自动化等）
• MCP（Model Context Protocol）支持
• 自定义 Agent/Modes 系统

二、安装方法

2.1 VS Code 扩展安装

方法一：VS Code Marketplace（推荐）

1. 打开 VS Code
2. 进入扩展面板（Ctrl+Shift+X/Cmd+Shift+X）
3. 搜索 “Kilo Code”
4. 点击 “Install” 旁边的下拉箭头，选择“Install Pre-Release Version”
5. 安装完成后，侧边栏会出现 Kilo Code 图标

注意：虽然标记为 “pre-release”，但这是稳定的推荐版本，只是 VS Code Marketplace 的分发通道。

方法二：Open VSX Registry

适用于 VSCodium、Gitpod、Eclipse Theia、Windsurf 等无法访问官方 Marketplace 的编辑器：

1. 打开编辑器
2. 进入扩展面板（Ctrl+Shift+X/Cmd+Shift+X）
3. 确保编辑器已配置 Open VSX Registry
4. 搜索 “Kilo Code”
5. 选择并点击 Install
6. 如提示则重新加载编辑器

方法三：VSIX 离线安装

1. 从 GitHub Releases 页面下载 VSIX 文件
2. 在 VS Code 中：扩展面板 → 菜单（三个点） → “从 VSIX 安装…”
3. 选择下载的 VSIX 文件并确认安装
4. 重新加载窗口

2.2 CLI 安装

方法一：npm 全局安装（推荐）

npminstall-g@kilocode/cli

方法二：npx 临时使用（无需安装）

npx @kilocode/cli

方法三：旧 CPU 无 AVX 支持

如果你的 CPU 不支持 AVX（如 Intel Xeon Nehalem、AMD Bulldozer 等），CLI 可能会崩溃报错 “Illegal instruction”。需下载 baseline 版本：

1. 访问 Kilo Releases 页面
2. 下载对应平台的-baseline版本：
   • Linux x64:kilo-linux-x64-baseline.tar.gz
   • macOS x64:kilo-darwin-x64-baseline.zip
   • Windows x64:kilo-windows-x64-baseline.zip
3. 解压并直接运行kilo二进制文件

验证安装：

kilo--version

2.3 JetBrains 插件

通过 JetBrains Plugin Marketplace 搜索 “Kilo Code” 安装。

2.4 升级

# CLI 自动升级kilo upgrade# 或通过 npmnpmupdate-g@kilocode/cli

2.5 卸载

# CLI 卸载kilo uninstall# npm 卸载npmuninstall-g@kilocode/cli

三、使用方法详解

3.1 首次配置

安装后，运行kilo或在 VS Code 中打开 Kilo Code 面板：

1. 使用/connect命令交互式添加 AI 提供商凭据
2. 注册 Kilo 账户（https://kilo.ai/），支持 Google 或 GitHub 登录
3. 注册后，Kilo Code 提供商自动配置，可免费开始使用

3.2 VS Code 扩展使用

基本使用流程

1. 打开 Kilo Code— 点击 VS Code 主侧边栏的 Kilo Code 图标打开聊天面板
2. 输入任务— 用自然语言描述需求，例如：
   • “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”
3. 发送任务— 按 Enter 发送
4. 审查和批准操作— Kilo 提出操作建议，默认大部分工具自动批准，仅 shell 命令、外部目录访问和敏感文件读取需要确认
5. 迭代— 继续提供反馈直到任务完成

权限设置

在 Settings → Auto-Approve 标签页中，可将每个工具设置为：

• Allow：自动批准
• Ask：需要确认
• Deny：拒绝执行

代码操作（Code Actions）

在编辑器中右键选中代码，可选择：

• Add to Chat— 将选中代码（含文件路径和行号）添加到当前聊天会话
• Agent Manager— 管理 Agent

3.3 CLI 使用

交互式模式

# 启动 TUI（终端用户界面）kilo# 带指定模式启动kilo--modearchitect# 带指定工作区启动kilo--workspace/path/to/project

一次性执行（脚本化/CI 友好）

# 非交互式执行任务kilo run"Implement feature X"# 自治模式（自动批准/拒绝）kilo run--auto"Implement feature X"

自治模式行为：

• 无需用户交互
• 所有操作根据配置自动批准或拒绝
• 追问自动回复"请自主决策"
• 任务完成或超时时自动退出
• 退出码：0=成功，124=超时，1=错误

会话恢复

# 恢复当前工作区最近的会话kilo--continuekilo-c

注意：不能与自治模式或提示参数一起使用。

GitHub PR 工作流

# 获取并检出 PR 分支，然后启动 kilokilopr<number>

3.4 CLI 完整命令参考

顶级命令

全局选项

交互式斜杠命令

会话命令：

Agent 和模型命令：

提供商命令：

系统命令：

Kilo Gateway 命令（连接时可用）：

内置命令：

3.5 Agent 模式系统

Kilo Code 使用专门的 Agent（旧称 Modes）来处理不同开发阶段的任务。

内置 Agent

切换 Agent

• VS Code：在聊天面板的下拉菜单中选择
• CLI：使用/agents命令或kilo --mode <name>启动

3.6 自定义 Agent（Custom Modes）

可以创建自定义 Agent 来适应特定任务或工作流。

创建方式

方式一：让 Kilo 自动生成（推荐）

在聊天中告诉 Kilo：

Create a new agent called "docs-writer" that can only read files and edit Markdown files.

Kilo 会在.kilo/agents/下生成 Agent 定义文件。

方式二：Settings UI

Settings → 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:"#10B981"permission:edit:"*.md":"allow""*":"deny"bash: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 属性

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-uncommitted

3.9 远程连接

让 Cloud Agents Web 界面访问本地 CLI 会话：

# 会话中切换/remote# 默认启用（添加到 ~/.config/kilo/config.json）{"remote_control":true}

3.10 自动补全

基于 FIM（Fill-in-the-Middle）技术，使用 Codestral 模型提供智能代码补全。状态栏显示补全成本跟踪。

免费自动补全：添加自己的 Mistral AI（Codestral）API Key，Mistral 提供 Codestral 免费层级。

3.11 其他生产力工具

• Enhance Prompt：优化提示词
• Git Commit Generation：AI 生成 Git 提交信息
• Voice Transcription：语音转录
• Message Feedback：消息反馈
• Code Actions：VS Code 右键菜单集成

四、配置系统

4.1 配置文件

项目级配置优先于全局设置。

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：覆盖活动提供商 ID
• KILO_API_KEY：覆盖 API Key
• KILO_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_done

4.5 配置优先级

Agent 配置从低到高合并：

1. 内置（原生）Agent 默认值
2. 全局配置（~/.config/kilo/kilo.jsonc）
3. 项目配置（项目根目录kilo.jsonc）
4. .kilo//.opencode/目录配置和 Agent.md文件
5. 环境变量覆盖（KILO_CONFIG_CONTENT）

同名 Agent 在不同级别出现时，属性是合并而非完全替换。

五、AI 提供商和模型

5.1 支持的提供商（40+）

Anthropic、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 MCP（Model 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 Apps

iOS/Android 移动应用，跨设备同步会话。

6.10 Slack 集成

在 Slack 中直接 @ Kilo 进行代码问答和 PR 操作。

6.11 Gas Town by Kilo

Kilo 提供的云开发环境。

七、企业使用

7.1 团队/组织模式

如果属于 Kilo 组织（Team 或 Enterprise），可将 CLI 请求路由到该组织：

交互式使用：
在 CLI 中使用/teams命令选择组织。选择会持久化到本地。

非交互式使用（kilo run）：
无--org标志，组织由以下来源确定（优先级从高到低）：

1. KILO_ORG_ID环境变量
2. 上次/teams选择的持久化结果

7.2 组织网络代理配置

在企业环境中，通过 VS Code 设置配置代理和证书信任，而不是单独的 CLI 安装。

八、Windows 特殊配置

Shift+Enter 支持

在 Windows Terminal 中启用 Shift+Enter 插入换行（而非提交消息）：

打开%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json，添加：

"actions": [ { "command": { "action": "sendInput", "input": "\u001b[13;2u" }, "id": "User.sendInput.ShiftEnterCustom" } ], "keybindings": [ { "keys": "shift+enter", "id": "User.sendInput.ShiftEnterCustom" } ]

TUI 键盘快捷键

Windows 上Ctrl+Z分配给输入撤销（因为原生 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/docs
• Discord: 社区讨论
• YouTube: 教程和演示
• 贡献指南: https://kilo.ai/docs/contributing

十二、总结

Kilo Code 是目前最全面的开源 AI 编程助手之一，主要优势：

1. 模型无关：支持 500+ 模型，不绑定单一提供商
2. 多平台：VS Code、JetBrains、CLI、Slack、移动端全覆盖
3. 开源：完全开源，可审查和定制
4. 灵活的 Agent 系统：内置 + 自定义 Agent，权限细粒度控制
5. MCP 支持：扩展能力强
6. 免费可用：Auto Free 模式 + 开源
7. 企业就绪：组织模式、团队管理、CI/CD 集成
8. CLI 优先：键盘优先的终端交互，适合自动化和脚本化
9. 会话同步：跨设备无缝切换

主要注意事项：

• 当前版本为 1.0，仍在快速迭代
• Auto Free 模式可能记录提示数据，不适合敏感项目
• VS Code 扩展标记为 “pre-release” 但实际稳定