使用 Claude 运行 Factory Droid

Factory 的 Droid 是一款与 Claude Code 同类的智能体 CLI，支持通过配置文件使用自备模型。将其指向 AI Prime Tech 网关后，Droid 的智能体循环就可以使用 Claude，同时也能使用网关提供的其他模型。

编辑设置文件

Droid 会读取 ~/.factory/settings.json。添加一个 customModels 数组，其中每个条目描述一个你希望使用的模型。这是当前的配置路径；较旧的 config.json 属于旧版配置，不支持 settings.json 的全部功能。

一个文件即可涵盖整个 Droid 配置，因此只需一个 customModels 列表，就能定义 CLI 可切换使用的所有模型。请将其保留在用户级别，而非按项目配置。

知道 settings.json 是当前使用的文件，可以避免不少困惑，因为旧笔记和讨论帖仍会提到 config.json，而且某些功能在这两个文件中的行为有所不同。当某项配置在一个文件中有效、在另一个文件中无效时，几乎总应以 settings.json 为准。当建议相互冲突时，优先采用 settings.json 而非 config.json，可以解决大多数问题。Factory 目前积极支持的是这个较新的文件，变量语法也只有在其中才真正有效。

描述模型

每个 customModels 条目包含模型 ID、baseUrl、apiKey、provider 和 maxOutputTokens。将 model 设置为 claude-sonnet-4-5 这样的网关模型 ID，并将 baseUrl 设置为网关主机地址。

这些字段共同明确告诉 Droid 如何访问模型。由于 Droid 不预设单一提供商，你需要逐项指定这些信息，这也使它足够灵活，能够连接网关。

正是这种明确的配置方式，让一个 Droid 安装实例可以接入同一网关上的多个 Claude 模型：每个模型都有独立的 customModels 条目，并共用 baseUrl 和密钥。尽管它们最终都连接到同一个上游端点，CLI 仍会将它们视为不同的可选模型。这些显式字段使一个安装实例能够通过同一个端点接入多个 Claude 模型。每个条目共用 baseUrl 和密钥，同时保留各自的模型 ID，因此由网关负责路由，Droid 只需选择模型名称。

选择提供商模式

provider 字段决定通信格式。对于网关的原生 Messages 接口，使用 anthropic；对于 Responses 风格的接口，使用 openai；对于 OpenAI 风格的 /v1 聊天端点，使用 generic-chat-completion-api。在网关上使用 Claude 时，anthropic 是自然的选择。

让 provider 与网关实际提供的接口匹配，可以避免首次运行时出错。将 provider 设置为 anthropic 后，Droid 会使用网关为 Claude 提供的原生格式进行通信。

这三种提供商模式也能清晰对应多模型网关可提供的接口，因此，如果同一网关还提供 OpenAI 风格的模型，你可以添加一个单独的条目，并将其 provider 设置为 generic-chat-completion-api。让每个条目的 provider 与其接口保持一致，是确保混合配置不出错的规则。为每个条目匹配 provider 和接口，是保持混合网关配置清晰的规则。原生 Claude 条目与 OpenAI 风格的条目可以正常共存。

配置 API 密钥

将密钥填入 apiKey，最好使用 ${VAR} 引用，例如 ${AIPRIME_API_KEY}，这样密钥就保留在环境中，而非写入文件。请注意，${VAR} 展开在 settings.json 中有效，但在旧版 config.json 中无效。

apiKey 字段也不能留空，即使网关在技术上允许匿名请求也不例外。Droid 会验证该字段是否有值，因此请始终提供密钥或存储密钥的变量。

这两点共同解释了一个常见问题：用户将 ${VAR} 放入旧版 config.json，但该文件不会展开变量，因此 Droid 读取到的是未解析的字面字符串。请在 settings.json 中使用变量形式，并确保在启动 Droid 的 shell 中确实导出了该变量。确认变量已在启动 Droid 的 shell 中导出，是用户经常遗漏的最后一步。Droid 只能读取启动它的环境中存在的变量。

切换并运行

在 Droid CLI 中，使用 /model 命令切换已配置的模型。为 claude-opus-4-8 添加另一个条目后，就可以在处理更复杂的任务时切换到该模型，无需再次修改配置。

此后，Droid 就会使用网关上的 Claude 运行智能体循环。由于配置保存在 settings.json 中，每次启动 CLI 时都会应用同一配置。

提前配置好 Sonnet 和 Opus 条目，就能随时根据任务选择模型：常规实现工作使用 Sonnet，需要更深入推理的问题使用 Opus。所有模型都通过网关使用，无需重新配置。通过 /model 切换，只需在会话中输入一行命令即可更换模型。在会话中使用一行 /model 命令切换，让按任务选择模型变得轻松。你无需离开会话，就能从 Sonnet 切换到 Opus。

// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model

常见问题

AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。