Claude Code로 지피터스 20기 다시보기 유튜브 재생목록 자동 동기화 커맨드 만들기
한줄 요약
지피터스 다시보기 영상 링크를 유튜브 재생목록에 자동으로 추가하는 Claude Code 커맨드를 만들어서, 출퇴근 시 끊김 없이 자동 재생으로 학습할 수 있게 되었습니다.
이런 분들께 도움돼요
지피터스/온라인 강의 다시보기를 유튜브 재생목록으로 정리하고 싶은 분
매번 사이트 로그인하고 영상 하나씩 클릭하는 게 귀찮은 분
Claude Code로 반복 업무를 자동화하고 싶은 분
크롬 확장프로그램 디버깅에 지친 분
소개: 시도하고자 했던 것과 그 이유
문제 상황
지피터스 20기 스터디에 참여하면서 매주 10개 이상의 다시보기 영상을 봐야 했습니다. 그런데 매번:
지피터스 사이트에 로그인해야 하고
영상 하나를 본 다음 다시 이전 화면으로 돌아가서
다음 영상을 클릭해야 하는 번거로움이 있었습니다
출퇴근 시간(왕복 2시간)을 활용해서 영상을 보고 싶었는데, 지하철에서 이 과정을 반복하는 건 너무 불편했어요.
기존 시도와 한계
처음에는 크롬 확장프로그 램으로 유튜브 재생목록에 추가하는 기능을 개발했었습니다. 하지만:
문제가 생기면 직접 일일이 에러 체크하고
디버깅하면서 문제 해결해야 했습니다
유튜브 API 변경, 인증 만료 등 예상치 못한 오류가 자주 발생
"유지보수가 너무 힘들다"는 생각이 들었습니다.
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
Claude Code (CLI 버전)
YouTube Data API v3 (OAuth 2.0 인증)
Python (google-api-python-client)
Claude Code 커맨드 구조
Claude Code에서는 .claude/commands/ 폴더에 마크다운 파일을 만들면 커스텀 커맨드로 사용할 수 있습니다.
.claude/
├── commands/
│ └── youtube-playlist-sync.md # 커맨드 정의
└── skills/
└── youtube-playlist-sync/
├── SKILL.md # 스킬 설명
└── scripts/
└── youtube_playlist_sync.py # Python 스크립트
실제 사용 흐름
Step 1: 지피터스에서 다시보기 링크 저장
지피터스 사이트에서 다시보기 > "링크 다운로드"를 실행하면 텍스트 파일이 다운로드됩니다.
Step 2: 확장자 변경
다운로드된 파일의 확장자를 .txt → .md로 변경합니다.
Step 3: Claude Code에서 명령 실행
/youtube-playlist-sync "지피터스 20기" @00-inbox/지피터스 20기 1주차_다시보기_링크.md
이게 끝입니다!
핵심 기술: PowerShell 한글 문제 해결
Windows PowerShell에서 한글 인자를 전달하면 인코딩이 깨지는 문제가 있었습니다. Claude Code가 이 문제를 JSON job 파일 방식으로 우회하도록 설계해줬습니다.
{
"markdown_path": "D:\\Projects\\pkm\\00-inbox\\지피터스 20기 1주차_다시보기_링크.md",
"playlist_name": "지피터스 20기",
"privacy_status": "private"
}
AI와의 협업에서 인상적이었던 점
문제가 생겨도 Claude Code AI가 알아서 처리해줍니다.
크롬 확장프로그램의 경우 문제가 생기면 내가 직접 일일이 에러 체크하고 디버깅하면서 문제 해결해야 했는데, Claude Code에서 처리하면 굉장히 편리하게 문제가 해결됩니다.
예를 들어:
OAuth 토큰 만료 → 자동으로 재인증 안내
중복 영상 감지 → 이미 있는 영상은 건너뜀
API 오류 → 에러 메시지 해석 후 해결책 제시
결과와 배운 점
정량적 결과
항목
Before
After
영상 1개 추가 시간
30초~1분
자동
16개 영상 추가
8~16분
10초
에러 발생 시 해결
30분~1시간
AI가 처리
실제 사용 효과
이제 출퇴근 시 한 번만 유튜브 재생목록에서 실행하면 자동으로 여러 스터디의 다시보기를 연속 재생할 수 있습니다.
일상의 작은 부분이지만 나에게는 귀찮은 문제가 해결되어 가려운 부분이 해소된 것 같아 너무 좋습니다!
배운 점
Claude Code 커맨드 시스템의 강력함: 복잡한 자동화도 마크다운 파일 하나로 정의 가능
AI의 디버깅 능력: 문제 해결을 AI에게 위임하면 유지보수 부담이 크게 줄어듦
JSON 우회 패턴: Windows 환경에서 한글 인코딩 문제 해결의 정석
재사용 가능한 프롬프트
커맨드 실행 프롬프트
/youtube-playlist-sync "재생목록명" @파일경로.md
처음 세팅할 때 Claude Code에게 요청하는 프롬프트
유튜브 재생목록에 마크다운 파일의 YouTube 링크를 자동으로 추가하는
Claude Code 커맨드를 만들어줘.
요구사항:
- 마크다운 파일에서 YouTube 링크를 추출
- 재생목록에 이미 있는 영상은 중복 추가하지 않음
- PowerShell에서 한글 인자 전달 시 깨지지 않도록 JSON job 파일 방식 사용
- YouTube Data API와 OAuth 인증 사용
파일 구조 및 코드
커맨드 정의 파일 (.claude/commands/youtube-playlist-sync.md)
---
description: 유튜브 재생목록에 Markdown 링크 목록을 추가 (중복 방지)
allowed-tools: Read, Write, Edit, Bash
---
# /youtube-playlist-sync - YouTube 재생목록 동기화
Markdown 파일의 YouTube 링크를 지정한 재생목록으로 추가한다.
이미 존재하는 영상은 건너뛰어 중복 저장을 방지한다.
## 사용법
/youtube-playlist-sync "재생목록명" @00-inbox/링크목록.md
주요 기능
링크 추출: 마크다운에서 youtube.com, youtu.be 링크 자동 인식
중복 방지: 재생목록에 이미 있는 영상 ID 체크 후 건너뜀
자동 생성: 재생목록이 없으면 새로 생성 (private 기본값)
마무리
작은 불편함이었지만, Claude Code로 해결하니 "왜 진작 안 했지?"라는 생각이 듭니다.
특히 에러가 나도 AI가 알아서 해결해준다는 점이 가장 큰 장점입니다. 크롬 확장프로그램처럼 혼자 디버깅하느라 시간 낭비할 필요가 없어요.
지피터스 스터디원 분들도 비슷한 불편함이 있다면 한번 시도해보세요!
사용 환경: Windows 11, Claude Code CLI, Python 3.11+ 작성일: 2026-01-23 작 성자: 황금호랑이 (지피터스 20기)
