14 ноября 2026 г.
Почему сайты от Claude Code одинаковые: как настроить свои UI-компоненты

Чтобы сайты от Claude Code не выглядели одинаково, дай агенту готовые компоненты и короткие правила оформления проекта: цвета, шрифты, радиусы, отступы. Для React-проекта можно начать с shadcn/ui, изменить его исходный код под свой дизайн и попросить агента переиспользовать эти файлы. Потом открой страницу на телефоне и проверь работу клавиатурой. Одна инструкция без проверки интерфейс не спасёт.
Поводом стал ролик о библиотеках для Claude Code. Автор предлагает перестать поручать модели изобретать каждый диалог и каждое уведомление заново. Ролику уже несколько дней, это не новый релиз Claude. Я взял оттуда рабочий вопрос и сверил варианты по документации самих библиотек: где находится поведение компонента, кто отвечает за внешний вид и что агенту действительно можно поручить.
Почему просьба «сделай красиво» даёт знакомый шаблон
Модель видит фразу, но не видит вкус заказчика. У неё нет выбранной сетки, набора отступов, палитры и решений для сложных элементов. Если в проекте ещё нет собственных компонентов, агенту приходится собирать кнопку и модальное окно из того, что он помнит. При следующем запросе результат может измениться. Для продукта такая непредсказуемость мешает: кнопка в одной форме округлая, в другой квадратная, а предупреждение на разных страницах ведёт себя по-разному.
У меня к этому подходу простой вопрос: что именно агент должен повторять? Если ответ только «хороший дизайн», проект ещё не дал ему материала для работы. Нужны реальные файлы с примерами и правило, когда брать готовый компонент. В документации shadcn/ui прямо описан подход с открытым кодом: компонент попадает в твой проект, его можно менять и показывать модели как часть существующего приложения. Это отличается от просьбы «нарисуй как на красивом сайте».
Здесь есть нюанс: сама по себе библиотека не делает интерфейс уникальным. Если поставить компоненты и оставить исходные цвета, типографику и геометрию, получится узнаваемый исходный стиль. Отличие появляется, когда ты меняешь конкретные решения и повторяешь их во всём продукте. Я бы начал с одного экрана: карточка, кнопка действия и окно подтверждения. Если они выглядят и ведут себя согласованно, можно идти дальше.
Что выбрать: готовый код или примитив поведения
У библиотек разные задачи. shadcn/ui отдаёт код компонента в проект и предлагает готовую точку старта для оформления. Это удобно, если агент будет читать и править те же файлы, что и ты. Компонент можно подстроить под уже существующий сайт, а не наслаивать десятки переопределений поверх чужого пакета. Но при обновлении тебе придётся следить за своим изменённым кодом.
Radix Primitives и Base UI решают другую часть задачи: дают нестилизованное поведение элементов. Фокус, управление клавиатурой и структура диалога остаются на библиотеке; цвет, шрифт и размеры собираешь сам. Base UI поставляется одной зависимостью @base-ui/react, но в итоговую сборку попадают только используемые части. Обе библиотеки полезны, когда визуальная система уже есть и нужен аккуратный нижний слой под неё.
Для новичка разница такая: shadcn/ui даёт готовую одежду, которую можно перекроить в файлах проекта; Radix и Base UI дают механику, которую надо одеть самому. Не смешивай их на одном экране без причины. Проверь, на чём уже построен существующий продукт: новая библиотека может принести несовместимые стили, зависимости и дубли компонентов. Если проект на Astro без React-островков, эти React-варианты тоже не становятся магически подходящими только потому, что агент их любит.
Есть узкие инструменты. Например, Sonner предназначен для уведомлений в React: там показаны контейнер Toaster и вызов toast. Можно взять его для уведомления о сохранении, не пытаясь изобрести всплывашку вручную. А вот Vaul из того же круга рекомендаций я бы сейчас не советовал без оговорки: в его официальном репозитории автор прямо пишет, что проект не поддерживается. Видео или старый список библиотек не заменяют проверку состояния пакета.
Как собрать пробный проект без риска для рабочего сайта
Ниже маршрут для существующего React-проекта на Next.js; это не команда для нашего Astro-блога. Сначала сохрани исходное состояние проекта и посмотри его зависимости. Официальная инструкция Next.js показывает, как добавить компонент в проект, а документация CLI отдельно объясняет, что инициализация настраивает зависимости, вспомогательный код и CSS-переменные. Я бы отрепетировал это в копии проекта, а не на рабочем релизе.
В папке пробного проекта запусти:
npx shadcn@latest init
npx shadcn@latest add button
npx shadcn@latest add dialog
Команды добавления кнопки и диалога указаны в их документации. CLI может скачать пакет через npx и установить зависимости в проект. До запуска зафиксируй состояние файлов, а после сравни изменения: обязательного экрана подтверждения у этих команд нет. Исходный код компонентов станет частью твоего приложения; теперь агенту есть на что опереться. В существующей кодовой базе отдельно проверь конфигурацию путей импорта и не включай флаг перезаписи чужих компонентов вслепую.

Попроси Claude собрать небольшую страницу записи на консультацию: поле контакта, кнопка отправки и диалог подтверждения. Не проси сразу весь сайт. Сначала посмотри, использовал ли он добавленные компоненты, не нарисовал ли второй вариант той же кнопки и не перенёс ли текст запроса внутрь CSS-классов. После этого меняй внешний вид в исходниках компонента и теме, а не исправляй каждый экземпляр кнопки по отдельности.
Цвета и радиусы: почему настройки важнее ещё одного промпта
У shadcn/ui есть система семантических CSS-переменных: например, фон страницы, основной текст и цвет главного действия. Компоненты ссылаются на эти значения, а не выбирают новый цвет в каждой карточке. Меняешь токен в теме - одно изменение доходит до нескольких мест. В документации это связано с настройкой cssVariables в components.json; в новом проекте режим включён по умолчанию, но в старом проверь значение самостоятельно.
Для первого опыта я бы ограничил выбор: основной цвет действия, цвет фона, шрифт заголовков, шрифт текста и радиус элементов. Добавь один референс страницы, которая тебе нравится, и назови конкретно, что берёшь: плотность, контраст, крупный заголовок. Не проси «сделай как у бренда X» целиком. Агент может скопировать детали, которые этому проекту не нужны, или случайно перепутать публичную стилистику с чужим логотипом.
Потом сравни три места: кнопку на главной, кнопку в форме и подтверждение внутри диалога. Если каждая выглядит как продукт другой команды, значит правило ещё не закрепилось в общем компоненте. Если общий компонент изменил всё сразу - появился настоящий рычаг. Красота при этом остаётся вкусовой задачей. CSS-переменная избавляет от случайных оттенков, но не решает за тебя, какой цвет выбрать.
Как объяснить правила Claude Code
CLAUDE.md позволяет хранить инструкции проекта между сессиями Claude Code. Если в проекте уже есть AGENTS.md, проверь по той же документации, когда именно Claude читает его: наличие CLAUDE.md меняет поведение. Инструкции остаются контекстом для агента, а не блокировкой на уровне программы. Поэтому правило должно быть коротким и проверяемым: «Перед созданием нового UI-элемента посмотри существующие компоненты. Используй нашу кнопку и диалог. Если нужного поведения нет, объясни, почему добавляешь зависимость. После изменения проверь экран на узкой ширине и работу клавиатурой». Точную форму подстрой под файлы своего проекта.
Не вставляй в инструкцию каталог всех библиотек на свете. От этого агент не узнает, что принято в твоём приложении. Дай путь к папке компонентов и к файлу темы, приложи пример удачного экрана. Даже хорошая инструкция не гарантирует, что он не напишет отдельный самодельный popover. После генерации открой diff: появился ли новый компонент, поменялись ли глобальные токены, почему добавлена зависимость. Это быстрее, чем разбирать несогласованность после сборки большого сайта.
Тут важно развести две работы. Режим /design помогает выбрать направление макета до написания кода. Компонентная система нужна после выбора: она удерживает единый язык в работающем приложении. А рекомендации Chrome полезны для проверки веб-поведения и совместимости. Ни один из этих инструментов не заменяет остальные.
Что проверить до публикации
Открой страницу на обычном мониторе и на телефоне. Посмотри, помещаются ли кнопки, не превращается ли диалог в окно шире экрана, читается ли текст на тёмном фоне. Затем убери мышь. Для модального окна правила W3C описывают понятный тест: после открытия фокус находится внутри, Tab и Shift+Tab переходят между элементами окна, Escape закрывает его. После закрытия проверь, куда вернулся фокус. Библиотека даёт отправную точку, но твоя сборка и твои стили способны всё испортить.
Я бы ещё проверил, что обе версии страницы делают одно и то же: подтверждение не исчезло на мобильном, уведомление не перекрывает кнопку, текст ошибки виден рядом с полем. Это не сертификат доступности и не отчёт из тестовой лаборатории. Просто минимальная проверка вещи, которую человек действительно будет нажимать. Если она не пройдена, никакой «вау-дизайн» не стоит публикации.
Короткий итог: дай агенту исходный код компонентов и ясные правила темы, затем проверь реальную страницу. Не стоит ставить библиотеку поверх работающего проекта ради моды; начни с одного экрана. И не называй видео от 7 ноября свежим релизом: тема полезна потому, что привычка модели заново строить элементы встречается в обычной разработке, а не потому, что вышла ещё одна кнопка.
Источники
- Видео Griffin Wooldridge о библиотеках компонентов для Claude Code.
- shadcn/ui: как устроен открытый код компонентов.
- shadcn/ui: CLI и команды установки.
- shadcn/ui: инструкция для Next.js.
- shadcn/ui: кнопка и диалог.
- shadcn/ui: темы и CSS-переменные.
- Radix Primitives: принципы и доступность и Base UI: quick start.
- Sonner: README и Vaul: статус проекта.
- Claude Code: как работает память проекта.
- W3C: поведение модального диалога.
