Kilo Code：开源 AI 编程工具 (2026)

Kilo Code 是一款以 VS Code 扩展形式运行的开源 AI 编程助手。它是 Cline（最初名为 Claude Dev）的一个分支，专注于改进用户体验 (UX)、降低 Token 消耗，并提供对多个 AI 供应商的更好支持。如果你一直在寻找一个可以在 VS Code 内部运行，且能替代 Cursor AI 功能的免费开源方案，Kilo Code 非常值得评估。

什么是 Kilo Code？

Kilo Code 是一个 VS Code 插件，它直接在你的编辑器中提供了一个 AI 编程智能体 (Agent)。它可以：

读取并写入项目中的文件
执行终端命令
浏览网页查询文档
在单个任务中创建和编辑多个文件
通过 API 使用任何 AI 模型（Claude、GPT、Gemini、本地模型）
在执行操作前向你展示其确切计划

它与基础的代码补全工具（如 Copilot）不同，因为它是一个智能体 (Agent) —— 它可以自主执行多步骤任务，例如“创建一个带有测试和文档的新 REST API 端点”。

Kilo Code vs Cline vs Cursor

功能	Kilo Code	Cline	Cursor
开源	是 (Apache 2.0)	是 (Apache 2.0)	否
在 VS Code 中运行	是	是	独立编辑器 (VS Code 分支)
模型支持	任何 API (Claude, GPT, Gemini, Ollama)	任何 API	Claude, GPT (内置)
文件编辑	是 (需经批准)	是 (需经批准)	是 (行内 + 聊天)
终端访问	是	是	是
网页浏览	是	是	否
Token 优化	较 Cline 有所改进	基准水平	私有技术
价格	免费 (自带 API Key)	免费 (自带 API Key)	$20/月 + API 成本
自定义模式	是	有限	否

安装

通过 VS Code 市场安装

1. 打开 VS Code
2. 进入扩展面板 (Ctrl+Shift+X / Cmd+Shift+X)
3. 搜索 "Kilo Code"
4. 点击安装
5. 如有提示，请重新加载 VS Code

通过命令行安装

code --install-extension kilocode.kilo-code

从源码安装 (面向贡献者)

git clone https://github.com/kilocode/kilo-code.git
cd kilo-code
npm install
npm run build

# 打包扩展
npx vsce package

# 安装 .vsix 文件
code --install-extension kilo-code-*.vsix

配置

安装完成后，配置你的 AI 供应商。

步骤 1：打开 Kilo Code 设置

按下 Ctrl+Shift+P (macOS 为 Cmd+Shift+P) 并输入 "Kilo Code: Open Settings"。

步骤 2：配置 AI 供应商

Kilo Code 支持多个供应商。以下是最常见的配置：

Anthropic (Claude):

{
  "kilocode.provider": "anthropic",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.model": "claude-sonnet-4-20250514"
}

OpenAI (GPT):

{
  "kilocode.provider": "openai",
  "kilocode.apiKey": "sk-xxxxx",
  "kilocode.model": "gpt-4o"
}

Google (Gemini):

{
  "kilocode.provider": "google",
  "kilocode.apiKey": "AIzaSyxxxxx",
  "kilocode.model": "gemini-2.0-flash"
}

本地模型 (Ollama):

{
  "kilocode.provider": "ollama",
  "kilocode.baseUrl": "http://localhost:11434",
  "kilocode.model": "qwen2.5-coder:32b"
}

OpenRouter (访问所有模型):

{
  "kilocode.provider": "openrouter",
  "kilocode.apiKey": "sk-or-xxxxx",
  "kilocode.model": "anthropic/claude-sonnet-4-20250514"
}

使用 Kilo Code

基础用法

从活动栏（左侧边栏的 Kilo 图标）打开 Kilo Code 面板，或按下快捷键。然后使用自然语言输入你的请求：

创建一个带有 /health 端点的 Node.js Express 服务器，
返回当前时间戳和运行时间。

Kilo Code 将会：

规划文件更改
准确展示它将创建或修改的内容
等待你的批准
执行更改
(可选) 运行命令（如 npm install express）

多文件任务

Kilo Code 擅长处理跨越多个文件的任务：

为这个 Express 应用添加用户认证：
- 创建一个包含 email 和加密密码的 User 模型
- 添加 /register 和 /login 端点
- 为受保护的路由创建 JWT 中间件
- 为认证端点添加测试

终端命令

Kilo Code 可以在经过你批准的情况下运行终端命令：

安装所需的依赖项并运行测试套件

它会在运行前向你展示确切的命令：

# Kilo Code 建议执行：
npm install bcryptjs jsonwebtoken
npm test

你可以批准、修改或拒绝每个命令。

网页浏览

Kilo Code 可以从网上获取文档来辅助工作：

查找最新的 Prisma ORM 迁移语法，并创建一个
迁移脚本，添加一个“comments”表，其中包含指向
“users”和“posts”表的外键。

自定义模式

Kilo Code 的一大特色是自定义模式。模式允许你针对不同类型的工作配置 AI 的行为：

内置模式

模式	描述	工具权限
Code	默认编码模式	完整的文件、终端、浏览器访问权限
Architect	架构设计模式	只读文件访问，无终端权限
Ask	问答模式	只读，仅提供信息性回复
Debug	调试模式	具有诊断焦点的完整访问权限

创建自定义模式

在项目根目录创建一个 .kilo/modes.json 文件：

{
  "modes": [
    {
      "slug": "reviewer",
      "name": "Code Reviewer",
      "roleDefinition": "你是一名资深代码审查员。负责分析代码中的 Bug、安全问题和最佳实践。严禁直接修改文件。",
      "groups": ["read"],
      "customInstructions": "重点关注：错误处理、输入验证、SQL 注入、XSS 和竞态条件。请具体说明行号。"
    },
    {
      "slug": "docs",
      "name": "Documentation Writer",
      "roleDefinition": "你是一名技术文档撰写者。负责生成清晰、简洁的文档。",
      "groups": ["read", "edit"],
      "customInstructions": "为函数编写 JSDoc 注释，编写 README 章节，并为复杂逻辑添加行内注释。"
    }
  ]
}

通过 Kilo Code 面板中的下拉菜单，或者通过输入 /mode reviewer 来切换模式。

Token 使用优化

Kilo Code 包含多项功能来减少 Token 消耗：

上下文管理

# Kilo Code 会自动：
- 仅向 AI 发送相关文件（而非整个项目）
- 将大文件截断为相关部分
- 在对话中缓存文件读取内容
- 使用基于 diff 的编辑模式以最小化输出 Token

手动上下文控制

你可以显式控制发送的内容：

@file:src/auth/middleware.ts @file:src/models/user.ts
修复认证中间件中的 JWT 验证 - 它应该正确检查 Token 过期。

@file: 前缀告诉 Kilo Code 在上下文中包含特定文件。

成本追踪

Kilo Code 在面板中实时显示 Token 使用情况和预估成本：

任务: Add user authentication
Tokens 使用量: 12,450 input / 3,200 output
预估成本: $0.08 (Claude Sonnet 4)

配置文件参考

VS Code settings.json 中的全局设置：

{
  "kilocode.provider": "anthropic",
  "kilocode.model": "claude-sonnet-4-20250514",
  "kilocode.apiKey": "sk-ant-xxxxx",
  "kilocode.maxTokens": 8192,
  "kilocode.temperature": 0,
  "kilocode.autoApprove": {
    "readFiles": true,
    "listFiles": true,
    "writeFiles": false,
    "executeCommands": false
  },
  "kilocode.customInstructions": "始终使用 TypeScript。在 React 中优先使用函数式组件。使用 Tailwind CSS 进行样式设计。"
}

项目级指令

在项目根目录创建 .kilo/instructions.md 文件，用于存放特定于项目的指令：

# 项目指令

- 这是一个使用 App Router 的 Next.js 15 应用
- 使用 Prisma 进行数据库访问
- 所有 API 路由必须使用 Zod 验证输入
- 使用 Vitest 进行测试
- 使用 pnpm，不要使用 npm 或 yarn

常见问题排查

问题	原因	解决方案
"API key invalid"	Key 错误或已过期	从供应商控制面板重新生成 Key
扩展无法加载	VS Code 版本过旧	更新 VS Code 至最新版本
响应缓慢	上下文过大或模型较慢	使用更快的模型；使用 `@file:` 减少上下文
文件编辑未生效	权限问题	检查 VS Code 中的工作区信任设置
终端命令失败	未检测到 Shell	在设置中配置 `kilocode.shell`
Token 使用量高	发送了过多上下文	使用 `@file:` 限制上下文；关闭不相关的文件

总结

Kilo Code 为 VS Code 带来了自主 AI 编程智能体能力，无需订阅费用或切换到独立的编辑器。它对多 AI 供应商的支持、自定义模式以及 Token 优化使其成为闭源工具的强有力开源替代方案。其核心优势在于灵活性：你可以自由选择 AI 供应商、控制成本，并根据自己的工作流定制智能体的行为。

对于使用 Kilo Code 构建涉及 AI 生成媒体（如视频制作、数字人生成或图像处理）的开发人员，Hypereal AI 提供了一个简单且经济实惠的 API，支持在无需管理 GPU 基础设施的情况下将这些能力集成到你的项目中。