Перейти к основному содержанию
Factory Droid CLI (команда droid) — это терминальный AI-агент для разработки ПО от Factory AI.
Протокол: OpenAI-совместимый
  • Базовый 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. Идентификаторы моделей всегда используют формат vendor/model.

​
Запуск

droid exec -m "orcarouter/auto" --auto low "Reply with exactly: OK"
Ожидаемый вывод: OK.

​
Примечания

  • Пользовательские модели указываются в массиве custom_models.
  • Используйте provider: "generic-chat-completion-api" для OpenAI-совместимого протокола.
  • base_url должен включать /v1.
  • --auto <low|medium|high> управляет автономностью (насколько агент может действовать без присмотра) — это не управление reasoning. См. ниже про thinking.
Расширение для VS Code: официальное расширение Factory для VS Code использует тот же ~/.factory/config.json, что и CLI — приведённая выше запись custom_models применяется к обоим, без отдельной настройки эндпоинта внутри редактора. Два нюанса: Factory полностью тестирует и проводит бенчмарки только на официальных API Anthropic/OpenAI, и известная проблема может направлять субагентов обратно в 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.json через reasoningEffort. Проверено: -r high проходит сквозь до OrcaRouter. (Примечание: записи custom_models не имеют поля reasoning — управляйте им через -r или settings.json.)