Claude Code 실행 기록을 그래프로 추적하는 rungraph

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

TL;DR

Claude Code의 최종 diff만으로는 여러 하위 에이전트와 도구 호출이 어떤 순서로 실행됐는지, 실패와 재시도가 어디서 발생했는지 파악하기 어렵습니다. rungraph는 기존 세션 기록을 읽어 프롬프트, 하위 에이전트, 도구 호출을 그래프로 배치하고 각 노드의 입력·출력과 직전 사고 흐름을 연결합니다. 실행을 타임랩스로 재생하거나 오류 구간을 찾을 수 있으며, MCP 서버를 통해 Claude에게 특정 실패 원인을 질의할 수도 있습니다. npx rungraph로 설정 없이 사용할 수 있고, 기록은 로컬에 보관되며 export와 비밀 정보 유출 차단 기능을 제공합니다.

실용적 조언

설정 없이 npx rungraph로 실행 기록을 확인하고, 기존 디스크 세션이나 지난주 세션도 불러올 수 있습니다. rungraph export로 기록을 내보낸 뒤 동료가 rungraph open으로 같은 그래프를 열 수 있습니다. Claude Code뿐 아니라 Codex, opencode, Cursor, Hermes 실행 기록에도 적용할 수 있습니다.

섹션별 상세

작성자는 Claude Code의 최종 diff만으로는 40분 동안 어떤 하위 에이전트가 무엇을 시도했는지, 실패 뒤 어디서 재시도했는지 확인하기 어렵다는 문제를 제기했습니다. rungraph는 Claude가 이미 디스크에 저장한 세션을 읽어 사용자의 프롬프트를 중심축으로 두고 하위 에이전트와 도구 호출을 별도 그래프 노드와 레인으로 배치합니다. 각 노드를 클릭하면 호출 내용과 출력, 호출 직전의 Claude 사고 흐름을 확인할 수 있어 최종 결과만 남는 기존 기록의 공백을 줄입니다.

rungraph는 실행 전체를 재생하거나 특정 시점으로 이동할 수 있는 타임랩스와 오류·재시도 구간 표시 기능을 제공합니다. MCP 서버로도 작동하므로 터미널에서 Claude에게 token.js 편집이 실패한 이유를 물으면 관련 그래프 노드를 찾아 답할 수 있습니다. rungraph export로 실행 기록을 하나의 파일로 공유할 수 있고, 비밀 정보가 컴퓨터 밖으로 나가려 할 때 중단·경고하며 모든 데이터는 로컬에 남습니다.

용어 해설

하위 에이전트(Subagent): — 주 에이전트가 작업을 나눠 맡기는 별도의 실행 단위입니다. 각 하위 에이전트가 독립적으로 도구를 호출하고 결과를 반환하므로 여러 작업을 병렬로 처리할 수 있지만, 전체 실행 흐름을 추적하려면 별도 기록이 필요합니다.
MCP 서버(MCP Server): — AI 에이전트가 외부 도구나 데이터에 접근하도록 연결하는 서버입니다. rungraph는 저장된 실행 기록을 MCP 서버로 노출해 터미널의 Claude가 특정 도구 호출이나 실패 원인을 그래프에서 찾아 답하도록 구성합니다.
도구 호출(Tool Call): — AI 에이전트가 파일 편집, 명령 실행, 검색 같은 외부 작업을 요청하는 기록입니다. rungraph에서는 각 도구 호출을 그래프의 노드로 표시하고 입력, 출력, 호출 직전의 사고 흐름을 함께 확인하게 합니다.
재시도 루프(Retry Loop): — 같은 작업이 실패한 뒤 유사한 방식으로 반복 실행되는 흐름입니다. rungraph는 실행 기록에서 재시도와 오류가 이어지는 구간을 별도 스트립으로 표시해 작업이 계획에서 벗어난 지점을 찾도록 돕습니다.

언급된 도구

rungraph추천링크

Claude Code와 여러 코딩 에이전트의 세션 기록을 그래프로 시각화하고 재생·검색·공유하는 로컬 도구입니다.

언급된 리소스

GitHubfayzan123/rungraph

Demorungraph interactive demo