에이전트 · Claude Code

Claude Code가 Mac에 남기는 것.

세션 로그, 체크포인트, 임시 작업 공간, 워크트리. Devbroom은 이 모두를 찾아내고, 어떤 것은 Claude Code가 스스로 지우는지, 어떤 것이 사용자에게 맡겨지는지, 어떤 것은 절대 건드리지 않는지 알려 줍니다.

출시 예정살피는 대상
스캔 예시에서
37.8 GBClaude Code 데이터
297세션
98더 이상 없는 폴더의 세션
2지금 실행 중
살피는 대상

폴더마다 고유한 규칙이 있습니다.

Devbroom은 모든 위치를 Claude Code의 동작 방식에 맞춰 다룹니다. 에이전트가 스스로 정리하는 것은 에이전트에게 맡기고, 자체 명령이 있는 것은 그 명령으로 처리합니다.

판정 대상항목마다 따로 확인합니다. 준비됨으로 나오면 정리할 수 있습니다.
claude purge로Claude Code 자체 명령으로 처리하며, 버튼을 길게 눌러 확인합니다.
Claude Code가 삭제오래된 것은 에이전트가 스스로 정리합니다. Devbroom은 보여 주기만 합니다.
건드리지 않음보여 주기만 하고 절대 삭제하지 않습니다.

임시 작업 공간

세션의 작업 공간과 임시 파일. 끝난 세션의 것은 Claude Code가 스스로 지우기 전에 살펴본 뒤 정리할 수 있습니다. 실행 중인 세션의 것은 차단됨으로 남습니다.

/private/tmp/claude-<uid>
판정 대상

MCP 및 오류 로그

로그 파일뿐입니다.

~/Library/Caches/claude-cli-nodejs
판정 대상

세션 로그

파일을 직접 지우면 세션 이어 가기와 메모리가 망가집니다. Devbroom은 이를 위해 Claude Code 자체 명령을 쓰며, 폴더가 더 이상 없는 프로젝트의 기록을 한 번에 지웁니다. 삭제하는 대신 프로젝트의 대화를 보관할 수도 있습니다(Pro). 보관 파일이 검증되기 전에는 아무것도 옮기지 않고, 메모리는 그대로 남으며, 기록에서 다시 열 수 있습니다.

~/.claude/projects
claude purge로

체크포인트

cleanupPeriodDays(기본 30일)보다 오래된 것은 Claude Code가 스스로 지웁니다.

~/.claude/file-history
Claude Code가 삭제

로그와 캐시

디버그 로그, 셸 스냅샷, 붙여 넣은 내용과 이미지. 오래된 것은 Claude Code가 스스로 지웁니다.

~/.claude/debug~/.claude/shell-snapshots~/.claude/paste-cache~/.claude/image-cache
Claude Code가 삭제

CLI 버전

업데이터가 현재 버전, 실행 중인 버전, 최신 두 버전을 남깁니다.

~/.local/share/claude/versions
업데이터가 관리

플러그인

/plugin이 관리합니다. 사용 중인 플러그인은 지우면 안 됩니다.

~/.claude/plugins/cache~/.claude/plugins/marketplaces
건드리지 않음

데스크톱 앱 데이터

앱의 상태이며, 내장 CLI와 가상 머신 이미지도 들어 있습니다.

~/Library/Application Support/Claude
건드리지 않음
보호됨

계정과 설정은 그대로 둡니다.

이 파일과 폴더는 보호됩니다. 어떤 판정도 이것들을 정리 대상으로 만들지 않으며, 크기와 상관없이 그대로 남습니다.

계정 및 전역 상태~/.claude.json
자격 증명~/.claude/.credentials.json
설정settings.json · settings.local.json
프롬프트 기록~/.claude/history.jsonl
에이전트 메모리~/.claude/agent-memory
설치된 플러그인~/.claude/plugins
워크트리

Claude Code의 워크트리를 흔적으로 알아봅니다.

다음 흔적으로 워크트리가 Claude Code의 것임을 알아봅니다. 흔적이 강할수록 소유자를 더 확실하게 표시합니다.

  • 확실git 메타데이터의 CLAUDE_BASE 표식
  • 확실Claude Code가 건 워크트리 잠금
  • 유력.claude/worktrees 폴더 안
  • 유력Claude Code 작업 공간 안
  • 가능성 있음worktree-로 시작하는 브랜치 이름
  • 저장되지 않은 작업이 있으면 차단됨. git은 --force 없이 이런 워크트리를 제거하지 않으며, Devbroom은 --force를 절대 쓰지 않습니다.
  • 그 안이나 상위 폴더에서 세션이 실행 중이면 차단됨.
  • 무시된 파일이 있으면 검토 필요: git worktree remove는 묻지 않고 그 파일들을 지웁니다.
실행 중인 세션

보이지만, 실행 중에는 건드리지 않습니다.

Devbroom은 어떤 Claude Code 세션이 실행 중인지 압니다. 실행 중인 세션의 프로세스는 절대 건드리지 않으며, 세션이 이어지는 동안 그 폴더와 임시 공간은 차단됨으로 남습니다.

세션 2개 실행 중

Claude Code 임시 공간shop · 세션 23f5b61713.2 GB차단됨: 이 폴더에서 실행 중인 세션의 데이터가 있습니다.
Claude Code 임시 공간shop · 세션 ab041197 · 완료7.3 GB
호환성

Claude Code의 파일부터 확인합니다.

에이전트의 데이터를 신뢰하기 전에, Devbroom은 파일이 예상한 형식인지 확인합니다. 그렇지 않으면 그 데이터는 읽기만 하며, 어느 것도 정리 준비됨으로 간주하지 않습니다.

테스트된 버전2.1.0 - 2.1.292

이 범위를 벗어난 버전도 형식이 맞으면 동작하며, “아직 테스트되지 않음”으로 표시됩니다.

형식 확인cwd와 sessionId

~/.claude/projects의 로그에는 세션과 폴더를 잇는 이 두 필드가 있어야 합니다.

사용 중인 버전devbroom compat

폴더가 다른 곳에 있으면 CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR 값을 따릅니다.

Claude Code는 일하게 두세요. 뒷정리는 Devbroom이 합니다.

출시 예정
다른 에이전트CodexCursorOpenCodeOrca