想在编码时使用自己的 AI 模型，又不想经历复杂的配置过程？Droid 通过在其 CLI 中支持外部 API，让这件事变得更简单，你可以连接一个符合自己工作方式的自定义模型。本指南将介绍如何配置 API、解决常见问题，以及如何在 Droid 中使用 Kimi。继续阅读，开始使用。
什么是 Droid？
Droid 是一款 AI 编码工具，可以帮助开发者更高效地编写代码、解决报错并处理开发任务。它支持内置 AI 模型，也允许用户通过 CLI 连接自定义模型，从而获得更高的灵活性。无论你需要快速获得帮助，还是需要更个性化的配置，它都能适用于不同的编码工作流程。
如何在 Droid 中使用内置 AI 模型？
使用内置 AI 模型可以让你无需先连接任何外部 API，就能轻松开始用 Droid 编码。安装好应用后，你可以在平台内选择一个模型，开始使用 AI 帮助进行代码分析、功能开发、错误修复和代码审查。以下是使用 Droid 的具体步骤：
第一步：安装并打开 Droid
首先在你的设备上下载 Factory App 并完成安装。安装完成后，打开应用并登录你的账号。这样你就可以在应用内使用 Droid 及其内置 AI 功能。
第二步：将 Droid 连接到你的项目文件夹
将工作目录设置为你要处理的代码库。这样可以将 Droid 与本地项目关联起来，使其能够读取文件、理解代码结构，并结合更完整的上下文支持你的开发任务。
第三步：选择一个内置模型并开始输入提示词
打开模型选择器，从 Droid 提供的内置 AI 模型中选择一个。选定模型后，你就可以开始输入提示词，例如让它分析代码库、修复错误、审查代码或开发新功能。
如何将 Droid 连接到外部 API？
将 Droid 连接到外部 API，可以让你更自由地使用自己偏好的模型，而不必局限于内置选项。配置过程在 Droid CLI 中完成，只需在设置文件中添加一个自定义模型；保存后，该模型就会出现在 /model 菜单中，可供选择。以下步骤以 Kimi 为例，展示从获取 API 密钥到选择模型的完整配置过程：
第一步：从月之暗面获取 Kimi API 密钥
首先从月之暗面创建或复制你的Kimi API 密钥。你需要这个密钥，因为 Droid 会用它连接 Kimi API，并通过你自己的账号发送请求。建议将该密钥保存为环境变量（例如 MOONSHOT_API_KEY），以便在设置文件中安全使用。
第二步：打开 Droid 设置文件
接下来，打开 Droid CLI 中用于添加自定义模型的设置文件。在 macOS 上，文件路径为 ~/.factory/settings.json；在 Windows PowerShell 中，路径为 %USERPROFILE%\.factory\settings.json。这是 Droid 读取自定义模型配置的主要文件。
第三步：将 Kimi 添加为自定义模型
在 settings.json 中，将 Kimi 添加到 customModels 数组下。这会告诉 Droid 需要使用哪个模型、调用哪个 API 端点、遵循哪种提供商格式，以及使用哪个 API 密钥进行身份验证。如果文件中已有其他配置，不要替换全部内容，只需在现有的 customModels 数组中添加这个模型对象即可。
第四步：保存文件并重启 Droid
添加好配置后，保存文件并重启 Droid CLI。这样可以确保 Droid 重新加载更新后的设置，并正确识别新添加的自定义模型。
第五步：在 Droid 中通过 /model 选择 Kimi 模型
打开 Droid CLI，运行 /model 命令。此时你配置的 Kimi 应该会出现在自定义模型（Custom models）部分。从列表中选择它，将 Kimi 设为当前编码会话使用的模型。
第 6 步：运行任务
选定 Kimi 后，就可以在 Droid 中用它处理实际工作了。可以尝试让它审查代码、修复 bug 或解释某个代码库。Droid 会通过 Kimi API 发送请求，并使用该模型完成任务。
使用 Kimi API 的好处
将 Kimi 接入 Droid 后，它不再只是 CLI 中的一个外部模型，而是能融入日常开发流程的实用编码助手，既能处理零散的编码工作，也能应对更大型的工程任务。以下是使用 Kimi API 的一些好处：
提升开发效率
Kimi 可以在你编码时生成代码、解释逻辑、提出修复建议，帮助你更快完成日常编码任务。这意味着处理简单的开发需求时，无需在多个工具之间来回切换。有了 Droid 中的 Kimi，日常编程工作会更容易管理。
编写更可靠的代码
Kimi 可以审查你的代码，指出潜在问题，并在小错误演变成大麻烦之前帮助改进代码结构。当你希望获得更清晰的逻辑和更好的可维护性时，这种早期反馈很有用。长期来看，它能帮助你写出更易于测试、更新和理解的代码。
处理多样化的开发任务
Kimi 不局限于从零编写代码，还能帮助重构代码、编写文档、理解陌生项目，并支持各类任务中的功能开发。对于希望用同一个 AI 模型协助工作流程中多个环节的开发者来说，这使它成为一个灵活的选择。
连接 API 常见错误排查
在 Droid 中连接外部 API 密钥通常很简单，但一些细小的配置失误仍可能导致问题。多数问题出在设置文件、提供方名称、API 密钥或模型服务器配置上，而不是 Droid 本身。好在只要清楚该查看哪里，这些错误通常很容易修复。
选择器中未显示模型
如果使用的是旧版格式，请检查
~/.factory/settings.json或config.json中的 JSON 语法是否正确设置变更会通过文件监听自动检测
确认自定义模型配置中已包含所有必填字段
“Invalid provider”（提供方无效）错误
确保 provider 的值精确为
anthropic、openai或generic-chat-completion-api之一检查 provider 字段中是否存在拼写错误或大小写不正确的问题
身份验证错误
确认你的 API 密钥有效且账户中仍有可用额度
检查该 API 密钥是否具备该提供方所需的正确权限
确认 base URL 与提供方文档中的 API 端点一致
本地模型无法连接
确保本地模型服务器正在运行，例如执行
ollama serve确认 base URL 正确，且在提供方要求的情况下包含
/v1/检查该模型是否已拉取或在本地可用
速率限制或配额错误
检查你所用提供方的 API 速率限制和使用配额
在提供方的控制台中监控使用情况，查看是否已达到限制
结语
在 Droid 中使用自定义 API，可以让你更好地掌控如何借助 AI 编写、测试和改进代码。完成配置后，围绕适合自己需求的模型来打造编码工作流程会变得更加容易。无论是继续使用内置选项，还是接入外部模型，Droid 都提供了一种灵活的方式，把 AI 融入开发工作中。如果你想找一个简单的起点来搭建自定义配置，不妨在 Droid 中试试 Kimi。它可以是让日常编码工作更顺畅、更高效的实用选择。