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

URL: https://agentvera.dev/ru/blog/how-to-use-droid/ · Опубликовано: 2026-11-14

Как пользоваться Factory Droid в терминале: установка, вход, выбор модели, droid exec с уровнями автономии, настройка AGENTS.md, MCP и собственных дроидов.

**Коротко:**

- Установите через curl -fsSL https://app.factory.ai/cli | sh (или brew install --cask droid), запустите droid в проекте, войдите через браузер и опишите задачу. Droid спрашивает перед правкой файлов и запуском команд.
- Для скриптов и CI droid exec по умолчанию только читает; --auto low разрешает правки, medium добавляет установки, сборки, тесты и коммиты, high — пуши и деплой. Без браузера используйте FACTORY_API_KEY.
- Тариф Free работает с вашим собственным инференсом (ChatGPT, Copilot, OpenRouter или API-ключи); Pro стоит $20 в месяц на ноябрь 2026 года. Правила — в AGENTS.md, настройки и MCP-серверы — в ~/.factory/.

Чтобы пользоваться 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](https://factory.com "Factory"). Он читает ваш код, предлагает изменения и применяет их после вашего одобрения. Тот же агент работает в десктопном и веб-приложениях Factory, в интеграциях с IDE и через SDK. Версия 1.0 вышла 29 октября 2026 года, а новые версии выходят несколько раз в неделю.

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

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

На macOS или Linux:

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

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

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

В Windows PowerShell:

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

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

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

```bash
cd my-project
droid
```

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

```bash
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`:

```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:

```bash
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
```

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

| Уровень | Что разрешает |
|---|---|
| (по умолчанию) | Только чтение |
| `--auto low` | Правки файлов |
| `--auto medium` | Плюс установки, сборки, тесты, commit, checkout и pull |
| `--auto high` | Плюс пуши и деплой |

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

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

Droid читает `AGENTS.md` как инструкции для репозитория. Делайте его коротким: стек, как запускать тесты, что не трогать и что значит «готово». В нашем руководстве по [CLAUDE.md и AGENTS.md](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md") разобрано, что туда писать.

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

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

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

```bash
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 года)

| Тариф | Цена | Примечания |
|---|---|---|
| Free | $0 | Инференс ваш: ChatGPT, Copilot, OpenRouter или собственные ключи |
| Pro | $20/мес. | Все модели, десктопное приложение, CLI и SDK |
| Plus | $100/мес. | Примерно 5x лимита Pro |
| Max | $200/мес. | Примерно 10x лимита Pro |
| Teams | $60/мес. + $40/место | До 10 мест |

Перед решением загляните на [страницу тарифов Factory](https://factory.com/pricing "Тарифы Factory"): тарифы часто меняются.

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

- **Старые ссылки на документацию.** Документация переехала с docs.factory.ai на [docs.factory.com](https://docs.factory.com "Документация Factory"); 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](/ru/ "AgentVera") — десктопное приложение, которое запускает эти CLI бок о бок в настоящих терминалах, с вашими собственными установками и входами. [Поддержка Droid](/ru/agents/factory-droid/ "Factory Droid в AgentVera") устроена так:

- **Одна сессия на агента.** AgentVera находит сессию, которую создаёт Droid, и при следующих запусках открывает её через `droid --resume <id>`, так что разговор переживает перезапуск приложения.
- **Модель, уровень усилий и роль.** Выбранные для агента модель и уровень усилий передаются через файл настроек, а роль агента — через `--append-system-prompt`.
- **Ваш вход или ваши API-ключи.** Droid сохраняет ваш вход в Factory. В Settings → Accounts можно добавить аккаунты с `FACTORY_API_KEY` и дать каждому агенту свой.
- **Панели, worktrees и ревью.** Запускайте Droid в сетке [workspace](/ru/features/workspace/ "Workspace") рядом с другими агентами, каждого в своём git worktree, и проверяйте их изменения через [код-ревью](/ru/features/code-review/ "Код-ревью").

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

## Итоги

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

Источники: [быстрый старт Droid](https://docs.factory.com/cli/getting-started/quickstart "Быстрый старт Droid"), [справочник CLI](https://docs.factory.com/docs/droid-cli/cli-reference "Справочник Droid CLI"), [droid exec](https://docs.factory.com/docs/droid-exec/overview "droid exec"), [модели](https://docs.factory.com/docs/models "Модели Droid"), [MCP](https://docs.factory.com/docs/harness/mcp "MCP в Droid"), [список изменений](https://docs.factory.com/changelog/cli-updates "Список изменений Droid CLI").

## Частые вопросы

**Factory Droid бесплатный?** Есть тариф Free за $0, где инференс ваш: войдите через ChatGPT, GitHub Copilot или OpenRouter либо добавьте собственные API-ключи. Платные тарифы на ноябрь 2026 года: Pro за $20, Plus за $100 и Max за $200 в месяц, и на каждой ступени лимит использования выше.

**Можно ли использовать с Droid свой API-ключ?** Да. Добавьте запись customModels в ~/.factory/settings.json с именем модели, базовым URL, провайдером и ключом (ключ можно брать из переменной окружения). Ключи остаются на вашем компьютере, а собственные модели работают и в CLI, и в десктопном приложении.

**Чем droid отличается от droid exec?** droid открывает интерактивную сессию, которая спрашивает перед каждой правкой или командой. droid exec выполняет одну задачу без чата — для скриптов и CI. Он только читает, пока вы не повысите автономию через --auto low, medium или high.

**Читает ли Droid AGENTS.md?** Да. AGENTS.md — это файл инструкций, который Droid читает для репозитория: укажите в нём стек, команду для тестов, правила и то, что трогать нельзя.

**Как продолжить сессию Droid?** Запустите droid --resume, чтобы выбрать одну из недавних сессий, или droid --resume <id> для конкретной. droid search "текст" находит старые сессии, а --fork <id> копирует сессию, чтобы попробовать другое направление.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/