Claude Code v2.1.327을 사내 자동화 작업(job)에 배포한 다음 날 아침, v2.1.328이 출시되었습니다.
지난번에는 'Bedrock 상에서 서브 에이전트의 effort 설정이 무효화되는' 회귀(regression)가 있어, 배포 후 이를 인지하게 되었습니다. 이번에도 같은 문제가 발생하지 않는지 변경 사항을 전반적으로 확인했습니다.
릴리스 노트의 분량이 많습니다. 여기서는 기업용 gateway 사용, 자체 runner 구축, 멀티 프로바이더 배포와 관련된 내용만 정리하겠습니다.
이 글에서 알 수 있는 것:
Amazon Bedrock・Microsoft Foundry・Google Cloud Gateway를 위한 auto mode 추가, MCP tool hook의 제어 강화, Self-Hosted Runner의 관리 기능 확장, 자동 압축(auto compaction) 수정, zsh 및 Bash 버그 수정 등 총 5가지 사항입니다. 릴리스일은 2026년 11월 19일입니다.
v2.1.328에서 Claude의 auto mode가 다음 플랫폼에 대응했습니다:
- Amazon Bedrock
- Google Cloud's Agent Platform
- Microsoft Foundry
- Claude apps gateway
auto mode란, 추론의 무게(effort level)를 Claude가 작업의 복잡성에 따라 자동으로 선택하는 모드입니다. 이전까지는 Claude.com이나 Anthropic API를 직접 사용하는 세션에서만 작동했습니다.
기업 내부에서 Bedrock나 Foundry를 internal deployment의 기반으로 사용하고 있다면, effort 설정은 플로우(flow) 측면에서 고정할 수밖에 없었습니다. v2.1.328 이후로는 자동화 작업의 effort 판단을 Claude 측에 위임하는 선택지가 추가되었습니다.
반면, 기존 설정에 영향을 줄 수 있는 점이 중요합니다.
확인 포인트: --permission-mode
명시하지 않은 interactive session은 v2.1.328부터 auto mode로 시작하는 사양이 되었습니다. 기존 작업이 의도치 않게 auto mode로 전환되지 않았는지 확인할 필요가 있습니다. 특히 gateway를 거치는 상시 작동(常時稼働) 작업은 설정 재검토를 권장합니다.
auto mode의 effort 선택은 '작업이 무겁다고 판단했을 때, 더 많은 토큰을 사용할 수 있다'는 동작을 할 가능성이 있습니다. 비용 관리를 하고 있다면, 배포 후 토큰 소비량을 모니터링하는 것을 추천합니다.
커맨드 hook 및 HTTP hook에 이미 있던 `
claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds: 세션 재개 대기 시간과 신규 세션 대기 시간을 분리하여 측정 가능
claude_code_self_hosted_orchestrator_sessions_given_up_total: Anthropic이 러너(runner) 시작을 포기한 횟수를 원인별로 집계
이를 통해 "세션이 큐에 막혀 있는지"와 "러너가 시작하는 데 실패했는지"를 구분하여 모니터링할 수 있게 되었습니다. 이전에는 두 경우 모두 같은 큐 지연으로 보이던 부분이 있어, 문제의 원인을 분리하는 데 도움이 됩니다.
Self-Hosted Runner를 본격적으로 운영하는 조직에게는 실용적인 추가 기능입니다. 저희 환경에서는 러너의 given_up_total이 알림 임계치에 걸려야만 문제를 인지하게 되는 패턴이 몇 번 있었습니다.
시작 시 경고(Startup Warning) 추가:
다음 두 가지 경우에 대해 시작 시 경고가 발생하도록 변경되었습니다:
- 호스트의
settings.json에서 기본 권한 모드(permission mode)를 설정했지만, 세션이 이를 무시하는 경우
- 오케스트레이터(orchestrator) 시작 시
policy.maxEffortLevel에 유효하지 않은 값이 설정된 경우
설정 오류를 배포 직후에 감지할 수 있게 되었습니다.
자동 컴팩션 동작 관련 수정:
수정 내용: 자동 컴팩션이 실행될 때, 이전에는 바로 직전의 시스템 프롬프트(system prompt)를 그대로 재사용했습니다. v2.1.328부터는 /compact 명령어와 동일한 방식으로 시스템 프롬프트를 재구성하도록 변경되었습니다.
오버나이트 작업(overnight job)이나 지속 실행되는 작업처럼 컴팩션이 여러 번 발생하는 세션에서는, 시스템 프롬프트가 점진적으로 어긋나는 현상이 발생했을 가능성이 있습니다. 컴팩션 후 세션의 동작이 이상하다고 느껴지셨다면, 이 수정 사항과 관련이 있을 수 있습니다.
또한, 컴팩션 후에 세션을 재개(resume)할 때, 컴팩션 요약이나 최근 메시지가 사라지는 문제도 수정되었습니다. 이는 rewind 이후 /clear를 실행했을 때의 경로에서도 동일하게 수정된 내용입니다.
장기간 운영되는 세션을 사용하고 계신 경우, v2.1.328 이후의 동작을 확인해 보시는 것이 좋습니다.
사소하지만 영향 범위가 넓은 버그 수정:
수정 내용: Bash 명령어를 zsh에서 실행했을 때, =로 시작하는 단어(예: echo ==== 또는 [ a == b ])에서 "not found" 오류가 발생하던 문제를 수정했습니다. =cmd가 명령어의 절대 경로로 전개되는 동작을 무효화했습니다.
zsh에는 =cmd를 명령어의 절대 경로로 전개하는 기능이 있습니다(예: =python → /usr/bin/python). Claude Code가 생성한 Bash 스크립트에 == 같은 비교 연산자나 ====와 같은 구분 기호가 포함될 경우, zsh 환경에서는 예상치 못한 전개가 발생했습니다.
macOS의 기본 셸이 2019년부터 zsh로 변경되었기 때문에, Mac 사용자 중심으로 영향을 받은 분들이 일정 수 있을 것이라 생각합니다. 저 역시 예전에 echo ====가 "not found"가 되어 원인을 추적했던 기억이 있습니다. 논리적으로는 가능하지만, 그렇지 않은 경우였습니다.
Linux (bash) 환경에서만 사용하신다면 영향은 없습니다.
v2.1.327에 포함되었던 "Bedrock이나 Google Cloud AgentPlatform・Foundry가 서브 에이전트의 Progress 요약(Progress summary) effort 설정을 거부할 때, 세션 전체의 effort가 무효화되는" 회귀 현상(regression)은 v2.1.328에서 수정되었습니다.
v2.1.327을 배포한 상태에서 Bedrock상의 서브 에이전트가 의도보다 가벼운 추론으로 작동했던 경우, v2.1.328로 업데이트하면 개선될 가능성이 있습니다.
- Bedrock/Foundry/Google Cloud Gateway에 대한 Auto 모드 대응으로 인해, 기존의 인터랙티브 세션(interactive session) 권한 모드 설정을 재검토해야 합니다.
- MCP 툴 후크(tool hook)에
onFailure: block이 추가되었습니다.
추가적으로, MCP 서버 사용 시 제어가 다른 훅(hook)과 통일될 수 있습니다. Self-Hosted Runner의 메트릭스가 추가되어, 큐 정체와 러너(runner) 시작 실패를 분리하여 모니터링할 수 있게 되었습니다.
또한 자동 압축(auto compaction)의 시스템 프롬프트 문제와 zsh의 = 버그 수정이 포함됩니다.
v2.1.328은 특히 게이트웨이(gateways)와 Self-Hosted Runner를 위한 변경 사항이 많았던 버전입니다. Bedrock과 함께 사내에 배포하는 팀은 자동 압축 수정 및 auto mode 대응을 우선적으로 확인하는 것을 권장합니다.
무인 실행이 멈추는 원인 점검을 코코나라(ココナラ)에서 받고 있습니다 ("Claude Code 점검"으로 검색).