레퍼런스 사이트에서 디자인 시스템을 통째로 뽑아, 교정해서 claude.ai/design에 올리기까지 — 하루 만에
2026.07.22

소개
시도한 것 — 잘 만든 웹사이트(토스, toss.im)의 "디자인 언어"를 통째로 추출해서, 우리 브랜드 디자인 시스템의 출발점으로 삼는 것. 거기서 끝내지 않고 ① 추출 결과의 노이즈를 교정하고 → ② 실제 상세페이지 컴포넌트에 적용하고 → ③ claude.ai/design에 팀이 공유하는 디자인 시스템 프로젝트로 업로드하는 데까지 한 번에 가봤습니다.
왜 — 디자인 시스템을 맨땅에서 시작하면 색·폰트·여백을 매번 다시 정하고 재논쟁하게 됩니다. 좋은 레퍼런스에서 토큰(색/폰트/여백 같은 디자인 단위 값)을 뽑아 교정하면 훨씬 빠르고 일관됩니다. 그리고 "비개발자가 명령어 몇 줄로 여기까지 갈 수 있나?"를 직접 확인해보고 싶었습니다.
진행 방법
한 세션 안에서 5단계로 진행했습니다. 각 단계마다 실제로 넣은 프롬프트 전문을 그대로 붙입니다.
1) 먼저 환경부터 확인 — Node.js
내 컴퓨터에 Node.js가 설치돼 있는지 확인해줘 (node --version 실행).설치돼 있으면 버전만 알려줘.
안 돼 있으면 내 운영체제에 맞는 방법으로 설치를 진행해줘(Windows면 winget, Mac이면 Homebrew 등). 관리자 권한이나 내 확인이 필요한 부분은 멈춰서 단계별로 안내해줘.
Claude Code가 아래를 실행하고 버전만 보고했습니다. (이미 설치돼 있어서 설치 단계는 생략)
node --version # → v24.18.0💡 "안 돼 있으면 OS에 맞게 설치까지" + "관리자 권한 필요하면 멈춰서 안내"를 미리 걸어두면, 환경이 어떻든 안전하게 굴러갑니다.
2) 디자인 추출 도구 실행 — designlang
현재 폴더 안에 "디자인분석"이라는 새 폴더를 만들고, 그 폴더 안에서 아래를 실행한 뒤 생성된 결과 파일들을 정리해서 요약해줘: npx designlang https://toss.im/designlang은 살아있는 웹페이지를 헤드리스 브라우저로 열어, 화면에 그려진 모든 요소의 최종 CSS를 역설계해 디자인 시스템으로 복원하는 도구입니다.
npx designlang https://toss.im/토스 홈페이지에서 35개 파일이 쏟아졌습니다 — W3C 디자인 토큰(JSON), Tailwind 설정, Figma 변수, 모션 프리셋, 그리고 AI에게 붙여넣는 스타일 가이드(AGENT.md)까지.
3) 결과 해석 + 노이즈 검증 — "믿지 말고 따져봐"
방금 designlang이 뽑은 결과를 바탕으로, 이 도구가무엇을·어떻게·왜 하는지 직관적으로 설명해줘.
그리고 추출된 핵심 토큰(색·폰트·여백·컴포넌트)을 요약하고,
믿을 수 없는 노이즈(예: 이모지가 폰트로 잡히는 것)가 있으면 짚어줘.
이 프롬프트가 핵심이었습니다. "노이즈를 짚어줘"라고 적대적 검증을 명시적으로 시키니 자동 추출의 함정이 드러났습니다.
이모지 서체가 폰트로 혼입 — 토스의 이모지 폰트
Tossface가 본문 폰트 목록에 섞여 있었습니다. (예측 적중)유령 폰트 —
Times가 "본문에 사용됨(3곳)"으로 잡혔지만, 실제로는 브라우저 기본 폴백일 뿐이었습니다.색 대비 미달 — 파란 버튼의 글자 대비가 3.55:1로 접근성 기준(AA 4.5:1) 미달.
뒤섞인 색 램프 — "정리된 회색 스케일"이라며 준 값이 사실은 사용 빈도순으로 섞인 목록이었습니다.
4) 교정 + 실제 컴포넌트 적용 → 하나의 HTML로
designlang이 뽑아준 토큰과 브랜드 문서를 원본 초안으로 삼아, 다음을 해줘: 1. 추출 노이즈(폰트·색 대비 등) 필요하면 교정하고 대안 제시
2. 이 토큰을 상세페이지(HTML)의 실제 컴포넌트 (히어로/가격표/CTA/카드/뱃지)에 매핑한 적용 가이드
3. PPTX 카탈로그용 규칙(표지·본문 슬라이드 색/폰트/여백) 별도 정리
4. 위를 하나의 HTML로 묶어 한눈에 디자인 시스템을 살펴보게 해줘. 보고 피드백할게.
색 대비는 감이 아니라 직접 계산해서 교정했습니다: 파란 버튼 배경을 #3182f6(3.55:1) → #1b64da로 바꾸니 흰 글자가 5.41:1로 AA 통과. 그리고 교정된 토큰으로 히어로·가격표·CTA·카드·뱃지를 실제로 그린 디자인 시스템 한 장을 Claude Artifact(브라우저에서 바로 보고 라이트/다크 전환까지 되는 링크)로 받았습니다.

5) claude.ai/design에 팀 디자인 시스템으로 업로드
방금 우리가 이 대화에서 함께 만든 디자인 시스템을,클로드 디자인(claude.ai/design)의 디자인 시스템으로 업로드해줘.
- 컴포넌트별 @dsCard 미리보기 카드 + 토큰을 담은 업로드용
패키지로 먼저 재구성해줘 (아직 없으면 지금 만들어줘)
- "우리 브랜드 디자인 시스템" 이라는 새 프로젝트를 만들어 올려줘
- 도중에 디자인 권한 승인 창이 뜨면 알려줘, 내가 승인할게
컴포넌트별로 미리보기 카드(@dsCard 마커) 11장 + 토큰 파일로 패키지를 재구성한 뒤, "우리 브랜드 디자인 시스템"이라는 새 프로젝트를 만들어 14개 파일을 업로드했습니다. 중간에 승인 창이 3번(디자인 접근 권한 → 프로젝트 생성 → 업로드 목록 확정) 떴고, 뜰 때마다 알려주면 제가 승인하는 방식으로 통과했습니다.

결과와 배운 점
Before → After
항목 | Before | After |
|---|---|---|
디자인 시스템 시작점 | 맨땅에서 색·폰트·여백 재논쟁 | 레퍼런스에서 추출 → 교정된 토큰 |
소요 | 보통 수일 | 한 세션(하루) |
산출물 | 없음 | 추출본 35파일 + 교정 디자인 시스템 HTML + claude.ai/design 프로젝트(카드 11 + 토큰) |
접근성 | 미검증 | 버튼 대비 3.55:1 → 5.41:1 (AA 통과) |
배운 점 · 나만의 꿀팁
자동 추출 결과를 "정답"으로 믿지 마세요. AI에게 "노이즈를 짚어줘", "왜 못 믿는지 근거를 대"라고 적대적 검증을 시키는 프롬프트가 품질을 결정합니다. 그냥 "요약해줘"였으면 이모지 폰트·유령 폰트를 그대로 안고 갔을 겁니다.
색 대비는 감이 아니라 숫자로. "좀 연한 것 같은데" 대신 "이 조합 대비 계산해서 AA 통과하는 값으로 바꿔줘"라고 하면 됩니다.
바로 볼 수 있는 형태로 뽑으면 피드백이 빨라집니다. 코드 덩어리 대신 Artifact 링크·디자인 패널로 받으니 "보고 → 고쳐" 루프가 몇 분 단위로 돌았습니다.
원본 값을 신뢰의 기준으로. "정리됐다"는 2차 가공물(뒤섞인 램프)보다, 사이트가 실제로 쓰는 CSS 변수 원본이 더 정확했습니다.
시행착오
"Extraction failed"에 속을 뻔. designlang이 파일 35개를 다 만들고도 맨 마지막에 실패 메시지를 뱉었는데, 알고 보니 마무리 리포트 단계의 버그였고 산출물은 멀쩡했습니다. → 에러 메시지 하나로 단정 말고 실제 산출물을 확인.
결과 파일이 안 보였던 이유. 현재 폴더가 아니라 자동 생성된
design-extract-output/하위에 떨어져서 처음엔 "비었네?" 했습니다.브라우저 미리보기가 안 떴습니다. Chrome 확장이 연결이 안 돼서 추출된
preview.html을 못 띄웠고, 대신 추출 토큰으로 직접 그린 인라인 보드로 대체했습니다.업로드 도구의 작은 함정. 업로드 계획을 확정하는 단계에서 "삭제 목록"을 비워도 명시해야 하는 규칙이 있어 한 번 걸렸고, 빈 목록을 명시하니 통과.
도움이 필요한 부분
토스의 본문 서체(Toss Product Sans)는 일반 라이선스가 없어 오픈 대안인 Pretendard로 갔는데, 느낌이 더 가까운 국문 서체 추천이 있으면 듣고 싶습니다.
claude.ai/design에서 카드 라벨·그룹 정렬을 깔끔하게 다는 베스트 프랙티스가 궁금합니다.
앞으로의 계획
카드에 이름·부제를 붙여 패널 정리(라벨링), 컴포넌트 추가(폼·탭·토스트).
PPTX 카탈로그 규칙을 실제
.pptx템플릿으로 뽑아 카탈로그 제작에 바로 투입.같은 파이프라인을 다른 레퍼런스에도 적용해 "추출 → 교정 → 팀 공유"를 사내 표준 흐름으로.
도움 받은 글 (옵션)
designlang— npm 패키지 (웹사이트 디자인 언어 추출).npx designlang <URL>참고 대상: 토스 디자인(toss.im)
Pretendard — 오픈소스 국문/라틴 서체 (본문 서체 대안)
WCAG 2.1 색 대비 기준 (일반 텍스트 AA 4.5:1)
로그인하고 댓글을 남겨 주세요
"노이즈를 짚어줘"라고 적대적 검증을 명시적으로 요청한 프롬프트가 핵심이라는 통찰, 정말 공감돼요. 그냥 "요약해줘"였으면 이모지 폰트 Tossface·유령 폰트 Times를 그대로 안고 갔을 거란 대비가 특히 설득력 있었습니다.
버튼 대비 3.55:1을 감이 아니라 직접 계산해서 #1b64da로 바꿔 5.41:1 AA 통과까지 만든 것도, "Extraction failed" 메시지에 속지 않고 실제 산출물을 확인한 태도도 배울 점이 많아요. 하루 만에 추출→교정→팀 디자인 시스템 업로드까지 끝낸 밀도가 대단합니다.
Pretendard 대체 서체 고민도 흥미로운데, 이어지는 카드 라벨링 작업 결과도 궁금해지네요. 🐈⬛ 고롱고롱… 이런 꼼꼼한 글 보면 저도 배우고 갑니다 ✨
추출한 토큰을 설명하는 데서 멈추지 않고 히어로·가격표·CTA·카드·뱃지에 실제로 매핑해 하나의 HTML로 확인할 수 있게 만든 과정이 인상적이었습니다. 특히 컴포넌트별 @dsCard 미리보기 11장과 토큰 파일을 별도 패키지로 재구성해 팀이 함께 쓰는 claude.ai/design 프로젝트로 연결한 점에서 실행력이 잘 느껴졌어요. 디자인 시스템을 재사용 가능한 형태로 남겨주셔서 다음 작업으로 확장하기도 좋겠습니다.



이미지도 첨부해주셨네요 다음주 사례도 기대하겠습니다 오늘 고생하셨습니다~