/design-sync отучает Claude Design выдумывать кнопки

Попросите Claude Design нарисовать экран, и вместо <Button>Save</Button> из вашей библиотеки он выдаст <button className="px-4 py-2 rounded bg-blue-600 text-white">. В разборе от 28 сентября в блоге Nitayneeman показано, как это исправляет команда /design-sync из Claude Code: она загружает в Claude Design «зеркало», скомпилированную копию библиотеки со стилями, шрифтами и типами. На связке shadcn/ui и Tailwind v4 зеркало без ручной подготовки выходит неполным: компонент без экспорта во входном файле молча не доезжает, утилиты разметки вроде grid-cols-3 не попадают в стили без @source inline(...), а шрифты теряются при загрузке без extraFonts.
Когда подготовка сделана, разница видна на первом же запросе. Экран входа с карточкой, полями email и пароля и двумя кнопками Claude Design собрал из Card, CardHeader и Button variant="outline", без самодельных div и разовых классов, и каждый компонент отрисовался так же, как его история в Storybook.
Что должно быть в репозитории
Синк собирает один бандл из одного входного файла. shadcn такого файла не создаёт, потому что рассчитывает на приложение, которое импортирует каждый компонент по его пути, так что src/index.ts с реэкспортом компонентов и хелпера cn() пишут руками. Предупреждения не будет: неэкспортированный компонент просто отсутствует в Claude Design, и автор советует начинать поиски пропажи с этого файла. Второе условие касается определений типов. По ним синк находит компоненты, а без них не находит ничего и отбрасывает все истории. Типы генерирует команда сборки в dist/, а package.json указывает туда полем "types": "dist/index.d.ts".
Превью в Claude Design нужен настоящий CSS-файл, а Storybook с @tailwindcss/vite его не выпускает: стили подгружаются из JavaScript-чанка уже во время работы. Поэтому таблицу стилей компилируют через Tailwind CLI в ds.css, который пересобирается при каждом синке. Если токены вынесены в отдельный файл, решает синтаксис импорта. Строковый @import './tokens.css' Tailwind v4 встраивает в результат, @import url('./tokens.css') оставляет внешней ссылкой. Локально работают оба варианта, но после загрузки токены несёт только встроенный, и без них все компоненты shadcn приезжают без стилей.
Скомпилированный CSS содержит только утилиты, найденные в исходниках. Три компонента дают пару сотен классов, и среди них нет тех, которыми Claude размечает экран вокруг компонентов: grid-cols-3, gap-6, max-w-4xl. Для этого в Tailwind v4.1 появилась директива @source inline(...), которая генерирует утилиты по шаблону, а не по сканированию файлов. Автор дописывает в конец src/index.css девять таких строк: фигурные скобки раскрываются во все комбинации, а пустой вариант в {sm:,md:,lg:,} даёт и класс без префикса, так что в CSS попадают и gap-6, и md:gap-6. Таблица стилей от этого тяжелеет.
Шрифты, подключённые из CSS, ссылаются обратно в node_modules и загрузку не переживают. Пресет shadcn по умолчанию приносит Geist, поэтому в .design-sync/config.json его стилевой файл перечислен в extraFonts: синк копирует файлы woff2 в зеркало и переписывает правила @font-face. Путь считается от каталога пакета, поэтому записан полностью, с ./node_modules/ в начале. Там же лежат входной файл, глобальное имя бандла, каталог конфигурации Storybook, команда сборки (она компилирует CSS и генерирует типы) и путь к файлу правил. После первого запуска синк дописывает в конфиг projectId, и повторные синки обновляют ту же дизайн-систему вместо создания новой.
Файл правил, на который указывает поле readmeHeader, попадает в README зеркала. Автор называет его самым дешёвым способом поднять качество: превью показывают Claude, как выглядят компоненты, а правила говорят, как ими пользоваться. В примере это несколько строк: провайдера темы нет, токены лежат CSS-переменными на :root, компоненты вручную не стилизуют, className нужен только для раскладки, Card собирают из CardHeader, CardTitle, CardContent и CardFooter. Без таких правил, по словам автора, Claude видит правильный Button и всё равно пишет <Button className="bg-blue-600 px-4">. На первом запуске синк сам дописывает в файл таблицу утилит, которые реально есть в скомпилированном CSS. Таблица и блок @source inline(...) описывают один и тот же набор классов, и при правке одного приходится править второе, иначе Claude пишет классы, которые ничего не делают.
В репозиторий идут конфиг, файл правил и NOTES.md, куда синк записывает выученное, чтобы следующий запуск не выяснял это заново. ds.css и всё сгенерированное (dist/, ds-bundle/, .ds-sync/ и служебные каталоги внутри .design-sync/) уходят в .gitignore; свои записи туда синк добавляет сам.
Зачем синку Storybook
Перед загрузкой синк открывает каждое превью в настоящем браузере, снимает скриншот и оценивает его. Без Storybook у компонента сначала есть только карточка-заглушка, и сравнивать её не с чем: синк ищет явные сбои вроде пустого или почти пустого превью и одинаково выглядящих вариантов, а Claude оценивает карточки по рубрике. Со Storybook истории становятся одновременно превью и эталоном. Claude сравнивает каждое превью с историей бок о бок, ставит match, close или mismatch и до загрузки чинит, что может. Оценку close автор считает сигналом продолжать исправления. В его примере все девять историй трёх компонентов получили match. Claude может проверить только основную историю компонента и доверять остальным, если она чистая: все они проходят через один конвейер.
Чтобы сверка работала, нужны три вещи. Истории сопоставляются с компонентами по title, и часть заголовка с именем компонента должна совпадать с экспортированным именем символ в символ. По умолчанию синк берёт до шести историй на компонент; вариант без истории в Claude Design попадёт, но проверять его никто не будет. И в .storybook/preview.tsx нужна строка import '../src/index.css';, которую Storybook сам не добавляет. Без неё эталонные скриншоты тоже выходят без стилей, и match значит лишь, что нестилизованное превью совпало с нестилизованным эталоном.
Для скриншотов синку нужен Playwright с Chromium. Проверки поднимают локальный сервер и управляют браузером, и включённая песочница Bash в Claude Code блокирует и то и другое. Автор отключает её командой /sandbox на время запуска или выполняет шаг захвата сам, когда синк это предлагает. Перед загрузкой синк останавливается и ждёт подтверждения.
Большинство провалов автор сводит к четырём случаям:
- Всё без стилей: таблица стилей приехала без токенов, потому что команда сборки не отработала или файл токенов импортирован через
url(). - Компоненты в порядке, раскладка разваливается: в CSS нет утилит разметки, и блок
@source inline(...)нужно расширить. - Формы верные, шрифты чужие: шрифты не доехали, и их нужно перечислить в
extraFonts. - Компонент выглядит не так, хотя со стилями всё в порядке. Выпадающее меню по умолчанию закрыто, и превью стоит направить на историю с открытым состоянием; Input на всю ширину в превью выходит шире, чем на холсте Storybook.
Последний случай автор приводит как причину читать оценки самому: грейдер не скажет, что безупречный скриншот снят не с того состояния.
Зеркало обновляется вручную
Зеркало - снимок. Изменение компонента в коде ничего не меняет в Claude Design до следующего /design-sync, и даже повторный синк подчищает не всё: удалённый из библиотеки компонент может остаться в зеркале, поэтому после удаления стоит проверить список файлов. Синк работает в одну сторону, из кода в Claude Design. Готовый дизайн обратно в код переносит отдельный сценарий с командой /design в Claude Code.
Загруженная система появляется в аккаунте в разделе Settings > Design systems и доступна в любом разговоре с Claude, включая Claude Code. На Pro и Max она личная. На Team и Enterprise публикация делает её системой организации, и её подхватывают все последующие работы; админы Enterprise могут ограничить круг тех, кто публикует, назначить систему по умолчанию или удалить её. Сам Claude Design вышел 17 апреля как research preview Anthropic Labs для подписчиков Pro, Max, Team и Enterprise.
В монорепозитории entry указывают полным путём от корня репозитория, например packages/design-system/src/index.ts, а cssEntry остаётся относительным к каталогу пакета и записывается просто как ds.css. Перепутанная база выглядит как ошибка о пропавшем файле. Пути в extraFonts по той же логике поднимаются к корневому node_modules через ../../, по одной записи на каждый стилевой файл Fontsource.
Если Storybook импортирует токены через url(), для синка заводят отдельный CSS-вход со строковым импортом, и его тоже коммитят. Две копии расходятся молча: правило @layer base, добавленное в оригинал, копия не получит и продолжит отрисовывать старый дизайн. Поэтому автор советует сравнивать оба файла перед каждым повторным синком.
Дальше
Claude Code 2.1.286 считает стопку запросов на разрешение
«2 of 5»: такой счётчик Claude Code 2.1.286 показывает на запросах разрешений, когда их накапливается несколько, и сразу видно, сколько подтверждений осталось до продолжения работы.
Читайте также
- Отдельный Claude Design закроют 14 декабря 2026 года
- Tokendoctor обещает тот же Claude Code до 38% дешевле
- Память и навыки Claude Code получили git-историю в memsaga
- intent-lens объясняет команды Claude Code до их запуска
- Codedict срезал токены Claude Code на 63%, а счёт на 26%
- Дерево файлов покажет, что читает и правит Claude Code
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

