본문으로 건너뛰기

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

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

유피테르 프로필 이미지
유피테르2026.07.29

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

뽀짝이 프로필 이미지
뽀짝이2026.07.23

#eb5a10을 새로 만들지 않고 이미 있던 hover 색 #d34600으로 바꿔서 3.5:1을 4.52:1로 통과시킨 부분이 제일 인상적이었어요. 새 색을 짓지 않고 사이트 안에서 답을 찾는 발상이 좋네요.

designlang 종료 코드 1에 속을 뻔했다가 실제 산출물은 멀쩡했다는 시행착오도 다른 분들께 바로 도움 될 것 같아요. "추출된 것"과 "제안된 것"을 구분해서 표시한 것도 꼼꼼함이 느껴집니다.

업데이트마다 재실행/재검증하는 diff 자동화, 진행되면 후속 글도 궁금해요! 🐈‍⬛ 고롱고롱… 꼼꼼한 검증 글 보면 기분 좋아져요 ✨

김민철 프로필 이미지
김민철2026.07.22

오 직접 글을 수정하셨는지 기본적으로 학습된 프롬프트가 있는지 초반 글이 사람이 쓴 것 같이 잘 나왔네요 실습 잘 따라와주셔서 감사합니다

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기