想在无需复杂配置的情况下，使用自己的 AI 模型编程？Droid 的 CLI 支持外部 API，方便你连接适合自身工作流程的自定义模型。本指南将介绍如何设置 API、解决常见问题，以及如何在 Droid 中使用 Kimi。继续阅读，开始配置。
什么是 Droid？
Droid 是一款 AI 编程工具，可帮助开发者编写代码、解决错误，并更高效地处理开发任务。它支持内置 AI 模型，也允许用户通过 CLI 连接自定义模型，提供更高的灵活性。无论你需要快速协助，还是更个性化的配置，它都适用于不同的编程工作流程。
如何在 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 可以在你工作时生成代码、解释逻辑并提供修复建议，帮助你更快完成日常编码任务。这意味着，无需在多个工具之间切换来获取简单的开发支持。在 Droid 中使用 Kimi 后，日常编程工作会更易于高效处理。
编写更可靠的代码
Kimi 可以审查你的代码、指出潜在问题，并在小错误演变为大问题之前帮助改进代码结构。当你需要更清晰的逻辑和更好的可维护性时，这类早期反馈很有帮助。长期来看，它可以帮助你构建更易于测试、更新和理解的代码。
处理多样化的开发任务
Kimi 不仅能从零开始编写代码，还可协助重构、编写代码文档、理解不熟悉的项目，并支持不同任务中的功能开发。对于希望由一个 AI 模型协助处理工作流程多个环节的开发者而言，这是一个灵活的选择。
连接 API 时的常见错误排查
在 Droid 中连接外部 API 密钥通常很简单，但设置中的小错误仍可能导致问题。大多数问题源于设置文件、提供商名称、API 密钥或模型服务器配置，而非 Droid 本身。好在，只要知道排查方向，这些错误通常很容易修复。
模型未显示在选择器中
如果使用旧版格式，请检查
~/.factory/settings.json或config.json中的 JSON 语法系统会通过文件监控自动检测设置变更
确认自定义模型配置中包含所有必填字段
“无效的提供商”错误
确保提供商值严格为
anthropic、openai或generic-chat-completion-api检查 provider 字段中是否存在拼写错误，并确认大小写正确
身份验证错误
确认你的 API 密钥有效且有可用额度
检查 API 密钥是否拥有该提供商所需的正确权限
确认基础 URL 与提供商文档中的 API 端点一致
本地模型无法连接
确保本地模型服务器正在运行，例如
ollama serve确认基础 URL 正确；如果提供商要求，请包含
/v1/检查模型是否已拉取或可在本地使用
速率限制或配额错误
检查提供商的 API 速率限制和使用配额
通过提供商控制台监控用量，确认是否已达到限制
结语
在 Droid 中使用自定义 API，让你能够更好地掌控如何借助 AI 构建、测试和改进代码。完成设置后，你可以更轻松地围绕符合自身需求的模型安排编程流程。无论是使用内置选项，还是连接外部模型，Droid 都提供了将 AI 引入开发工作的灵活方式。如果想从自定义配置开始尝试，值得在 Droid 中试用 Kimi。它可以让日常编码工作更顺畅、更高效。