跳轉到主要內容
Factory Droid CLI （指令 droid）是 Factory AI 的終端 AI 軟體工程代理。
協定：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> 控制的是自主程度（代理可在無人看管下做多少事）——它不是推理控制。思考請見下文。
VS Code 擴充套件： Factory 的官方 VS Code 擴充套件與 CLI 共用同一份 ~/.factory/config.json——上面的 custom_models 條目對兩者皆適用， 沒有獨立的編輯器內端點設定。有兩點須注意：Factory 僅針對官方 Anthropic/OpenAI API 進行完整測試與基準評測，且有一個已知問題可能會將 子代理（subagent）路由回 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 控制。）