클로드 코드 영상 편집, 쇼츠 맡기기 전 확인할 조건
클로드 코드 영상 편집을 ffmpeg-skill로 시작하기 전에 설치 요건과 한국어 자막, 먼저 써 본 사람들이 막힌 곳을 확인하고 시험 영상부터 돌려 보세요.
이 사례, 나한테 해당될까요?
- 지금 해 보기같은 형식의 쇼츠·릴스를 매주 만들고 Claude Pro 이상을 이미 쓰는 사람15초 시험 영상 하나로 doctor 점검과 저해상도 시안부터 돌려 보기
- 조건 확인 후맥에서 Homebrew로 ffmpeg를 깔았거나 한국어 자막을 넣으려는 사람doctor 점검에서 자막 도구와 한국어 글꼴을 쓸 수 있다고 나오는지 먼저 보기
- 기다려도 됨터미널을 처음 쓰거나 컷마다 감으로 다듬는 편집을 하는 사람지금 쓰는 편집기는 그대로 두고, 편집 계획표만 AI로 만들어 보기
그로우빗이 직접 실행해 본 결과가 아니라 원저자 자료와 공개된 사용자 보고를 대조한 내용입니다(2026-11-18 확인).
읽는 대신, 내 AI에게 시켜 보세요
받아쓴 대본과 타임코드, 만들 영상 조건을 붙여 넣으면 편집 도구에 넘길 남길 구간표와 자막표, 사람이 눈으로 볼 장면 목록을 만들어 줍니다.
프롬프트 내용 펼쳐 보기프롬프트 내용 접기
당신은 숏폼 영상의 편집 계획을 세우는 편집 조수입니다. 아래 두 칸에 붙여 넣은 자료만 근거로, 편집 도구(사람이든 AI 에이전트든)에 넘길 편집 계획표를 만들어 주세요. 규칙 - 자료에 없는 장면, 시간, 대사, 숫자는 지어내지 마세요. 모르면 "확인 필요"라고 적으세요. - 타임코드와 숫자는 자료에 적힌 그대로 쓰세요. 같은 구간의 시간이 자료끼리 다르거나 시작이 끝보다 늦으면 고치지 말고 "불일치"로 표시하세요. - 자막은 원본 대사를 그대로 쓰세요. 줄여야 하면 원문과 줄인 문장을 나란히 적으세요. - 근거 없는 과장 표현(최고, 무조건 같은 말)은 자막에 넣지 말고, 뺀 문구와 이유를 한 줄씩 알려 주세요. - 목표 길이를 맞추려고 대사를 새로 만들지 마세요. 길이가 맞지 않으면 남거나 모자란 시간을 초 단위로 알려 주세요. 출력 형식 1. 남길 구간표: 순서 / 시작 / 끝 / 길이(초) / 남기는 이유 2. 자막표: 구간 / 원본 대사 / 화면 자막(줄였으면 원문과 함께) 3. 길이 계산: 남길 구간의 합계와 목표 길이의 차이 4. 사람이 눈으로 확인할 장면: 자막 위치, 얼굴 잘림, 화면 속 글자처럼 도구가 재지 못하는 것 5. 확인 필요·불일치·뺀 문구 목록 만들 영상 조건: [화면 비율 / 목표 길이(초) / 올릴 곳(쇼츠·릴스·틱톡)] 원본 대본과 타임코드: [받아쓰기 결과나 촬영 메모를 시간과 함께 붙여 넣기]
고객 얼굴이 나오는 원본이나 개인정보가 담긴 대본은 붙여 넣기 전에 이름·연락처를 지우세요.

쇼츠·릴스를 혼자 만드는 마케터와 1인 사업자를 위한 글입니다. 컷 편집과 자막에 매일 시간을 쓰다 보면 "Claude Code에 맡기면 편집 프로그램이 필요 없다"는 말이 솔깃합니다.
이 글은 오픈소스 스킬 ffmpeg-skill의 원저자 자료와, 먼저 써 본 사람들이 GitHub·Reddit에 남긴 보고를 대조했습니다. 무엇이 되고, 어디서 막혔고, 얼마가 들고, 어떤 순서로 시작하면 덜 헤매는지를 정리합니다.
클로드 코드 영상 편집은 실제로 무엇을 하나요?
Claude Code가 영상을 직접 그리는 것이 아니라, 내 컴퓨터의 FFmpeg(영상 자르기·변환 프로그램)를 다루는 도구를 골라 실행합니다. ffmpeg-skill은 이 일을 정해진 순서로 하게 만드는 Agent Skill(AI에게 작업 방법을 알려 주는 설명서 묶음)입니다.
README 기준으로 자르기, 무음 삭제, 화면 비율 맞추기, 자막, 음량, 플랫폼별 내보내기 같은 도구 42개가 들어 있고, Cursor·Codex에서도 쓸 수 있습니다. 2026년 11월 18일 확인한 npm 최신판은 3.10.1입니다.
원저자가 든 예시는 이렇습니다. 인터뷰 영상에서 두 구간을 남기고 릴스용 60초로 맞춰 달라고 하면, 에이전트가 원본을 측정하고 자르고 9:16으로 맞춘 뒤 결과 파일을 다시 재서 "59.98초, 1080×1920, 30fps"처럼 보고합니다. 이 예시는 원저자 설명이며, 그로우빗이 같은 결과를 직접 얻어 본 것은 아닙니다.
ffmpeg-skill은 무엇을 확인해 주고 무엇은 못 하나요?
길이, 해상도, 음량처럼 잴 수 있는 값은 결과 파일을 다시 재서 통과 여부를 적습니다. 화면 내용과 자막이 보기 좋은 자리에 있는지는 "확인하지 않음" 목록에 따로 적습니다.
| 구분 | 도구가 재거나 기록하는 것 | 사람이 봐야 하는 것 |
|---|---|---|
| 컷 편집 | 결과 길이, 앞뒤 끝이 제대로 재생되는지 | 잘린 구간에 중요한 말이 있었는지 |
| 화면 비율 | 출력 크기와 초당 프레임 수 | 9:16으로 자를 때 인물이 화면 밖으로 나갔는지 |
| 자막 | 자막 문구를 바꾸지 않고 넣었는지, 실제로 쓴 글꼴 이름(결과에 기록) | 자막 위치와 읽기 쉬운지 |
| 음량 | 목표 음량(쇼츠용 -14 LUFS 기본)과 최대 음량 | 배경음과 목소리 균형 |
README에 따르면 16:9 영상을 9:16으로 자르면 남는 폭이 30% 정도라서, 장면 모음 이미지(contact sheet)를 확인한 뒤 정하라고 권합니다. 같은 이름의 결과 파일이 있으면 덮어쓰지 않고 멈추며, --dry-run으로 실행할 명령을 미리 보여 줍니다.
먼저 써 본 사람들은 어디서 막혔나요?
GitHub에 외부 사용자가 올린 보고를 보면, 편집 실력보다 설치된 FFmpeg 구성과 스킬의 버그에서 먼저 막혔습니다. 2026년 11월 4일 한 사용자는 맥 Homebrew의 기본 ffmpeg에는 자막 필터가 없어 자막 작업이 원인 모를 오류로 실패하는데, --dry-run(실제로 처리하지 않는 시험 실행)은 문제없이 통과했다고 보고했고 이 이슈는 11월 5일 닫혔습니다.
11월 10일에는 자기 릴스 편집기에 이 스킬을 쓰는 다른 사용자가 가로나 세로 픽셀 수가 홀수인 휴대폰 스크린샷 JPEG에서 실패하는 문제와, 자막 위치 지정이 엉뚱한 곳에 찍히는 문제를 올렸습니다. 관리자는 11월 11일 두 문제를 FFmpeg 6.1.1에서 재현했고, 수정 사항을 #435에 넣어 다음 릴리스에 반영하겠다고 답했습니다.
Reddit에는 ffmpeg-skill이 아니라 Remotion 같은 다른 도구로 Claude에게 편집을 맡겨 본 사람들의 경험담이 있고, 이들은 시간과 한계를 짚습니다.
- ▸r/ClaudeAI(2026-10-29)에서 한 사용자는 최근 유튜브 영상을 Claude로만 편집했고, 20달러 요금제 안에서 했지만 한 편에 2~4시간이 걸렸으며 작업 방식을 다듬는 데 몇 주가 들었다고 적었습니다.
- ▸r/ClaudeCode(2026-11-08)에서 다른 사용자는 첫 결과물까지 15~30분, 수정 요청마다 10~15분이 걸린다고 했습니다.
- ▸같은 질문을 올린 r/claudeskills 글타래에서는 프레임까지 맞추는 편집은 사람이 직접 봐야 한다며 편집 전체를 맡기지는 않는다는 의견도 나왔습니다.
이 시간은 컴퓨터와 영상 길이에 따라 다른 개인 경험입니다.
한국어 자막과 군말 자르기도 되나요?
README에 따르면 한국어 자막에는 한글을 표시할 수 있는 글꼴을 자동으로 찾아 쓰고, 그런 글꼴이 컴퓨터에 없으면 깨진 글자로 결과를 내지 않고 오류로 알립니다. 한국어 표시 가능 여부는 doctor의 글꼴 점검 항목(fonts.scripts의 ko)에 따로 나오므로 작업 전에 확인할 수 있습니다.
"음", "어" 같은 군말을 자르는 기능의 기본 단어 목록에도 한국어가 들어 있습니다. 다만 이 기능은 말한 단어마다 시각이 찍힌 받아쓰기 결과가 있을 때만 작동합니다. 그런 파일이 이미 있으면 넘겨 주면 되고, 받아쓰기까지 이 스킬로 하려면 faster-whisper 같은 음성 인식 프로그램을 따로 깔아야 합니다. README 설명으로는 음성 인식이 내 컴퓨터 안에서 돌아 녹음이 외부로 나가지 않으며, 처음 돌릴 때 모델을 한 번 받습니다.
외부 사용자가 음성 인식 엔진을 비교한 공개 시험(2026-10-10)은 영어 음성 58분으로 했기 때문에, 이 스킬 경로에서의 한국어 받아쓰기 정확도는 공개 자료로 확인되지 않았습니다. 받아쓰기 결과를 자막에 쓰기 전에 직접 훑어볼 시간을 잡아 두세요.
비용과 설치 조건은 어떻게 되나요?
ffmpeg-skill 자체는 MIT 라이선스의 무료 오픈소스입니다. 비용은 Claude Code를 쓰기 위한 Claude 요금제에서 나오며, 공식 문서에 따르면 무료 요금제로는 Claude Code를 쓸 수 없습니다.
| 항목 | 내용(2026-11-18 확인) |
|---|---|
| Claude Code 이용 | Pro·Max·Ultra·Team·Enterprise 또는 Console 계정, 또는 Amazon Bedrock 같은 외부 API 제공사 |
| Pro 요금 | 월 결제 20달러, 연간 결제 시 월 17달러(선불 200달러), 세금 별도 |
| 사용 한도 | 5시간마다와 주 단위 한도가 적용되며 모델·대화 길이·파일 크기에 따라 빨리 찰 수 있음 |
| 원화 요금 | 공식 요금 페이지가 달러로 표시돼 확인 못 함 |
| 필요한 프로그램 | FFmpeg 6.1 이상, Python 3.10 이상, npx 설치 시 Node 16 이상 |
설치 조건에서 가장 자주 걸리는 곳은 운영체제별 FFmpeg입니다. 맥은 README가 brew install ffmpeg-full을 권하는데, 기본 ffmpeg 패키지에는 자막·글자 그리기 필터가 빠져 있기 때문입니다. ffmpeg-full은 설치해도 자동으로 연결되지 않습니다. PATH에 잡힌 ffmpeg가 Homebrew 기본 패키지라면 스킬이 같은 Homebrew의 ffmpeg-full을 스스로 찾아 쓰지만, ffmpeg가 아예 없다면 README 안내대로 PATH 앞에 넣거나 brew link로 연결해야 합니다. 윈도는 winget 설치를 안내하지만, 실제 기기로 찍은 영상 묶음 시험과 관리자 외 사용자의 설치 확인은 윈도에서 아직 끝나지 않았다고 README가 스스로 밝힙니다.
처음 시작한다면 어떤 순서가 안전한가요?
긴 원본을 바로 맡기기보다, 15초짜리 시험 영상으로 설치와 결과 확인 흐름부터 맞추는 편이 안전합니다. 아래 순서는 Reddit 사용자들의 조언과 README의 점검 기능을 묶은 것입니다.
npx ffmpeg-skill로 설치한 뒤 npx ffmpeg-skill doctor --json에서 자막 도구를 쓸 수 있는지(tools 항목)와 한국어 글꼴(fonts.scripts)을 봅니다.--dry-run으로 어떤 명령을 쓸지 확인합니다."더 좋게 해 줘" 대신 "0:20~0:23 자막이 얼굴을 가려요"처럼 구간과 문제를 함께 적으면 다시 고쳐 달라는 횟수가 줄었다는 경험담이 r/ClaudeCode에 있었습니다. 컷과 자막 정보를 편집 계획 파일 하나에 모아 두면 한 줄만 고쳐 다시 렌더링할 수 있습니다.
같은 형식의 영상을 자주 만드는 사람이라면 이 순서로 틀을 잡아 둘 만합니다. 영상마다 연출이 다르다면 지금은 위 프롬프트로 편집 계획표만 받고, 편집은 쓰던 프로그램으로 하는 편이 낫습니다. 스킬과 MCP의 차이는 Claude Code 스킬과 MCP 비교에, Claude Code가 처음이라면 무료 입문 강의에 정리해 두었습니다. 캡컷 쪽 AI 기능이 궁금하다면 캡컷 ChatGPT 연결 소식도 함께 보세요.
참고 자료
- ▸GitHub kajisho5/ffmpeg-skill, 「README」(v3.10.1, 2026-11-18 확인) — https://github.com/kajisho5/ffmpeg-skill
- ▸GitHub kajisho5/ffmpeg-skill 이슈 #393, 「caption.py / render.py: a build without the subtitles filter fails with an unclassified parse error, and --dry-run passes」(2026-11-04) — https://github.com/kajisho5/ffmpeg-skill/issues/393
- ▸GitHub kajisho5/ffmpeg-skill 이슈 #436, 「caption.py --srt: --position lands in the wrong place (legacy SSA alignment)」(2026-11-10) — https://github.com/kajisho5/ffmpeg-skill/issues/436
- ▸GitHub kajisho5/ffmpeg-skill 이슈 #437, 「insert.py fails on odd-sized JPEGs (phone screenshots)」(2026-11-10) — https://github.com/kajisho5/ffmpeg-skill/issues/437
- ▸GitHub kajisho5/ffmpeg-skill 이슈 #318, 「ASR: Parakeet vs whisper.cpp on six speech sets, two Macs (and a whisper.cpp repetition loop that
-mc 0stops)」(2026-10-10) — https://github.com/kajisho5/ffmpeg-skill/issues/318 - ▸Reddit r/ClaudeAI, 「How do you actually create videos with Claude? Looking for advice on Skills for Shorts/Reels with TTS audio, while keeping token usage low」(2026-10-29) — https://www.reddit.com/r/ClaudeAI/comments/1xihme5/how_do_you_actually_create_videos_with_claude/
- ▸Reddit r/ClaudeCode, 「I’m video editing daily with Claude (Whisper, FFmpeg, HyperFrames setup) - but it’s terribly long to work and needs to be reprompted few times to get a good end result. It can take hours for one video. Any tips to accelerate this process?」(2026-11-08) — https://www.reddit.com/r/ClaudeCode/comments/1xqugx1/im_video_editing_daily_with_claude_whisper_ffmpeg/
- ▸Reddit r/claudeskills, 같은 작성자의 같은 제목 글(2026-11-08) — https://www.reddit.com/r/claudeskills/comments/1xqui10/im_video_editing_daily_with_claude_whisper_ffmpeg/
- ▸Claude Code Docs, 「Advanced setup」(2026-11-18 확인) — https://code.claude.com/docs/en/setup
- ▸Claude, 「플랜 및 요금제」(2026-11-18 확인) — https://claude.com/pricing
함께 읽으면 좋은 글
Claude 실무 글을 먼저, 그다음 최신 글을 보여 드려요

CLAUDE.md 규칙이 무시될 때, 줄이는 기준과 훅 설정
CLAUDE.md 규칙이 자꾸 무시된다면 파일을 줄이는 기준부터 보세요. 반드시 지킬 규칙을 훅으로 옮기고, 훅이 실패할 때 통과되지 않게 설정하세요.

클로드 코드 대화 기록에 남은 비밀번호, 지우기 전 할 일
클로드 코드 대화 기록에 비밀번호나 API 키를 붙여 넣었다면 기록부터 지우지 마세요. 교체, 노출 기간 확인, 기록 정리, 재발 방지 순서로 점검하세요.

깃허브 기여자에 Claude가 뜰 때 끄는 설정과 지우는 순서
깃허브 기여자 목록에 Claude가 보이면 커밋 기록 문제인지 화면 갱신 지연인지부터 나누세요. 앞으로 끄는 설정과 이미 남은 기록 처리 순서를 확인하세요.