【新手教程】Kilo Code 安装与上手：开源 AI 编程智能体，5 分钟完成配置

显示全部楼层

前言\n\n最近 GitHub Trending 上有一款开源 AI 编程智能体工具 Kilo Code 热度飙升，单日新增 500+ Star，累计已达 2.3 万星。它被称为 all-in-one agentic engineering platform，整合了当前最流行的开源编程智能体能力，支持 VS Code 插件直接安装。\n\n对于想尝试 AI 辅助编程但不知道从哪入手的新手，这篇教程带你从零完成安装配置，5 分钟内让 AI 帮你写代码。\n\n---\n\n一、Kilo Code 是什么？\n\nKilo Code 是一个开源的 AI 编程智能体平台，核心特点：\n

基于 VS Code 插件，安装零门槛\n
支持多种 AI 模型（Claude、GPT、Gemini 等）\n
内置代码生成、重构、调试、文档生成等功能\n
完全开源，可自托管 API Key\n
社区活跃，更新频繁\n

\n\n相比 GitHub Copilot，Kilo Code 更强调 Agentic（智能体）能力——不只是补全代码，而是能理解需求、规划任务、执行多步骤操作。\n\n---\n\n二、前置条件\n\n开始安装前，请确认你的环境满足以下要求：\n

操作系统：Windows 10+ / macOS 11+ / Linux（Ubuntu 20.04+ 推荐）\n
VS Code：版本 1.85 或更高（建议最新版）\n
Node.js：18.x 或更高（部分功能需要）\n
Git：已安装并配置好用户名/邮箱\n
AI API Key：至少准备一个（OpenAI / Anthropic / Google 等）\n

\n\n检查命令：\n

\ncode --version # VS Code 版本\nnode --version # Node.js 版本\ngit --version # Git 版本\n

复制代码

\n\n---\n\n三、安装步骤\n\n步骤 1：安装 VS Code 插件\n\n打开 VS Code，按 Ctrl+Shift+X（Mac 为 Cmd+Shift+X）打开扩展市场，搜索 Kilo Code，点击安装。\n\n或者直接在浏览器访问 VS Code 市场页面。\n\n步骤 2：配置 API Key\n\n安装完成后，按 Ctrl+Shift+P 打开命令面板，输入并选择：\n

\nKilo Code: Open Settings\n

复制代码

\n\n在设置页面中，找到 API Provider 选项，选择你要使用的 AI 服务商：\n

OpenAI：需填写 sk-... 格式的 API Key\n
Anthropic：需填写 Claude 系列的 API Key\n
Google：需填写 Gemini 的 API Key\n
OpenRouter：支持多模型聚合，适合想试不同模型的用户\n

\n\n提示：如果没有 API Key，可以先选择 OpenRouter 注册，新用户有免费额度。\n\n步骤 3：选择模型\n\n配置好 API Key 后，在设置中选择具体模型：\n

编程任务推荐：Claude 3.5 Sonnet、GPT-4o、Gemini 1.5 Pro\n
快速轻量任务：Claude 3 Haiku、GPT-4o-mini\n

\n\n步骤 4：验证安装\n\n新建一个文件，按 Ctrl+Shift+P，输入：\n

\nKilo Code: New Task\n

复制代码

\n\n输入简单指令测试，例如：\n

\n写一个 Python 函数，计算斐波那契数列的前 n 项\n

复制代码

\n\n如果看到 AI 生成代码并出现在编辑器中，说明安装成功！\n\n---\n\n四、核心功能速览\n\n安装完成后，你可以尝试这些功能：\n

代码生成：自然语言描述需求，自动生成代码\n
代码重构：选中代码，要求优化或转换风格\n
Bug 修复：粘贴报错信息，自动分析并给出修复建议\n
单元测试：为现有函数自动生成测试用例\n
文档生成：自动为代码添加注释和文档字符串\n
多文件操作：支持跨文件理解和修改（Agent 模式）\n

\n\n常用快捷键：\n

Ctrl+Shift+P → Kilo Code: New Task：创建新任务\n
Ctrl+Shift+P → Kilo Code: Fix Code：修复当前文件问题\n
Ctrl+Shift+P → Kilo Code: Explain Code：解释选中代码\n

\n\n---\n\n五、常见问题与解决\n\nQ1：安装后插件不生效？\n

检查 VS Code 版本是否 >= 1.85\n
尝试重启 VS Code\n
在扩展面板中确认 Kilo Code 已启用\n

\n\nQ2：提示 API Key 无效？\n

确认 Key 没有多余空格\n
检查是否选择了正确的服务商（OpenAI Key 不能用于 Anthropic）\n
新注册的 Key 可能需要等待几分钟生效\n

\n\nQ3：生成代码速度慢？\n

切换为更快的模型（如 GPT-4o-mini）\n
检查网络连接，部分地区访问 API 可能需要代理\n
开启 Streaming 选项，实时显示生成过程\n

\n\nQ4：如何保护 API Key 安全？\n

不要在公共仓库中提交包含 Key 的配置文件\n
使用 VS Code 的 Secret Storage 功能存储 Key\n
定期轮换 API Key\n

\n\n---\n\n六、进阶建议\n\n上手之后，可以进一步探索：\n

自定义提示词：在设置中修改系统提示词，让 AI 更符合你的编码风格\n
Agent 模式：开启后可以执行多步骤任务，如帮我搭建一个 Flask 项目结构\n
集成终端：让 AI 直接执行 shell 命令，实现真正的自动化\n
团队配置：导出设置文件，团队成员一键导入统一配置\n

\n\n---\n\n结语\n\nKilo Code 作为近期最热门的开源 AI 编程工具之一，降低了新手使用 AI 辅助编程的门槛。不需要复杂的配置，一个 VS Code 插件就能让 AI 成为你的编程搭档。\n\n如果你在使用过程中遇到问题，欢迎在楼下留言交流。也欢迎分享你的使用心得和技巧！\n\n相关链接：\n