Claude Code 안에서 Clipper로 긴 영상 하나를 Shorts 5개로 만들기
긴 영상을 Shorts로 나눠 올리려는 크리에이터를 위한 중급 가이드입니다. Clipper로 자막이 입혀진 세로 클립과 게시용 텍스트 파일을 만드는 과정을 따라 합니다.
시작하기 전에
- Claude Code 설치
- uv 설치
- ffmpeg 설치
- 음성 모델과 패키지용 디스크 여유 공간 약 3GB
- 직접 만들었거나 사용 허락을 받은 영상: YouTube 링크 또는 ffmpeg가 읽는 로컬 파일
- Windows에서 테스트됨, macOS·Linux는 미확인, NVIDIA GPU는 선택 사항
사용하는 운영체제에 맞는 줄을 골라 터미널에서 실행하세요. Windows는 winget, macOS는 brew, Ubuntu/Debian은 apt를 씁니다. 아래는 macOS용 명령어입니다.
macOS에서 ffmpeg 설치 brew install ffmpegClaude Code 안에서 아래 내용을 입력해 마켓플레이스를 추가하세요.
마켓플레이스 추가 /plugin marketplace add gouthamk16/clipper계속 Claude Code 안에서 아래 내용을 입력해 Clipper를 설치하세요. 첫 클립은 엔진이 Python 패키지를 설치하고 음성 모델을 내려받느라 몇 분 더 걸립니다. 그다음부터는 바로 시작합니다.
플러그인 설치 /plugin install clipper@clipper아래 doctor 명령어를 실행하세요. Claude에게 설정을 확인해 달라고 요청해도 됩니다.
설정 확인 uv run --project clipper doctor로컬 파일을 넣어 clip 명령어를 실행하세요. YouTube 영상이면 파일 이름 자리에 링크를 넣고, 뒤에 원하는 클립 수를 숫자로 붙이세요(예: 3).
로컬 파일 클립 만들기 /clipper:clip my-podcast-episode-12.mp4편집자에게 말하듯 요청하세요. Claude가 고른 장면을 바꿔 다시 렌더링하며, 다운로드와 음성 받아쓰기는 다시 하지 않습니다.
편집 요청 clip the three funniest moments from this stream: make #2 shorter and give #4 a punchier hook뜻: 스트림에서 가장 웃긴 장면 세 개를 클립으로 만들고, 2번은 더 짧게, 4번은 더 강한 훅으로 바꾸라는 요청입니다.
clipper-output 폴더를 여세요. 클립마다 자막이 입혀진 1080x1920 세로 MP4와, YouTube·Instagram·TikTok에 붙여 넣을 제목·설명·해시태그 .txt 파일이 있습니다. clips.json에는 모든 클립의 구간과 텍스트가 정리되어 있습니다.
관심 주제에서 이번 달 가장 빠르게 성장하는 긴 영상을 하루 조회수 순으로 보여 달라고 요청하세요.
영상 찾기 /clipper:find gaming streams, tech podcasts
주의할 점
- 직접 만들었거나 사용 허락을 받은 영상만 자르세요. 남의 영상을 올리면 저작권 신고나 삭제를 받을 수 있습니다.
- 2026년 10월 1일부터 YouTube는 다른 크리에이터 영상을 주로 다시 올리는 채널의 노출을 줄입니다.
- 제작자들은 21초와 34초 클립이 Shorts 피드에 노출되고 38초를 넘는 클립은 노출되지 않는 것을 확인했습니다. Clipper는 15~35초를 목표로 합니다.
- 첫 실행은 Python 패키지 설치와 음성 모델 다운로드(약 3GB) 때문에 느립니다.
- NVIDIA GPU가 없으면 더 작은 음성 모델을 쓰고 받아쓰기에 시간이 더 걸립니다.
자주 묻는 질문
- 영상이 클리핑 서비스에 업로드되나요?
- 아닙니다. 내 컴퓨터에서 실행되어 업로드, 워터마크, 분 단위 크레딧이 없습니다. Claude가 대본을 읽고 장면을 고르며 훅을 씁니다.
- 클립에는 무엇이 들어 있나요?
- 깔끔하게 자른 장면, 처음 3초 안에 화면에 뜨는 훅 문구, 단어별 자막, 말하는 사람을 따라가는 크롭이 들어갑니다. 0.7초보다 긴 정지 구간은 제거되고 게시용 파일도 함께 만들어집니다.
- 장면은 어떻게 고르나요?
- Claude가 대본의 모든 문장을 읽습니다. YouTube에서 다시 많이 본 구간, 댓글 속 타임스탬프, 오디오 에너지 급등을 단서로 삼아 첫 1초에 시선을 잡고 단독으로 이해되며 여운이 남는 클립을 고릅니다.
- TYPESAFE_API_KEY는 무엇에 쓰나요?
- 선택 사항입니다. TypeSafe API 키를 TYPESAFE_API_KEY로 설정하면 Claude 없이도 Clipper가 클립을 고르고 렌더링하며, Jev로 후보 점수를 매깁니다. 키가 없으면 Claude가 장면을 고릅니다.
출처
바탕이 된 소식
- gouthamk16/clipper (11월 17일)