Factory Droid CLI — ИИ-агент для автоматизации рабочих процессов
О проекте
Command Line: Automation Across the SDLC. Script and parallelize Droids at massive scale for CI/CD, migrations, and maintenance. From automated code review to self-healing builds, integrate agents into every phase of development.
Droid CLI — инструмент командной строки от Factory AI, который работает как ИИ-агент для разработки программного обеспечения. Он позволяет взаимодействовать с разными большими языковыми моделями из терминала, собирать, отлаживать и рефакторить код и даже создавать готовые приложения.
- Официальная страница: https://factory.ai/product/cli
- Официальная документация: https://docs.factory.ai/cli/getting-started/quickstart
- Установка: см. инструкцию ниже на этой странице
Демонстрация

Возможности
| Категория | Возможности | Ценность | Пример / примечание |
|---|---|---|---|
| Быстрый старт и CLI | Установка за 30 секунд; интерактивный сеанс droid запускается в каталоге проекта; поддерживаются macOS/Linux и Windows | Быстрое подключение к текущему проекту без новых инструментов | Установка в Windows: irm https://app.factory.ai/cli/windows | iex; запуск: droid |
| Сквозная разработка функций | Автоматизация всего процесса от планирования до реализации и тестирования; прозрачный процесс проверки | Быстрее поставка при сохранении контроля человека | Встроенный просмотр diff и процесс одобрения (см. «Прозрачность и контроль») |
| Глубокое понимание кодовой базы | Объединяет общие знания организации из кодовой базы, документации и трекера задач; учитывает контекст и со временем работает лучше | Более точные предложения и изменения | Постоянно использует знания из разных репозиториев и документов |
| Интеграция с инженерными системами | Встроенная интеграция с Jira, Notion, Slack и другими инструментами; разработка синхронизирована с процессами команды | Меньше переключений между инструментами и информационных барьеров | «и другими» означает, что интеграций больше |
| Автоматизация для продакшена | Рабочие процессы переиспользуются локально и в CI/CD; встроенная безопасность и соответствие требованиям корпоративного уровня | Согласованность и проверяемость | Подходит для конвейеров и корпоративных сред |
| Корпоративные возможности | Варианты развёртывания в частной среде, соответствие SOC-2, изолированные (air-gapped) среды | Соответствие требованиям безопасности и нормативам | Приоритет безопасности и качества |
| Усиление существующих инструментов | Работает в терминале, IDE и привычной среде разработки; не нужно менять редактор или осваивать новый интерфейс | Сохраняются привычки, низкая стоимость перехода | Глубокая интеграция со знакомыми инструментами |
| Прозрачность и контроль | Каждое решение видно и доступно для проверки; полный контроль над изменениями кода; встроенный просмотр diff и процесс одобрения | Меньше рисков, больше контроля | Удобно для ревью, всё отслеживается |
| Гибкость в выборе моделей | Нет привязки к одному ИИ-провайдеру; для каждой задачи выбирается лучшая модель; единое поведение и память на уровне организации | Оптимальный баланс производительности и стоимости | Поддерживается маршрутизация между моделями |
| Следующие шаги и ресурсы | Quickstart, Common Use Cases, IDE Integration, Configuration, AGENTS.md | Помогают внедрить инструмент на практике | См. разделы страницы «Next steps/Additional resources» |
Настройка ИИ-модели
Пошаговая инструкция для Windows
1.Откройте терминал

2.Установите Factory Droid CLI
Официальная команда установки:
Команда установки
irm https://app.factory.ai/cli/windows | iex

3.Измените файл конфигурации
Droid CLI подключается к сторонним API через пользовательские модели (BYOK). Скрипт добавляет модели 88API в customModels файла ~/.factory/settings.json (это место настройки, которое сейчас указано в документации Factory): заменяются только модели, в названии которых есть [88API], остальные настройки и пользовательские модели сохраняются, а исходный файл копируется в settings.json.bak.<timestamp>. Модели 88API, которые старые версии скрипта записали в ~/.factory/config.json, тоже удаляются. Записываемые модели:
- Модели GPT (
gpt-6.1-sol,gpt-6-astra): provideropenai, Base URLhttps://api.88api.ai/v1 - Модели Claude (
claude-fable-5-1,claude-opus-5-5,claude-sonnet-5-5): provideranthropic, Base URLhttps://api.88api.ai(без /v1)

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.
Изменение файла конфигурации одной командой
iex (irm 'https://88api.ai/helper/factory-cli-setup.ps1')Следуйте подсказкам: на запросе Base URL просто нажмите Enter (по умолчанию https://api.88api.ai). Скрипт обрабатывает два типа моделей по-разному: для моделей GPT используется https://api.88api.ai/v1, для моделей Claude — https://api.88api.ai (без /v1). На запросе API Key вставьте ключ, созданный в консоли 88API (вводимые символы не отображаются в открытом виде). Чтобы позже сменить ключ API, просто запустите скрипт ещё раз.
4.Начните работу с Droid CLI
Теперь можно пользоваться Droid CLI!
# Перейдите в каталог проекта (необязательно)
cd C:\path\to\your\project
# Запуск Droid CLI
droidПереключитесь на модель 88API
После запуска droid введите /model и выберите модель с пометкой [88API] в разделе Custom models внизу списка (например, GPT-6.1 Sol [88API] или Claude Opus 5.5 [88API]). Без переключения Droid использует собственные модели Factory, и запросы не идут через 88API. Для моделей Claude группа вашего ключа 88API должна включать соответствующие модели Claude.
Для работы Droid CLI нужно войти в официальный аккаунт (бесплатно).
5.Решение частых проблем в Windows
При установке появляется ошибка permission denied
Обычно это проблема с правами. Попробуйте следующие решения:
-
Запустите
PowerShellот имени администратора и повторите команду установки -
Если вы устанавливаете через npm, настройте
npmна использование каталога пользователя:npm config set prefix "$env:APPDATA\npm"
Ошибка политики выполнения PowerShell
Если мешает ограничение политики выполнения, выполните: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Пошаговая инструкция для macOS/Linux
1.Установите Droid CLI
Установка Droid CLI
Откройте терминал и выполните команду: curl -fsSL https://app.factory.ai/cli | sh


Измените переменные окружения по подсказке установщика (просто скопируйте предложенный код):
В Linux выберите ~/.bashrc или ~/.zshrc в зависимости от оболочки
Переменные окружения Droid CLI (только пример)
echo 'export PATH=/Users/ваше-имя-пользователя/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc2.Измените файл конфигурации
Droid CLI подключается к сторонним API через пользовательские модели (BYOK). Скрипт добавляет модели 88API в customModels файла ~/.factory/settings.json (это место настройки, которое сейчас указано в документации Factory): заменяются только модели, в названии которых есть [88API], остальные настройки и пользовательские модели сохраняются, а исходный файл копируется в settings.json.bak.<timestamp>. Модели 88API, которые старые версии скрипта записали в ~/.factory/config.json, тоже удаляются. Записываемые модели:
- Модели GPT (
gpt-6.1-sol,gpt-6-astra): provideropenai, Base URLhttps://api.88api.ai/v1 - Модели Claude (
claude-fable-5-1,claude-opus-5-5,claude-sonnet-5-5): provideranthropic, Base URLhttps://api.88api.ai(без /v1)
Изменение файла конфигурации одной командой
curl -fsSL https://88api.ai/helper/factory-cli-setup.sh | bashСледуйте подсказкам: на запросе Base URL просто нажмите Enter (по умолчанию https://api.88api.ai). Скрипт обрабатывает два типа моделей по-разному: для моделей GPT используется https://api.88api.ai/v1, для моделей Claude — https://api.88api.ai (без /v1). На запросе API Key вставьте ключ, созданный в консоли 88API (вводимые символы не отображаются в открытом виде). Чтобы позже сменить ключ API, просто запустите скрипт ещё раз.

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.
3.Начните работу с Droid CLI
Теперь можно пользоваться Droid CLI!
# Перейдите в каталог проекта (необязательно)
cd /path/to/your/project
# Запуск Droid CLI
droidПереключитесь на модель 88API
После запуска droid введите /model и выберите модель с пометкой [88API] в разделе Custom models внизу списка (например, GPT-6.1 Sol [88API] или Claude Opus 5.5 [88API]). Без переключения Droid использует собственные модели Factory, и запросы не идут через 88API. Для моделей Claude группа вашего ключа 88API должна включать соответствующие модели Claude.
Для работы Droid CLI нужно войти в официальный аккаунт (бесплатно).
Ручная настройка (необязательно)
Без скрипта можно вручную добавить модели 88API в массив customModels файла ~/.factory/settings.json (в Windows: %USERPROFILE%\.factory\settings.json). Если файл уже существует, объедините только customModels, сохранив остальные настройки:
{
"customModels": [
{
"model": "gpt-6.1-sol",
"displayName": "GPT-6.1 Sol [88API]",
"baseUrl": "https://api.88api.ai/v1",
"apiKey": "sk-your-88api-key",
"provider": "openai",
"maxOutputTokens": 128000
},
{
"model": "claude-opus-5-5",
"displayName": "Claude Opus 5.5 [88API]",
"baseUrl": "https://api.88api.ai",
"apiKey": "sk-your-88api-key",
"provider": "anthropic",
"maxOutputTokens": 32000
}
]
}Обратите внимание: для provider openai в baseUrl обязателен /v1; для provider anthropic укажите https://api.88api.ai (без /v1). После сохранения перезапустите droid и выберите модель через /model.
~/.factory/config.json (поля в snake_case, например custom_models и base_url) — устаревший формат Factory: при запуске Droid копирует эти модели в settings.json, а последующие изменения config.json игнорируются. Используйте settings.json.