캡컷 에이전트
영상을 넣으면 무음·잔말·중복 테이크를 잘라 편집 가능한 CapCut 드래프트를 만들어 줍니다.
영상은 어디에도 업로드되지 않습니다.
분석·전사·드래프트 생성이 전부 사용자 PC 안에서 끝납니다. API 키도 필요 없습니다.
설치
macOS
- 내려받은 zip을 풉니다.
capcut-agent앱 아이콘을응용 프로그램으로 끌어다 놓습니다. (앱 하나를 통째로 옮기세요. 안을 열어 파일을 따로 꺼내면 실행되지 않습니다.)- 앱을 우클릭 → 열기 → 열기로 실행합니다. (첫 실행만 이렇게 합니다. 그냥 더블클릭하면 확인되지 않은 개발자라며 막힙니다.)
- 브라우저가 자동으로 열리면 준비 완료입니다.
진행 상황을 눈으로 보고 싶으면 zip 안의 실행하기.command를 더블클릭하세요.
터미널 창에 로그가 표시됩니다.
Windows
- 내려받은 zip을 풀고 폴더를 원하는 위치에 둡니다.
capcut-agent.exe를 실행합니다.- SmartScreen 경고가 뜨면 추가 정보 → 실행을 누릅니다.
첫 실행은 조금 느립니다.
음성 인식 모델(약 500MB)을 한 번 내려받습니다. 이때만 인터넷이 필요하고, 이후에는 오프라인에서도 동작합니다.
Claude에 연결하기 (선택)
Claude Desktop이나 Claude Code에서 대화로 편집을 시키고 싶다면 MCP 서버로 등록합니다.
자동 등록
터미널(macOS) 또는 명령 프롬프트(Windows)에서 실행 파일에 install-mcp 인자를 주면 됩니다.
# macOS
/Applications/capcut-agent.app/Contents/MacOS/capcut-agent install-mcp
# Windows
capcut-agent.exe install-mcpClaude Desktop을 완전히 종료했다가 다시 켜면 도구가 나타납니다.
연결 후 할 수 있는 말
- "
~/Movies/vlog.mp4분석해 줘" - "삭제 추천된 문장들 보여 줘"
- "3번, 7번은 살리고 나머지 추천대로 드래프트 만들어 줘"
- "자막 SRT로 뽑아 줘"
편집 강도
| 강도 | 설명 |
|---|---|
normal | 안전하게. 확실한 무음만 자릅니다. |
tight | 기본값. 문장 사이와 문장 안쪽 쉼까지 촘촘하게 자릅니다. |
ultra | 가장 촘촘하게. 숨 쉬는 틈까지 잘라내 속도감이 강해집니다. |
자주 겪는 문제
"Failed to load Python shared library" 오류가 납니다 (macOS)
앱 안에서 실행 파일만 따로 꺼내 옮기면 이 오류가 납니다. zip을 다시 풀고
capcut-agent 앱 아이콘 자체를 옮긴 뒤 실행해 주세요.
웹 화면이 안 열립니다
다른 프로그램이 포트를 쓰고 있어도 비어 있는 포트를 자동으로 찾아 뜹니다.
실행 창에 표시된 주소를 브라우저에 직접 입력해 보세요.
포트를 지정하고 싶으면 capcut-agent ui --port 3010으로 실행합니다.
드래프트 폴더를 못 찾는다고 합니다
CapCut을 한 번 실행해 프로젝트를 만든 뒤 다시 시도하세요. 그래도 안 되면 화면에서 폴더를 직접 지정할 수 있습니다.
만든 드래프트가 CapCut에 안 보입니다
CapCut이 켜져 있었다면 완전히 종료했다가 다시 켜 보세요. 드래프트 목록은 실행할 때 읽힙니다.