想在编程时使用自己的 AI 模型，又不想经历繁琐的配置流程？Droid 通过在 CLI 中支持外部 API，让这件事变得更简单，你可以接入符合自身工作流程的自定义模型。本指南将介绍如何配置 API、解决常见问题，以及如何在 Droid 中使用 Kimi。继续阅读，开始上手吧。
什么是 Droid？
Droid 是一款 AI 编程工具，可以帮助开发者更高效地编写代码、解决错误并处理开发任务。它支持内置 AI 模型，同时也允许用户通过 CLI 接入自定义模型，从而获得更大的灵活性。无论你需要快速获得帮助，还是需要更个性化的配置，Droid 都能满足不同的编程工作流程。
如何在 Droid 中使用内置 AI 模型？
内置 AI 模型让你无需先接入任何外部 API，就能轻松开始在 Droid 中编程。安装应用后，你可以在平台内选择一个模型，开始使用 AI 辅助功能进行代码分析、功能开发、问题修复和代码审查。以下是使用 Droid 的入门步骤：
第 1 步：安装并打开 Droid
首先在你的设备上下载并安装 Factory App。安装完成后，打开应用并登录你的账号。这样你就可以使用 Droid 及其内置的 AI 功能了。
第 2 步：将 Droid 连接到你的项目文件夹
将工作目录设置为你要处理的代码库。这样可以将 Droid 与你的本地项目关联起来，使其能够读取文件、理解代码结构，并在更完整的上下文中支持你的开发任务。
第 3 步：选择内置模型并开始提问
打开模型选择器，从 Droid 提供的内置 AI 模型中选择一个。选定模型后，你就可以开始输入提示词，例如让它分析代码库、修复漏洞、审查代码，或开发新功能。
如何将 Droid 与外部 API 连接？
将 Droid 接入外部 API，可以让你更自由地使用自己偏好的模型，而不必局限于内置选项。整个配置过程都在 Droid CLI 内完成，只需在设置文件中添加自定义模型，保存后该模型就会出现在 /model 菜单中。下面以 Kimi 为例，演示从获取 API 密钥到选择模型的完整配置流程：
第 1 步：从月之暗面获取 Kimi API 密钥
首先在月之暗面创建或复制你的Kimi API 密钥。你需要用到这个密钥，因为 Droid 会通过它连接 Kimi API，并使用你自己的账号发送请求。建议将密钥保存为环境变量，例如 MOONSHOT_API_KEY，以便在设置文件中安全地引用它。
第 2 步：打开 Droid 设置文件
接下来，打开 Droid CLI 中用于添加自定义模型的设置文件。在 macOS 上，文件路径为 ~/.factory/settings.json；在 Windows PowerShell 中，使用 %USERPROFILE%\.factory\settings.json。这是 Droid 读取你的自定义模型配置的主要文件。
第 3 步：将 Kimi 添加为自定义模型
在 settings.json 中，将 Kimi 添加到 customModels 数组内。这会告诉 Droid 应使用哪个模型、调用哪个 API 接口、遵循哪种提供商格式，以及使用哪个 API 密钥进行身份验证。如果文件中已有其他配置，请不要覆盖全部内容，只需在现有的 customModels 数组中添加这个模型对象即可。
第 4 步：保存文件并重启 Droid
完成配置添加后，保存文件并重启 Droid CLI。这样可以确保 Droid 重新加载更新后的设置，并正确识别新添加的自定义模型。
第 5 步：在 Droid 中使用 /model 选择 Kimi 模型
打开 Droid CLI，运行 /model 命令。此时你的 Kimi 配置应该会出现在“自定义模型”部分。从列表中选择它，即可将 Kimi 设为编程会话的当前模型。
第 6 步：运行任务
选定 Kimi 后，你就可以在 Droid 中用它处理实际工作了。可以试着输入一个提示词，比如审查代码、修复 bug 或解释某段代码库。Droid 会通过 Kimi API 发送请求，并用该模型完成任务。
使用 Kimi API 的好处
将 Kimi 接入 Droid 后，它的作用远不止 CLI 里的一个外部模型。它会变成一个融入你日常开发流程的实用编程助手，无论是琐碎的编码工作还是较大的工程任务都能帮上忙。以下是使用 Kimi API 的一些好处：
提升开发效率
Kimi 可以在你工作时生成代码、解释逻辑并提出修复建议，帮你更快地完成日常编码任务。这意味着你无需在多个工具之间切换来获取简单的开发支持。有了 Kimi 加入 Droid，日常编程工作会更容易应付。
编写更可靠的代码
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 密钥是否具有该提供方所需的正确权限
确认基础 URL 与提供方文档中的 API 端点一致
本地模型无法连接
确保本地模型服务器正在运行，例如
ollama serve确认基础 URL 正确，如果提供方要求，还需包含
/v1/检查该模型是否已经拉取，或者在本地是否可用
速率限制或配额错误
检查你的提供方的 API 速率限制和使用配额
在提供方的控制台中监控使用情况，看是否已达到限制
结语
在 Droid 中使用自定义 API，可以让你在用 AI 构建、测试和改进代码方面拥有更多掌控权。一旦配置完成，围绕适合自己需求的模型来打造编码工作流就会变得更加容易。无论是继续使用内置选项，还是接入外部模型，Droid 都提供了一种灵活的方式，把 AI 带入开发工作中。如果你想找一个简单的起点来尝试自定义配置，Kimi 值得在 Droid 中一试。它可能是让日常编码工作更顺畅、更高效的实用之选。