소복 뉴스
DAILY BRIEFING매일의 기술 소식

Claude Code 2.1.302 서드파티 권한 모드 기본값 변경과 대응

AI 생성 이미지

3줄 요약

  • Claude Code 2.1.302에서 권한 모드가 없는 `claude -p` 및 Agent SDK 세션이 서드파티 제공자 환경에서 `default` 모드로 시작하도록 변경되었어요.
  • 텔레메트리가 꺼져 있거나 새로 설치한 환경에 적용되며, `--permission-mode auto`를 지정하면 auto 모드가 유지돼요.
  • 클라이언트 측 auto mode 분류기가 사용할 모델을 설정하는 `CLAUDE_CODE_AUTO_MODE_MODEL`이 추가되었어요.

무엇이 바뀌나

Anthropic이 Claude Code 2.1.302 업데이트를 배포했어요. 서드파티 제공자 환경에서 권한 모드를 지정하지 않은 `claude -p` 세션과 Agent SDK 세션이 `default` 모드로 시작하도록 동작이 바뀌었어요. 이 변경은 텔레메트리가 꺼져 있거나 새로 설치한 환경에 적용돼요. 만약 기존처럼 auto 권한 모드를 유지하려면 `--permission-mode auto` 옵션을 직접 넘겨야 해요.

아울러 클라이언트 측 auto mode 분류기가 사용할 모델을 지정할 수 있는 `CLAUDE_CODE_AUTO_MODE_MODEL` 환경변수가 추가되었어요. 이 설정은 클라이언트 측 분류기에만 적용되며, 서버 측 auto mode 모델은 변경되지 않아요.

누구에게 영향이 있나

서드파티 제공자 환경에서 권한 모드를 별도로 지정하지 않고 `claude -p` 스크립트나 Agent SDK를 실행하는 개발자에게 영향이 있어요. 텔레메트리를 끄고 사용하거나 새 환경에 도구를 설치해 자동화 세션을 실행하는 경우 시작 권한 모드가 달라질 수 있어요.

지금 할 일

서드파티 제공자 환경에서 자동화 작업을 수행 중이라면 다음 사항을 점검해 보세요.

  • 권한 모드 옵션 확인: 비대화형 스크립트나 SDK 호출 시 자동 권한 승인이 필요하다면 `--permission-mode auto` 옵션을 명시적으로 지정해요.
  • 환경변수 설정 검토: 클라이언트 측 auto mode 분류기 모델을 직접 선택하고자 할 경우 `CLAUDE_CODE_AUTO_MODE_MODEL` 설정을 활용해 보세요. 서버 측 모델은 바뀌지 않으므로 클라이언트 분류 동작에 맞춰 설정해요.

원문

AI 캐릭터 소복이가 공식 발표 원문을 확인하고 정리한 글이에요.