Claude Code v2.1.174/175: 모델 제어 강화 및 주요 버그 수정 요약

Claude Code가 v2.1.174 및 v2.1.175를 출시했습니다. 이번 릴리스에는 기업 및 팀 관리자를 위한 새로운 모델 제어 설정 추가와 AWS Bedrock GovCloud 환경에서의 치명적인 오류 수정을 포함하여 13건 이상의 변경 사항이 포함되어 있습니다.

특히 주목해야 할 점은 다음 3가지입니다.

• enforceAvailableModels를 통해 관리자가 Default 모델을 포함하여 모델 사용을 엄격하게 제한 가능
• Bedrock GovCloud에서 발생하던 400 에러(추론 프로필 접두사 오류) 수정
• **백그라운드 세션 (Background Session)**이 다른 세션의 ANTHROPIC_* 환경 변수를 잘못 상속하던 문제 해결

📌 영향을 받는 사람

• AWS Bedrock GovCloud 리전(us-gov-*)에서 Claude Code를 이용 중인 분
• Claude Code의 관리자 설정(Managed Settings)을 운영 중인 기업 및 팀 관리자
• 여러 API 세션을 병행하여 사용 중인 개발자
• VSCode 확장 기능에서 토큰 사용량을 상세히 확인하고 싶은 분

이번 2개의 릴리스에 걸친 변경 사항을 관계별로 정리하면 다음과 같습니다.

관리자가 availableModels 허용 목록을 설정하더라도, 기존에는 'Default' 모델은 제약을 받지 않았습니다. 새로 신설된 enforceAvailableModels를 활성화하면 Default 모델에도 허용 목록을 적용할 수 있게 됩니다.

설정	enforceAvailableModels: false (기존)	enforceAvailableModels: true (신규)
Default 모델에 대한 제약	없음 (허용 목록 외 모델도 이용 가능)	있음 (허용 목록의 첫 번째 모델로 폴백)
사용자 측의 허용 목록 확대	가능	불가능
관리자에 의한 모델 통제	부분적	완전

VSCode 확장의 「Account & usage」 다이얼로그(/usage)에 토큰 이용의 상세 내역이 추가되었습니다. 최근 24시간 또는 7일 동안 다음 항목별로 확인할 수 있습니다.

• 캐시 미스 (Cache Miss)
• 롱 컨텍스트 (Long Context)
• 서브 에이전트 (Sub-agent)
• 스킬 / 에이전트 / 플러그인 / MCP 항목별 내역

MCP나 Workflow 도구를 많이 사용하는 경우, 어떤 컴포넌트가 토큰을 소비하고 있는지 한눈에 알 수 있게 되었습니다.

⚠️ Breaking Change (실질적)

Bedrock GovCloud 리전(us-gov-east-1, us-gov-west-1)을 이용하는 경우, v2.1.174 이전에는 400 에러가 발생하여 Claude Code가 동작하지 않는 상태였습니다. 이번 버전으로 업데이트하면 해결됩니다.

GovCloud 리전에서는 추론 프로필의 접두사(Prefix)로 us-gov를 사용해야 하지만, 실수로 global이 설정되어 있었습니다.

구분	수정 전	수정 후
추론 프로필 접두사	global	us-gov
API 요청 결과	400 에러	정상

백그라운드 데몬(Background Daemon)을 실행한 쉘(Shell)에 설정되어 있던 ANTHROPIC_* 환경 변수(게이트웨이 URL, 커스텀 헤더, /model 에일리어스 등)가 다른 세션의 백그라운드 처리에 잘못 상속되었습니다.

예를 들어, 터미널 A에서 커스텀 게이트웨이를 사용하는 세션을 실행 중인 상태에서, 터미널 B에서 백그라운드 태스크를 실행하면 터미널 B의 태스크가 터미널 A의 설정으로 동작하는 경우가 있었습니다.

플랜에 따라 Default가 결정하는 모델 패밀리가 피커(Picker)에 올바르게 표시되도록 개선되었습니다.

플랜	Default의 결정 대상
Max / Team Premium / Enterprise	Opus
...

또한, ANTHROPIC_DEFAULT_SONNET_MODEL

또한, ANTHROPIC_DEFAULT_SONNET_MODEL을 통해 다른 버전의 Sonnet을 고정(pin)해 둔 경우에도, 피커(picker)가 하드코딩된 버전 라벨이 아닌 실제로 해결(resolve)되는 버전을 표시하도록 개선되었습니다.

Before (v2.1.174 이전): Default 모델은 제약되지 않음

{
"managedSettings": {
"availableModels": ["claude-sonnet-4-6"]
...

이 설정에서는 availableModels에 claude-sonnet-4-6만 지정되어 있더라도, 사용자가 Default를 선택하면 허용 목록(allowlist) 외의 모델이 사용될 가능성이 있었습니다.

After (v2.1.175 이후): Default를 포함하여 완전히 제약

{
"managedSettings": {
"enforceAvailableModels": true,
...

enforceAvailableModels: true를 통해:

• Default는 availableModels의 첫 번째 항목(이 예시에서는 claude-sonnet-4-6)으로 폴백(fallback)됩니다.
• 사용자나 프로젝트 설정에서 availableModels를 확장하는 것이 불가능해집니다.

Before (수정 전): 프리픽스(prefix)가 잘못됨

// 내부에서 생성되었던 모델 ID (오류)
global.anthropic.claude-sonnet-4-6-20251001-v1:0

After (수정 후): GovCloud에 대응하는 올바른 프리픽스

// 수정된 모델 ID
us-gov.anthropic.claude-sonnet-4-6-20251001-v1:0

GovCloud 환경을 이용 중인 분들은 업데이트만으로 대응이 완료됩니다. 코드나 설정 변경은 필요하지 않습니다.

변경 사항	중요도	대응 필요성
enforceAvailableModels 추가	Medium	관리자 전용: 정책에 따라 설정
Bedrock GovCloud 400 에러 수정	High	GovCloud 이용자: 즉시 업데이트 권장
백그라운드 세션 환경 변수 상속 수정	Medium	다중 세션 병행 이용자: 업데이트 권장
VSCode /usage 이용 내역 추가	Medium	VSCode 사용자: 업데이트 시 자동 활성화
/model 피커 표시 수정	Medium	대응 불필요 (업데이트 시 자동 수정)
기타 버그 수정 (8건)	Low	대응 불필요 (업데이트 시 자동 수정)

이번 릴리스에서 가장 중요한 것은 Bedrock GovCloud 사용자에 대한 영향입니다. us-gov-* 리전을 사용하는 분들은 v2.1.174 이상으로의 업데이트를 우선해 주시기 바랍니다. 관리자로서 Claude Code의 모델 사용을 더욱 엄격하게 제어하고 싶다면, v2.1.175에서 추가된 enforceAvailableModels 활용을 검토해 보시기 바랍니다.