Claude Code로 만드는 스크롤 애니메이션 웹사이트: 스킬과 프롬프트
등장 효과와 간단한 패럴랙스는 CSS 스크롤 기반 애니메이션으로 시작하고, 섹션을 고정(pin)하거나 스크럽해야 할 때 GSAP ScrollTrigger와 Lenis를 더하며, 모든 효과에 prefers-reduced-motion 대체 동작을 마련하세요. Claude Code 워크플로는 무료 스킬 4개와 글로 읽는 튜토리얼 2개로 다룹니다. 유료 라이브러리는 날짜를 밝힌 가격과 함께만 소개하고, 업체의 주장은 업체 주장임을 표시했습니다.
AI의 도움을 받은 글: 이 가이드는 Claude Fable 5.1의 도움으로 초안을 작성했으며, 모든 사실은 출처로 연결됩니다.
짧은 답
먼저 CSS 스크롤 기반 애니메이션을 쓰세요. 페이드업 등장 효과와 간단한 패럴랙스를 JavaScript 없이 처리합니다. 다만 2026년 10월 27일 기준 MDN은 animation-timeline 속성을 Baseline이 아닌 Limited availability로 분류하므로, 규칙을 @supports로 감싸고 이 규칙 없이도 페이지가 읽히도록 하세요(MDN: animation-timeline). 섹션을 고정하거나 스크럽해야 한다면 GSAP ScrollTrigger를 쓰고, 관성 스무스 스크롤이 필요할 때만 Lenis를 더하세요. GSAP는 Webflow의 지원으로 모든 사용자에게 무료이며(GSAP pricing), Lenis는 MIT 라이선스입니다(Lenis README). 스크롤에 맞춰 움직이는 3D 장면이라면 Three.js가 답입니다. 무엇을 고르든 모든 효과에 prefers-reduced-motion 분기를 두세요. 이 미디어 기능은 2020년 1월부터 Baseline입니다(MDN: prefers-reduced-motion).
어떤 효과에 어떤 기법이 맞을까요?
| 효과 | 사용할 것 | 이유 |
|---|---|---|
| 페이드업 등장 효과, 간단한 패럴랙스 | @supports 블록 안에서 scroll() 또는 view()와 함께 쓰는 CSS animation-timeline | JavaScript가 필요 없고 브라우저가 구동합니다. MDN 기준 Limited availability이므로 정적 대체 화면이 중요합니다 |
| 타임라인이 재생되는 동안 히어로 고정 | pin: true와 scrub을 쓴 GSAP ScrollTrigger | pin, scrub, snap, pinSpacing이 기본 제공되고, 조정하는 동안 markers가 시작선과 끝선을 그려 줍니다 |
| 관성 스무스 스크롤 | GSAP ticker로 ScrollTrigger와 동기화한 Lenis | 몇 KB에 MIT 라이선스이며 기본적으로 reduced motion을 존중합니다. README에 동기화 코드가 들어 있습니다 |
| 스크롤에 맞춘 3D 장면이나 카메라 비행 | 스크롤 값 하나로 구동하는 Three.js(MIT, 2026-10-30에 r187 출시) | 진짜 3D 깊이감을 주지만 휴대폰에서 부드럽게 유지하기가 가장 어렵습니다 |
| 메뉴, 카드, 모달, 텍스트 전환 | CSS 트랜지션(예: transitions.dev 스니펫) | 스크롤 기반이 아닙니다. 각 스니펫에 prefers-reduced-motion 가드가 포함되어 있습니다 |
Zumkai의 튜토리얼은 세 가지 질문으로 판단하라고 제안합니다. 고정이 있는가, 스크럽이 있는가, 서로 다른 속도의 패럴랙스가 있는가? 세 질문 모두 아니라면 CSS 스크롤 기반 애니메이션으로 충분하고, 하나라도 그렇다면 GSAP ScrollTrigger를 쓸 이유가 됩니다(Zumkai, 2026-09-19). 또 하나의 규칙은 GSAP의 ScrollSmoother와 Lenis를 한 페이지에서 함께 쓰지 말라는 것입니다. 둘 다 스크롤 위치를 제어하므로 고정 구간을 두고 충돌합니다. motif 요약: Cinematic scroll with GSAP + Lenis in Claude Code.
Claude Code용 무료 스킬
Claude Code는 내 컴퓨터의 모든 프로젝트에 적용되는 ~/.claude/skills/skill-name/SKILL.md, 저장소 하나에 적용되는 .claude/skills/skill-name/SKILL.md, 또는 /plugin-name:skill-name 형태의 플러그인에서 스킬을 불러옵니다(Claude Code docs: Skills). Claude Code 스킬은 Agent Skills 오픈 표준을 따르며, 문서에 따르면 이 표준은 여러 AI 도구에서 작동합니다. 아래 네 가지는 저희가 전부 읽어 본 스킬이며, GitHub 스타 수와 마지막 푸시 날짜는 2026년 10월 27일 기준입니다. GSAP 공식 스킬을 포함한 더 많은 모션 스킬은 모션용 에이전트 스킬에 정리되어 있습니다.
| 스킬 | 하는 일 | 라이선스와 스타 | 설치 |
|---|---|---|---|
| nateherkai/scroll-craft | 스크롤 기반 사이트 제작 워크플로 전체를 다룹니다. 브리프, 8가지 페이지 문법 중 하나 선택, 정점이 하나인 감정 곡선, 제작, 그리고 데스크톱·모바일·reduced-motion 상태를 스크린샷으로 확인하는 Playwright 점검까지 이어집니다. GSAP가 아니라 자체 엔진(data-sc 속성을 쓰는 scrollcraft.js)을 씁니다 | MIT, 스타 4,102개, 마지막 푸시 2026-09-30 | /plugin marketplace add nateherkai/scroll-craft 실행 후 /plugin install nateherk-design, 또는 Claude Code에 SKILL.md를 읽게 하기 |
| elayadesign/ai-design-skills: landing-page-design | 랜딩 페이지 구조, 카피 규칙, 엄격한 비주얼 시스템을 다룹니다. 모션 섹션은 이징 곡선을 하나로 고정하고, transform과 opacity만 허용하며, IntersectionObserver나 Framer Motion의 whileInView로 등장 효과를 실행하고, reduced motion에서는 움직임을 opacity 변화로 바꿉니다 | MIT, 스타 8,523개, 마지막 푸시 2026-10-26 | 스킬 폴더를 .claude/skills/에 복사 |
| emilkowalski/skills | UI 모션 감각을 담은 스킬 모음: animate, review-animations, animation-performance, find-animation-opportunities 등. 스크롤 전용은 아니며, Claude가 작성한 코드의 이징, 지속 시간, 프레임 예산을 판단하는 데 씁니다 | MIT, 스타 50,454개, 마지막 푸시 2026-10-11 | npx skills@latest add emilkowalski/skills |
| Jakubantalik/transitions.dev | 카드, 메뉴, 모달, 텍스트용 CSS 트랜지션입니다. 저장소에 따르면 Pro 트랜지션을 포함해 43개 이상입니다. README에 따르면 복사한 스니펫마다 prefers-reduced-motion 가드가 들어 있습니다. 스크롤 기반은 아닙니다 | 자체 라이선스(아래 인용), 도구는 MIT, 스타 5,818개, 마지막 푸시 2026-10-25 | npx skills add Jakubantalik/transitions.dev |
고지 사항. scroll-craft에는 Node 18 이상, 전체 FFmpeg 빌드, Chrome이 포함된 playwright-core가 필요합니다. 생성 에셋은 선택 사항이지만 KIE AI API 키가 필요하고 무료가 아닙니다. 직접 찍은 사진과 영상으로 만들 때는 키가 필요 없습니다(scroll-craft README). 사이트 10개를 다시 만든 사례는 Claude Code가 아니라 Codex로 작업한 것입니다. Emil Kowalski의 README에는 그의 뉴스레터와 토스트 라이브러리 Sonner 링크가 들어 있습니다. landing-page-design 스킬은 내용 일부의 출처로 Leon Lin의 taste-skill을 밝히고 있으며, 둘 다 MIT입니다. transitions.dev는 Pro 트랜지션용으로 Pro와 Business 요금제를 판매합니다. 무료 세트와 스킬은 요금제 없이 쓸 수 있습니다.
단계별 안내: GSAP와 Lenis로 만드는 고정 히어로
- 기본 Vite 프로젝트를 만들고 두 라이브러리를 설치합니다: npm create vite@latest 다음에 npm install gsap lenis(ScrollHaus, 업체).
- 트리거를 만들기 전에 ScrollTrigger를 등록하고 Lenis와 연결합니다: lenis.on('scroll', ScrollTrigger.update); gsap.ticker.add(time => lenis.raf(time * 1000)); gsap.ticker.lagSmoothing(0). 이 연결이 없으면 고정 위치가 잘못 계산되고 타임라인이 일찍 실행됩니다(Lenis README; Zumkai).
- Claude Code에는 형용사 대신 구조를 주세요. Zumkai가 iart-ai web-animation-skills 저장소에서 인용한 한 줄 프롬프트 "GSAP로 스크롤에 맞춰 타임라인을 스크럽하는 고정 히어로 섹션을 만들어 줘"에서 시작한 다음, 섹션 구성, 어떤 레이어를 고정할지, 스크럽 길이(Zumkai의 예시는 end: "+=150%"와 scrub: 1), 모바일 동작, Lenis가 들어가는 지점을 지정하세요.
- 분기가 둘인 gsap.matchMedia를 요청하세요. (prefers-reduced-motion: no-preference)에서는 고정, 스크럽, 패럴랙스를 모두 적용하고, reduce에서는 고정도 스크럽도 없는 정적이고 읽기 쉬운 버전을 보여 줍니다(Zumkai; GSAP ScrollTrigger docs).
- 조정하는 동안에는 markers: true를 켜 두고 게시 전에 끄세요. 시작 위치와 끝 위치가 어긋나면 이미지와 폰트가 로드된 뒤 ScrollTrigger.refresh()를 호출하세요. 위치는 매 프레임이 아니라 한 번만 계산됩니다(GSAP ScrollTrigger docs; ScrollHaus).
- 고정한 요소 자체가 아니라 그 자식 요소에 애니메이션을 적용하고, 좁은 화면에서 고정 구간으로 확보된 공간을 확인하세요. ScrollTrigger는 아래 콘텐츠가 튀지 않도록 기본적으로 pinSpacing 패딩을 추가합니다(GSAP ScrollTrigger docs; Zumkai).
ScrollHaus 방식: 섹션 하나씩
ScrollHaus는 스크롤 기반 사이트 템플릿을 판매하며(scrollhaus.ai), 이 가이드는 ScrollHaus가 직접 발행했고 예시도 자사 사이트라는 고지로 시작합니다(ScrollHaus, 2026-10-06). 방법 자체는 아무것도 사지 않아도 쓸 수 있습니다. 실제 운영 중인 참고 사이트 하나를 고르고, 구조화된 브리프를 쓴 다음, Claude Code에 한 번에 한 섹션씩 요청하고 다음 섹션으로 넘어가기 전에 브라우저에서 확인합니다. 문제는 보이는 대로 바로 알려 주세요("등장 효과가 너무 일찍 실행돼", "모바일에서 헤드라인이 세 줄로 넘어가"). 시네마틱한 고정 히어로를 만들 때는 FFmpeg로 클립에서 24fps WebP 프레임을 추출하고, Claude에게 300vh 동안 캔버스 이미지 시퀀스를 스크럽하게 합니다. 출시 체크리스트는 캔버스 위에 실제 HTML 제목과 본문을 둘 것, reduced-motion 대체 동작, 압축하고 캐시한 이미지와 프레임을 요구합니다. 요청하지 않은 라이브러리를 Claude가 추가한다면 허용할 라이브러리를 프롬프트에 나열하라고 조언합니다. motif 요약: How to Make an Animated Website With Claude Code.
복사해서 쓰는 프롬프트
각 프롬프트에는 작성자를 밝혀 두었습니다. 대괄호 부분을 내 내용으로 바꾸세요.
1. 고정 히어로(iart-ai 예시, Zumkai의 조언대로 구조화)
GSAP로 스크롤에 맞춰 타임라인을 스크럽하는 고정 히어로 섹션을 만들어 줘. 섹션 순서: [목록]. [레이어]를 고정하고, 타임라인은 end: "+=150%", scrub: 1로 진행해 줘. 스무스 스크롤에는 Lenis를 쓰고, lagSmoothing(0)을 적용한 GSAP ticker로 동기화해 줘. 휴대폰에서는 [더 짧은 스크럽 또는 고정 없음]. 전체를 gsap.matchMedia로 감싸고 prefers-reduced-motion: reduce용 정적 분기를 넣어 줘. gsap와 lenis 외의 라이브러리는 추가하지 마. 첫 문장은 Zumkai가 인용한 iart-ai 예시 프롬프트이고, 나머지 구조는 Zumkai의 조언을 따랐습니다.
2. 마케팅 사이트 전체를 위한 구조화된 브리프(ScrollHaus, 업체)
[브랜드]를 위한 원페이지 마케팅 사이트를 만들어 줘. [한 줄 설명]. 섹션: 히어로, 기능 소개 행 3개, 증거/추천사, 가격, 푸터 CTA. 스타일: [참고 사이트], 어두운 배경, 큰 세리프 헤드라인, 절제된 팔레트. 모션: Lenis 스무스 스크롤, GSAP ScrollTrigger 등장 효과(페이드+상승, stagger 0.1s), /frames/f_0001.webp부터 f_0144.webp까지 캔버스 이미지 시퀀스를 300vh 동안 스크럽하는 고정 히어로. prefers-reduced-motion을 존중할 것. 모바일 우선, 가로 스크롤 없음. 헤드라인은 실제 HTML 텍스트로 유지. gsap와 lenis 외의 라이브러리는 추가하지 마. 사이트 템플릿을 판매하는 ScrollHaus에서 인용했습니다.
3. JavaScript 없이 CSS로 먼저 만드는 등장 효과(motif)
이 페이지에 CSS 스크롤 기반 애니메이션만으로 스크롤 등장 효과를 추가해 줘. 각 섹션에 animation-timeline: view()를 적용하고, transform과 opacity로 짧게 떠오르며 나타나게 하고, JavaScript는 쓰지 마. 규칙은 @supports (animation-timeline: view()) 안에 넣어서, 지원하지 않는 브라우저에서는 콘텐츠가 정적으로 온전히 보이게 해 줘. @media (prefers-reduced-motion: reduce)에서는 움직임을 없애고 짧은 opacity 변화만 남겨 줘. 라이브러리는 추가하지 마. 이 가이드에 링크한 MDN 페이지를 바탕으로 motif가 작성했습니다.
4. 빌더와 비평 라운드를 거치는 순수 Three.js 스크롤 사이트(Chris, @everestchris6)
2026년 10월 27일 기준 motif 아카이브에서 스크롤 기반 웹사이트용으로 크리에이터가 직접 쓴 완전한 프롬프트는 Chris의 Three.js 브리프 하나뿐이며, this is the only prompt you need to one-shot a studio-level 3d website with claude opus 5.5라는 제목으로 보관되어 있습니다(2026-10-07 게시). 이 프롬프트는 빌드 단계 없이 import map을 쓰는 순수 Three.js, "부드러운 스크롤 값 하나가 모든 것을 구동"하는 구조, 챕터마다 별도의 렌더 타깃, 최소 0.1 뷰포트 높이에 걸쳐 부드럽게 들어오고 나가는 고정, 그리고 "즉시 스크롤과 정지 프레임으로 prefers-reduced-motion을 존중"할 것을 요구합니다. 분량이 깁니다. 빌더 에이전트와 비평 에이전트가 따로 있어 라운드마다 각 요소를 참고 자료와 비교해 점수를 매기고, Playwright 레코더가 스크롤을 60fps로 녹화해 모션을 점검합니다. 고지: Replicate의 유료 이미지 모델로 이미지를 생성하며 먼저 이미지 예산을 정하라고 요청합니다. Opus 5.5 사용 표기는 크리에이터의 주장입니다.
유료 라이브러리와 확인 당일 가격
접근성과 성능 체크리스트
- CSS, gsap.matchMedia, 그리고 respectReducedMotion이 기본으로 켜져 있는 Lenis에서 prefers-reduced-motion: reduce 분기를 두세요. 움직임은 짧은 opacity 변화나 정지 프레임으로 바꾸고, 콘텐츠를 숨기지는 마세요. 큰 물체를 확대하거나 이동시키면 전정 기관 관련 멀미 증상을 유발할 수 있습니다(MDN; Lenis README).
- 기본적으로 transform과 opacity를 애니메이션하세요. width, height, top, margin은 피하고, transition: all은 절대 쓰지 마세요. 프레임 예산은 60fps에서 16.7ms, 120Hz 화면에서 8ms이며, 이 스킬에 따르면 이제 대부분의 휴대폰이 120Hz 화면을 갖추고 있습니다(emilkowalski/skills: animation-performance).
- 캔버스나 WebGL 장면 위에 헤드라인과 본문을 실제 HTML로 두어 검색 엔진과 스크린 리더가 텍스트를 읽을 수 있게 하세요(ScrollHaus; scroll-craft SKILL.md).
- 고정 구간의 공간을 확보하고, 고정한 요소 자체가 아니라 그 자식 요소에 애니메이션을 적용하세요(GSAP ScrollTrigger docs).
- 폰트와 이미지가 로드된 뒤 ScrollTrigger.refresh()를 호출하세요. 시작 위치와 끝 위치는 계속 계산되는 것이 아니라 처음 한 번과 크기 변경 시에만 계산됩니다(GSAP ScrollTrigger docs).
- 휴대폰에는 더 작은 프레임 세트를 제공하고, 캔버스 픽셀 비율 상한을 2로 두며, 포스터 프레임을 먼저 보여 줘서 최대 콘텐츠풀 페인트(LCP)가 빠르게 이뤄지게 하세요(ScrollHaus).
- 노트북만이 아니라 중급 휴대폰에서도 테스트하세요(ScrollHaus). 브라우저 점검은 Claude Code에 맡기세요. Zumkai는 Playwright MCP와 Chrome DevTools MCP를 쓰고, scroll-craft는 reduced-motion 상태를 포함해 자체 Playwright 스크린샷 점검을 실행합니다(Zumkai; scroll-craft).
- 읽기를 방해하는 모션은 덜어 내세요. 긴 인트로, 텍스트 아래의 패럴랙스, 폼 옆의 반복 애니메이션 같은 것들입니다(Zumkai).
motif 아카이브에서 보이는 것
motif archives videos of finished work, so a scroll website reaches it as a screen recording from its creator. As of 16 November 2026 the landings page lists 124 pages that creators say they made with Claude, each with the creator's post and, when they gave one, the live site, and the sites directory lists more than 17,000 live sites whose creators credit Claude in their own words. Scroll-driven examples include a bird of 300,000 points of light that carries a story as you scroll, a vanilla Three.js product page with a scroll-driven camera and the making of a scroll-driven Three.js site built with Blender and Opus 5.5. Product promos are collected in Product & UI, and 3D renders in 3D & Generative. For motion projects that render to MP4 instead, start at Quick start; the GSAP agent skills in our list are under Agent skills for motion.
Can Claude Code build scenes in Spline or Rive?
Yes, through each tool's own MCP server, and both vendors document it. Spline's MCP server moved to the cloud on 19 October 2026, so Claude, ChatGPT or Cursor can build a 3D scene in a real Spline file without the editor open (Spline changelog); Spline also publishes an agent plugin, splinetool/spline-skills (MIT), added in Claude Code with /plugin marketplace add splinetool/spline-skills.
Rive works the other way round: its Editor MCP runs inside the Rive desktop app for macOS or Windows, which must stay open, and you connect Claude Code with claude mcp add --transport http rive http://127.0.0.1:9791/mcp (Rive docs, read 2026-11-16). The current Rive web runtime is 2.50.0, released on 9 November 2026 (rive-wasm releases). Both are checked as of 2026-11-16; motif has not run either server.
자주 묻는 질문
Claude Code로 스크롤 애니메이션을 만들려면 스킬이 필요한가요?
아니요. 구조화된 프롬프트만 있으면 GSAP, Lenis, CSS 스크롤 기반 코드를 작성합니다. 스킬은 디자인 기준과 점검 단계를 더해 줍니다. scroll-craft는 Playwright로 데스크톱, 모바일, reduced-motion 상태를 스크린샷으로 찍고, emilkowalski/skills는 이징, 지속 시간, 프레임 예산을 검토합니다(scroll-craft; emilkowalski/skills).
CSS 스크롤 기반 애니메이션과 GSAP ScrollTrigger 중 무엇을 써야 하나요?
정적 대체 화면을 받아들일 수 있다면 등장 효과와 간단한 패럴랙스에는 CSS를 쓰세요. 2026년 10월 27일 기준 MDN은 animation-timeline을 Limited availability로 분류합니다(MDN). 섹션을 고정, 스크럽하거나 스냅해야 한다면 GSAP를 쓰세요. GSAP는 모든 사용자에게 무료입니다(GSAP pricing).
Lenis가 꼭 필요한가요?
관성 스무스 스크롤을 원할 때만 필요합니다. ScrollTrigger는 브라우저 기본 스크롤에서도 작동합니다. Lenis를 더한다면 GSAP ticker로 동기화하고 ScrollSmoother를 함께 실행하지 마세요(Lenis README; Zumkai).
무료 스킬을 상업 작업에 써도 되나요?
scroll-craft, emilkowalski/skills, landing-page-design은 MIT입니다. transitions.dev는 상업적 사용을 무제한으로 허용하지만 라이브러리를 경쟁 제품으로 재배포하는 것은 금지하며, Pro 트랜지션에는 유료 요금제가 필요합니다(transitions.dev LICENSE).
ScrollTide는 돈을 낼 만한가요?
motif는 테스트하지 않았으므로 평가하지 않습니다. 가격과 카탈로그 수치는 확인 날짜와 함께 위에 정리했으며, 모든 판매는 환불되지 않습니다(ScrollTide pricing). scrolltide.co의 React 컴포넌트 라이브러리를 자신이 만들었다고 밝힌 Aman Singh(@amananimates)가 X에서 이 서비스를 홍보합니다(2026-10-25 게시물).
prefers-reduced-motion은 어떻게 처리하나요?
CSS에서는 @media (prefers-reduced-motion: reduce)로, GSAP에서는 gsap.matchMedia로 분기하고, Lenis의 respectReducedMotion은 기본값 그대로 두세요. 콘텐츠는 유지하고 움직임만 opacity 변화나 정지 프레임으로 바꾸세요(MDN).
Does Spline have an official Claude integration?
Yes: a cloud MCP server since 19 October 2026 and an MIT-licensed agent plugin, spline-skills, both published by Spline (Spline changelog, spline-skills). Rive has an Editor MCP that runs inside its desktop app (Rive docs).
출처
- Zumkai: Cinematic scroll with GSAP + Lenis in Claude Code (2026-09-19)
- ScrollHaus(업체): How to Make an Animated Website With Claude Code (2026-10-06)
- ScrollHaus 홈(업체)
- GitHub: nateherkai/scroll-craft
- GitHub: nateherkai/scroll-craft SKILL.md
- GitHub: elayadesign/ai-design-skills, landing-page-design SKILL.md
- GitHub: emilkowalski/skills
- GitHub: emilkowalski/skills, animation-performance SKILL.md
- GitHub: Jakubantalik/transitions.dev LICENSE
- GitHub: Jakubantalik/transitions.dev
- GSAP 문서: ScrollTrigger
- GSAP 가격: 모든 사용자에게 무료
- GitHub: darkroomengineering/lenis README
- GitHub: mrdoob/three.js
- MDN: CSS scroll-driven animations
- MDN: animation-timeline
- MDN: prefers-reduced-motion
- Claude Code 문서: Skills
- ScrollTide 홈(업체)
- ScrollTide 가격(업체)
- ScrollTide 무료 템플릿(업체)
- Scroll Shaders 가격(업체)
- X의 @amananimates(Aman Singh) (2026-10-25)
- X의 @himanshubuildss (2026-10-24)
- X의 @everestchris6 (2026-10-07), Three.js 스크롤 사이트 프롬프트
- Spline: Changelog
- splinetool/spline-skills
- Rive: Editor MCP integration
- rive-app/rive-wasm: releases