Groundhog로 Claude Code 반복 작업 측정

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

Claude Code의 세션 기록을 읽는 Groundhog 플러그인은 에이전트가 반복 작업을 얼마나 수행했는지 로컬에서 집계한다. 게시자는 369개 세션과 8,467회의 도구 호출을 기준으로 11%가 이미 한 작업을 다시 수행했고, 한 파일을 84회 다시 건드렸으며, `true` 명령을 59회 실행했다고 기록했다. 같은 대상을 두 번 확인한 사례에서는 74%의 경우 두 확인 사이에 파일 상태가 바뀌었지만, 26%는 불필요한 재확인에 가까웠다. 읽기 전용으로 동작하고 아무것도 업로드하지 않으며, 게시자는 개인 개발보다 여러 에이전트를 운영하는 환경에서 활용 가치가 크다고 평가했다.

섹션별 상세

01

게시자는 반복 작업과 캐싱 가능성을 확인하기 위해 Claude Code가 저장한 JSONL 세션 기록을 Groundhog로 읽었다. 369개 세션에서 8,467회의 도구 호출을 모아 이미 처리한 작업의 재실행 비율과 특정 파일에 대한 반복 접근을 계산했다. 이 방식은 단일 세션의 인상보다 여러 세션에 걸친 에이전트 행동을 수치로 비교할 수 있게 한다.

02

집계 결과 도구 호출의 11%가 이미 수행한 작업을 다시 했고, 한 파일은 84회 다시 읽거나 수정 대상으로 다뤄졌다. `true`라는 실질적 작업이 없는 명령도 59회 실행됐으며, 화면에는 Bash가 4,192회로 가장 많이 사용된 도구로 나타난다. 반복 호출을 식별하면 에이전트가 같은 작업을 재수행하는 지점과 캐싱으로 줄일 수 있는 지점을 분리할 수 있다.

03

같은 대상을 두 번 살핀 사례 가운데 74%에서는 첫 확인과 두 번째 확인 사이에 파일 상태가 바뀌었고, 26%에서는 동일한 상태를 다시 확인한 것으로 집계됐다. 게시자는 파일이 실시간 작업 중 이동하거나 변경될 수 있어 재확인 자체가 항상 낭비는 아니라고 설명했다. 따라서 단순히 중복 호출을 모두 제거하기보다 상태 변화가 있었던 재관찰과 불필요한 재관찰을 구분하는 것이 핵심이다.

04

Groundhog는 로컬 세션 파일만 읽고 아무것도 업로드하거나 수정하지 않는 구조로 제공된다. 사용자는 플러그인을 설치한 뒤 `/groundhog:stats`를 실행해 전체 호출 수, 오류 수, 반복 파일, 반복 명령과 재관찰 결과를 확인할 수 있다. 게시자는 개인 개발자에게는 가치가 제한적일 수 있지만 여러 에이전트를 함께 운영하는 환경에서는 행동 측정과 캐싱 설계에 유용하다고 평가했다.

이미지 분석

Screenshot
화면에는 369개 세션, 8,467회의 도구 호출, 365건의 오류가 집계되어 있다. Bash 호출 4,192회, 이미 수행한 작업의 재실행 934회, 특정 파일의 84회 재접근, `true` 명령 59회, 상태가 바뀐 재관찰 74%가 함께 표시되어 게시물의 수치 주장을 뒷받침한다.
Claude Code 터미널에서 Groundhog의 세션 통계 명령과 반복 호출 결과가 출력된 화면이다.

Screenshot
동일한 통계 화면에서 에이전트의 총 세션 수와 도구 호출 수, 반복 파일 접근, 무의미한 명령 실행, 두 관찰 사이의 파일 변경 비율을 확인할 수 있다. 화면 하단은 읽기 전용 처리와 토큰·비용 수치를 제외했다는 점도 함께 밝힌다.
Groundhog가 Claude Code의 로컬 세션 기록을 읽어 에이전트의 반복 작업 통계를 출력한 터미널 화면이다.

용어 해설

JSONL: — JSONL은 한 줄마다 하나의 JSON 객체를 저장하는 텍스트 형식이다. Claude Code는 세션 기록을 이 형식으로 남기며, Groundhog는 이 파일을 읽어 여러 세션의 도구 호출과 반복 패턴을 집계한다. 세션 데이터를 구조적으로 순회하기 때문에 원본 기록을 수정하지 않고도 사용 행태를 확인할 수 있다.
스마트 캐싱(Smart Caching): — 스마트 캐싱은 이미 계산하거나 확인한 결과를 저장해 동일한 작업을 다시 처리하지 않도록 하는 방식이다. 이 게시물에서는 에이전트가 같은 대상을 반복해서 읽는 패턴과 그 사이에 파일 상태가 바뀌는 상황을 구분하는 관찰 대상으로 등장한다. 반복 작업을 줄이면 도구 호출과 처리 비용을 낮출 여지가 생긴다.
도구 호출(Tool Call): — 도구 호출은 AI 에이전트가 Bash 같은 외부 도구를 실행해 파일을 읽거나 명령을 수행하는 한 번의 작업 요청이다. 게시물은 369개 세션에서 8,467회의 호출을 모아 재실행과 무의미한 명령의 빈도를 계산했다. 에이전트의 실제 작업 흐름을 평가하는 기본 단위로 활용된다.
읽기 전용 플러그인(Read-only Plugin): — 읽기 전용 플러그인은 로컬 데이터를 읽어 결과를 산출하지만 원본 파일이나 시스템 상태를 변경하지 않는 확장 기능이다. Groundhog는 Claude Code의 JSONL 세션 기록을 읽고 통계를 생성하며, 게시물은 데이터가 외부로 업로드되지 않는다고 설명한다. 따라서 에이전트의 과거 실행을 점검하면서 작업 환경에 직접 개입하지 않는 구조다.

코드 예제

text

/plugin marketplace add fraqtl-ai/groundhog
/plugin install groundhog@fraqtl-ai
/groundhog:stats

Claude Code에서 Groundhog를 마켓플레이스에 추가하고 설치한 뒤 세션 통계를 실행하는 명령이다. 첫 번째 명령은 플러그인 저장소를 등록하고 두 번째 명령은 해당 플러그인을 설치한다. 마지막 명령은 로컬 세션 기록을 읽어 반복 호출과 재관찰 수치를 출력한다.

언급된 도구

Claude Code중립

에이전트 세션을 JSONL로 저장하고 도구 호출을 실행하는 코딩 에이전트

Groundhog중립링크

Claude Code의 로컬 JSONL 세션 기록에서 반복 작업과 재관찰 통계를 생성하는 읽기 전용 플러그인

언급된 리소스

GitHubfraqtl-ai/groundhog