Roo Code 是一款 AI 编程工具，可以帮助你在一个地方管理编程任务并连接外部服务。学会如何将 API 连接到 Roo Code，能帮你链接像 Kimi API 这样的工具，让工作流程更顺畅。这是一种为 Roo Code 增添更多 AI 功能、使其在各种开发任务中更实用的简单方法。接下来一步步看看具体怎么操作。
Roo Code 是什么？
Roo Code 是一款为 VS Code 打造的开源 AI 编程 agent，可以帮助开发者更高效地编写、编辑和管理代码。它在你的 IDE 内运行，因此你无需离开常用的开发环境就能获得 AI 支持。Roo Code 可以帮助完成生成代码、调试、重构、更新文档以及回答项目相关问题等任务。
Roo Code 能为你做什么？
在连接 API 之前，先了解一下 Roo Code 本身的用途会很有帮助。它不只是 VS Code 里的一个基础编程助手，还能处理各种开发任务、支持日常编程工作，并在开发过程中节省时间。下面来具体看看 Roo Code 能为你做些什么：
根据描述生成代码
Roo Code 可以将简单的语言提示词转换为实际代码，这在你想更快构建功能时会很有帮助。你只需用简单的话描述需求，它就会根据这个请求生成代码。这对创建函数、小工具或启动新的项目部分都很有用。
重构和调试代码
它可以审查现有代码、清理并改进结构，同时不改变代码的主要用途。Roo Code 还能帮忙发现 bug、修复错误，并针对存在问题的部分提出更好的写法建议。这让提升代码质量、更快解决问题变得更容易。
编写和更新文档
Roo Code 可以帮你为项目创建文档，包括设置指南、说明文字和代码注释。当代码发生变化时，它也能更新旧文档，让文档始终保持实用和清晰。这可以节省时间，让项目信息井井有条。
回答代码库相关问题
如果你正在处理一个大型项目，Roo Code 可以帮你解释文件、函数，以及代码库中不同部分之间的联系。你不必手动逐一检查，而是可以直接提问，更快得到答案。这能让理解不熟悉的代码变得更容易。
执行终端命令
Roo Code 还可以作为工作流程的一部分运行终端命令，这有助于完成安装软件包、运行脚本或处理项目设置等任务。这样可以把更多开发工作都集中在同一处。它能让重复性任务更容易管理。
如何将外部 LLM 与 Roo Code 连接？
Roo Code 可以通过其 API 设置连接外部 LLM，让你在 VS Code 中使用自己选择的模型。具体步骤会因提供方略有不同，但整体流程基本一致。下面以 Kimi 为例，让你从头到尾看看整个设置过程：
注意： 根据 Roo Code 官方文档，Roo Code 扩展已于 2026 年 5 月 15 日停止服务。如果你已经安装了它，或者正在使用某个分支版本，设置方式基本仍是这样。
第一步：获取你的 Kimi API 密钥
前往 Kimi 开放平台，登录你的账户并创建一个新的 API 密钥。密钥生成后，将其复制并妥善保存，因为在设置过程中你需要将它粘贴到 Roo Code 中。这个密钥是 Roo Code 与你的 Kimi 账户之间的连接凭证，能让它向模型发送请求。
第二步：打开 Roo Code 设置
打开 VS Code，从侧边栏点击 Roo Code 面板。然后点击齿轮图标，打开设置部分。Roo Code 在这里保存用于外部 LLM 连接的提供方、API 密钥、基础 URL 和模型设置。
第三步：选择 API 提供方
在 Roo Code 设置中找到 API Provider 字段。如果看到 Moonshot 选项，选择它，因为这是直接连接 Kimi API 最简单的方式。这会告诉 Roo Code 在发送提示词和接收响应时应使用哪个服务。
第 4 步：粘贴你的 Kimi API key
选择提供商后，将你的 Kimi API key 粘贴到 Moonshot API key 字段中。如果 Roo Code 要求填写 base URL，也需要检查一下。对于全球版 Kimi API，正确的 base URL 是：https://api.moonshot.ai/v1
这一步会将你的 Roo Code 配置与 Kimi API 端点关联起来，让插件能够与模型通信。
第 5 步：选择 Kimi 模型
接下来，在模型字段中选择一个 Kimi 模型，如有需要也可以手动输入。对于开发工作，kimi-k2.7-code 是一个不错的选择，因为它专门针对编程任务。选定后，Roo Code 会使用该模型来处理提示词、代码辅助以及与项目相关的请求。
第 6 步：如果没有 Moonshot 选项，使用 OpenAI Compatible
有些版本或分支的 Roo Code 可能不会显示 Moonshot 作为提供商选项。这种情况下，可以选择 OpenAI Compatible，然后手动填入 Kimi API 的相关信息。使用以下值：
API 提供商：OpenAI Compatible
Base URL：https://api.moonshot.ai/v1
API Key：你的 Kimi API key
Model ID：kimi-k2.7-code
第 7 步：保存并测试
保存设置后，向 Roo Code 发送一个简单的请求，例如：
如果 Roo Code 能正常回复，说明你的 Kimi API 连接已生效。
使用 Kimi API 的好处
Kimi API 通过处理日常编码任务并提供实用的编码辅助，帮助提升软件开发效率。看看下面这些好处，了解它能如何改善你的工作流程：
减少重复性手动工作
自动完成编写样板代码、解释函数、排查错误等常见任务，从而加快开发速度。这有助于减少编码过程中那些琐碎但耗时的工作，让你有更多时间投入到功能构建和问题解决上。
提升代码质量与一致性
分析现有实现、发现潜在的改进点，并在整个开发过程中支持更好的编码规范。这可以帮助你让代码在不同文件和项目部分之间保持更整洁、更易读、更一致。
提升工作流程的灵活性
在代码生成、项目探索、重构、文档编写等多种开发活动中使用 Kimi，而无需改变你原有的工作流程。它让你用一套配置就能支持不同的编码任务，使日常开发更顺畅、更易管理。
排查 Roo Code API 集成问题
即便配置已经完成，一些小的设置错误仍可能导致连接无法正常工作。当你的 Roo Code API 配置没有按预期响应时，问题通常出在 API key、base URL、模型名称或工具设置上。检查以下常见问题，可以帮助你更快修复连接，让 Roo Code 恢复正常工作：
API key 无效：重新生成并重新粘贴
错误或过期的 API key 是导致连接失败的最常见原因之一。如果 Roo Code 无法验证你的请求，请返回提供商控制台，生成一个新的 key，并将其重新粘贴到正确的 API key 字段中。同时也要检查 key 前后是否有多余的空格。
base URL 错误：复制准确的端点
base URL 必须与提供商正确的 API 端点相匹配，否则 Roo Code 不知道该将请求发送到哪里。即便 URL 中有一个小错误，也会导致连接中断。请从提供商的官方文档中复制准确的端点，替换掉设置中已有的地址。
模型 ID 不受支持：使用准确的名称
如果模型 ID 输入错误，或所选模型在你的配置中不受支持，请求可能会失败或返回错误。请从提供商文档中查看模型名称，并在 Roo Code 设置中使用完全一致的拼写，包括连字符、版本名称以及特定于代码的模型标签都要匹配。
工具调用失败：启用原生工具调用
如果当前配置关闭或不支持工具调用，某些功能可能无法正常工作。这种情况下，请检查 Roo Code 或提供商的设置，若模型支持原生工具调用，请将其启用。这有助于解决操作、命令或结构化工具响应未按预期工作的问题。
速率限制错误：检查余额和模型
当你达到请求限制、使用了限制更严格的模型，或触发了账户使用限制时，可能会出现速率限制错误。请检查你的提供商账户，看看是余额、配额还是当前模型的限制导致了该问题。在某些情况下，切换到另一个受支持的模型也能解决问题。
总结
了解如何将 API key 连接到 Roo Code，可以让你更轻松地将外部 AI 能力引入编码工作流程，而不会增加额外的复杂性。一旦配置正确完成，Roo Code 在 VS Code 中处理各种开发任务时会变得更加灵活。关键在于从一开始就使用正确的提供商设置、模型信息和 API 配置。如果你想获得更顺畅的编码体验，Kimi 是值得尝试的选择。试着在 Roo Code 中使用它，看看它是否适合你的工作流程。