2026년 6월 13일에 출시된 Claude Code v2.1.176은 보안 및 거버넌스상의 중요한 수정을 포함한 다수의 버그 수정(Bug Fix)이 포함된 릴리스입니다.

특히 주목해야 할 점은 availableModels 강제를 회피할 수 있었던 우회 경로(Loophole)의 수정입니다. 엔터프라이즈 환경에서 모델 사용 제한을 운영하고 있는 조직에 직접적인 영향을 미치는 변경 사항이며, 거버넌스 담당자 및 플랫폼 엔지니어는 해당 내용을 파악해 두어야 합니다.

이와 더불어 백그라운드/클라우드 세션(Background/Cloud Session)이나 원격 제어(Remote Control), Windows/Linux 고유의 환경 문제 등도 여러 건 수정되어, Claude Code를 일상적으로 사용하는 개발자에게도 중요한 업데이트입니다.

📌 영향을 받는 사람

• 조직에서 모델 허가 목록(availableModels)을 운영하고 있는 관리자
• AWS Bedrock을 통해 Claude Code를 이용하고 있는 개발자
• claude agents나 백그라운드 세션을 활용하고 있는 팀
• Linux / Windows 환경에서 Claude Code를 사용하고 있는 개발자

⚠️ 중요한 수정

엔터프라이즈 환경에서 모델 사용을 제한하고 있는 조직은 반드시 확인하시기 바랍니다.

기존에는 모델 에일리어스(Alias)를 사용한 선택이 ANTHROPIC_DEFAULT_*_MODEL 환경 변수를 통해 차단된 모델로 리다이렉트되는 보안상의 우회 경로가 존재했습니다.

또한 /fast 명령어가 허가 목록 외의 모델로 전환하려고 할 경우, 이전에는 그대로 전환되었으나 앞으로는 토글이 **거부(Refused)**됩니다.

수정 내용:

• ANTHROPIC_DEFAULT_*_MODEL을 통해 차단된 모델로 리다이렉트되는 경로 차단
• /fast가 허가 목록 외 모델로의 전환을 시도할 경우 토글 거부

awsCredentialExport에서 가져온 인증 정보를 기존의 고정 1시간이 아니라 각 인증 정보의 Expiration 필드 값까지 캐시하도록 변경되었습니다.

이를 통해 수명이 짧은 인증 정보(예: 15분 토큰)의 잘못된 장기 캐시나, 만료 전의 불필요한 재취득 문제가 해결됩니다.

Opus 4.8이 활성화되지 않은 조직에서 Fable 5를 사용했을 때 auto 모드가 실패하던 문제를 수정했습니다. 분류기(Classifier)가 이용 가능한 최선의 Opus 모델로 **폴백(Fallback)**하도록 변경되었습니다.

Read · Edit · Write 도구의 경로에 대한 hook의 if

조건에서 문서에 기재된 패턴이 올바르게 매칭되지 않는 문제를 수정했습니다.

수정 전 동작하지 않았던 패턴(예):

# .claude/settings.json
hooks:
- event: PreToolUse
...

💡 Tips

v2.1.176으로 업데이트한 후, 기존의 hook 설정을 재검토하여 기대한 대로 동작하는지 다시 한번 확인하는 것을 권장합니다.

Web 및 모바일 원격 접속 시 발생하던 다음 문제들이 수정되었습니다:

모델의 무단 전환: Web/모바일에서 접속하면 세션의 모델이 바뀌어 버리는 문제 -
연결 끊김 알림 표시 미흡: 사람이 읽을 수 있는 이유가 아닌 숫자 코드만 표시되는 문제 -
연결 실패 시 중복 행: 대화 트랜스크립트(transcript)에 중복된 행이 추가되는 문제 -
로그아웃 후에도 세션 지속: 다른 계정으로 로그인해도 세션이 끊기지 않는 문제

claude agents나 백그라운드 세션을 사용하는 팀에 영향을 미치는 수정 사항이 다수 포함되어 있습니다:

Linux:

• .claude/settings.json이 절대 경로를 가리키는 심볼릭 링크(symbolic link)인 경우 샌드박스(sandbox)가 실행되지 않는 문제를 수정

Windows:

• claude agents 뷰의 입력란에 텍스트 커서가 표시되지 않는 문제를 수정 -
• ~/.claude/daemon에 ReadOnly 속성이 설정되어 있으면 데몬(daemon)이 실행되지 않는 문제를 수정

tmux/SSH:

• SSH를 통한 tmux 내에서 /copy나 마우스 선택 복사가 시스템 클립보드에 전달되지 않는 문제를 수정 -
• tmux 3.2 미만 버전에서 붙여넣기 버퍼(paste buffer)가 로드되지 않는 문제를 수정

# Claude Code CLI의 경우
npm update -g @anthropic-ai/claude-code
# 버전 확인
...

v2.1.176 이후에는 다음과 같은 패턴이 기대한 대로 동작합니다:

{
"hooks": [
{
...

{
"availableModels": [
"claude-sonnet-4-6",
...

💡 Tips

v2.1.176 이후에는 ANTHROPIC_DEFAULT_*_MODEL 환경 변수나 /fast 명령어를 통한 우회 경로로 허용 목록(allowlist) 외의 모델이 사용되는 일이 없어집니다. 설정이 의도한 대로 기능하는지 업데이트 후에 한 번 테스트를 실시해 주세요.

Claude Code v2.1.176의 핵심 포인트를 정리합니다:

v2.1.177도 같은 날 출시되었으나, 현재 시점에서는 릴리스 노트 내용이 공개되지 않았으므로 자세한 내용은 공식 릴리스 페이지를 확인해 주시기 바랍니다.

본 기사는 Claude Code v2.1.176의 릴리스 데이터를 바탕으로 작성되었습니다.