Интеграция Claude Code: Настройка разрешений для запуска конвейера | Руководство AI App Factory

Что вы сможете делать после изучения

Настраивать безопасные разрешения Claude Code без использования --dangerously-skip-permissions
Понимать автоматически генерируемый белый список разрешений Factory
Выполнять полный 7-этапный конвейер в Claude Code
Освоить кроссплатформенную настройку разрешений (Windows/macOS/Linux)

Ваша текущая проблема

При первом использовании Factory вы можете столкнуться с:

Блокировкой разрешений: Claude Code сообщает «Нет разрешения на чтение файла»
Использованием опасных параметров: Вынуждены добавлять --dangerously-skip-permissions для обхода проверок безопасности
Сложностью ручной настройки: Не знаете, какие операции следует разрешить
Кроссплатформенными проблемами: Несоответствие путей и разрешений между Windows и Unix

На самом деле Factory автоматически генерирует полную конфигурацию разрешений, вам просто нужно правильно её использовать.

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

Когда вам нужно запустить конвейер Factory в Claude Code:

После инициализации проекта с помощью factory init (автоматический запуск)
При продолжении конвейера с помощью factory run
При ручном запуске Claude Code

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

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

Основная концепция

Конфигурация разрешений Factory использует механизм белого списка: разрешены только явно указанные операции, все остальные запрещены.

Категории белого списка разрешений

Категория	Разрешенные операции	Назначение
Файловые операции	Read/Write/Edit/Glob	Чтение и изменение файлов проекта
Git-операции	git add/commit/push и др.	Контроль версий
Операции с директориями	ls/cd/tree/pwd	Просмотр структуры директорий
Инструменты сборки	npm/yarn/pnpm	Установка зависимостей, запуск скриптов
TypeScript	tsc/npx tsc	Проверка типов
Базы данных	npx prisma	Миграции и управление базами данных
Python	python/pip	Система дизайна UI
Тестирование	vitest/jest/test	Запуск тестов
Factory CLI	factory init/run/continue	Команды конвейера
Docker	docker compose	Контейнеризация и развертывание
Web-операции	WebFetch(domain:...)	Получение API-документации
Skills	superpowers/ui-ux-pro-max	Плагинные навыки

Почему не использовать `--dangerously-skip-permissions`?

Способ	Безопасность	Рекомендация
`--dangerously-skip-permissions`	❌ Разрешает Claude любые действия (включая удаление файлов)	Не рекомендуется
Конфигурация белого списка	✅ Разрешены только явные операции, нарушения вызывают ошибки	Рекомендуется

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

🎒 Подготовка перед началом

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

[x] Завершена установка и настройка (start/installation/)
[x] Завершена инициализация проекта Factory (start/init-project/)
[x] Установлен Claude Code: https://claude.ai/code
[x] Директория проекта инициализирована (существует директория .factory/)

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

В терминале выполните следующую команду для подтверждения:

bash

claude --version

Если появляется сообщение «command not found», сначала установите Claude Code.

Следуйте инструкциям

Шаг 1: Инициализация проекта (автоматическая генерация разрешений)

Почему: factory init автоматически генерирует .claude/settings.local.json, содержащий полный белый список разрешений.

В директории проекта выполните:

bash

# Создайте новую директорию и перейдите в нее
mkdir my-factory-project && cd my-factory-project

# Инициализируйте проект Factory
factory init

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

✓ Factory project initialized!
✓ Claude Code is starting...
  (Please wait for window to open)

Окно Claude Code автоматически откроется и отобразит следующее сообщение:

请阅读.factory/pipeline.yaml和.factory/agents/orchestrator.checkpoint.md，
启动流水线，帮我将产品想法碎片转化为可运行的应用，
接下来我将会输入想法碎片。注意：Agent引用的skills/和policies/
文件需要先查找.factory/目录，再查找根目录。

Что произошло:

Создана директория .factory/, содержащая конфигурацию конвейера
Сгенерирован файл .claude/settings.local.json (белый список разрешений)
Автоматически запущен Claude Code с передачей стартового сообщения

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

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

Проверьте сгенерированный файл разрешений:

bash

# Просмотрите содержимое файла разрешений
cat .claude/settings.local.json

Вы должны увидеть (часть содержимого):

json

{
  "permissions": {
    "allow": [
      "Read(/path/to/project/**)",
      "Write(/path/to/project/**)",
      "Glob(/path/to/project/**)",
      "Bash(git add:*)",
      "Bash(git commit:*)",
      "Bash(npm install:*)",
      "Bash(npx prisma generate:*)",
      "Skill(superpowers:brainstorming)",
      "Skill(ui-ux-pro-max)",
      "WebFetch(domain:github.com)",
      "WebFetch(domain:npmjs.org)"
    ]
  },
  "features": {
    "autoSave": true,
    "telemetry": false
  }
}

Пояснение путей

Пути в разрешениях автоматически корректируются в зависимости от вашей операционной системы:

Windows: Read(//c/Users/...) (поддерживаются как строчные, так и прописные буквы диска)
macOS/Linux: Read(/Users/...) (абсолютный путь)

Шаг 3: Запуск конвейера в Claude Code

Почему: Claude Code настроен с разрешениями и может напрямую читать определения Agent и файлы Skill.

В открытом окне Claude Code введите вашу идею продукта:

我想做一个移动端记账应用，帮助年轻人快速记录日常支出，
避免月底超支。主要功能是记录金额、选择分类（饮食、交通、娱乐、其他），
查看本月总支出。

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

Claude Code выполнит следующие шаги (автоматически):

Прочитать .factory/pipeline.yaml
Прочитать .factory/agents/orchestrator.checkpoint.md
Начать этап Bootstrap, структурировав вашу идею в input/idea.md
Приостановиться после завершения, ожидая вашего подтверждения

Контрольная точка ✅: Подтвердите завершение этапа Bootstrap

bash

# Просмотрите сгенерированную структурированную идею
cat input/idea.md

Шаг 4: Продолжение конвейера

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

В Claude Code ответьте:

继续

Claude Code автоматически перейдет к следующему этапу (PRD) и повторит процесс «выполнение→пауза→подтверждение» до завершения всех 7 этапов.

Использование factory run для перезапуска

Если окно Claude Code закрылось, вы можете выполнить в терминале:

bash

factory run

Это повторно отобразит инструкции выполнения Claude Code.

Шаг 5: Кроссплатформенная обработка разрешений (для пользователей Windows)

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

Если вы используете Windows, factory init автоматически сгенерирует разрешения с поддержкой букв диска:

json

{
  "permissions": {
    "allow": [
      "Read(//c/Users/yourname/project/**)",
      "Read(//C/Users/yourname/project/**)",
      "Write(//c/Users/yourname/project/**)",
      "Write(//C/Users/yourname/project/**)"
    ]
  }
}

Контрольная точка ✅: Проверка разрешений для пользователей Windows

powershell

# PowerShell
Get-Content .claude\settings.local.json | Select-String -Pattern "Read|Write"

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

Контрольная точка ✅

После выполнения описанных шагов вы должны иметь возможность:

[x] Найти файл .claude/settings.local.json
[x] Увидеть полный белый список разрешений (включающий Read/Write/Bash/Skill/WebFetch)
[x] Успешно запустить этап Bootstrap в Claude Code
[x] Просмотреть input/idea.md и подтвердить структурирование идеи
[x] Продолжить выполнение конвейера до следующего этапа

Если вы столкнулись с ошибками разрешений, обратитесь к разделу «Распространенные проблемы» ниже.

Распространенные проблемы

Проблема 1: Блокировка разрешений

Сообщение об ошибке:

Permission denied: Read(path/to/file)

Причина:

Файл разрешений сгенерирован неправильно или путь некорректен
Claude Code использует старый кэш разрешений

Решение:

Проверьте существование файла разрешений:

bash

ls -la .claude/settings.local.json

Перегенерируйте разрешения:

bash

# Удалите старый файл разрешений
rm .claude/settings.local.json

# Переинициализируйте (пересоздаст файл)
factory init --force

Перезапустите Claude Code, очистив кэш.

Проблема 2: Предупреждение `--dangerously-skip-permissions`

Сообщение об ошибке:

Using --dangerously-skip-permissions is not recommended.

Причина:

Не найден файл .claude/settings.local.json
Некорректный формат файла разрешений

Решение:

Проверьте формат файла разрешений (синтаксис JSON):

bash

# Проверка формата JSON
python -m json.tool .claude/settings.local.json

Если появляется сообщение о синтаксической ошибке, удалите файл и повторно выполните factory init.

Проблема 3: Не работают разрешения путей Windows

Сообщение об ошибке:

Permission denied: Read(C:\Users\yourname\project\file.js)

Причина:

В конфигурации разрешений отсутствуют пути с буквой диска
Некорректный формат пути (Windows требует формат //c/)

Решение:

Вручную отредактируйте .claude\settings.local.json, добавив пути с буквой диска:

json

{
  "permissions": {
    "allow": [
      "Read(//c/Users/yourname/project/**)",
      "Write(//c/Users/yourname/project/**)"
    ]
  }
}

Обратите внимание, что поддерживаются оба варианта написания буквы диска (//c/ и //C/).

Проблема 4: Блокировка разрешений Skills

Сообщение об ошибке:

Permission denied: Skill(superpowers:brainstorming)

Причина:

Не установлены необходимые плагины Claude Code (superpowers, ui-ux-pro-max)
Несовместимая версия плагина

Решение:

Добавьте маркетплейс плагинов:

bash

# Добавьте маркетплейс superpowers
claude plugin marketplace add obra/superpowers-marketplace

Установите плагин superpowers:

bash

claude plugin install superpowers@superpowers-marketplace

Добавьте маркетплейс ui-ux-pro-max:

bash

claude plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill

Установите плагин ui-ux-pro-max:

bash

claude plugin install ui-ux-pro-max@ui-ux-pro-max-skill

Повторно запустите конвейер.

Factory автоматически пытается установить плагины

Команда factory init автоматически пытается установить эти плагины. Если не удалось, установите вручную.

Резюме урока

Белый список разрешений безопаснее, чем --dangerously-skip-permissions
factory init автоматически генерирует .claude/settings.local.json
Конфигурация разрешений включает категории: файловые операции, Git, инструменты сборки, базы данных, Web-операции и др.
Кроссплатформенная поддержка: Windows использует пути //c/, Unix — абсолютные пути
Ручная установка плагинов: Если автоматическая установка не удалась, необходимо вручную установить superpowers и ui-ux-pro-max в Claude Code

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

В следующем уроке мы изучим OpenCode и другие AI-ассистенты.
Вы узнаете:
Как запускать конвейер Factory в OpenCode
Методы интеграции с другими AI-ассистентами: Cursor, GitHub Copilot
Различия в настройке разрешений для разных ассистентов

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

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

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

Функция	Путь к файлу	Номера строк
Генерация конфигурации разрешений	`cli/utils/claude-settings.js`	1-292
Автоматический запуск Claude Code	`cli/commands/init.js`	119-147
Обнаружение AI-ассистента	`cli/commands/run.js`	105-124
Генерация инструкций Claude Code	`cli/commands/run.js`	138-156
Кроссплатформенная обработка путей	`cli/utils/claude-settings.js`	14-67

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

generatePermissions(projectDir): Генерирует полный белый список разрешений, включающий операции Read/Write/Bash/Skill/WebFetch и др.
generateClaudeSettings(projectDir): Генерирует и записывает файл .claude/settings.local.json
launchClaudeCode(projectDir): Запускает окно Claude Code и передает стартовое сообщение
detectAIAssistant(): Обнаруживает тип текущего AI-ассистента (Claude Code/Cursor/OpenCode)

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

Паттерны путей Windows: Read(//c/**), Write(//c/**) (поддерживаются как строчные, так и прописные буквы диска)
Паттерны путей Unix: Read(/path/to/project/**), Write(/path/to/project/**)
Разрешения Skills: 'Skill(superpowers:brainstorming)', 'Skill(ui-ux-pro-max)'

Категории белого списка разрешений:

Файловые операции: Read/Write/Glob (поддержка подстановочных знаков)
Git-операции: git add/commit/push/pull и др. (полный набор команд Git)
Инструменты сборки: npm/yarn/pnpm install/build/test/dev
TypeScript: tsc/npx tsc/npx type-check
Базы данных: npx prisma validate/generate/migrate/push
Python: python/pip install (для ui-ux-pro-max)
Тестирование: vitest/jest/test
Factory CLI: factory init/run/continue/status/reset
Docker: docker compose/ps/build/run
Web-операции: WebFetch(domain:github.com) и др. (белый список доменов)

Интеграция Claude Code: Настройка разрешений для запуска конвейера | Руководство AI App Factory ​

Что вы сможете делать после изучения ​

Ваша текущая проблема ​

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

Основная концепция ​

Категории белого списка разрешений ​

Почему не использовать --dangerously-skip-permissions? ​

🎒 Подготовка перед началом ​

Следуйте инструкциям ​

Шаг 1: Инициализация проекта (автоматическая генерация разрешений) ​

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

Шаг 3: Запуск конвейера в Claude Code ​

Шаг 4: Продолжение конвейера ​

Шаг 5: Кроссплатформенная обработка разрешений (для пользователей Windows) ​

Контрольная точка ✅ ​

Распространенные проблемы ​

Проблема 1: Блокировка разрешений ​

Проблема 2: Предупреждение --dangerously-skip-permissions ​

Проблема 3: Не работают разрешения путей Windows ​

Проблема 4: Блокировка разрешений Skills ​

Резюме урока ​

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

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

Интеграция Claude Code: Настройка разрешений для запуска конвейера | Руководство AI App Factory

Что вы сможете делать после изучения

Ваша текущая проблема

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

Основная концепция

Категории белого списка разрешений

Почему не использовать `--dangerously-skip-permissions`?

🎒 Подготовка перед началом

Следуйте инструкциям

Шаг 1: Инициализация проекта (автоматическая генерация разрешений)

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

Шаг 3: Запуск конвейера в Claude Code

Шаг 4: Продолжение конвейера

Шаг 5: Кроссплатформенная обработка разрешений (для пользователей Windows)

Контрольная точка ✅

Распространенные проблемы

Проблема 1: Блокировка разрешений

Проблема 2: Предупреждение `--dangerously-skip-permissions`

Проблема 3: Не работают разрешения путей Windows

Проблема 4: Блокировка разрешений Skills

Резюме урока

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

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