Установка и настройка

Что вы сможете делать после этого урока

✅ Установить CLI-инструмент Agent App Factory и проверить установку ✅ Настроить Claude Code или OpenCode в качестве ИИ-движка выполнения ✅ Установить необходимые плагины для работы конвейера ✅ Завершить инициализацию проекта и запустить первый проект Factory

Ваша текущая сложность

Вы хотите использовать AI App Factory для превращения идей в приложения, но не знаете, какие инструменты устанавливать и как настраивать окружение. После установки вы боитесь пропустить обязательные плагины, и конвейер упадёт с ошибкой на середине.

Когда использовать этот подход

Когда вы впервые используете AI App Factory или настраиваете среду разработки на новой машине, сначала завершите установку и настройку, а затем приступайте к генерации приложений.

🎒 Подготовка к началу

Предварительные требования

Перед началом установки убедитесь, что:

• Node.js версии >= 16.0.0 — это минимальное требование для CLI-инструмента
• npm или yarn — для глобальной установки пакетов
• ИИ-ассистент — Claude Code или OpenCode (рекомендуется Claude Code)

Проверка версии Node.js:

node --version

Если версия ниже 16.0.0, скачайте и установите последнюю LTS-версию с официального сайта Node.js.

Основная идея

Установка AI App Factory включает 3 ключевых компонента:

1. CLI-инструмент — предоставляет интерфейс командной строки для управления состоянием проекта
2. ИИ-ассистент — "мозг", выполняющий конвейер, интерпретирующий инструкции Агента
3. Обязательные плагины — пакеты расширений, усиливающих возможности ИИ (мозговой штурм Bootstrap, система дизайна UI)

Порядок установки: Установка CLI → Настройка ИИ-ассистента → Инициализация проекта (автоматическая установка плагинов)

Следуйте за мной

Шаг 1: Установка CLI-инструмента

Установите Agent App Factory CLI глобально, чтобы использовать команду factory в любом каталоге.

npm install -g agent-app-factory

Вы должны увидеть: вывод об успешной установке

added 1 package in Xs

Проверка установки:

factory --version

Вы должны увидеть: вывод версии

1.0.0

Если версия не отображается, проверьте, успешно ли установлен пакет:

which factory  # macOS/Linux
where factory  # Windows

Не удаётся установить?

Если у вас проблемы с правами доступа (macOS/Linux), попробуйте:

sudo npm install -g agent-app-factory

Или используйте npx без глобальной установки (не рекомендуется, так как при каждом использовании потребуется загрузка):

npx agent-app-factory init

Шаг 2: Установка ИИ-ассистента

AI App Factory должен использоваться вместе с ИИ-ассистентом, поскольку определения Агента и файлы Skill — это инструкции ИИ в формате Markdown, которые необходимо интерпретировать и выполнять.

Вариант A: Claude Code (рекомендуется)

Claude Code — это официальный ИИ-помощник для программирования от Anthropic, глубоко интегрированный с AI App Factory.

Способ установки:

1. Посетите официальный сайт Claude Code
2. Скачайте и установите приложение для вашей платформы
3. После установки проверьте, доступна ли команда:

claude --version

Вы должны увидеть: вывод версии

Claude Code 1.x.x

Вариант B: OpenCode

OpenCode — это ещё один ИИ-помощник для программирования, поддерживающий режим Агента.

Способ установки:

1. Посетите официальный сайт OpenCode
2. Скачайте и установите приложение для вашей платформы
3. Если у вас нет инструмента командной строки, установите вручную:

• Windows: %LOCALAPPDATA%\Programs\OpenCode\
• macOS: /Applications/OpenCode.app/
• Linux: /usr/bin/opencode или /usr/local/bin/opencode

Почему рекомендуется Claude Code?

• Официальная поддержка, лучшая интеграция с системой разрешений AI App Factory
• Автоматическая установка плагинов, factory init автоматически настроит необходимые плагины
• Лучшее управление контекстом, экономия токенов

Шаг 3: Инициализация первого проекта Factory

Теперь у вас есть чистая фабрика, давайте инициализируем первый проект.

Создание каталога проекта:

mkdir my-first-app && cd my-first-app

Инициализация проекта Factory:

factory init

Вы должны увидеть:

Agent Factory - Project Initialization

✓ Factory project initialized!

Project structure created:
  .factory/
    agents/
    skills/
    policies/
    templates/
    pipeline.yaml
    config.yaml
    state.json

✓ Plugins installed!

Starting Claude Code...
✓ Claude Code is starting...
  (Please wait for window to open)

Контрольная точка ✅: Подтвердите, что следующие файлы были созданы

ls -la .factory/

Вы должны увидеть:

agents/
skills/
policies/
templates/
pipeline.yaml
config.yaml
state.json

В то же время окно Claude Code должно открыться автоматически.

Каталог должен быть пустым

factory init может быть запущен только в пустом каталоге или в каталоге, содержащем только .git, README.md и другие файлы конфигурации.

Если в каталоге есть другие файлы, вы увидите ошибку:

Cannot initialize: directory is not empty.
Factory init requires an empty directory or one with only git/config files.

Шаг 4: Автоматически установленные плагины

factory init пытается автоматически установить два обязательных плагина:

1. superpowers — Навык мозгового штурма на этапе Bootstrap
2. ui-ux-pro-max-skill — Система дизайна UI на этапе UI (67 стилей, 96 цветовых палитр, 100 отраслевых правил)

Если автоматическая установка не удалась, вы увидите предупреждение:

Note: superpowers plugin installation failed
The bootstrap stage may prompt you to install it manually

Что делать, если установка плагина не удалась?

Если установка плагина не удалась во время инициализации, вы можете установить его вручную в Claude Code позже:

1. Введите в Claude Code:

   /install superpowers
   /install ui-ux-pro-max-skill

2. Или посетите плагин-маркет для ручной установки

Шаг 5: Проверка разрешений ИИ-ассистента

factory init автоматически генерирует файл .claude/settings.local.json, настраивая необходимые разрешения.

Проверка конфигурации разрешений:

cat .claude/settings.local.json

Вы должны увидеть (упрощённая версия):

{
  "allowedCommands": [
    "read",
    "write",
    "glob",
    "bash"
  ],
  "allowedPaths": [
    ".factory/**",
    "input/**",
    "artifacts/**"
  ]
}

Эти разрешения позволяют ИИ-ассистенту:

• Читать определения Агента и файлы Skill
• Записывать артефакты в каталог artifacts/
• Выполнять необходимые скрипты и тесты

Не используйте --dangerously-skip-permissions

Сгенерированная AI App Factory конфигурация разрешений уже достаточно безопасна, не используйте --dangerously-skip-permissions в Claude Code, так как это снизит безопасность и может привести к несанкционированным операциям.

Предупреждения о распространённых ошибках

❌ Слишком низкая версия Node.js

Ошибка: npm install -g agent-app-factory не устанавливается или выдаёт ошибку при запуске

Причина: Версия Node.js ниже 16.0.0

Решение: Обновите Node.js до последней LTS-версии

# Обновление с помощью nvm (рекомендуется)
nvm install --lts
nvm use --lts

❌ Claude Code установлен неправильно

Ошибка: После выполнения factory init появляется сообщение "Claude CLI not found"

Причина: Claude Code не был правильно добавлен в PATH

Решение: Переустановите Claude Code или вручную добавьте путь к исполняемому файлу в переменные окружения

• Windows: Добавьте каталог установки Claude Code в PATH
• macOS/Linux: Проверьте, есть ли исполняемый файл claude в /usr/local/bin/

❌ Каталог не пустой

Ошибка: factory init выводит сообщение "directory is not empty"

Причина: В каталоге уже есть другие файлы (кроме .git, README.md и других конфигурационных файлов)

Решение: Инициализируйте в новом пустом каталоге или очистите существующий каталог

# Очистка каталога от неконфигурационных файлов
rm -rf * !(.git) !(README.md)

❌ Установка плагина не удалась

Ошибка: factory init показывает предупреждение об ошибке установки плагина

Причина: Проблемы с сетью или временная недоступность плагин-маркета Claude Code

Решение: Установите плагин вручную в Claude Code или установите по запросу при последующем выполнении конвейера

/install superpowers
/install ui-ux-pro-max-skill

Резюме урока

В этом уроке мы завершили полную установку и настройку AI App Factory:

1. ✅ CLI-инструмент — глобальная установка через npm install -g agent-app-factory
2. ✅ ИИ-ассистент — Claude Code или OpenCode, рекомендуется Claude Code
3. ✅ Инициализация проекта — factory init создаёт каталог .factory/ и автоматически настраивает его
4. ✅ Обязательные плагины — superpowers и ui-ux-pro-max-skill (автоматическая или ручная установка)
5. ✅ Конфигурация разрешений — автоматическая генерация файла разрешений Claude Code

Теперь у вас есть работающий проект Factory, окно Claude Code открыто и готово к выполнению конвейера.

Анонс следующего урока

В следующем уроке мы изучим инициализацию проекта Factory.

Вы узнаете:

• Структуру каталогов, создаваемую factory init
• Назначение каждого файла в каталоге .factory/
• Как изменять конфигурацию проекта
• Как проверять состояние проекта

Готовы начать создание вашего первого приложения? Давайте продолжим!

---

Приложение: Справочник по исходному коду

Нажмите, чтобы просмотреть расположение исходного кода

Обновлено: 2026-01-29

Функция	Путь к файлу	Строки
Вход CLI	cli/bin/factory.js	1-123
Команда инициализации	cli/commands/init.js	1-457
Требования к Node.js	package.json	41
Запуск Claude Code	cli/commands/init.js	119-147
Запуск OpenCode	cli/commands/init.js	152-215
Проверка установки плагина	cli/commands/init.js	360-392
Генерация конфигурации разрешений	cli/utils/claude-settings.js	1-275

Ключевые константы:

• NODE_VERSION_MIN = "16.0.0": Минимальное требование к версии Node.js (package.json:41)

Ключевые функции:

• getFactoryRoot(): Получение корневого каталога установки Factory (factory.js:22-52)
• init(): Инициализация проекта Factory (init.js:220-456)
• launchClaudeCode(): Запуск Claude Code (init.js:119-147)
• launchOpenCode(): Запуск OpenCode (init.js:152-215)
• generateClaudeSettings(): Генерация конфигурации разрешений Claude Code