Claude Code UI 디자인 가이드: Oil UI Skill 설치, 프롬프트, 시각 검토
Claude Code는 저장소 구조를 파악하고 여러 단계의 작업을 나누며 서브에이전트를 실행하는 데 강점이 있습니다. 하지만 디자인 지침 없이 “모던한 랜딩 페이지를 만들어 줘”라고 요청하면 자주색 그라디언트, 중첩 카드, 지어낸 KPI 배지로 이어지기 쉽습니다. Oil UI를 설치하면 Claude Code가 카테고리를 조사하고 서로 다른 방향을 나란히 비교한 다음 실제 뷰포트에서 렌더링된 페이지를 검증하는 구조화된 디자인 워크플로를 사용합니다.
npx skills add oil-oil/oil-ui를 실행해 프로젝트를 특정 컴포넌트 라이브러리에 묶지 않고 Claude Code에 무료 오픈소스 Skill을 설치하세요.
모호한 스타일 형용사 대신 제품, 사용자, 핵심 작업, 실제 콘텐츠, 목표 뷰포트(1440×900 또는 390×844 등)를 프롬프트 앞에 제시하세요.
새 페이지나 리디자인에서는 프로덕션 상태를 작성하기 전에 Claude Code로 3~4개의 서로 다른 방향을 담은 HTML 비교 보드를 만들게 하세요.
방문객이 ‘물빛과 그릇’ 가을 특별전의 일정과 전시실, 기물의 감상 포인트를 살펴 보고 방문을 예약하도록 돕습니다.

물빛
그릇
물 위의 황혼
황혼과 연못을 화면 가득 채웁니다. 기물은 어두운 영역에 두고, 세리프 대제목은 고요한 한쪽에만 배치합니다.
아침빛저널

빛은 수면에,
그릇 위에도 머뭅니다.
일상의 기물과 자연광을 다루는 전시입니다.
아침빛 저널
전시 도록을 펼치듯 신문 그리드로 아침빛, 기물, 방문 정보를 정리합니다.
창에 낀 안개.
반나절의 빛.

안개 창
유화를 하나의 창에 담고, 물안개와 청자, 종이의 여백이 천천히 펼쳐지게 합니다.
Claude Code에 전용 디자인 Skill이 필요한 이유
npx skills add oil-oil/oil-ui또는 Claude Code에 “이 Skill을 설치해 줘: npx skills add oil-oil/oil-ui 실행”이라고 직접 전송하세요.
- Claude Code 서브에이전트로 맥락 없는 블라인드 시각 리뷰를 100% 및 200% 확대에서 진행해 간격, 대비, 위계 문제를 전달 전에 수정하세요.
Claude Code에 별다른 방법 없이 “깔끔하고 모던한 SaaS 인터페이스”를 요청하면 모델은 학습 데이터의 통계적 평균에 기대게 됩니다. 중앙 정렬된 제목 위에 pill 배지를 놓고 아래에 같은 너비의 카드 세 장을 배치하며, 한쪽에 장식용 스파크라인이나 “+24%” 카운터를 추가합니다. 코드는 컴파일되지만 다른 AI 데모와 구분되지 않는 인터페이스가 됩니다.
Oil UI는 작업 순서를 바꿉니다. Claude Code가 프롬프트에서 바로 최종 마크업으로 넘어가는 대신 제품 카테고리를 이해하기 쉽게 만드는 요소를 조사하고, 서로 다른 시각 방향을 하나의 비교 보드에 배치한 다음, 작업을 끝내기 전에 실제 브라우저 렌더링을 검사합니다.
| 단계 | Claude Code에 한 번만 요청 | Claude Code + Oil UI 워크플로 |
|---|---|---|
| 출발점 | 일반적인 SaaS 카드 그리드와 안전한 팔레트를 기본 사용 | 제품 카테고리, 사용자 작업, 실제 콘텐츠에서 시작 |
| 방향 선택 | 한 가지 결과만 제공하며 어긋나면 처음부터 다시 요청해야 함 | 1440px 또는 390px에서 방향을 나란히 비교하는 기본 제공 페이지 |
| 데이터와 문구 | 가짜 백분율과 채움용 배지를 지어내는 경우가 많음 | 실제 도메인 필드를 중심으로 위계를 구성하고 불필요한 요소 제거 |
| 품질 확인 | 코드가 컴파일되면 바로 중단 | 블라인드 서브에이전트가 전체 페이지와 200% 크롭을 비평 |
작동하는 갤러리 사례와 프롬프트
컬렉션 둘러보기 →무료 Skill에서 Oil UI Pro로 전환해야 할 때
무료 오픈소스 Skill에는 카테고리 조사, 방향 비교 보드, 인위적인 AI 느낌 점검, 스크린샷 재현이 포함됩니다. Claude Code로 기존 프로덕션 앱을 개선하거나 밀도 높은 데스크톱 워크스페이스를 디자인하거나 클릭 수를 센 작업 점검과 함께 최대 3회의 블라인드 서브에이전트 리뷰가 필요하다면 Oil UI Pro를 사용하세요.
Oil UI Pro 살펴 보기 →npx github:oil-oil/oil-cli install oil-ui-pro자주 묻는 질문
Oil UI가 Claude Code를 React, Tailwind 또는 특정 UI 라이브러리에 묶어 두나요?
아니요. Oil UI는 디자인 방법, 레이아웃 판단, 시각 검증 단계를 제공합니다. Next.js, Vue, Svelte, 순수 HTML/CSS, 사내 디자인 시스템 등 어떤 스택이든 Claude Code는 기존 환경 안에서 마크업과 스타일을 작성합니다.
Oil UI를 사용할 때 Claude Opus와 Claude Sonnet은 어떻게 다른가요?
Opus는 일반적으로 전체 페이지의 타이포그래피 크기, 속도감, 편집적 위계에서 더 강한 판단을 보입니다. Sonnet은 더 신속하고 집중된 모듈, 상태 보완, 정해진 방향의 확장에 적합합니다. 둘 다 같은 Skill을 바로 읽을 수 있습니다.
Claude Code에 참고 스크린샷을 주고 재현하거나 응용하게 할 수 있나요?
네. 이미지 경로를 전달하고 픽셀 차이를 이용한 충실한 재현을 원하는지, 타이포그래피 분위기와 간격만 가져와 자신의 제품 콘텐츠에 적용하고 싶은지 명시하세요. Oil UI에는 두 경우 모두를 위한 전용 워크플로가 있습니다.
Claude Code가 Oil UI를 실제로 적용하고 있는지 어떻게 알 수 있나요?
프롬프트에 “Oil UI 사용”을 포함하세요. Claude Code가 스타일 없는 기본 코드를 바로 쏟아내는 대신 사용자 작업을 정리하고 서로 다른 시각 방향이나 비교 보드를 제안한 다음, 마무리 전에 렌더링된 스크린샷을 검사할 것입니다.



