88API88API
Руководство пользователяAI-приложенияAPIПомощь и поддержка

Factory Droid CLI — ИИ-агент для автоматизации рабочих процессов


WindowsmacOSLinux

О проекте

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, который работает как ИИ-агент для разработки программного обеспечения. Он позволяет взаимодействовать с разными большими языковыми моделями из терминала, собирать, отлаживать и рефакторить код и даже создавать готовые приложения.

  1. Официальная страница: https://factory.ai/product/cli
  2. Официальная документация: https://docs.factory.ai/cli/getting-started/quickstart
  3. Установка: см. инструкцию ниже на этой странице

Демонстрация


droid.webp

Возможности

КатегорияВозможностиЦенностьПример / примечание
Быстрый старт и 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.Откройте терминал

windows_open_terminal

2.Установите Factory Droid CLI

Официальная команда установки:

Команда установки

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

windows-install

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): provider openai, Base URL https://api.88api.ai/v1
  • Модели Claude (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://api.88api.ai (без /v1)

windows-configure.webp

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.

Изменение файла конфигурации одной командой

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

macos-open-terminal

macos-img-02.webp

Измените переменные окружения по подсказке установщика (просто скопируйте предложенный код):

В Linux выберите ~/.bashrc или ~/.zshrc в зависимости от оболочки

Переменные окружения Droid CLI (только пример)

echo 'export PATH=/Users/ваше-имя-пользователя/.local/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

2.Измените файл конфигурации

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): provider openai, Base URL https://api.88api.ai/v1
  • Модели Claude (claude-fable-5-1, claude-opus-5-5, claude-sonnet-5-5): provider anthropic, Base URL https://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, просто запустите скрипт ещё раз.

macos-img-03.webp

Подсказки скрипта выводятся на китайском языке; значения те же, что и в тексте.

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.