Claude Code v2.1.126 — 프로젝트 초기화, WSL 로그인, 보안 수정까지
AI

Claude Code v2.1.126 — 프로젝트 초기화, WSL 로그인, 보안 수정까지

zaq · · 4 min read

Claude Code v2.1.126이 출시되었습니다. 이번 업데이트는 프로젝트 관리, 인증 편의성, 보안 수정 등 실무에서 바로 체감할 수 있는 개선이 많이 들어왔습니다.

한마디로 요약하면

claude project purge 명령으로 프로젝트 상태를 깔끔하게 초기화할 수 있고, WSL2/SSH/컨테이너 환경에서도 OAuth 로그인이 편해졌습니다. 그리고 보안 설정이 우회되던 버그가 수정되었습니다.

프로젝트 초기화 — claude project purge

새로 추가된 claude project purge [path] 명령은 해당 프로젝트의 Claude Code 상태를 전부 삭제합니다. 트랜스크립트, 태스크, 파일 히스토리, 설정까지 한 번에 정리할 수 있어서 프로젝트를 완전히 새로 시작하고 싶을 때 유용합니다.

지원 옵션도 잘 갖춰져 있습니다:

  • --dry-run: 삭제 전에 미리 확인
  • -y/--yes: 확인 없이 바로 실행
  • -i/--interactive: 항목별로 선택해서 삭제
  • --all: 전체 프로젝트 일괄 삭제

인증 & 모델 선택 개선

OAuth 로그인이 편해졌습니다. WSL2, SSH, Docker 컨테이너 같이 브라우저 콜백이 localhost에 닿지 않는 환경에서는, 브라우저에 표시된 OAuth 코드를 터미널에 직접 붙여넣으면 됩니다. 원격 환경에서도 로그인이 막히지 않습니다.

/model 피커도 달라졌습니다. ANTHROPIC_BASE_URL을 Anthropic 호환 게이트웨이로 설정하면, 해당 게이트웨이의 /v1/models 엔드포인트에서 모델 목록을 가져와 보여줍니다. 직접 모델명을 외울 필요 없이 선택할 수 있어 편합니다.

권한 & 보안 수정

--dangerously-skip-permissions 플래그가 .claude/, .git/, .vscode/ 같은 경로의 쓰기 프롬프트도 우회하도록 바뀌었습니다. 다만 rm -rf / 같은 치명적 삭제 명령은 여전히 확인을 요구해서 안전망은 유지됩니다.

보안 수정이 하나 포함되었습니다. allowManagedDomainsOnly / allowManagedReadPathsOnly 설정이 상위 우선순위 managed-settings에 sandbox 블록이 없으면 무시되던 버그가 수정되었습니다. 엔터프라이즈 환경에서 관리 정책이 제대로 적용되지 않았을 수 있으니 업데이트가 권장됩니다.

그 밖의 개선

  • 이미지 붙여넣기: 2000px 이상 큰 이미지를 붙여넣으면 세션이 깨지던 문제가 수정되었습니다. 이제 자동으로 크기가 조정됩니다.
  • Read 도구: 파일별 멀웨어 평가 알림이 제거되었습니다. 구형 모델에서 "이것은 멀웨어가 아닙니다" 같은 불필요한 주석이 달리던 현상이 해결됩니다.
  • Auto 모드: 권한 확인이 멈춰있을 때 스피너가 빨간색으로 바뀝니다. 도구가 실행 중인지 권한 대기 중인지 한눈에 구분할 수 있습니다.
  • Windows: PowerShell 7 감지가 개선되고, PowerShell 도구 활성화 시 Bash 대신 PowerShell을 기본 셸로 사용합니다.

마무리

이번 업데이트는 "불편했던 것들"을 묵직하게 해결하는 느낌입니다. 프로젝트 초기화, 원격 로그인, 대용량 이미지 처리 같은 부분은 실제 사용하다 보면 꽤 거슬렸을 텐데, 한결 수월해졌습니다. 특히 보안 수정이 포함되어 있으니 관리 환경에서 Claude Code를 쓰고 있다면 빠르게 업데이트하는 게 좋겠습니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.126