Claude Code: Руководство по настройке дизайн-стека
Три инструмента. Устанавливаются один раз. Ваш Claude Code переходит с уровня «неплохо» на уровень профессионального дизайнера. Следуйте этому руководству по порядку — весь процесс занимает около 15 минут. Вы получите продуманную дизайн-систему, реальные паттерны интерфейсов и доступ к премиальным компонентам прямо из Claude Code.
Что входит в стек
Дизайн-стек состоит из трёх компонентов, которые работают вместе и кардинально меняют качество выходных данных Claude Code. Каждый инструмент решает конкретную задачу.
Обзор компонентов
| № | Инструмент | Описание |
|---|---|---|
| 01 | GitHub — UX/UI Design Skill | Даёт Claude настоящую дизайн-систему для работы. Реальные принципы UI, а не просто эстетика. Claude читает её автоматически в каждой сессии. |
| 02 | MCP — Google Stitch + Nano Banana 2 | Реальные референсы дизайн-паттернов. Claude перестаёт угадывать и начинает опираться на проверенные паттерны при создании интерфейсов. |
| 03 | Библиотека — 21st.dev | Премиальные 3D и реактивные компоненты, к которым Claude Code обращается напрямую. Разница в качестве результата заметна сразу. |
Зачем нужен каждый инструмент
CLAUDE.md (Шаг 01) — это «мозг» дизайн-системы. Файл содержит принципы верстки, правила отступов и паттерны компонентов. Claude автоматически читает его при каждом запуске в вашем проекте.
MCP-серверы (Шаг 02) — это «глаза» Claude Code. Google Stitch и Nano Banana 2 предоставляют доступ к внешним базам дизайн-паттернов в реальном времени, чтобы Claude не изобретал велосипед.
21st.dev (Шаг 03) — это «руки» Claude Code. Готовые компоненты — 3D-элементы, анимации, реактивный UI — подключаются напрямую, минуя ручную реализацию.
Итоговый результат
После настройки всех трёх инструментов Claude Code будет автоматически применять профессиональные дизайн-принципы, использовать проверенные паттерны и подключать готовые компоненты — без дополнительных инструкций с вашей стороны.
Перед началом: требования
Убедитесь, что у вас установлены и работают следующие инструменты, прежде чем переходить к установке стека.
Необходимое программное обеспечение
| Инструмент | Минимальная версия | Примечание |
|---|---|---|
| Claude Code | Актуальная версия | Должен быть установлен и аутентифицирован |
| Node.js | 18 или выше | Обязательное требование |
| npm | Любая актуальная | Устанавливается вместе с Node.js |
Проверка версий
Запустите следующие команды для проверки установленных версий:
# Проверьте ваши версии
$ node --version
$ npm --version
$ claude --version
Установка Claude Code
Совет: Если Claude Code ещё не установлен, выполните команду ниже, а затем пройдите аутентификацию с вашим аккаунтом Anthropic.
# Установка Claude Code глобально
npm install -g @anthropic-ai/claude-code
Пошаговая установка
Выполняйте шаги строго по порядку. Каждый следующий шаг опирается на предыдущий.
Шаг 01: Установка UX/UI Design Skill с GitHub (бесплатно)
Файл навыка CLAUDE.md добавляется в ваш проект. Он даёт Claude Code настоящую дизайн-систему — принципы верстки, паттерны компонентов, правила отступов — встроенные с самого начала.
Перейдите в папку вашего проекта, затем выполните команду ниже для загрузки файла навыка.
# Перейдите в ваш проект
$ cd your-project-folder
# Загрузите UX/UI навык в корень проекта
$ curl -O https://raw.githubusercontent.com/[repo-link]/main/CLAUDE.md
Важно: Claude Code автоматически читает любой файл CLAUDE.md в директории проекта. После установки дизайн-система загружается автоматически при каждом запуске Claude Code в этом проекте. Дополнительных действий не требуется.
Шаг 02: Установка Google Stitch MCP + Nano Banana 2 (бесплатно)
MCP-серверы дают Claude доступ к внешним референсам. Эти два инструмента предоставляют ему реальные дизайн-паттерны при создании интерфейсов. Установите оба с помощью встроенного MCP-установщика Claude Code.
Установка Google Stitch:
# Установка Google Stitch MCP
$ claude mcp add google-stitch
Установка Nano Banana 2:
# Установка Nano Banana 2 MCP
$ claude mcp add nano-banana-2
Совет: Проверьте корректность установки обоих MCP командой: claude mcp list — оба должны отображаться как активные.
Шаг 03: Подключение библиотеки компонентов 21st.dev (есть бесплатный тариф)
21st.dev — это библиотека компонентов, к которой Claude Code обращается напрямую: 3D-элементы, анимированные компоненты, реактивный UI. Создайте бесплатный аккаунт на 21st.dev, получите API-ключ в личном кабинете, затем выполните команду установки ниже.
# Замените YOUR_API_KEY_HERE на ваш ключ с 21st.dev
$ claude mcp add 21st-dev --api-key YOUR_API_KEY_HERE
Внимание: Держите API-ключ в тайне. Не вставляйте его в общие файлы и не коммитьте в Git. Эта команда надёжно сохраняет ключ в локальном конфиге Claude Code.
Проверка и тестирование
После установки всех трёх инструментов выполните финальную проверку, чтобы убедиться, что стек работает корректно.
Тестовый запрос
Откройте Claude Code в вашем проекте и вставьте промпт ниже. Если все три инструмента работают, Claude обратится к дизайн-навыку, сошлётся на реальные паттерны через MCP и использует компонент 21st.dev для 3D-элемента.
Тестовый промпт — вставьте в Claude Code:
Build me a landing page hero section with a 3D animated gradient background, a bold headline, a subheadline, and a CTA button. Use 21st.dev components for the 3D elements. Follow the UX/UI design skill guidelines for layout and spacing. Reference best-practice hero patterns from Stitch and Nano Banana.
Признаки успешной работы
| Инструмент | Признак корректной работы |
|---|---|
| CLAUDE.md (Design Skill) | Claude применяет дизайн-систему без дополнительных указаний |
| MCP (Stitch + Nano Banana) | Claude подтягивает реальный паттерн верстки |
| 21st.dev | Claude использует настоящий компонент 21st.dev для 3D-элемента |
Устранение неполадок
Совет: Если какой-то из признаков отсутствует в результате — проверьте, какой инструмент не установился, командой: claude mcp list
Если список MCP пуст или инструмент не отображается как активный — повторите соответствующий шаг установки. Убедитесь, что вы находитесь в правильной директории проекта при запуске Claude Code.
Часто задаваемые вопросы
Нужно ли устанавливать стек для каждого нового проекта?
Файл CLAUDE.md нужно копировать в каждый новый проект (или создавать заново через команду curl). MCP-серверы (Google Stitch, Nano Banana 2, 21st.dev) устанавливаются глобально и работают во всех проектах — повторная установка не требуется.
Что такое MCP и зачем он нужен Claude Code?
MCP (Model Context Protocol) — это протокол, позволяющий Claude Code подключаться к внешним инструментам и источникам данных в реальном времени. Google Stitch и Nano Banana 2 через MCP предоставляют Claude актуальные базы дизайн-паттернов, чтобы он не генерировал интерфейсы «из воздуха», а опирался на проверенные решения.
21st.dev — это платный сервис? Есть ли бесплатный доступ?
Да, у 21st.dev есть бесплатный тариф. Создайте аккаунт на сайте 21st.dev, получите API-ключ в личном кабинете и используйте его при установке MCP. Ограничения бесплатного тарифа уточняйте на официальном сайте сервиса.
Безопасно ли хранить API-ключ 21st.dev в Claude Code?
Команда claude mcp add 21st-dev --api-key YOUR_API_KEY_HERE сохраняет ключ в локальном конфигурационном файле Claude Code на вашей машине. Главное правило: никогда не вставляйте ключ напрямую в файлы проекта и не коммитьте его в Git-репозиторий. Добавьте файлы конфигурации в .gitignore для дополнительной безопасности.
CLAUDE.md работает только с Claude Code или с другими IDE тоже?
Файл CLAUDE.md разработан специально для Claude Code — именно этот инструмент автоматически читает его при запуске в директории проекта. Другие IDE и AI-ассистенты могут не поддерживать этот формат автоматически, но содержимое файла можно использовать как системный промпт в других инструментах вручную.
