Przejdź do głównej treści
Factory Droid CLI (polecenie droid) to terminalowy agent inżynierii oprogramowania AI od Factory AI.
Protokół: zgodny z OpenAI
  • Bazowy URL: https://api.orcarouter.ai/v1 (zawiera sufiks /v1)

​
Instalacja

macOS/Linux: 
curl -fsSL https://app.factory.ai/cli | sh
Windows (PowerShell): 
irm https://app.factory.ai/cli/windows | iex
Zainstalowane polecenie to droid.

​
Konfiguracja

Plik konfiguracyjny: ~/.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
    }
  ]
}
Zamień orcarouter/auto na konkretny model, jeśli wolisz, np. anthropic/claude-opus-4.8 lub google/gemini-2.5-flash. Identyfikatory modeli zawsze używają formatu vendor/model.

​
Uruchomienie

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
Oczekiwany wynik: OK.

​
Uwagi

  • Niestandardowe modele trafiają do tablicy custom_models.
  • Użyj provider: "generic-chat-completion-api" dla protokołu zgodnego z OpenAI.
  • base_url musi zawierać /v1.
  • --auto <low|medium|high> steruje autonomią (jak wiele agent może zrobić bez nadzoru) — to nie jest sterowanie rozumowaniem. Zobacz poniżej dot. myślenia.
Rozszerzenie VS Code: Oficjalne rozszerzenie VS Code od Factory współdzieli ten sam ~/.factory/config.json co CLI — powyższy wpis custom_models dotyczy obu, bez osobnego ustawienia punktu końcowego w edytorze. Dwa zastrzeżenia: Factory w pełni testuje i przeprowadza testy porównawcze tylko względem oficjalnych API Anthropic/OpenAI, a znany problem może kierować podrzędne agenty z powrotem do Anthropic zamiast do Twojego niestandardowego modelu.

​
Włączanie myślenia / rozumowania

Steruj poziomem wysiłku rozumowania flagą -r / --reasoning-effort (oddzielną od --auto): 
droid exec -m "anthropic/claude-sonnet-4.6" -r high --auto low "What is 17*23?"
Poziomy: low / medium / high (domyślny zależy od modelu — modele Anthropic domyślnie wyłączone, GPT-5 domyślnie medium). Możesz też ustawić to trwale w settings.json przez reasoningEffort. Zweryfikowane: -r high przechodzi do OrcaRouter. (Uwaga: wpisy custom_models nie mają pola rozumowania — steruj nim przez -r lub settings.json.)