Claude Code 2.1.126이 어제, 5월 1일에 출시됐어요. 체인지로그 대부분은 평범한 — 버그 픽스, OpenTelemetry 손질, Windows 셸 감지 개선이고요. 릴리스 노트가 명확히 짚어주지 않은, 더 중요한 추가 사항이 세 가지 있어요.
- 새
claude project purge [path]명령 — 프로젝트의 모든 Claude Code 상태(트랜스크립트, 작업, 파일 히스토리, 구성 항목)를 한 번에 삭제. CLAUDE_CODE_SUBPROCESS_ENV_SCRUB환경변수 설정 시 Linux에서 PID-네임스페이스 서브프로세스 샌드박싱.- 백그라운드 스크립트의 이벤트를 스트리밍하는 새
Monitor도구.
회사에서 Claude Code를 6개월 이상 production에 돌리고 있다면, 오늘 알아야 할 건 purge 명령이에요. 아무도 우리한테 필요하다고 말 안 해 줬던 정리고, Anthropic 릴리스 노트가 살짝 안 짚어주는 보안 함의가 평범한 housekeeping 업데이트보다 더 흥미롭게 만들어요. 3분, 4개 플래그, 그리고 docs에 없는 한 가지 조언이에요.
Project Purge가 실제로 하는 일
claude project purge [path] (또는 현재 디렉토리는 claude project purge .)이 삭제하는 것:
- 트랜스크립트 — 그 프로젝트에 우리가 보낸 모든 채팅 메시지랑 Claude Code가 생성한 모든 응답.
- 작업 — Claude Code가 그 프로젝트에 추적한 작업 히스토리(TodoCreate / TodoUpdate 상태).
- 파일 히스토리 — Claude이 어떤 파일을 읽고, 편집하고, 작성했는지에 대한 Claude Code 내부 기록.
- 구성 항목 —
~/.claude/projects/<project-hash>/디렉토리의 프로젝트 항목과 그걸 가리키는 관련 구성.
코드는 안 지워요. 프로젝트 파일도 안 지워요. Claude Code의 기억을 지워요 — 세션 간 Claude Code를 지속적으로 느끼게 만드는 로컬 전용 아티팩트요.
Anthropic Claude Code 릴리스 노트 기준 4개 플래그:
| 플래그 | 하는 일 |
|---|---|
--dry-run | 삭제될 것 출력, 실제 삭제는 안 함. 항상 먼저 실행. |
-y / --yes | 확인 프롬프트 스킵. 스크립트에서 사용. 인터랙티브로는 사용 금지. |
-i / --interactive | 삭제 전 각 항목 표시. 6개월+ 히스토리 검토에 최고. |
--all | 모든 프로젝트 정리. “기기 교체 중” 명령. |
실제로 언제 돌려야 할까
purge가 적절한 5가지 상황. 대부분의 사용자가 지금 우리 기기에 적어도 하나는 갖고 있어요.
1. 프로젝트가 아카이브됐을 때
6개월 전에 프로젝트 끝냈고, 레포가 read-only로 갔고, 안 만진 지 오래. Claude Code가 여전히 ~/.claude/projects/<hash>/에 ~30-200 MB 트랜스크립트 들고 있어요. 정리하세요. 생산성 안 만들고, 디스크 공간 차지하고, 트랜스크립트는 그동안 회전한 API 키들 언급하고 있을 거예요.
cd /path/to/archived-project
claude project purge --dry-run
# 파일 목록 맞는지 확인
claude project purge -i
# 인터랙티브 단계, 각각 y 누름
2. 기기 교체할 때
노트북 인계 중이거나 새 거 사서 클론 중. 옛 기기의 트랜스크립트가 추상적으로 민감하지 않더라도 — 6개월 전에 보낸 프롬프트들에 내부 서비스, API 엔드포인트, 회전 잊어버린 자격증명 두어 개 언급된 게 들어 있어요. IT한테 노트북 넘기기 전에 정리.
claude project purge --all --dry-run
# 범위 확인
claude project purge --all -i
3. 레포 소유자 변경
사이드 프로젝트를 개인 GitHub에서 외주나 회사로 옮겼어요. 로컬 Claude Code 트랜스크립트엔 프로젝트가 우리 거였을 때 맥락 적절했던 프롬프트가 있는데, 지금 새 소유권 하에선 부적절할 수 있어요. 새 소유권으로 다음 commit 푸시 전에 프로젝트 Claude Code 상태 정리.
4. 민감한 트랜스크립트가 있을 때
이게 Anthropic 릴리스 노트가 정중하게 안 짚어주는 케이스 — 트랜스크립트는 프롬프트 내용을 갖고 있어요. 우리가 보낸 모든 “여기 우리 데이터베이스 스키마, 인덱스 제안해 줘”. 모든 “여기 우리 인증 흐름, 버그 찾아 줘”. 모든 우발적 .env 라인 붙여넣기. 회사 보안팀이 어떤 종류든 사고 검토 프로세스 갖고 있다면, ~/.claude/projects/<hash>/의 트랜스크립트는 발견 surface예요.
이 부분 KISA/국정원 생성형 AI 보안 가이드 관점에서 특히 중요해요. 가이드라인은 명시적으로 “비인가 AI 사용(섀도우 AI)을 통제하라"고 요구하는데, 우리 로컬 트랜스크립트가 바로 그 통제 surface예요. 사고 후나 정기 보안 감사 시 — Claude Code가 읽은 디렉토리 건드린 모든 사건 — 정리하세요.
5. 프로젝트를 새 팀에 온보딩할 때
장기 프로젝트의 소유권을 다른 엔지니어한테 인계 중. 신선한 상태가 그 사람한테 우리 프롬프트 패턴이랑 그 프롬프트에 대한 Claude의 응답 패턴 6개월치를 상속 안 받고 시작하게 해요. 정리, 깨끗하게 인계.
3분 Walkthrough
프로젝트 열어요. 명령 3개.
스텝 1 — 미리보기 (--dry-run)
claude project purge --dry-run
이런 거 보일 거예요:
Project: my-saas-app (ID: a3f8b2c4...)
Would delete:
- 47 transcripts (~127 MB)
- 312 task entries
- 1,841 file-history records
- Config entry: ~/.claude/projects/a3f8b2c4...
Total: ~127 MB across 4 categories
[Dry run — nothing deleted]
그 목록 읽으세요. 예상 외인 게 있으면(프로젝트 ID 안 맞거나, 파일 히스토리 카운트 충격적으로 높거나) 멈추고 조사.
스텝 2 — 인터랙티브 검토 (-i)
claude project purge -i
각 카테고리 walk through. Anthropic의 인터랙티브 모드가 대표 트랜스크립트 파일 경로 보여주고 삭제 전에 물어봐요. 6개월+ 히스토리에 대해 이게 “잠깐, 그건 보존해야지” 잡는 경로예요. 거기 2분 쓰세요.
스텝 3 — 확인
-i 모드 완료 후, 우리 프로젝트의 ~/.claude/projects/<hash>/ 디렉토리가 비어 있어요. 검증:
ls -la ~/.claude/projects/ | grep <project-hash>
항목이 없으면 정리 성공. 다음에 그 프로젝트 디렉토리에서 Claude Code 돌릴 때 신선하게 시작해요.
Anthropic 릴리스 노트가 안 짚어주는 거
공식 체인지로그는 “프로젝트의 모든 Claude Code 상태 삭제"라고 적어요. 사실이지만 — 기술적 설명이지 보안 관련 설명은 아니에요.
알아야 할 것 더:
트랜스크립트는 우리가 붙여넣은 모든 거 갖고 있어요. 모든 프롬프트, 모든 응답, 모든 코드 블록 붙여넣기, 우발적 .env 값이나 API 키 포함. 프로젝트에 6개월 동안 Claude Code 써왔다면, 트랜스크립트는 Claude한테 우리 데이터로 뭘 시켰는지에 대한 종합 로그예요 — 검색 가능, 평문, 디스크에. Purge는 housekeeping 만이 아니에요. 데이터 위생이에요.
트랜스크립트는 git clean 후에도 지속되고 레포랑 같이 안 움직여요. ~/.claude/projects/<hash>/에 살지, 우리 프로젝트 디렉토리에 살지 않아요. git clean -fdx도 안 건드려요. 새 기기에 레포 클론해도 안 가져와요. 트랜스크립트는 설계상 로컬-기기 특정 — 명시적 purge 외에 모든 걸 살아남는다는 뜻이에요.
--all 플래그는 “떠나는 중” 명령. 노트북 회전 중, 직장 떠나는 중, 또는 IT한테 기기 인계 중이라면, claude project purge --all이 — 아무도 우리한테 돌리라고 안 알려줄 — 정리예요. 트랜스크립트는 신중한 독자가 의미 있는 내부 정보를 재구성할 만큼 충분한 맥락 갖고 있어요. 개인 기기 인계 전 브라우저 히스토리처럼 다루세요.
서브프로세스 샌드박싱이 관련 뉴스. CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 설정이 Linux에서 PID-네임스페이스 서브프로세스 격리를 활성화하고 동시에 Claude Code의 Bash 도구가 spawn하기 전에 Anthropic이랑 클라우드 공급자 자격증명을 서브프로세스 환경에서 제거해요. Claude Code를 서브프로세스가 env vars를 로그, 종속성 훅, 텔레메트리에 누설할 수 있는 환경에서 돌리면, 이 env var 설정. Purge가 과거 상태를 다루고, env var이 새 누설을 방지.
누구한테 이게 의미가 있냐면
Claude Code를 로컬에서 돌리는 솔로 개발자라면: 이번 주말에 가장 오래된 프로젝트 3개에 claude project purge --dry-run 돌리세요. 보존할 거 결정에 10분 쓰세요. 필요 없는 건 정리.
5-50명 엔지니어링 팀이라면: 오프보딩 체크리스트에 “노트북 인계 전 Claude Code 상태 정리"라는 보안-정책 라인 추가. 엔지니어 재직 중 트랜스크립트에 등장한 API 키 회전이랑 페어. 둘 다 3분 걸리고, 둘 다 진짜 구멍 닫아요.
한국 enterprise IT 또는 CISO라면: ~/.claude/projects/의 트랜스크립트는 이제 문서화된 데이터 발견 surface예요. KISA가 권장하는 “비인가 AI 사용 통제” 원칙이 이런 데이터 위생 정책을 통해 실제로 구현돼요. 표준 엔드포인트 관리 베이스라인에 추가 — 90일 동안 안 만진 모든 프로젝트의 주간 정리, 오프보딩 시 자동 정리. 과기정통부 생성형 AI 보안 가이드 시각에서 이건 “최소 권한 + 행위 이력 추적” 원칙의 자연스러운 연장이에요.
CI나 자동화에서 Claude Code 돌리면: 백그라운드 스크립트 이벤트 스트리밍하는 새 Monitor 도구가 purge 명령이랑 자연스럽게 페어. 각 작업 후 일시적 빌드 환경의 Claude Code 상태를 정리하는 작은 CI 스텝 빌드. “오래 산 러너에서 Claude Code 돌렸는데 상태 누적됨” 문제 방지.
Linux 프로덕션 호스트라면: 오늘 서비스 구성에 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB 설정. 진짜 보안 개선이 있는 한 줄 변경.
Project Purge로 못 고치는 거
솔직한 한계 5가지:
- 클라우드에 푸시된 건 안 정리해요. Anthropic이 프라이버시 정책에 따라 서버 측에서 우리 프롬프트를 로깅해요. Purge는 로컬 아티팩트만 다뤄요. 민감한 거 프롬프트로 보냈고 지금 사라지길 원한다면, 그건 별도 Anthropic 데이터 삭제 요청.
- MCP 서버 상태는 안 정리해요. 사용자 정의 MCP 서버는 자체 상태를 유지. 우리 로컬 MCP 서버가 프로젝트 컨텍스트 캐시 갖고 있다면, 그 캐시는
claude project purge후에도 살아남아요. - 트랜스크립트에 뭐가 있었는지 알려줄 수 없어요. “삭제된 것 요약” 기능 없음. 파일 카운트랑 사이즈는 보고, 프롬프트 내용은 안 봐요. 6개월 전에 보낸 프롬프트 알고 싶으면 — purge 전 수동 검토.
- 이전 Claude Code 버전에 소급 적용 안 돼요. 2.1.126 이전 설치는 약간 다른 경로에 트랜스크립트 남겼을 수 있어요. Purge는 표준
~/.claude/projects/경로 정리; 이전 off-path 아티팩트는 수동find+rm필요. - 오프보딩 대체 아니에요. 떠나는 엔지니어 기기의 Claude Code 상태 정리는 키 회전, 레포 액세스 제거, 자격증명 감사 대체 안 해요. 더 긴 체크리스트의 한 항목.
결론
2.1.126 업데이트는 출시 게시물 안 받는 종류 릴리스예요. 그리고 대부분 팀이 보안 모델에 미리 잡지 않은 클래스 문제를 조용히 닫는 종류 업데이트예요. 플래그 3개, 3분, 그리고 우리 기기가 Claude한테 우리가 보낸 모든 프롬프트의 시간순 로그가 되는 걸 멈춰요.
오늘 가장 오래된 프로젝트에 claude project purge --dry-run 돌리세요. 파일 히스토리 카운트에 놀랄 거예요.
Claude Code production 패턴 전반 팀 업스킬링은 Claude Code Mastery 강좌가 일상 워크플로우, Claude Code Session Mastery 강좌가 컨텍스트 윈도우랑 지속성 패턴(모듈 5에 새 purge 명령 다룸), AI Agent Security 강좌가 Linux 서브프로세스 샌드박싱이 다루는 더 넓은 위협 모델 다뤄요.
크로스 링크 — agentic-coding-tool 결정 프레임워크는 Mistral Vibe vs Claude Code vs Codex 비교 보세요. 관리되는 Windows 단말에서 Claude Code 돌리는 IT-admin 거버넌스 측면은 Microsoft Agent 365 Shadow AI 페이지 보고요.
