Claude Code가 내 컴퓨터에 무엇을 저장하는지 확인할 수 있는 CLI 도구를 만들었습니다

실용적 조언

npx agentlens scan 명령어를 통해 자신의 로컬 환경에 저장된 Claude Code 데이터를 즉시 확인할 수 있다.
agentlens redact 기능을 사용하여 로컬 메모리 파일에 민감한 정보가 포함되어 있는지 주기적으로 점검하는 것이 좋다.

섹션별 상세

작성자는 Claude Code가 로컬 시스템의 ~/.claude/ 디렉토리에 저장하는 데이터를 투명하게 확인하기 위해 agentlens라는 CLI 도구를 개발했다. 이 도구는 API 키나 계정 연동 없이 로컬 파일 시스템만 직접 읽어 정보를 추출하는 방식으로 작동한다.

bash

npx agentlens scan

Claude Code의 로컬 데이터를 전체적으로 감사하는 명령어

실제 조사 결과 10개 프로젝트에 걸쳐 사용자 역할, 선호도, 피드백 등이 담긴 76개의 지속성 메모리 파일이 발견됐다. 이는 에이전트가 사용자의 작업 스타일과 프로젝트 맥락을 학습하여 유지하고 있음을 의미한다.

세션 트랜스크립트 데이터의 누적 속도가 매우 빠름이 확인됐다. 작성자의 경우 4,445개의 세션 기록이 약 1.8GB를 차지했으며 전체 데이터 풋프린트는 2.2GB에 달했다.

agentlens는 단순 조회를 넘어 데이터 관리 기능을 제공한다. redact 명령어로 메모리에 유출된 비밀 정보를 찾거나 clean 명령어로 불필요한 데이터를 삭제하기 전 미리보기를 수행할 수 있다.

bash

agentlens clean --dry-run

삭제될 메모리 파일을 미리 확인하는 명령어

용어 해설

명령줄 인터페이스(CLI): — 텍스트 터미널을 통해 사용자가 명령어를 입력하여 컴퓨터와 상호작용하는 방식이다. 그래픽 인터페이스 없이도 시스템의 내부 파일이나 설정을 빠르게 제어할 수 있어 개발 도구에서 널리 쓰인다.
지속성 메모리(Persistent Memory): — 프로그램 종료 후에도 데이터가 사라지지 않고 로컬 파일 시스템에 저장되는 방식이다. 에이전트가 이전 대화의 맥락이나 사용자 설정을 다음 실행 시에도 기억할 수 있게 해준다.
세션 트랜스크립트(Session Transcript): — AI 모델과 사용자 간의 대화 및 도구 사용 기록 전체를 텍스트로 저장한 파일이다. 디버깅이나 과거 작업 내역 확인을 위해 사용되지만 시간이 지남에 따라 용량이 커질 수 있다.
데이터 풋프린트(Data Footprint): — 특정 소프트웨어나 시스템이 차지하는 전체 저장 공간의 크기를 의미한다. 여기서는 Claude Code가 로컬 디스크에 생성한 모든 파일의 총 용량을 뜻한다.

언급된 도구

agentlens추천

Claude Code 로컬 데이터 조회 및 관리 CLI

Claude Code중립

Anthropic의 코딩 에이전트

언급된 리소스

GitHubagentlens GitHub Repository