Claude Design으로 디자인시스템 만들어보기
2026.07.22
소개
경쟁사·레퍼런스 사이트를 볼 때마다 "이 색, 이 폰트, 이 여백감을 우리 사이트에도 써먹고 싶다"는 생각은 들지만, 실제로는 개발자 도구 열어서 색상 하나하나 스포이드로 찍고 폰트 확인하고… 하는 게 너무 번거로웠습니다.
그래서 이번엔 실제 웹사이트(지피터스 홈페이지, gpters.org)를 대상으로 디자인 시스템을 자동으로 추출 → 노이즈 교정 → 실제 컴포넌트/PPTX 규칙까지 매핑 → Claude Design에 바로 업로드하는 과정을 Claude Code로 한 세션에서 끝까지 해봤습니다. "AI가 뽑아준 토큰을 얼마나 믿고 바로 써도 되는가"를 확인해보고 싶었던 것도 이유 중 하나입니다.
진행 방법
사용 도구
designlang (npx CLI, Playwright 기반 디자인 토큰 추출 도구)
Claude Code (추출 → 노이즈 검증 → HTML 아티팩트 제작 → Claude Design 업로드까지 에이전트로 진행)
① 추출 실행
→ color/font/spacing/radius/shadow/motion 등 34개 파일이 한 번에 생성됩니다. (표지/미리보기 이미지 첨부 위치)
② 노이즈 짚어내기
→ 실제로 폰트가 "Apple Color Emoji"로 잘못 잡혀 있었고, 그 외에도 대비율 실패·토큰 이름 중복 등을 찾아냈습니다.
③ 교정 + 실전 매핑
→ 결과물: gpters.org 디자인 시스템 감사 (스크린샷 첨부 위치)
④ Claude Design에 업로드
→ Foundations / Components / PPTX Catalog 3개 그룹, 12개 파일로 재구성해 실제 Claude Design 프로젝트로 업로드까지 완료. (Claude Design 프로젝트 화면 스크린샷 첨부 위치)
결과와 배운 점
배운 점 / 꿀팁
자동 추출값을 곧이곧대로 쓰면 안 된다. 이모지가 많은 사이트는 폰트가 이모지 폴백으로 오분류되기 쉽습니다 — 실제 CSS 변수(variables.css) 원본과 꼭 대조해야 합니다.
대비(contrast) 문제는 새 색을 만들 필요 없이, 사이트가 이미 갖고 있는 hover/pressed 색상에서 답을 찾을 수 있는 경우가 많습니다. 실제로 #eb5a10(대비 3.5:1, WCAG 실패)을 이미 정의돼 있던 hover 색 #d34600으로 바꾸니 4.52:1로 통과했습니다.
"추출된 것"과 "제안된 것"을 반드시 구분해서 표시하세요. 가격표 컴포넌트는 원본 사이트에 없어서 도구가 못 잡아냈고, 카드/버튼/뱃지 토큰만으로 새로 조립한 "제안"임을 명확히 표시했습니다.
(사소하지만) 맥에서 한글 폴더명으로 작업할 때 로케일이 C로 잡혀있으면 셸이 깨집니다 — LANG=en_US.UTF-8 지정 필요.
시행착오
designlang이 34개 파일을 전부 정상 생성한 뒤에도 마지막 후처리 단계에서 에러를 던지며 종료 코드 1을 반환했습니다. 처음엔 "실패했나?" 했지만 실제 출력 폴더를 열어보니 결과물은 멀쩡했습니다 → 종료 코드만 보고 판단하지 말고 실제 산출물을 확인하는 습관이 필요합니다.
도움이 필요한 부분
사이트가 업데이트될 때마다 이 추출→교정 파이프라인을 어떻게 최소한의 수작업으로 재실행/재검증할지 (diff 자동화) 고민 중입니다. 비슷하게 해보신 분 계시면 공유 부탁드려요!
앞으로의 계획
같은 파이프라인을 팀의 다른 사이트/서비스에도 적용해보고, Claude Design 쪽 컴포넌트 그룹(@dsCard)도 점점 늘려나갈 예정입니다.
도움 받은 글 (옵션)
designlang CLI 소개 (PyTorch Korea 커뮤니티) — designlang 도구를 처음 알게 된 글
designlang GitHub
로그인하고 댓글을 남겨 주세요
#eb5a10을 새로 만들지 않고 이미 있던 hover 색 #d34600으로 바꿔서 3.5:1을 4.52:1로 통과시킨 부분이 제일 인상적이었어요. 새 색을 짓지 않고 사이트 안에서 답을 찾는 발상이 좋네요.
designlang 종료 코드 1에 속을 뻔했다가 실제 산출물은 멀쩡했다는 시행착오도 다른 분들께 바로 도움 될 것 같아요. "추출된 것"과 "제안된 것"을 구분해서 표시한 것도 꼼꼼함이 느껴집니다.
업데이트마다 재실행/재검증하는 diff 자동화, 진행되면 후속 글도 궁금해요! 🐈⬛ 고롱고롱… 꼼꼼한 검증 글 보면 기분 좋아져요 ✨
오 직접 글을 수정하셨는지 기본적으로 학습된 프롬프트가 있는지 초반 글이 사람이 쓴 것 같이 잘 나왔네요 실습 잘 따라와주셔서 감사합니다




디자인 토큰을 추출하는 데서 멈추지 않고 노이즈를 교정한 뒤 Foundations·Components·PPTX Catalog 3개 그룹, 12개 파일로 재구성해 Claude Design 업로드까지 한 세션에 완성하신 흐름이 정말 인상적입니다. 특히 Apple Color Emoji로 잘못 잡힌 폰트를 실제 CSS 변수와 대조해 바로잡은 과정을 함께 보여주셔서, 자동 추출 결과를 어디까지 검증해야 하는지 다른 분들도 명확하게 참고할 수 있겠어요. 번거로운 작업을 재사용 가능한 실전 과정으로 정리해 주셔서 감사합니다.