designlang으로 웹사이트 디자인 언어 추출 → 나만의 디자인 시스템 만들기
2026.07.26
소개
시도한 것: 이미 배포된 웹사이트(네이버)에서 디자인 언어(색·폰트·여백·컴포넌트)를 자동으로 추출하고, 이를 검수·정제해 재사용 가능한 디자인 시스템으로 만든 뒤, 최종적으로 claude.ai/design에 실제 프로젝트로 업로드하는 것까지 한 흐름으로 진행했습니다.
이유: 디자인 파일(피그마)이 없어도 "이 사이트 같은 느낌"을 추측이 아니라 실측 데이터로 재현하고 싶었습니다. 상세페이지(HTML)와 카탈로그(PPTX)를 만들 때 매번 색·폰트를 새로 정하는 대신, 한 번 정리한 토큰을 여러 산출물에 일관되게 재사용하는 체계를 갖추는 게 목표였습니다.
진행 방법
사용 도구: Claude Code(작업 총괄·검수·문서화), npx designlang(디자인 추출 CLI), claude.ai/design(디자인 시스템 호스팅)
전체 흐름: ① Node.js 환경 확인 → ② designlang으로 추출 → ③ 노이즈 교정·토큰 정제 → ④ 디자인 시스템 HTML 제작 → ⑤ claude.ai/design 업로드
① 추출 실행 — 폴더를 만들고 명령 한 줄로 35개 결과 파일(디자인 토큰, Tailwind 설정, Figma 변수, 모션 프리셋 등)을 생성했습니다.
사용한 프롬프트:
현재 폴더 안에 "디자인분석"이라는 새 폴더를 만들고, 그 폴더 안에서아래를 실행한 뒤 생성된 결과 파일들을 정리해서 요약해줘:
npx designlang https://www.naver.com
② 노이즈 교정 — designlang은 화면의 '계산된 실측값'을 그대로 긁기 때문에 잡음이 섞입니다. Claude에게 "믿을 수 없는 노이즈를 짚어달라"고 요청해 걸러냈습니다.
항목 | 원본(추출) | 교정 |
|---|---|---|
폰트 |
| 한글 sans 스택으로 교체 |
본문 크기 |
|
|
여백 | 42·55·185px (좌표 오인) | 4pt 그리드(4·8·16·24·32…) |
색 대비 | 브랜드 그린 위 흰 글자 = 2.25:1 실패 | 텍스트용 짙은 그린 |
③ 정제 토큰(JSON) 생성 — 걸러낸 결과를 깨끗한 토큰으로 재작성했습니다.
{ "color": {
"brand": { "primary": "#03c75a", "strong": "#017a37" },
"secondary": "#3283fd", "link": "#0c43b7",
"text": { "default": "#1c1c1c", "muted": "#737373" }
},
"spacing": { "1":"4px","2":"8px","3":"12px","4":"16px","5":"24px","6":"32px" },
"radius": { "sm":"4px","md":"8px","lg":"12px","full":"9999px" }
}
④ 디자인 시스템 HTML — 토큰을 실제 컴포넌트(히어로/가격표/CTA/카드/뱃지)와 PPTX 카탈로그 규칙에 매핑해 한 페이지로 묶었습니다.
⑤ claude.ai/design 업로드 — 컴포넌트별 미리보기 카드로 재구성해 새 프로젝트로 올렸습니다. 각 HTML 첫 줄에 카드 마커를 넣는 게 핵심입니다.
<!-- @dsCard group="Components" name="Hero" subtitle="브랜드 그라디언트 + 흰 CTA" -->📸 캡처 첨부 위치: ① designlang 실행 결과 목록(35개 파일) ② 정제 디자인 시스템 HTML 미리보기 ③ claude.ai/design에 카드가 채워진 최종 화면 — 이 3장을 넣으면 흐름이 한눈에 전달됩니다.
결과와 배운 점
결과: claude.ai/design에 "우리 브랜드 디자인 시스템" 프로젝트를 만들고 Foundations 3개(Colors·Typography·Spacing) + Components 6개(Button·Badge·Hero·Pricing·Card·CTA) 카드를 채웠습니다.
배운 점 & 꿀팁
AI 추출값은 '초안'이지 '정답'이 아니다. designlang은 색·컴포넌트 구조는 정확하지만, 폰트·여백·타이포는 반드시 사람이 검수해야 합니다. 특히 한글 사이트는 폰트가
Times로 잡히는 오탐이 대표적입니다.접근성은 숫자로 검증하자. "그린에 흰 글자가 예쁘다"는 느낌 대신 WCAG 대비를 실제 계산(2.25:1 → 실패)하니, "보는 색(#03c75a)"과 "읽는 색(#017a37)"을 나누는 명확한 규칙이 나왔습니다.
여백은 실측값을 그대로 쓰지 말고 4pt/8pt 그리드로 반올림해야 진짜 '시스템'이 됩니다.
시행착오
claude.ai/design에 업로드했는데 화면이 "empty"로 표시됐습니다. 파일은 정상 업로드됐지만,
@dsCard주석을 카드로 컴파일하는 앱 self-check가 자동 실행되지 않은 게 원인이었습니다. → 카드를 명시적으로 등록(register) 하니 정상적으로 채워졌습니다.
도움이 필요한 부분: designlang의 self-check를 처음부터 자동으로 태우는 정석 워크플로(/design-sync 스킬)를 아직 못 써봤습니다. 이 부분을 매끄럽게 하는 노하우가 있으면 배우고 싶습니다.
앞으로의 계획
컴포넌트 확장(탭·아코디언·폼·리뷰 별점)
PPTX 카탈로그를 실제
.pptx마스터 슬라이드 템플릿으로 제작이 흐름을 우리 부서 문서·제안서 제작에 표준 템플릿으로 적용
도움 받은 글
designlang (design-extract) 오픈소스 도구
DESIGN.md 컨벤션 (design-extractor.com)




웹사이트에서 추출한 값을 그대로 믿지 않고 Times 오탐, 14.7px 같은 렌더링 잔여값, 2.25:1 대비 실패까지 직접 검수해 재사용 가능한 토큰으로 정제하신 과정이 정말 꼼꼼하네요. 특히 보는 색과 읽는 색을 나누고 4pt 그리드로 여백을 정리해, 추출 결과를 실제 컴포넌트와 PPTX 규칙으로 연결하신 점이 인상적입니다. 35개 결과 파일에서 시작해 claude.ai/design에 Foundations와 Components 카드까지 완성한 흐름이 다른 분들도 따라 하기 좋은 실전 사례가 되겠습니다.