클로드 코드로 내 체스 복기 영상 만드는 법: 음성 메모가 엔진 분석과 만나면 생기는 일

체스 복기는 수치만 나열된 엔진 분석으로는 내 생각이 어땠는지, 왜 그 수를 뒀는지 설명하지 못합니다. 클로드 코드 스킬 'chess-postmortem-skills'는 내 음성 메모를 텍스트로 변환하고, 수순별 시각과 매칭해 스톡피시에게 '왜 내 수가 나빴나'를 집요하게 묻고, 내 말로 된 해설 영상까지 자동으로 만들어 줍니다.

이 도구는 무엇인가요

Claude Code용 스킬은 리체스 게임 링크와 음성 메모(또는 텍스트)를 입력받아, Stockfish 기반의 주석 PGN, 독립 실행형 HTML 뷰어, 그리고 내레이션 영상까지 자동으로 만들어 주는 전체 파이프라인이에요. Claude는 whisper.cpp 로 로컬에서 음성을 텍스트로 변환하고, PGN의 시계 시간과 매칭해 각 수마다 사용자가 어떤 생각을 했는지 기록합니다. 그런 뒤 엔진에 "왜 이 수를 두었나요?" 같은 인간적인 질문을 던져 답을 얻고, 이를 자연어로 정리해 주석 PGN와 영상에 삽입합니다.

1. 1. 게임 선택

   15+10 급전이나 장기(코리전스) 등 생각할 시간이 있는 게임을 골라 리체스 링크를 복사합니다.

2. 2. 생각 소리 녹음

   폰이나 웹 음성 녹음기로 수마다 떠오른 질문·계획을 녹음합니다. 전체 게임을 커버하면 좋습니다.

3. 3. Claude Code에 입력

   Claude Code를 열고 "analyze this game: <링크>, here is my think‑aloud recording:" 라고 말합니다.

4. 4. 결과 기다리기

   전체 파이프라인(스윕, 조사, 주석, 영상 생성)에는 약 1시간 정도 소요됩니다.

5. 5. 출력 확인

   주석이 달린 PGN, 스탠드얼론 HTML 뷰어, 그리고 내레이션 영상이 제공됩니다.

이 스킬은 Claude Code를 로컬에서 실행할 수 있어야 하며, 토큰 소모가 발생합니다. 한 번 분석에 약 $15 정도의 API 비용이 들 수 있으니 토큰 잔량을 확인해 주세요. 결과물은 오류가 거의 없지만, 이상한 부분이 보이면 Claude에게 해당 포지션을 다시 Stockfish로 검증하도록 요청하면 됩니다.

• 느린 게임(15+10 급전, 코리전스) 권장
• 전체 게임에 대한 음성·텍스트 메모가 있으면 효과 최고
• 분석 완료까지 약 1시간 소요
• API 비용이 발생하니 토큰 한도 확인

왜 쓰나요: 엔진 수치 대신 '내 생각의 복기'를 얻기 위해

이 도구를 쓰는 가장 큰 이유는 단순히 엔진이 제시하는 수치‑변수에 머무르지 않고, 경기 중 스스로 던졌던 질문과 추론을 그대로 되돌아볼 수 있기 때문이에요. Claude는 whisper.cpp 로 음성 메모를 텍스트로 변환하고, PGN 의 시각 정보와 매칭해 “8수에서 비숍을 c4에 둘까, e2에 둘까?” 같은 본인의 물음에 엔진이 답하도록 만들어요. 그래서 결과 영상에서는 내 질문이 등장하고, Stockfish 가 그에 대한 검증된 답변을 제공하니, 정당했던 계획과 불필요했던 두려움을 명확히 구분할 수 있습니다.

이러한 복기는 학습 효과를 크게 높여줘요. 주석 PGN 과 함께 제공되는 내레이션 영상에서는 어떤 포지션에서 어떤 생각을 했는지, 그 생각이 왜 맞았는지 혹은 왜 틀렸는지를 엔진이 직접 설명해 줍니다. 오류는 드물지만, 의심되는 부분은 언제든 Claude 에게 다시 확인하도록 요청하면 됩니다. 단, 15+10 급의 느린 게임이나 서신 게임에 적합하고, 전체 프로세스는 약 1시간 정도 걸리니 여유를 두고 사용하세요.

1. 링크와 음성 메모 준비

   lichess 게임 URL 과 전체를 녹음한 mp3(또는 텍스트 메모)를 준비합니다.

2. Claude Code에 요청

   "analyze this game: <링크>, here is my think‑aloud recording:" 라고 말합니다.

3. 엔진 처리 대기

   약 1시간 정도 기다리면 Stockfish sweep, 주석 PGN, 독립 실행형 HTML 이 생성됩니다.

4. 영상 및 주석 확인

   생성된 내레이션 영상과 주석 PGN 을 보며 자신의 질문과 엔진 답변을 비교합니다.

5. 추가 질문

   궁금한 포지션을 다시 물어보면 Claude 가 엔진과 검증 후 답변을 줍니다.

설치·사용 5단계: 녹음부터 영상까지

클로드 코드로 체스 복기 영상을 만들려면 5가지 단계만 따라하면 됩니다. 먼저 급속·장고 같은 충분히 생각할 수 있는 게임을 하나 준비하고, 경기 중 혹은 종료 후에 스마트폰이나 웹 음성 녹음기로 자신의 생각을 녹음합니다. 녹음 파일과 해당 경기의 Lichess 링크를 클로드 코드에 전달하면, 엔진이 자동으로 주석이 달린 PGN과 독립 실행형 HTML을 만들어 줍니다. 마지막으로 “영상 만들어줘” 라는 명령만 하면 내레이션이 들어간 동영상이 완성됩니다.

전체 흐름은 약 1시간 정도 소요됩니다. 클로드 코드는 음성을 Whisper.cpp 로 로컬 전사하고, PGN의 시간표와 매칭해 움직임마다 어떤 질문을 했는지 파악합니다. 그런 뒤 Stockfish와 대화를 이어가면서 인간적인 설명을 추가하고, 최종적으로 주석 PGN·HTML·스토리보드·음성 내레이션을 모두 포함한 비디오 파일을 출력합니다.

1. 1️⃣ 게임 준비

   15+10 급속 혹은 장고 게임을 선택해 충분히 생각할 시간을 확보합니다.

2. 2️⃣ 음성(또는 필기) 녹음

   플레이 중 혹은 종료 후, 스마트폰·웹 음성 녹음기로 자신의 생각을 녹음합니다.

3. 3️⃣ 클로드 코드에 전달

   Lichess 경기 링크와 녹음 파일을 클로드 코드에 입력합니다.

4. 4️⃣ 엔진 분석 대기≈ 1시간

   클로드 코드가 Stockfish와 대화하면서 주석 PGN·HTML을 생성합니다.

5. 5️⃣ 영상 생성

   “영상 만들어줘” 라고 명령하면 내레이션 비디오가 만들어집니다.

analyze this game: https://lichess.org/XXXXX, here is my think-aloud recording: mygame.mp3

• 스마트폰·웹 음성 녹음기
• Lichess 경기 링크
• Claude Code 접근 권한
• 약 1시간 정도의 처리 시간

• 음성 녹음 파일을 mp3 형식으로 저장
• Lichess 경기 링크 복사
• Claude Code에 파일과 링크 전달
• 1시간 정도 기다린 뒤 결과 확인
• ‘영상 만들어줘’ 명령으로 비디오 생성

한눈에 보는 산출물 구조와 비용

분석이 끝나면 내 로컬 폴더에 네 가지 핵심 파일이 쌓입니다. 각각은 독립적으로도 쓸 수 있고, 순서대로 열어보면 '엔진 수치 → 내 생각 복기 → 영상 시청' 흐름이 자연스럽게 이어지도록 설계돼 있어요.

비용·시간 대부분은 '스위프 → 조사관 서브에이전트 병렬 질의 → 검증 패스 → 비디오 렌더링' 순서로 소모됩니다. 음성 메모가 길수록 전사·매핑 단계가 늘어나지만, 그만큼 내 사고 과정을 엔진이 정밀하게 반박해 주니 학습 밀도가 높아집니다. 퀴터가 부족하면 analyze 단계까지만 돌리고 make a video는 나중에 따로 실행해도 됩니다.

정리: 내 실수를 내 목소리로 복기하는 새로운 루틴

Claude Code를 활용하면 이제 내 목소리로 남긴 생각을 그대로 복기할 수 있어요. 15+10 급속이나 장고 같은 충분히 생각할 시간이 있는 게임을 골라, 게임 도중에 스마트폰이나 웹 녹음기로 생각을 말해 두면 됩니다. 게임이 끝난 뒤에는 lichess 링크와 음성 파일을 Claude에 전달하면, 엔진인 Stockfish가 제시하는 수치뿐 아니라 “왜 그 수를 두었지?” 같은 저의 질문까지도 영상과 주석 PGN에 반영됩니다. 전체 과정은 약 1시간 정도 소요되고, API 사용량 기준으로 약 $15 정도 비용이 들지만, 스스로 던진 질문에 대한 답을 얻을 수 있어 학습 효과가 크게 올라갑니다.

1. 게임 선택

   15+10 급속, 장고, 혹은 통신 게임처럼 생각할 여유가 있는 게임을 하나 정합니다.

2. 음성 기록

   게임 진행 중에 스마트폰 녹음기 등으로 ‘think‑aloud’를 기록합니다. 프랑스어, 한국어, 어떤 언어든 상관없습니다.

3. Claude에 명령

   Claude Code 창을 열고 다음과 같이 입력합니다.

4. 결과 확인

   약 1시간 뒤에 주석 PGN, 독립 실행형 HTML, 그리고 나레이션 영상이 생성됩니다.

analyze this game: https://lichess.org/XXXXX, here is my think-aloud recording:

• 자신의 최근 급속 게임을 하나 골라 기록해 보세요.
• 위의 analyze this game 명령을 Claude에 입력하고 기다립니다.
• 생성된 영상과 주석을 확인하고, 이해되지 않는 부분을 다시 Claude에 질문해 보세요.

• 음성 녹음 파일을 MP3 형식으로 저장하기
• Claude Code 실행 전 토큰 잔량 확인하기
• 분석이 끝난 뒤 오류가 있으면 ‘check that position with the engine’ 명령으로 재검증하기

• 원문 보기