Как пользоваться Droid: пошаговое руководство по Factory Droid CLI

Чтобы пользоваться Droid, агентом для программирования от Factory, установите CLI командой curl -fsSL https://app.factory.ai/cli | sh, запустите droid в проекте, войдите через браузер и опишите задачу. Droid спрашивает, прежде чем изменить файл или выполнить команду; для скриптов и CI есть droid exec, который только читает, пока вы не повысите его автономию.

Это руководство описывает Droid CLI по состоянию на ноябрь 2026 года (версия 1.12): установку, вход, модели, интерактивную сессию, droid exec и его уровни автономии, AGENTS.md, MCP-серверы, собственных дроидов и стоимость.

Что такое Droid

Droid — терминальный агент для программирования от Factory. Он читает ваш код, предлагает изменения и применяет их после вашего одобрения. Тот же агент работает в десктопном и веб-приложениях Factory, в интеграциях с IDE и через SDK. Версия 1.0 вышла 29 октября 2026 года, а новые версии выходят несколько раз в неделю.

Droid не привязан к одному поставщику моделей. Он предлагает модели Anthropic, OpenAI, Google и xAI, а также open-weight-модели, которые Factory объединяет под названием «Droid Core», и вы можете добавить собственные эндпоинты.

Шаг 1: установите CLI

На macOS или Linux:

curl -fsSL https://app.factory.ai/cli | sh

Другие варианты:

brew install --cask droid      # Homebrew
npm install -g droid           # npm

В Windows PowerShell:

irm https://app.factory.ai/cli/windows | iex

На Linux для входа также нужен xdg-utils (sudo apt-get install xdg-utils). Обновляться потом можно командой droid update.

Шаг 2: войдите

cd my-project
droid

При первом запуске открывается браузер для входа в аккаунт Factory. Для CI и других машин без браузера создайте API-ключ в настройках Factory и экспортируйте его:

export FACTORY_API_KEY=fk-...

Шаг 3: работайте в сессии

Опишите задачу простыми словами. Droid объясняет, что собирается сделать, а затем спрашивает перед каждой правкой или командой. Полезные клавиши и команды:

• Shift+Tab переключает между обычным режимом и режимом spec, в котором Droid пишет план, прежде чем менять код.
• ! запускает команду оболочки вручную; ? показывает список сочетаний клавиш.
• /model меняет модель, /settings открывает настройки, /review запрашивает ревью изменений.
• /compress сокращает длинный разговор; /sessions показывает прошлые сессии.

Чтобы вернуться позже, запустите droid --resume (или droid --resume <id>). droid search "checkout bug" находит старую сессию по тексту, а --fork <id> копирует сессию.

Шаг 4: выберите модель

Модель меняется через /model в сессии, -m в командной строке или ключ model в настройках. На платных тарифах каждая модель расходует лимит с коэффициентом: на ноябрь 2026 года Claude Opus 5.5 считается как 1,6x, Claude Sonnet 5.5 — 0,8x, Claude Haiku 5.5 — 0,04x. Берите маленькую модель для рутинных правок и большую — для проектирования и отладки.

Чтобы использовать свой ключ, добавьте собственную модель в ~/.factory/settings.json:

{
  "customModels": [
    {
      "model": "claude-sonnet-5-5",
      "displayName": "Sonnet (my key)",
      "baseUrl": "https://api.anthropic.com",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "provider": "anthropic"
    }
  ]
}

provider — это anthropic, openai, generic-chat-completion-api или bedrock-converse. Ключи остаются на вашем компьютере.

Шаг 5: droid exec и уровни автономии

droid exec выполняет одну задачу без чата — именно это нужно в скриптах и CI:

droid exec "summarize the changes on this branch"
droid exec --auto low "fix the failing unit test in price.test.ts"
droid exec -f task.md -o json --auto medium

По умолчанию он только читает. Что ему можно, решаете вы:

--skip-permissions-unsafe отключает все подтверждения; оставьте его для одноразовых контейнеров. Учтите, что код выхода 0 означает, что Droid закончил работу, а не что задача выполнена успешно, поэтому проверяйте результат в CI. Для интерактивных сессий можно задать уровень по умолчанию через sessionDefaultSettings.autonomyLevel и более тонкие permissionRules (allow, ask, block) в настройках.

Шаг 6: AGENTS.md и настройки

Droid читает AGENTS.md как инструкции для репозитория. Делайте его коротким: стек, как запускать тесты, что не трогать и что значит «готово». В нашем руководстве по CLAUDE.md и AGENTS.md разобрано, что туда писать.

Настройки лежат в ~/.factory/settings.json для вас и в .factory/settings.json для проекта, у каждого есть settings.local.json для переопределений, которые вы не коммитите.

Шаг 7: MCP-серверы и собственные дроиды

Добавляйте MCP-серверы из командной строки:

droid mcp add docs https://example.com/mcp --type http
droid mcp add memory "npx -y @modelcontextprotocol/server-memory"

Они сохраняются в ~/.factory/mcp.json (или .factory/mcp.json для проекта) в разделе mcpServers. В сессии ими управляет /mcp, включая вход через OAuth.

Собственные дроиды — это субагенты: Markdown-файл с YAML-заголовком (name, description, model, tools и другие поля) в .factory/droids/ или ~/.factory/droids/. Droid передаёт им работу через свой инструмент Task, а /droids управляет ими. Небольшой дроид «автор тестов» или «ревьюер» на дешёвой модели — хороший первый вариант.

Сколько стоит Droid (на ноябрь 2026 года)

Перед решением загляните на страницу тарифов Factory: тарифы часто меняются.

Частые ошибки

• Старые ссылки на документацию. Документация переехала с docs.factory.ai на docs.factory.com; URL для установки по-прежнему используют app.factory.ai.
• Слишком ранний запуск exec с высокой автономией. Начинайте задания CI с --auto low и повышайте уровень только для шагов, которым это нужно.
• Доверие коду выхода 0. Он означает лишь, что запуск завершился. Проверяйте после этого тесты или diff.
• -r означает две разные вещи. В droid флаг -r продолжает сессию, в droid exec — задаёт уровень рассуждений. Пишите --resume полностью, чтобы избежать сюрпризов.

Droid рядом с другими CLI в AgentVera

Если Droid — ваш единственный агент, собственных приложений Factory может хватить. Сложнее становится, когда Droid работает рядом с Claude Code, Codex или Gemini CLI в одном проекте. AgentVera — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. Поддержка Droid устроена так:

• Одна сессия на агента. AgentVera находит сессию, которую создаёт Droid, и при следующих запусках открывает её через droid --resume <id>, так что разговор переживает перезапуск приложения.
• Модель, уровень усилий и роль. Выбранные для агента модель и уровень усилий передаются через файл настроек, а роль агента — через --append-system-prompt.
• Ваш вход или ваши API-ключи. Droid сохраняет ваш вход в Factory. В Settings → Accounts можно добавить аккаунты с FACTORY_API_KEY и дать каждому агенту свой.
• Панели, worktrees и ревью. Запускайте Droid в сетке workspace рядом с другими агентами, каждого в своём git worktree, и проверяйте их изменения через код-ревью.

Бесплатный тариф включает до 18 агентов, MCP, Git, Docker, SSH, код-ревью и экономию токенов. Pro стоит $9,99 в месяц; если у вас ещё не было пробного периода, первый вход в приложение включает Pro на 7 дней без карты. Чтобы попробовать, скачайте AgentVera.

Итоги

Чтобы начать работу с Droid, нужны две команды: скрипт установки и droid. Дальше главное — контроль: оставляйте интерактивные сессии на подтверждении, запускайте droid exec с --auto low, записывайте правила проекта в AGENTS.md и выбирайте модель под задачу с учётом коэффициента расхода.

Источники: быстрый старт Droid, справочник CLI, droid exec, модели, MCP, список изменений.