跳转到主要内容
Factory Droid CLI （命令 droid）是 Factory AI 的终端 AI 软件工程 agent。
协议：OpenAI 兼容
  • Base URL： https://api.orcarouter.ai/v1（带 /v1 后缀）

​
安装

macOS/Linux： 
curl -fsSL https://app.factory.ai/cli | sh
Windows（PowerShell）： 
irm https://app.factory.ai/cli/windows | iex
安装后的命令是 droid。

​
配置

配置文件：~/.factory/config.json。 
{
  "custom_models": [
    {
      "model_display_name": "OrcaRouter Auto",
      "model": "orcarouter/auto",
      "base_url": "https://api.orcarouter.ai/v1",
      "api_key": "sk-orca-...",
      "provider": "generic-chat-completion-api",
      "max_tokens": 8192
    }
  ]
}
如果你愿意，可以把 orcarouter/auto 换成具体模型，例如 anthropic/claude-opus-4.8 或 google/gemini-2.5-flash。模型 ID 始终使用 vendor/model 格式。

​
运行

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
预期输出：OK。

​
注意事项

  • 自定义模型放在 custom_models 数组中。
  • 对 OpenAI 兼容协议使用 provider: "generic-chat-completion-api"。
  • base_url 必须包含 /v1。
  • --auto <low|medium|high> 控制自主程度（agent 可在无人值守下做多少事）——它不是推理控制。思考请见下文。
VS Code 扩展： Factory 的官方 VS Code 扩展与 CLI 共用同一个 ~/.factory/config.json——上面的 custom_models 条目对两者都适用， 没有单独的编辑器内端点设置。有两点需要注意：Factory 只对官方 Anthropic/OpenAI API 做完整测试和基准评测；另外有一个已知问题， 可能会把子 agent 重新路由回 Anthropic 而非你的自定义模型。

​
启用思考 / 推理

用 -r / --reasoning-effort 标志控制推理 effort（与 --auto 分开）： 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
级别：low / medium / high（默认值因模型而异——Anthropic 模型默认关闭，GPT-5 默认 medium）。你也可以在 settings.json 中通过 reasoningEffort 持久化设置。已验证：-r high 会透传到 OrcaRouter。（注意：custom_models 条目没有推理字段——请通过 -r 或 settings.json 控制。）