클로드(Claude)와 Garmin을 활용한 주간 훈련 검토 및 파워 유저를 위한 Claude Code

코딩 불필요 이 게시물의 대부분은 코딩이 필요하지 않습니다. 만약 자신의 앱에 Garmin 데이터를 넣고 싶은 개발자라면, 대신 [Build with Garmin data]를 참고하세요.

지난 세 부분에서 여러분은 Garmin을 Claude에 연결하는 법을 배웠고, 좋은 질문을 하는 법도 익혔으며, 심지어 Claude가 워치용 운동 루틴까지 만들어주게 했습니다. 마지막 부분은 이것을 주간 습관으로 만드는 방법에 대한 것입니다:

한 메시지로 주간 훈련 검토
채팅으로 데이터 기록
Claude Code: 파일 및 스케줄에 저장되는 리포트 (더 기술적인 사용자용)
모든 것을 자신의 컴퓨터에서 실행하기

한 메시지로 주간 검토

제가 찾은 가장 유용한 습관입니다: 매주 월요일 아침, 한 메시지를 통해 지난 주를 간략하게 검토하는 것입니다.

매주 같은 긴 요청을 입력하는 것을 피하려면, Claude Project에 넣어두세요. 프로젝트는 그 안에 적용되는 모든 채팅의 지침을 유지합니다.

claude.ai에서 Projects를 열고 Training이라는 이름으로 하나 만드세요.
프로젝트의 instructions를 열고 다음과 같은 내용을 붙여넣으세요:

You are my training assistant. I'm a recreational runner training for a half marathon on 7 December. My easy pace is about 5:40/km. Use my Garmin data.

...

매주 월요일마다, 프로젝트 내부에서 새 채팅을 열고 weekly review라고 입력하세요.

그게 전부입니다. 목표가 변경되면 지침을 편집하세요: 새로운 레이스, 새로운 초점, 휴식 주간 등이 있습니다.

기본 검토 방식이 익숙해지면 잘 작동하는 몇 가지 추가 기능들이 있습니다:

…그리고 다음 주 세 번의 달리기를 계획해 주고, 저장하기 전에 보여줘.
…그리고 이번 주 장거리 달리기와 지난 세 번의 기록을 비교해 줘.
…그리고 내 훈련 부하(training load)가 매주 약 10%보다 빠르게 증가하고 있는지 알려줘.

채팅으로 데이터 기록하기 (Logging data by chat)

이 커넥터는 또한 시계에서 포착하지 못하는 데이터를 위해 사용자에게 유용한 몇 가지 내용을 Garmin 계정에 **작성(write)**할 수 있습니다:

"오늘 아침 체중을 72.4kg으로 기록해 줘."
"어제 달리기 기록 이름을 'Parkrun PB 시도'로 변경하고 메모를 추가해 줘: 바람이 많이 불었고, 강하게 느껴졌어."
"일요일 달리기를 레이스로 표시해 줘."
"오늘 라이딩의 자각된 노력도(perceived effort)를 10점 만점에 7점으로 설정해 줘."

이 기록들은 사용자가 직접 입력한 것처럼 Garmin Connect 앱에 나타납니다.

알아두어야 할 두 가지 사항:

Claude는 삭제하거나 덮어쓰기 전에 사용자에게 물어봅니다. 체중을 추가하는 것은 큰 주의가 필요하지 않지만, 삭제하는 것은 주의가 필요하며 Claude가 먼저 확인합니다.
일부 항목은 제거할 수 없습니다. 예를 들어, Garmin에는 기록된 수분 섭취량을 삭제할 방법이 없습니다. 따라서 해당 데이터를 기록하기 전에는 반드시 다시 확인하세요.

Claude Code: 파일로 보고서 생성 및 스케줄링

이 섹션은 터미널 사용에 익숙한 사람들을 위한 것입니다. 그렇지 않다면, 위의 검토 내용만으로 충분합니다.

Claude Code는 터미널에서 사용할 수 있는 Claude입니다. 이 코드는 동일한 Garmin 커넥터를 사용할 수 있으며, 파일과 연동되기 때문에 사용자가 보관할 수 있는 Markdown 형식의 파일로 검토 내용을 저장할 수 있습니다. 즉, 스스로 작성되는 훈련 일지 같은 것입니다.

커넥터 추가하기 (Add the connector)

claude mcp add --transport http garmin https://garmin.ficdev.xyz/mcp

그런 다음 Claude Code를 시작하고, /mcp를 입력한 후 garmin을 선택하고 열리는 브라우저 창에서 Garmin에 로그인합니다. (터미널에서는 claude mcp login garmin이 동일한 작업을 수행합니다.) 이 과정은 단 한 번만 하면 됩니다.

파일로 보고서 요청하기 (Ask for a report as a file)

Claude Code 내, 훈련 노트를 보관하는 폴더에서:

클로드는 데이터를 가져와 파일을 작성하고 그 내용을 사용자에게 보여줍니다. 몇 달이 지나면 검색하고 비교하며 질문할 수 있는 주간 검토 폴더를 갖게 됩니다: "9월과 10월의 리뷰를 읽어줘. 무엇이 달라졌니?"

스케줄링으로 실행하기

Claude Code는 채팅을 열지 않고도 단일 요청을 실행할 수 있습니다. 이는 스케줄러가 대신 실행할 수 있음을 의미합니다:

claude -p "Do my weekly training review from my Garmin data for the last 7 days and save it as reviews/$(date +%G-W%V).md: activities, distance, sleep, HRV and resting heart rate compared with the previous 4 weeks, and one suggestion for next week." \
  --allowedTools "mcp__garmin" "Write"

-p는 하나의 요청을 실행하고 종료합니다. --allowedTools는 아무도 '허용' 버튼을 클릭해 줄 사람이 없기 때문에, 사전에 Garmin 커넥터와 파일 쓰기를 사용할 권한을 부여합니다. 이 목록은 짧게 유지하세요. 여기서는 Garmin과 파일 작성만 있습니다.

이 명령어는 macOS 및 Linux 터미널용입니다: $(date +%G-W%V)가 2026-W43과 같은 이번 주의 번호를 채우고, \는 줄을 이어줍니다. Windows PowerShell에서는 한 줄에 작성하고 Claude에게 파일 이름을 지정하게 하세요:

claude -p "Do my weekly training review from my Garmin data for the last 7 days and save it in the reviews folder, named after this week's ISO year and week number, like reviews/2026-W43.md" --allowedTools "mcp__garmin" "Write"

이 명령어를 주간 cron 작업(macOS 및 Linux) 또는 작업 스케줄러(Task Scheduler) 작업(Windows)에 넣어두면, 당신이 잠에서 깨기 전 매주 월요일마다 검토가 폴더에 나타납니다.

만약 Garmin에 해당 주 데이터가 없다면, Claude는 파일을 아예 저장하지 않을 수 있으며 대신 그 이유를 설명합니다. 제가 이 기능에 대해 테스트했을 때 시계 데이터가 없는 계정에서는 정확히 그렇게 작동했습니다. 스케줄링된 실행 중에는 아무도 그 설명을 읽지 않기 때문에, 파일이 누락되었다는 것은 보통 시계와 동기화되지 않았다는 의미입니다.

솔직한 주의사항이 하나 있습니다. 자동화된 실행(automated run)은 사용자에게 아무것도 물어볼 수 없습니다. 예약 요청은 읽기 및 보고에만 사용하고, 운동 일정 잡기와 같이 Garmin에 데이터를 쓰는 모든 작업은 미리보기를 확인할 수 있는 방식으로 상호작용적으로 수행해야 합니다.

모든 것을 자신의 컴퓨터에서 실행하기

지금까지의 모든 내용은 garmin.ficdev.xyz의 호스팅(hosted) 커넥터를 사용했습니다. 이는 편리하며, 사용자님의 Garmin 데이터나 비밀번호를 저장하지 않습니다. 사용자님의 Garmin 세션은 Claude 계정이 유지하는 연결 내부의 암호화된 상태로 존재합니다.

만약 여전히 다른 사람의 서버에서 아무것도 실행하고 싶지 않다면, Claude Desktop을 위한 완전히 로컬(local) 옵션이 있습니다: 바로 **Garmin 데스크톱 확장 프로그램(Garmin Desktop Extension)**입니다.

최신 릴리스에서 garminconnect-mcp-<version>.mcpb를 다운로드합니다.
이 파일을 더블클릭하거나, Claude Desktop의 **설정(Settings) → 확장 프로그램(Extensions)**으로 드래그한 후 **설치(Install)**를 선택합니다.
Claude에게 Garmin 데이터에 대해 질문을 합니다. 처음에는 사용자님의 컴퓨터에서 제공되는 Garmin 로그인 페이지가 브라우저에 열립니다. 거기서 로그인한 다음, Claude에게 완료했다고 알려주세요.

이제 사용자님의 Garmin 세션은 컴퓨터에 저장되며 Garmin과 직접 통신합니다. 동일한 질문, 운동 및 검토 기능이 이전과 정확하게 작동합니다. 확장 프로그램 설정에서는 사용하지 않는 도구 그룹을 비활성화할 수도 있어 Claude가 집중하도록 유지하는 데 도움이 됩니다.

이것이 시리즈입니다

총 4개의 게시물을 거치며 여러분은 Garmin 연결부터 시작하여, 좋은 질문을 던지는 방법, 운동을 구축하고 예약하는 방법, 그리고 스스로 실행되는 주간 검토에 이르기까지 과정을 경험했습니다.

모든 Claude 앱 설정 가이드: garmin.ficdev.xyz/claude
모든 것이 오픈 소스입니다: github.com/DynamicsNinja/garminconnect-js
구축 방법: 시작하게 된 게시물

만약 이것이 여러분의 주간 훈련 루틴에 포함되었다면, 어떻게 사용하시는지 들려주시면 좋겠습니다. 댓글에 자신만의 '주간 검토 지침(weekly-review instructions)'을 공유해 주세요. 제가 최고의 내용들을 모아보겠습니다.