Claude Code v2.1.176: 모델 제어 우회 수정 및 버그 수정 요약

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를 사용하고 있는 개발자

중요도	변경 내용	카테고리
🔴 High	`availableModels` 강제 회피 우회 경로 수정	보안
🟡 Medium	Bedrock 인증 정보 캐시를 만료(Expiration) 시점까지 연장	AWS Bedrock
🟡 Medium	Fable 5의 auto 모드 실패 수정	모델 호환성
🟡 Medium	Hook의 `if` 조건 경로 매칭 수정	Hook
🟡 Medium	Remote Control 여러 불량 수정	원격 제어
🟡 Medium	백그라운드/클라우드 세션 여러 건 수정	세션 관리
🟢 Low	Linux 샌드박스 실행 실패(symlink) 수정	Linux
...	`/cd` · worktree 이동 후 git 브랜치 오표시 수정	Git
🟢 Low	Windows 고유 불량 수정 (2건)	Windows
🟢 Low	`claude agents`의 back 조작 시 다른 창 절단 문제 수정	agents
🟢 Low	세션 타이틀을 대화 언어로 자동 생성 (신기능)	UX
🟢 Low	`footerLinksRegexes` 설정 추가 (신기능)	커스터마이징

⚠️ 중요한 수정

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

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

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

수정 내용:

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

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

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

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

상황	수정 전	수정 후
Opus 4.8 활성화	auto 모드 정상	auto 모드 정상
Opus 4.8 비활성화 + Fable 5	auto 모드 실패 ❌	최선의 Opus로 폴백 ✅

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

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

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

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

💡 Tips

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

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

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

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

문제	설명
지속적인 "Working" 표시	`/bg` 실행 후 지속적인 처리가 없으면 영원히 "Working" 상태가 됨
PR URL 검색 누락	스케줄링 실행 중 또는 작업 블록(job block) 중에 열린 PR이 `claude agents`에 나타나지 않음
세션 이름 시드(seed) 실패	`claude --bg -cn <name>`이 세션 이름을 시드하지 않음
클라우드 인증 실패	유휴(idle) 시간이 너무 길어 "Could not resolve authentication method" 에러 발생
잘못된 resume ID	손상된 상태 파일로부터의 잘못된 resume ID를 거부

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의 핵심 포인트를 정리합니다:

구분	요점
최중요	`availableModels` 우회 수정 — 엔터프라이즈의 모델 거버넌스(governance)가 확실하게 작동하게 됨
Bedrock 사용자	인증 정보 캐시가 실제 만료(Expiration) 시점까지 연장되어, 불필요한 재취득이 감소
Hook 사용자	경로 패턴(`src/**`, `.env` 등)이 올바르게 매칭되도록 수정. 기존 설정의 동작 확인 권장
agents/백그라운드	지속적인 "Working" 문제나 PR URL 누락 등 다수 수정. 안정성 향상
Windows/Linux	환경 특유의 실행 및 UI 결함 해소

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

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

Claude Code v2.1.176: 모델 제어 우회 수정 및 버그 수정 요약

요약

핵심 포인트

댓글