클로드 코드 receipts 스킬 리뷰: 한 달 성과를 1분 만에 영수증으로, 스킬 없이는 원본 대화까지 읽었다

클로드 코드를 한 달 쓰고 “그래서 이걸로 뭘 했느냐”는 질문을 받으면 기억만으로 정리하기 어렵습니다. receipts(리시츠, “영수증”)는 앤트로픽(Anthropic)이 공식 플러그인 저장소에 올린 스킬로, 내 컴퓨터에 쌓인 클로드 코드 세션 기록과 git 기록을 읽어 한 달 성과를 영수증 모양 보고서로 만들어 줍니다. 스킬은 무료이고, 보고서 문장을 쓸 때 클로드 사용량이 조금 듭니다. 정답을 미리 아는 가상 한 달 기록으로 같은 요청을 스킬 없이 두 번, 스킬을 넣고 두 번 보내 비교했습니다.

스킬은 클로드가 특정 일을 할 때 꺼내 읽는 작업 설명서 폴더(SKILL.md)입니다. 처음이라면 클로드 스킬 뜻과 만드는 법을 먼저 보세요.

결과부터 보기: 같은 한 달, 두 가지 보고서

직접 눌러 보기: 네 번 만든 보고서 열어 보기 (클로드가 만든 파일을 손대지 않고 올림, 사용 기록은 실험용 예시 데이터)

따라 해 보기: 요청문과 실습 재료

홈 폴더에서 클로드 코드를 열고 아래 요청을 보냈습니다. 스킬 이름은 말하지 않았습니다. 클로드 코드가 처음이라면 클로드 코드 설치 방법을 먼저 보세요. 실습 재료(zip)에는 예시 기록을 만드는 파이썬 파일, 요청문, 채점 기준, 정답, 조건별 결과를 넣었습니다.

지난 30일 동안 내가 클로드 코드로 한 일을 팀장님께 보고할 수 있게 정리해 줘. 사용 기록은 이 컴퓨터에 있는 클로드 코드 세션 기록을 쓰면 돼. 결과는 홈 폴더에 파일로 남겨 줘.

스킬을 깔았다면 클로드 코드 대화창에 /receipts만 쳐도 됩니다. /receipts week(7일), /receipts quarter(90일), /receipts 14(14일), /receipts for 프로젝트이름(한 프로젝트만)처럼 범위를 바꿉니다. 좋은 결과라면 홈 폴더에 마크다운 보고서와 HTML 영수증 두 파일이 생기고, 클로드가 보고서에 실린 프로젝트 이름을 한 줄로 알려 줍니다.

receipts에 들어 있는 것

플러그인에는 스킬 하나만 들어 있고 명령·에이전트·훅·MCP 서버는 없습니다. /receipts는 스킬 이름으로 부르는 방식입니다. 디렉터리 정보로는 클로드 코드 전용입니다.

파일	하는 일
SKILL.md (300줄)	클로드가 따를 6단계: 기간 정하기 → 집계 스크립트 실행 → 보고서 쓰기 → 마크다운 저장 → HTML 영수증 저장 → 무엇이 컴퓨터 밖으로 나갔는지 알리기
mine-transcripts.mjs (1,474줄)	세션 기록(jsonl)과 각 저장소의 git 기록을 읽어 세션·요청·활동일·손댄 파일·커밋·PR·프로젝트별 비중을 JSON으로 내고, 같은 숫자로 HTML 영수증을 만드는 Node.js 스크립트

SKILL.md가 정한 규칙이 이 스킬의 성격을 보여 줍니다. 달러 금액과 “절약한 시간”은 넣지 않습니다. 로컬 기록으로는 근거 있게 계산할 수 없다는 이유입니다. 커밋은 “내 git 이름으로 했고, 클로드가 고친 파일이 들어 있는 커밋”만 셉니다. PR(풀 리퀘스트)은 고친 코드를 합쳐 달라고 올리는 요청인데, 클로드가 gh pr create를 실행한 횟수로 셉니다. 배포 봇 커밋이나 클로드와 상관없는 커밋은 빠집니다. 파일을 건드리지 않은 세션은 “조사(프로젝트 없음)” 줄로 따로 모읍니다.

스크립트에는 인터넷으로 보내는 코드가 없고, 클로드에게는 이름·합계 숫자·프로젝트 이름만 담긴 요약이 넘어갑니다.

영수증의 영어 이름표 뜻: Sessions(세션), Prompts(요청), Files touched(손댄 파일), Lines touched(손댄 줄, 대략), Commits carrying that work(클로드 작업이 담긴 커밋), PRs opened(연 PR), By project(프로젝트별), Spend(사용량 비중), Export CSV(표 내려받기).

1단계. 설치하기 (약 1분)

이 단계에서는 스킬을 클로드 코드에 넣습니다. 공식 README에 적힌 방법은 클로드 코드 안에서 아래 명령을 입력하는 것입니다. 사용자 전체 설정에 플러그인을 넣는 방법이라 이번에는 시험하지 않았습니다.

/plugin install receipts@claude-plugins-official

이번에는 스킬 폴더를 사용자 스킬 폴더(~/.claude/skills)에 복사했습니다. 이 스킬은 모든 프로젝트의 기록을 모으므로 프로젝트 폴더보다 사용자 폴더가 맞습니다. 아무 폴더에서나 터미널로 실행합니다.

git clone --depth 1 --filter=blob:none --sparse https://github.com/anthropics/claude-plugins-official.git cpo
git -C cpo sparse-checkout set plugins/receipts
mkdir -p ~/.claude/skills && cp -r cpo/plugins/receipts/skills/receipts ~/.claude/skills/

실제 실행 기록 · macOS 26.1 · 빈 홈 폴더

$ git clone --depth 1 --filter=blob:none --sparse https://github.com/anthropics/claude-plugins-official.git cpo
Cloning into 'cpo'...

$ git -C cpo sparse-checkout set plugins/receipts && mkdir -p ~/.claude/skills && cp -r cpo/plugins/receipts/skills/receipts ~/.claude/skills/

$ cd ~/.claude/skills && wc -l receipts/SKILL.md receipts/scripts/*
     300 receipts/SKILL.md
    1474 receipts/scripts/mine-transcripts.mjs
    1774 total

이렇게 나오면 성공 ~/.claude/skills/receipts에 SKILL.md와 scripts/mine-transcripts.mjs가 보입니다.

• node: command not found가 나오면: 집계 스크립트는 Node.js로 돌아갑니다. 클로드 코드를 npm으로 설치했다면 이미 있고, 아니라면 nodejs.org에서 LTS 버전을 설치한 뒤 다시 실행합니다.
• git이 없다는 오류가 나오면: 저장소 페이지에서 Code > Download ZIP(코드 > ZIP으로 받기)으로 받아 plugins/receipts/skills/receipts 폴더만 복사해도 됩니다.

필요 없어지면 아래 명령으로 지웁니다. 플러그인으로 설치했다면 터미널에서 claude plugin uninstall receipts@claude-plugins-official입니다.

rm -r ~/.claude/skills/receipts

2단계. 보고서 만들기 (약 1분)

이 단계에서는 위 요청문으로 보고서를 받습니다. 두 번 모두 클로드는 첫 동작으로 receipts 스킬을 불렀고, 집계 스크립트를 --days 30으로 한 번 돌린 뒤 한국어 보고서를 썼습니다. 도구 호출은 4~5번이었습니다.

이렇게 나오면 성공 홈 폴더에 claude-code-receipts-시작일-to-끝일.md와 같은 이름의 .html이 생깁니다. 클로드는 “보고서에 프로젝트 이름 monthly-report, cafe-homepage, ~/Documents/meeting-notes가 그대로 들어갑니다”처럼 공유 전에 볼 것을 알려 줍니다.

마크다운 보고서는 한국어로 나왔고, HTML 영수증은 정해진 틀이라 이름표가 영어입니다. 2회차에서 클로드도 “이 파일은 자동 생성 템플릿이라 한국어가 아닐 수 있다”고 알려 줬습니다.

• 보고서에 실린 이름이 걱정되면: /receipts for cafe-homepage처럼 한 프로젝트로 좁혀 다시 만듭니다.
• 커밋이 “–”로 나오면: 그 폴더가 git 저장소가 아니거나, 클로드가 고친 파일이 든 내 커밋이 없다는 뜻입니다. git 오류일 때는 “?”로 따로 표시됩니다.

스킬 없이 vs 있이 비교 결과

사용 기록은 실험용으로 만든 가상 한 달치입니다. 가상 사용자 “김하늘”의 홈 폴더에 세션 16개, git 저장소 2개(카페 홈페이지, 월간 보고서), 일반 폴더 하나(회의록), 파일을 안 건드린 조사 세션 4개를 넣었습니다. 함정도 넣었습니다. 기간 밖(9월 5일) 세션 1개, 배포 봇 커밋 1개, 클로드가 안 건드린 파일의 커밋 1개입니다. 정답은 집계 스크립트를 직접 돌린 값입니다. 세션 15·활동일 15·파일 7·커밋 6·PR 1입니다. 채점 기준 10개는 실행 전에 SKILL.md와 README에서 뽑아 고정했고, 요청문에는 넣지 않았습니다.

채점 항목	스킬 없이 1·2	스킬 있이 1·2
기간 30일·활동일	✗ ✗	✓ ✓
세션·요청 수	✓ ✓	✓ ✓
손댄 파일 7개	✗ ✗	✓ ✓
커밋 6개(봇·무관 커밋 제외)	✓ ✓	✓ ✓
PR 1번	✓ ✓	✓ ✓
프로젝트별 표, 조사 세션 따로	✓ ✓	✓ ✓
달러·절약 시간을 지어내지 않음	✓ ✓	✓ ✓
홈 폴더에 파일로 저장	✓ ✓	✓ ✓
팀장 보고용 문구	✓ ✓	✓ ✓
실린 프로젝트 이름 확인 안내	✗ ✗	✓ ✓
합계	7/10 · 7/10	10/10 · 10/10

스킬 쪽 세션·요청·활동일은 16으로 나왔습니다. 보고서를 만드는 지금 대화도 기록에 들어가 하나가 더해진 것입니다. 조사 줄도 4개가 아니라 5개입니다. 같은 이유로 생긴 차이라 채점에서는 맞는 것으로 봤습니다.

실행 기록 · 작업 폴더 runs.tsv에서 옮김

조건(회차)        걸린 시간      달러    턴  도구 호출  불린 스킬   채점
none-1 스킬 없이   1분 반쯤       0.817   10   9        없음        7/10
none-2 스킬 없이   1분 반 남짓    0.950   13  12        없음        7/10
skill-1 스킬 있이  1분 안쪽       0.357    6   4        receipts   10/10
skill-2 스킬 있이  1분 안쪽       0.389    7   5        receipts   10/10

스킬 없이: 원본 대화를 읽고, 지금 파일까지 대조

스킬 없이는 두 번 모두 세션 기록 파일을 직접 열어 읽고, 파이썬으로 요청을 뽑은 뒤 각 저장소의 git 기록을 확인했습니다. 결과는 날짜별 작업표가 붙은 읽기 좋은 보고서였습니다. 배포 봇 커밋과 라이선스 커밋을 “세션 기록에 없는 작업”이라며 뺀 것도 정확했습니다.

빠진 것도 분명했습니다. 기간을 9월 19일부터로 잡아 31일이 됐고, 활동일 수와 손댄 파일 수는 숫자로 나오지 않았습니다. 2회차는 “파일 수정 7·작성 5″라는 도구 호출 횟수를 적었는데, 실제로 손댄 파일은 7개입니다. 보고서에 실린 프로젝트 이름을 확인하라는 안내도 없었습니다.

스킬에는 없는 장점도 있었습니다. 두 번 모두 지금 파일과 git을 대조해 “회의록 2건은 기록상 저장했는데 폴더가 비어 있다”, “10월 2일 영업시간 수정은 커밋도 없고 파일에도 없다”, “원격 저장소가 없어 PR이 실제로 올라갔는지 모른다”를 짚었습니다. 예시 데이터를 만들 때 회의록 파일과 그 수정 내용은 기록에만 넣고 실제 파일로는 만들지 않았는데, 그 차이를 찾아낸 것입니다. 실제 업무라면 “다시 해야 할 일”을 알려 주는 쓸모 있는 확인입니다.

스킬 있이: 정해진 숫자, 공유 전 확인까지

스킬 쪽은 집계 스크립트가 낸 숫자를 그대로 써서 두 번의 숫자가 같았습니다. 커밋 6건을 두고 “활동일 16일 중 6일은 그날 작업이 커밋까지 이어졌다”고 풀어 쓴 문장이 두 번 다 나왔습니다. 사용량의 61%가 파일을 안 건드린 조사였고 이번 달은 조사 비중이 높았다는 해석도 같았습니다. 손댄 줄 수 약 490줄에는 “같은 곳을 다시 고치면 매번 세는 근사치라 작성한 코드 줄 수로 보면 안 된다”는 주의가 붙었습니다.

마지막에는 두 번 다 “구체적인 성과 한두 가지를 직접 덧붙이라”고 권했습니다. 예로 “반나절 만에 끝낸 작업”을 들었습니다. 숫자보다 사례가 설득력 있다는 SKILL.md의 지시를 따른 것입니다. 세션 기록 원본은 한 번도 열지 않았습니다.

이런 사람에게 권합니다

• ✅ 클로드 코드 사용을 팀장님이나 회사에 설명해야 하는 사람. 1분 안쪽에 커밋·PR·프로젝트별 비중이 정리되고, 과장된 숫자가 들어가지 않습니다.
• ✅ 대화 내용이 밖으로 나가는 것이 걱정되는 사람. 클로드에게는 합계와 프로젝트 이름만 넘어갑니다.
• ✅ 매달 같은 형식으로 남기고 싶은 사람. 숫자가 스크립트에서 나오므로 달마다 나란히 비교할 수 있습니다.
• ❌ 날짜별로 무엇을 했는지 작업 일지가 필요한 사람. 스킬은 합계만 냅니다. 이때는 스킬 없이 요청하는 편이 맞고, 원본 대화를 읽으므로 사용량이 2배 남짓 듭니다.

한계와 주의할 점

• 가상 한 달 기록 한 벌로 조건마다 두 번씩만 돌렸습니다. 실제 기록은 더 길고 복잡해서 걸리는 시간과 비용이 다를 수 있습니다.
• 기록에 남은 것만 셉니다. 클로드가 고친 뒤 지운 파일도 “손댄 파일”에 들어가고, 클로드 앱이나 다른 컴퓨터에서 한 일은 빠집니다.
• 중간 파일 /tmp/cc-receipt.html이 컴퓨터에 남습니다. 본인만 읽을 수 있는 권한으로 만들어지지만, 프로젝트 이름이 들어 있으니 필요 없으면 지웁니다.

대안

방법	다른 점	이럴 때 고르세요
receipts(이 글)	“무엇을 해냈나”: 커밋·PR·프로젝트별 비중을 영수증으로	사용한 가치를 설명해야 할 때
session-report	“어디서 많이 썼나”: 토큰·캐시·비싼 요청을 보고서로	사용량 한도를 아끼고 싶을 때
클로드 코드의 /usage	지금 요금제 한도를 얼마나 썼는지 보여 주는 기본 명령	남은 한도만 알면 될 때
스킬 없이 요청	원본 대화와 지금 파일까지 읽어 날짜별 작업표와 확인할 일까지	작업 일지가 필요하고, 대화 내용을 읽혀도 될 때

두 공식 플러그인은 같은 세션 기록을 읽습니다. README도 session-report는 “사용을 더 싸게”, receipts는 “쓴 값어치를 설명”하는 용도로 나눠 소개합니다. 요금제별 한도는 클로드 요금제 정리에 있습니다.

자주 묻는 질문

클로드 코드 사용 기록은 어디에 저장되나요?

내 컴퓨터의 ~/.claude/projects 폴더에 프로젝트(작업 폴더)마다 jsonl 파일로 쌓입니다. receipts는 이 폴더와 각 저장소의 git 기록만 읽습니다.

/receipts라고 쳐야만 불리나요?

이번에는 “지난 30일 동안 클로드 코드로 한 일을 팀장님께 보고할 수 있게”라는 요청만으로 두 번 다 불렸습니다. 확실히 하려면 /receipts를 쓰면 됩니다.

보고서가 회사나 앤트로픽으로 올라가나요?

SKILL.md는 “부탁하지 않으면 어디에도 올리지 말라”고 정해 두었고, 이번 네 번 모두 홈 폴더에만 저장했습니다. 공유 링크가 필요하면 따로 요청해야 합니다.

receipts 스킬은 무료인가요?

Apache 2.0 라이선스로 무료입니다. 보고서 문장을 쓰는 데 이번 실험 기준 0.4달러 미만의 클로드 사용량이 들었고, 구독 요금제라면 그만큼 한도에서 차감됩니다. 다른 공식 플러그인은 클로드 스킬·플러그인 디렉터리 사용법에서 찾을 수 있습니다.

출처

receipts 플러그인 폴더(README), SKILL.md, anthropics/claude-plugins-official 저장소 (모두 2026-10-19 확인, 저장소 별 42,997개, 플러그인 추가 2026-07-17, 마지막 변경 2026-10-08)