メインコンテンツへスキップ
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.8google/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>自律性 (エージェントが無人でどこまで実行できるか) を制御します — reasoning の制御では ありません。thinking については下記を参照。
VS Code 拡張機能: Factory の公式 VS Code 拡張機能は CLI と同じ ~/.factory/config.json を共有します — 上記の custom_models エントリは 両方に適用され、エディター内専用のエンドポイント設定はありません。2 つの 注意点があります: Factory は公式の Anthropic/OpenAI API に対してのみ完全に テストおよびベンチマークを行っていること、そしてサブエージェントをカスタム モデルではなく Anthropic にルーティングし直す既知の問題があることです。

thinking / reasoning を有効化する

reasoning エフォートは -r / --reasoning-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.jsonreasoningEffort で永続的に設定することもできます。検証済み: -r high は OrcaRouter にパススルーされます。(注: custom_models のエントリには reasoning フィールドがありません — -r または settings.json で制御してください。)