Claude Code 주간 브리핑 Week 18 — project purge·PR URL 세션 재개
시리즈: Claude Code 주간 브리핑 | Week 18
2026년 4월 다섯째 주, Claude Code가 챙긴 것들
2026년 4월 27일부터 5월 1일까지 Claude Code는 v2.1.120에서 v2.1.126으로 업데이트됐다. 이번 주 메인 기능은 4건 — 브라우저 콜백 없는 로그인, claude project purge, PR URL로 세션 재개, Git Bash 없는 Windows 지원. 특히 project purge와 Resume by PR URL은 다중 에이전트 파이프라인과 세션 추적 방식에 직접 관계된 변경이다. 릴리스 노트 기준으로 각 기능의 공식 동작을 정리하고, 다중 에이전트·발행 파이프라인·git 규율에 적용할 수 있는 시사점을 분석으로 덧붙인다.
이 포스팅은 Claude Code 공식 docs(code.claude.com) 기반으로 작성됐다. ‘직접 돌려본 결과’가 아닌 공식 문서 기준 동작을 소개하는 방식임을 먼저 밝혀둔다.
1. 브라우저 콜백 없는 로그인 — WSL2·SSH·컨테이너 환경 (v2.1.126)
공식 docs 기준 동작
claude auth login이 브라우저 콜백을 localhost로 전달할 수 없는 환경, 즉 WSL2, SSH 세션, 컨테이너에서 동작하지 않던 문제를 해소했다. 이제 브라우저가 보여주는 OAuth 코드를 터미널에 직접 붙여넣는 방식으로 인증이 가능하다.
claude auth login명령 실행 후 브라우저에서 표시된 코드를 터미널에 붙여넣으면 된다. 동일 릴리스에서 느리거나 프록시를 경유하는 연결과 IPv6-only devcontainer 환경의 로그인 타임아웃 문제도 함께 수정됐다.
적용 시사점
맥OS·Linux 환경에서는 변화 없음. WSL2·SSH·컨테이너를 사용하는 환경에서 유효한 변경이다. 브라우저 리다이렉트 없이 코드 붙여넣기만으로 인증이 완료되므로, 헤드리스 서버나 원격 개발 환경에서 Claude Code를 처음 설정하는 경우에 특히 유용하다.
2. claude project purge — 프로젝트 상태 초기화 (v2.1.126) ★
공식 docs 기준 동작
한 프로젝트의 모든 Claude Code 로컬 상태를 삭제하는 명령이다. 삭제 대상은 transcripts, tasks, file history, 프로젝트 config 엔트리 전체다.
옵션은 아래 네 가지다.
| 옵션 | 동작 |
|---|---|
--dry-run | 삭제될 항목을 미리보기만 하고 실제 삭제하지 않음 |
-y / --yes | 확인 프롬프트 없이 즉시 삭제 |
-i / --interactive | 삭제 항목을 직접 선택 |
--all | 모든 프로젝트 상태 일괄 정리 |
사용 순서는 먼저 --dry-run으로 삭제 범위를 확인한 뒤 실제 실행하는 것을 공식 docs가 권장한다.
# 삭제 범위 미리보기
claude project purge --dry-run
# 실제 삭제
claude project purge적용 시사점 ★
다중 에이전트 파이프라인을 운영하다 보면 프로젝트 단위로 쌓이는 상태(transcripts, tasks)가 세션 간 컨텍스트 오염 원인이 될 수 있다. claude project purge는 특정 프로젝트를 깨끗한 상태로 되돌리는 공식 수단을 제공한다. --dry-run 안전장치가 있어 의도치 않은 삭제를 사전에 걸러낼 수 있는 구조다. 파이프라인 초기화나 테스트 환경 리셋 시나리오에서 활용 가능성이 있다.
3. Resume by PR URL — PR 번호로 세션 즉시 복귀 (v2.1.122) ★
공식 docs 기준 동작
gh pr create로 PR을 만들면 Claude Code가 해당 PR을 생성한 세션과 연결해 둔다. v2.1.122부터는 세션 이름을 기억하지 않아도 PR URL만으로 그 세션으로 복귀할 수 있다.
세션 피커를 열고 PR URL을 붙여넣으면, 붙여넣기 첫 글자에서 자동으로 검색 모드에 진입하며 해당 PR을 생성한 세션으로 목록이 필터링된다. Enter를 누르면 해당 세션을 재개한다.
> /resume피커가 열린 상태에서 아래와 같이 PR URL을 붙여넣는다.
https://github.com/your-org/your-repo/pull/1234피커를 거치지 않고 커맨드라인에서 직접 PR 번호를 지정할 수도 있다.
claude --from-pr 1234GitHub, GitHub Enterprise, GitLab, Bitbucket의 pull/merge request URL이 모두 지원된다.
적용 시사점 ★
git 규율에서 main 직접 작업이 원칙이라도 PR 흐름을 통한 작업 추적이 함께 운영되는 환경에서 실용적이다. 세션과 PR이 자동으로 연결되므로, PR URL 하나만으로 해당 작업을 만든 Claude Code 세션으로 즉시 돌아올 수 있다. 세션-PR 간 추적성을 확보하는 공식 수단이 마련됐다.
4. Git Bash 없는 Windows 지원 (Windows) — 소개
공식 docs 기준 동작
Git for Windows가 더 이상 필수 조건이 아니다. Bash가 없는 환경에서 Claude Code는 PowerShell을 셸 도구로 사용하며, PowerShell 도구가 활성화된 경우 기본 셸로 취급한다. Microsoft Store, PATH 없는 MSI, .NET 글로벌 도구로 설치된 PowerShell 7을 자동으로 감지한다.
적용 시사점
맥OS·Linux 환경 독자라면 별도 조치 불필요. 이 변경은 Windows 환경에 해당한다. 팀 내 Windows 사용자가 있거나 Windows 환경으로 전환이 예정된 경우에만 참고하면 된다.
5. Other wins — 눈에 띄는 개선 3가지
W18에는 메인 기능 외에도 파이프라인 운영에 직접 관계있는 개선이 포함됐다.
PostToolUse 훅 확장: PostToolUse 훅의 hookSpecificOutput.updatedToolOutput 옵션이 MCP뿐 아니라 임의 도구의 출력도 교체할 수 있게 됐다. 자동화 스크립트에서 도구 출력을 후처리하거나 변환하는 용도로 활용 가능하다.
claude ultrareview 서브커맨드: /ultrareview를 CI·스크립트에서 비대화형으로 실행할 수 있는 claude ultrareview 서브커맨드가 추가됐다. 결과는 stdout으로 출력되며 --json 옵션으로 원시 출력을 받을 수 있고, 완료 시 exit 0, 실패 시 exit 1을 반환한다. CI 파이프라인에서 코드 리뷰를 자동화하는 진입점으로 쓸 수 있다.
MCP 서버 자동 재시도: MCP 서버가 시작 중 연결 타임아웃 등 일시적 오류(transient error)를 만나면 최대 3회 자동으로 재시도한다. 서버가 연결 실패 상태로 남아있던 문제를 줄이는 개선이다.
Week 18 정리
| 기능 | 버전 | 분류 |
|---|---|---|
| 브라우저 콜백 없는 로그인 | v2.1.126 | 환경 확장 (WSL2·SSH·컨테이너) |
| claude project purge | v2.1.126 | 상태 관리 ★ |
| Resume by PR URL | v2.1.122 | 세션 관리 ★ |
| Git Bash 없는 Windows 지원 | Windows | 환경 확장 (Windows 전용) |
이번 주 핵심은 project purge와 Resume by PR URL 두 가지다. 전자는 프로젝트 상태를 안전하게 초기화하는 수단을, 후자는 세션과 PR을 연결하는 추적성 기반을 제공한다. 어느 쪽이든 파이프라인 규모가 커질수록 실용적인 기능이다.
이 시리즈의 다른 글
이 포스팅은 Claude Code 주간 브리핑 시리즈의 일부입니다. 다른 주차 브리핑은 시리즈 전체 목록에서 확인할 수 있습니다.
출처: Claude Code 공식 docs — code.claude.com (릴리스 v2.1.120–v2.1.126, 2026-04-27 ~ 2026-05-01)