Source: https://aiprimetech.io/zh/learn/use-claude-api-with-factory-droid/

[首页](/zh/) / [学习](/zh/learn/) / 使用 Claude 运行 Factory Droid 

# 使用 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
```

## 常见问题 

 如何使用 Claude 运行 Factory Droid？

在 ~/.factory/settings.json 中添加一个 customModels 条目，将 provider 设置为 anthropic，baseUrl 设置为 https://aiprimetech.io,，并填入模型 ID 和 apiKey。使用 /model 切换模型。 Claude 应使用哪个 provider 值？

原生 Messages 接口使用 anthropic。openai 或 generic-chat-completion-api 则用于 OpenAI 风格的端点。 apiKey 可以为空吗？

不可以，Droid 要求该字段有值。请使用 ${VAR} 引用，例如 ${AIPRIME_API_KEY}；变量展开在 settings.json 中有效，在旧版 config.json 中无效。 如何切换模型？

在 Droid CLI 中使用 /model 命令，即可在 customModels 列表中的各个条目之间切换。  

几分钟内开始使用 Claude

获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) 

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

## 更多 Claude API 指南

[如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[使用 Claude 运行 Codex CLI](/zh/learn/use-claude-api-with-codex/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)