클로디 디자인 "디자인 시스템" 업로드 과정
2026.07.22
오늘 진행한 프로젝트(designlang 추출 → 토큰 교정 → 디자인 시스템 문서화 → claude.ai/design 업로드)를 사례 발표 양식에 맞춰 정리했습니다. 아래 내용을 그대로 복사해 쓰시면 됩니다.
소개 — 시도하고자 했던 것과 그 이유
"좋아하는 웹사이트의 디자인을, 감(感)이 아니라 실제 규칙으로 뽑아내 내 것으로 만들 수 있을까?" 를 실험했습니다.
평소 디자인 레퍼런스를 볼 때 "이 느낌 좋다"에서 멈추고, 막상 내 작업에 옮기려면 색·폰트·여백을 일일이 눈대중으로 따야 했습니다. 이번엔 국내 이메일 마케팅 서비스 스티비(stibee.com) 를 대상으로 삼아, ① 디자인 토큰을 자동 추출하고 → ② 추출 노이즈를 사람이 교정하고 → ③ 실제 상세페이지 컴포넌트와 PPTX 규칙에 매핑한 디자인 시스템으로 완성한 뒤 → ④ claude.ai/design에 팀이 함께 쓸 수 있는 프로젝트로 올리는 것까지 한 흐름으로 해봤습니다.
목표는 "예쁜 결과물 하나"가 아니라, 재사용 가능한 브랜드 규칙 자산을 만드는 것이었습니다.
진행 방법 — 어떤 도구를 어떻게 활용했나
사용 도구: Claude Code · designlang(오픈소스 디자인 추출 CLI) · claude.ai/design(디자인 시스템 호스팅)
전체 흐름은 4단계였습니다.
1) 환경 확인 & 자동 추출 — Node.js 설치를 확인하고, 헤드리스 브라우저로 실제 렌더된 CSS를 훑는 designlang을 돌렸습니다. URL 하나로 색·폰트·간격·모션·컴포넌트를 35개 포맷(디자인 토큰 JSON, Tailwind, Figma 변수 등)으로 뽑아줍니다.
npx designlang https://stibee.com
추출 결과 핵심 토큰: 원색 #ff6464, 서체 Pretendard, 머티리얼 flat, 컴포넌트 라이브러리 Ant Design.
2) 추출 노이즈 교정 — 여기가 이번 프로젝트의 핵심이었습니다. 빈도 기반 자동 추출이라 잘못 잡힌 값이 많았고, 이걸 Claude에게 짚게 했습니다. 사용한 프롬프트:
방금 designlang이 뽑은 결과를 바탕으로, 이 도구가 무엇을·어떻게·왜 하는지
직관적으로 설명해줘. 그리고 추출된 핵심 토큰(색·폰트·여백·컴포넌트)을 요약하고,
믿을 수 없는 노이즈(예: 이모지가 폰트로 잡히는 것)가 있으면 짚어줘.
실제로 걸러낸 노이즈 7건: 아이콘 폰트(stibeeicon10)가 서체로 오인, 본문 크기가 44px(실제 14px)로 잡힘, 흰 글자 on #ff6464가 대비 2.9:1로 WCAG 실패, 간격에 난수성 값 혼입 등.
3) 디자인 시스템 문서화 — 교정본을 실제 컴포넌트와 PPTX 규칙에 매핑해 하나의 HTML로 묶었습니다.
designlang이 뽑아준 토큰과 브랜드 문서를 원본 초안으로 삼아:
1. 추출 노이즈(폰트·색 대비 등) 교정하고 대안 제시
2. 이 토큰을 상세페이지(HTML) 실제 컴포넌트(히어로/가격표/CTA/카드/뱃지)에 매핑
3. PPTX 카탈로그용 규칙(표지·본문 슬라이드 색/폰트/여백) 별도 정리
4. 위를 하나의 HTML로 묶어 한눈에 살펴보게 해줘
4) claude.ai/design 업로드 — 컴포넌트별로 파일을 쪼개고 각 미리보기 HTML 첫 줄에 @dsCard 마커를 넣어, Design System 패널에 카드로 자동 등록되게 했습니다.
<!-- @dsCard group="Components" name="히어로" width="900" height="460" -->
이렇게 준비한 11개 파일(Foundations 3 + Components 5 + 토큰 2 + README)을 "우리 브랜드 디자인 시스템" 프로젝트로 새로 만들어 올렸습니다.
📸 캡처 남길 자리: ① designlang 실행 로그(35개 파일 생성 화면) ② 디자인 시스템 HTML 전체 뷰(색·타이포·컴포넌트) ③ claude.ai/design에 카드로 정리된 프로젝트 화면 — 이 3장을 넣으면 흐름이 한눈에 보입니다.
결과와 배운 점
결과물: 스티비 브랜드를 교정된 토큰 → 상세페이지 컴포넌트 5종 → PPTX 규칙 → claude.ai/design 팀 자산까지 한 번에 연결한 디자인 시스템 파이프라인을 완성했습니다.
배운 점 & 꿀팁
자동 추출은 '초안'이지 '정답'이 아니다. 가장 큰 교훈이었어요. 툴이 뽑은 토큰을 그대로 믿으면 안 되고, 특히 색 대비·아이콘 폰트·본문 크기는 반드시 사람이 검증해야 합니다. Claude에게 "믿을 수 없는 노이즈를 짚어줘"라고 의심을 명시적으로 시키는 프롬프트가 결정적이었습니다.
접근성은 대안까지 세트로.
#ff6464가 대비 실패라는 지적에서 끝내지 않고, 텍스트용 강화색#d92d2d(4.8:1 통과)를 분리해 "원색은 장식, 강화색은 텍스트"라는 규칙으로 정리하니 실무에 바로 쓸 수 있었습니다.결과물은 '재사용 단위'로 쪼개라. 통짜 HTML보다
@dsCard카드 단위로 나누니 claude.ai/design에서 컴포넌트별로 관리·증분 업데이트가 가능해졌습니다.
시행착오
npx designlang마지막 단계에서 "Extraction failed" 오류가 떴는데, 알고 보니 툴 자체 버그로 마무리 단계 하나만 실패한 것이고 결과 파일 35개는 정상 생성돼 있었습니다. → 오류 메시지에 놀라기 전에 실제 산출물을 먼저 확인하는 습관.한글 사이트를 영어 휴리스틱으로 분석해 CTA 동사를 엉뚱하게
saas로 뽑는 등, 언어 불일치로 인한 오분류도 있었습니다.
도움이 필요한 부분
지금은 Pretendard가 뷰어 PC에 설치돼 있어야 정확히 보이는데(없으면 시스템 폰트로 폴백), 웹폰트를 안전하게 임베드(self-host / data URI) 하는 실무 팁이 있으면 공유 부탁드립니다.
앞으로의 계획
버튼·인풋·내비게이션 등 컴포넌트를 추가해 디자인 시스템을 확장하고, 실제 상세페이지 1개를 이 토큰만으로 처음부터 끝까지 만들어보려 합니다.
도움 받은 글 (옵션)
designlang(오픈소스 디자인 추출 도구) —npx designlang <URL>DESIGN.md 컨벤션 / DTCG(Design Tokens) 표준 포맷
(여기에 참고한 지피터스 글이나 스티비 브랜드 페이지 링크를 추가하세요)
발표용이라 캡처 3장 자리를 본문에 표시해 뒀습니다. 필요하시면 이 사례글을 지피터스에 바로 붙일 수 있도록 이미지 없는 순수 텍스트 버전이나, 더 짧은 요약 버전으로도 정리해 드릴게요.
로그인하고 댓글을 남겨 주세요
자동 추출 결과를 그대로 사용하지 않고 아이콘 폰트 오인식, 본문 크기 오류, 색 대비 실패까지 7건의 노이즈를 직접 검증해 교정하신 과정이 특히 인상적이었습니다. 원색과 텍스트용 강화색을 분리해 접근성 기준을 실제 디자인 규칙으로 연결하고, 컴포넌트를 @dsCard 카드 단위로 나눠 11개 파일의 팀 자산으로 완성하신 점도 정말 실용적이네요.



실습 잘 따라와주셔서 감사합니다~ 다음주 사례 발표도 기대하겠습니다 ㅎㅎ