shadcn/ui의 개요
shadcn/ui는 가져와 쓰는 패키지가 아닙니다. CLI가 각 컴포넌트의 소스 코드를 프로젝트에 복사하고, 그 코드는 내 것이 되어 직접 수정합니다. 같은 CLI로 서드파티 및 프라이빗 registry의 항목도 가져옵니다. 컴포넌트는 Radix, Base UI 또는 React Aria 위에 만들어지고 스타일은 Tailwind를 씁니다. 설치 가이드는 Next.js, Vite, Laravel, React Router, Astro, TanStack Start를 다룹니다.
저장소에는 agent skills도 들어 있습니다. SKILL.md가 담긴 폴더로, 코딩 에이전트가 작업에 필요할 때 불러옵니다. 주력 스킬인 shadcn은 `shadcn info --json`으로 components.json을 읽어 프레임워크, Tailwind 버전, 별칭, 아이콘 라이브러리, 베이스 라이브러리, 설치된 컴포넌트를 에이전트에 전달하고, 이를 조합하는 규칙도 알려 줍니다. 두 번째 스킬인 migrate-radix-to-base는 프로젝트를 Radix에서 Base UI로 옮깁니다. 설치는 Vercel의 skills CLI로 합니다: `npx skills add shadcn/ui`.
저장소는 2023년 1월에 만들어졌고 스타는 약 128,470개, 포크는 11,417개입니다. CLI의 최신 릴리스는 shadcn@4.23.0(2026년 10월 27일)이며, 가장 최근 커밋은 2026년 11월 17일입니다.
shadcn/ui, 쓸 만한 가치가 있습니까?
이 스킬은 보기보다 중요합니다. shadcn/ui는 코딩 에이전트가 이미 즐겨 쓰는 라이브러리이면서, 세부에서 가장 자주 잘못 쓰는 라이브러리이기 때문입니다. 학습 데이터에 기대어 코드를 쓰는 에이전트는 폼 필드를 space-y-4가 붙은 div에 쌓고, bg-blue-500으로 색을 덮어쓰고, 스크린 리더에 필요한 DialogTitle을 빠뜨립니다. shadcn 스킬은 바로 그런 습관을 겨냥한 성문 규칙집입니다. 폼은 FieldGroup과 Field에 넣고, 2~7개의 선택지는 ToggleGroup을 쓰고, 색은 시맨틱 토큰에서 가져오며, 모든 Dialog, Sheet, Drawer에는 제목을 붙입니다. 규칙마다 잘못된 코드와 올바른 코드를 짝지은 파일로 연결됩니다.
나머지 절반은 프로젝트 맥락입니다. 스킬은 로드될 때 `shadcn info --json`을 실행해 실제 설정을 에이전트에 넘깁니다. 프로젝트가 Radix, Base UI, React Aria 중 무엇을 쓰는지도 포함되며, 이에 따라 커스텀 트리거의 API가 달라집니다. 이어서 손으로 무엇을 쓰기 전에 `shadcn search`, `shadcn docs`, `add --diff`를 쓰도록 유도하고, registry는 추측하지 말고 물어보라고 지시합니다. 스킬에는 테스트 프롬프트 8개를 담은 evals 파일이 있어, 대부분의 커뮤니티 스킬보다 체계적입니다.
설치는 프로젝트에서 `npx skills add shadcn/ui` 한 줄이면 됩니다. Vercel의 skills CLI는 설치된 에이전트를 감지하고(Claude Code, Codex, Cursor, OpenCode 외 75개를 나열합니다) 파일을 어디에 둘지 묻습니다. -g를 붙이면 모든 프로젝트에 설치됩니다. skills.sh 기준으로 shadcn 스킬은 약 152,400회, 마이그레이션 스킬은 약 38,500회 설치되었습니다. 문서는 Claude Code에서의 사용 흐름을 설명하며, 저장소에는 Codex에서 스킬 이름과 아이콘이 표시되도록 하는 작은 agents/openai.yml도 있습니다. 별도의 MCP 서버는 `npx shadcn@latest mcp init --client claude`(또는 cursor, vscode, codex, opencode)로 설정하며, 에이전트가 registry를 탐색하고 설치할 수 있게 합니다. 스킬은 이 서버의 사용법도 알려 줍니다.
보안상의 절충은 구체적입니다. 스킬은 npx, pnpm dlx, bunx로 `shadcn@latest`를 실행하는 셸 명령을 미리 승인하므로, Claude Code에서 에이전트는 add를 포함한 CLI를 묻지 않고 실행할 수 있고, @latest는 그날 npm이 내려주는 버 전을 뜻합니다. 커뮤니티 registry의 컴포넌트는 소스 코드로 프로젝트에 들어옵니다. 스킬은 에이전트에게 나중에 이를 읽어 보라고 하지만, 이는 조언이지 검사가 아닙니다. skills CLI는 DISABLE_TELEMETRY=1을 설정하지 않으면 익명 설치 텔레메트리를 보냅니다.
라이브러리로서의 방식은 4년 가까이 지나도 유효합니다. 읽기 쉬운 코드를 얻고 종속도 없지만, 복사한 컴포넌트는 스스로 업데이트되지 않으므로 유지보수로 그 대가를 치릅니다. 열려 있는 이슈와 풀 리퀘스트 1,746건은 프로젝트에 얼마나 많은 활동이 몰리는지 보여 줍니다. 에이전트를 쓰는 React 팀에게 스킬은 추가 부담이 적고, 이 코드에서 에이전트가 가장 자주 저지르는 실수를 바로잡습니다. shadcn/ui를 쓰지 않는다면 아무 역할도 하지 않습니다.
제 역할을 하는 곳
Claude Code로 Next.js SaaS 대시보드를 만드는 1인 창업자
폼을 하나하나 손보지 않고도 일관된 설정 페이지와 데이터 테이블을 만들고 싶다
`npx skills add shadcn/ui`를 한 번 실행한 뒤 페이지를 요청합니다. 에이전트는 프로젝트 설정을 읽고 CLI로 Tabs, Card, 폼 컴포넌트를 추가하며 FieldGroup 규칙을 따릅니다. 일반적인 모델 사용료 외의 비용은 없습니다.
사내 컴포넌트 registry를 둔 20명 규모 제품팀의 프런트엔드 리드
에이전트가 새 컴포넌트를 만들어 내지 말고 우리 브랜드 컴포넌트를 쓰게 하고 싶다
프라이빗 registry를 components.json에 추가하고 인증 변수를 .env.local에 둔 뒤, 스킬과 MCP 서버를 설치하면 에이전트가 마크업을 쓰기 전에 registry를 검색합니다. 어떤 registry를 쓸지 물어보라는 스킬 규칙 덕분에 공개 항목으로 기본 선택하는 일을 막을 수 있습니다.
Radix 기반의 오래된 shadcn/ui 프로젝트를 운영하는 팀
빌드를 깨뜨리지 않고 Base UI로 옮기고 싶다
migrate-radix-to-base 스킬은 `shadcn info`로 베이스 라이브러리를 확인하고, 깨끗한 git 트리를 요구하며, 먼저 타입 검사를 실행한 뒤 커밋 하나에 컴포넌트 하나씩 옮깁니다. 마지막 컴포넌트가 옮겨질 때까지 Radix는 설치된 상태로 둡니다.
도입 전 확인할 점
- 설정
- `npx shadcn@latest init`(또는 템플릿)으로 프로젝트를 초기화한 다음 프로젝트 루트에서 `npx skills add shadcn/ui`를 실행합니다. skills CLI에는 Node.js 22.20 이상이 필요합니다. MCP 서버는 선택 사항으로 `npx shadcn@latest mcp init --client <agent>`로 설정하며, Codex는 config.toml을 직접 수정해야 합니다.
- 연동
- 스킬은 Vercel의 skills CLI로 Claude Code, Codex, Cursor, OpenCode 등 여러 에이전트에 설치합니다. MCP 서버는 Claude Code, Cursor, VS Code(Copilot), Codex, OpenCode를 지원합니다. registry는 공식, 커뮤니티, 인증이 필요한 프라이빗 registry를 지원합니다.
- 데이터와 개인정보
- 호스팅 서비스가 없는 프런트엔드 라이브러리입니다. 스킬은 shadcn CLI를 로컬에서 실행합니다. skills CLI는 익명 설치 텔레메트리를 보냅니다(DISABLE_TELEMETRY=1 또는 DO_NOT_TRACK=1로 끌 수 있음). 프라이빗 registry 토큰은 .env.local에 둡니다.
- 대규모 사용 시 비용
- 규모와 관계없이 무료입니다. 실제 비용은 복사한 컴포넌트의 유지보수와, 스킬이 로드될 때마다 추가되는 컨텍스트입니다. 로드당 토큰 사용량은 공개되지 않았습니다.
- 제한
- React 전용이며 Tailwind를 전제로 합니다. 스킬은 components.json 파일이 있을 때 작동하므로, 이 파일이 없는 프로젝트에서는 아무것도 하지 않습니다. 문서는 Claude Code에서의 흐름을 보여 주며, 스킬에 내장된 `shadcn info` 명령을 다른 에이전트가 어떻게 처리하는지는 문서화되어 있지 않습니다.
좋은 점
- 컴포넌트 소스가 내 저장소에 있어, 씨름할 런타임 의존성이 없음
- 에이전트가 코드를 쓰기 전에 스킬이 실제 프로젝트 설정을 읽음
- 잘못된 예와 올바른 예를 갖춘 구체적인 조합 규칙
- 설치 명령 하나로 Claude Code, Codex, Cursor 등 수십 개 에이전트 지원
- MIT 라이선스. 스킬, CLI, MCP 서버 모두 무료
아쉬운 점
- 스킬이 버전을 고정하지 않은 `npx shadcn@latest` 명령을 미리 승인함
- 복사한 컴포넌트는 수동으로 업데이트해야 함
- 서드파티 registry 코드는 에이전트만 검토하며, 그마저 보장되지 않음
- React와 Tailwind 전용
추천 대상
코딩 에이전트에게 UI를 맡기면서 결과물이 shadcn/ui 고유의 규칙을 따르길 원하는 React 및 Tailwind 팀.
shadcn/ui 대안
shadcn/ui: 자주 묻는 질문
- shadcn/ui, 쓸 만한 가치가 있습니까?
- React 앱에 직접 소유하는 컴포넌트 계층을 두는 기본 방식이라는 지위는 여전하며, 에이전트 스킬은 라이브러리가 자신의 규칙을 코딩 에이전트에 가르치는 사례로 지금까지 가장 명확합니다. 평점은 5점 만점에 4.5점입니다.
- shadcn/ui의 가격은 얼마입니까?
- MIT 라이선스로 무료이며 유료 요금제는 없습니다. 스킬도 무료입니다.
- shadcn/ui의 단점은 무엇입니까?
- 스킬이 버전을 고정하지 않은 `npx shadcn@latest` 명령을 미리 승인함; 복사한 컴포넌트는 수동으로 업데이트해야 함; 서드파티 registry 코드는 에이전트만 검토하며, 그마저 보장되지 않음; React와 Tailwind 전용.
- shadcn/ui에 적합한 사람은 누구입니까?
- 코딩 에이전트에게 UI를 맡기면서 결과물이 shadcn/ui 고유의 규칙을 따르길 원하는 React 및 Tailwind 팀.
- 팀이나 프로덕션 환경에서 shadcn/ui의 비용은 얼마입니까?
- 규모와 관계없이 무료입니다. 실제 비용은 복사한 컴포넌트의 유지보수와, 스킬이 로드될 때마다 추가되는 컨텍스트입니다. 로드당 토큰 사용량은 공개되지 않았습니다.
- shadcn/ui에 회사 데이터를 맡겨도 안전합니까?
- 호스팅 서비스가 없는 프런트엔드 라이브러리입니다. 스킬은 shadcn CLI를 로컬에서 실행합니다. skills CLI는 익명 설치 텔레메트리를 보냅니다(DISABLE_TELEMETRY=1 또는 DO_NOT_TRACK=1로 끌 수 있음). 프라이빗 registry 토큰은 .env.local에 둡니다.
- shadcn/ui의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Astryx, Impeccable 및 Anthropic Skills입니다.
답변 확인일: 2026년 11월 18일.