안녕하세요, 약토피아 약디입니다☺️
오늘은 Claude Code로 약물 작용기전을 설명하는 영상 만드는 방법을 준비했어요. 예시 약물은 PPI(양성자 펌프 억제제)로 골랐습니다. "왜 식전에 먹어야 하나요?"라는 질문에 영상으로 답해볼게요.
AI로 영상을 만들면 그럴듯하지만 틀린 내용이 들어갈 수 있기 때문에, "대본을 쓰고 → 근거 논문으로 확인하고 → 약사가 승인한 내용만" 영상으로 그리게 하는 순서로 진행했어요.
Step 1. 사전 준비물
1/ Claude Code 설치
Claude Code는 Claude 유료 플랜에서 쓸 수 있어요.
Claude Code가 뭔가요?
내 컴퓨터 안에서 직접 일하는 Claude예요.
채팅창의 Claude는 답을 글로 보여 주는 데서 끝나지만, Claude Code는 내 컴퓨터 폴더에 파일을 만들고 필요한 프로그램을 실행하는 것까지 해요.
터미널, VS Code 같은 개발 도구(IDE), Claude 데스크톱 앱에서 쓸 수 있어요.
오늘은 터미널이 낯선 분도 편하게 쓸 수 있는 Claude 데스크톱 앱의 「Code」 탭에서 써 볼게요.
2/ Node.js 설치
nodejs.org에서 LTS 버전을 설치해 주세요. Remotion을 돌리는 데 필요해요.
Node.js 설치방법은 지난 칼럼에서 자세히 설명했으니 참고해주세요!
Remotion이 뭔가요?
코드로 영상을 만드는 도구예요.
장면마다 화면에 무엇을 그릴지 코드로 정해서 영상을 만들어요.
Claude Code와 같이 쓰는 이유
- 코드를 몰라도 돼요. Claude Code에 말로 요청하면 Claude가 Remotion 코드를 대신 짜 줘요. Remotion이 Claude가 보고 따라 할 공식 사용 설명서(스킬)를 만들어 뒀어요
- 그림을 지어내는 영상 생성 AI와 달리, 화면에 들어가는 글자와 숫자를 코드에 적힌 그대로 그려요. 약사가 확인한 자막과 개수를 그대로 넣을 수 있어요.
- 미리보기에서 바로 확인하고, 단어 하나 · 타이밍 하나만 고쳐서 다시 MP4로 뽑을 수 있어요
개인이나 직원 3명 이하 회사는 무료이고, 그보다 큰 회사는 회사용 라이선스가 필요해요.
3/ PubMed 커넥터 연결
PubMed 커넥터 연결 방법은 이전 칼럼 내용 참고해주세요!
Step 2. Claude로 대본 초안 만들기
1/ Claude 데스크톱 앱에서 「Code」 탭을 열고, [Local] → [Select folder]로 작업할 폴더를 고릅니다
저는 [PPI 작용기전 영상]이라는 폴더를 만들어서 진행했어요.
2/ [대본 프롬프트]를 입력합니다
[대본 프롬프트]
'약물', '보는 사람', ' 올릴 곳' 등에 기입하는 내용은 원하는 대로 수정해서 사용하시면 됩니다.
PPI(양성자 펌프 억제제)의 작용기전을 설명하는 짧은 영상 대본을 써 줘.
- 보는 사람: 약국에서 PPI를 처음 받는 환자
- 올릴 곳: 유튜브 (16:9 가로, 약 30초)
- 꼭 담을 내용: 왜 식사 전에 먹어야 하는지
[대본 형식]
- 장면마다 「자막 / 움직임 / 길이(초)」를 표로 쓴다
- 자막은 한 장면에 한 문장, 한 줄에 들어갈 길이로 쓴다
- 움직임에는 화면에 나오는 것의 개수와 순서까지 정한다 (예: 펌프 6개 중 2개가 켜짐). 개수를 정하지 않은 칸을 남기지 않는다
- 화면에 나오는 글자(제목·라벨)는 따로 목록으로 적는다
[주장 목록]
- 대본이 담은 사실 주장을 자막과 움직임에서 모두 뽑아 번호를 붙인다
- 주장마다 「복용법」인지 「작용기전」인지 표시한다
결과는 대본초안.md로 저장해 줘.작업이 완료되면 대본초안.md 파일이 생성 됩니다.
Step 3. 근거 논문 찾기
1/ 같은 창에 이어서 [근거 검색 프롬프트]를 입력합니다
[근거 검색 프롬프트]
프롬프트 입력 전에 PubMed 커넥터가 잘 연결되어 있는지 확인해주세요.
PPI(양성자 펌프 억제제)의 작용기전을 환자용 짧은 영상으로 만들려고 해.
대본초안.md의 주장마다 근거 논문을 PubMed에서 찾아 줘.
[주장 목록]
대본초안.md의 주장 목록 전부
[주장 종류 나누기]
- 복용법·환자 안내(언제·어떻게 먹는지): 진료지침을 찾는다. 국내 학회 지침이 먼저, 그다음 해외 주요 학회 지침.
국내 허가사항은 PubMed에 없으니 "의약품안전나라에서 약사가 직접 확인"이라고만 적는다.
허가사항과 지침이 다르면 허가사항을 따른다.
- 작용기전(약이 몸에서 어떻게 작동하는지): 약리학 리뷰를 찾는다.
오래된 리뷰를 쓰면 최근 10년 안의 리뷰 1건으로 같은 내용을 교차 확인한다.
[넣는 논문]
- PubMed에 색인된 피어리뷰 논문 또는 학회 공식 진료지침
- 성인 대상
- 전문이 무료로 공개된 것 (PMC 등)
- 지침은 최신판
[빼는 논문]
- 소아 전용, 동물 단독, 프리프린트, 제약사 자료, 기사·블로그
- 초록만 볼 수 있는 것
[출력]
1. 후보 표: 주장 번호 | 논문 제목 | 저자·연도·학술지 | DOI | 넣음/뺌 | 이유(위 기준 중 어느 항목인지)
— 검색에 나와서 본 논문은 뺀 것까지 전부 적는다
2. 채택 표: 주장 번호 | 채택 근거 1~2건 | 그 주장을 뒷받침하는 원문 문장(영어 그대로)
3. 근거 없음: 기준에 맞는 근거를 못 찾은 주장 번호와 찾아본 검색어
[지킬 것]
- 기준에 맞는 근거가 없으면 "근거 없음"이라고 쓴다. 기준을 낮춰서 채우지 않는다.
- 원문 문장은 논문 본문에서 그대로 옮긴다. 본문을 못 읽었으면 "본문 미확인"이라고 쓴다.
- 최종 판단은 약사가 한다. 너는 후보와 이유만 정리한다.
결과는 근거선정표.md로 저장해 줘.2/ 근거선정표.md파일이 만들어집니다
채택한 논문과 제외한 논문을 이유와 함께 표로 정리해줍니다.
Step 4. 약사 검토용 대본확인표 만들기
1/ 같은 창에 이어서 [대조 프롬프트]를 입력합니다
[대조 프롬프트]
대본초안.md와 근거선정표.md로 약사가 확인할 대본확인표를 만들어 줘.
[표]
장면 | 자막 | 움직임(개수·순서까지) | 근거 원문 문장(영어 그대로) | 출처 | 판정(일치/일부/근거 없음)
[고치는 법]
- 근거 원문과 다른 자막·움직임은 근거에 맞게 고친다
- 근거가 없는 줄은 표에서 빼고, 표 아래 「뺀 줄과 이유」에 적는다
- 근거 원문 문장은 논문 본문에서 그대로 옮긴다. 본문을 못 읽었으면 「본문 미확인」으로 쓴다
[맨 위에 적을 것]
- 형식: 올릴 곳 · 화면 비율 · 해상도 · 길이
- 화면 제목
- 화면 라벨: 그림 위에 붙일 이름표 목록 (대본초안.md의 화면 글자 목록에서 가져온다)
[맨 아래에 적을 것]
- 약사가 확인해야 할 점 (허가사항 확인이 필요한 줄, 판정이 「일부」인 줄)
- 최종 판단은 약사가 한다
결과는 대본확인.md로 저장해 줘.2/ 대본확인.md 를 약사가 검토합니다
대본(자막) 한 줄마다 근거가 된 논문 원문 문장과 판정(일치 · 일부 · 근거 없음)이 붙은 표가 나와요.
검토하면서 필요한 부분은 수정합니다. 최종 자막을 결정하고 나면 '이 자막으로 대본확인.md'에 최종 반영해줘' 라고 요청하면 됩니다.
Step 5. Remotion으로 영상 만들기
1/ 같은 창에서 [Remotion 프로젝트 프롬프트]를 입력합니다
[Remotion 프로젝트 프롬프트]
이 폴더에 Remotion 영상 프로젝트를 만들어 줘.
- Remotion 공식 안내(https://www.remotion.dev/docs/ai/coding-agents) 순서대로 만들고, 프로젝트 이름은 my-video로 한다
- Remotion 스킬도 설치한다
- 다 되면 미리보기(npm run dev)를 켜고 열 주소를 알려 준다Claude Code가 Remotion 공식 안내 순서대로 프로젝트를 만들고, Claude가 참고할 Remotion 스킬까지 설치한 뒤 미리보기 주소를 알려줍니다.
중간에 명령을 실행해도 되는지 물으면 허용해 주세요.
2/ 이어서 [영상 프롬프트]를 입력합니다
[영상 프롬프트]
‘형식’과 ‘스타일’은 원하는대로 수정해서 사용하세요.
대본확인.md(약사 확인 완료)대로 Remotion 영상을 만들어 줘.
[형식]
- 대본확인.md 맨 위에 적힌 형식 그대로 만든다 (유튜브 16:9, 1920×1080, 30fps)
[데이터에서만 그리기]
- 자막, 장면 길이, 개수, 화면 글자(제목·라벨)는 src/scenes.json에 대본확인.md에서 글자 그대로 옮긴다
- 영상 코드는 scenes.json 값만 쓴다. 코드에 자막·라벨 글자나 개수를 직접 적지 않는다
- 대본확인.md의 화면 라벨은 빠짐없이, 각 라벨이 가리키는 그림 위에 붙인다
- 대본확인표에 없는 글자·숫자·구조(그래프, 날짜 막대, 세포 안 구조 등)는 넣지 않는다
[스타일]
- 따뜻한 플랫 일러스트: 크림색 배경, 부드러운 그라데이션과 그림자, 둥근 도형
- 위쪽에 제목, 아래쪽에 자막 한 줄. 자막과 그림 사이를 너무 띄우지 않는다
[카메라]
- 약이 펌프에 붙는 장면에서는 펌프 하나로 다가가 가까이 보여 준 뒤 다시 빠진다
- 장면이 바뀔 때 자연스럽게 전환한다. 제목과 자막은 카메라를 따라 움직이지 않는다
[확인]
- 장면마다 자막이 다 보이는 프레임을 npx remotion still로 뽑아 대본확인표와 자막·개수를 대조한다
- 다르면 고친 뒤 npx remotion render로 out/video.mp4를 만든다Step 4에서 최종 확인한 대본확인.md를 토대로, Claude Code가 방금 만든 my-video 폴더 안에 영상을 만들어줍니다. 미리보기 화면(Remotion Studio)도 볼 수 있어요.
📹 최종 결과물
아래 링크에서 확인하실 수 있습니다.
오늘은 Claude Code와 Remotion을 활용해 근거 기반의 PPI 작용기전 영상을 만들어 봤는데요, 다른 약의 기전 영상도 프롬프트의 약 이름만 바꿔 같은 순서로 만들어 보시면 좋을 것 같아요!🙂
오늘 내용이 도움 되셨다면, 주변 동료분들께 많이 공유해주세요💚
약토피아의 다른 채널이 궁금하다면?
💛 약토피아 AI 오픈카톡방 (참여코드: 0327)
650명 이상의 약사/제약인 분들이 참여하고 있어요!
