2026년 6월 5일, Anthropic이 Claude Code의 신버전 v2.1.163 및 v2.1.165를 출시했습니다.

이번 업데이트의 핵심은 조직에서의 운영 관리를 강화하는 버전 강제 기능의 추가입니다. requiredMinimumVersion / requiredMaximumVersion을 사용함으로써, 엔지니어가 너무 오래되었거나 너무 최신인 버전으로 Claude Code를 실행하는 것을 차단할 수 있게 되었습니다. 이에 더해, /plugin list 명령어가 추가되었고, Stop/SubagentStop 훅(Hook)의 개선, 그리고 claude -p 행(Hang) 현상 및 $TMPDIR 퇴행(Regression)을 포함한 다수의 버그 수정이 포함되었습니다.

📌 영향을 받는 대상

• Claude Code를 조직·팀 단위로 운영 중인 관리자
• CI/CD 파이프라인에서 claude -p를 사용 중인 개발자
• Bedrock / Vertex AI / Azure AI Foundry를 통해 Claude를 이용 중인 개발자
• MCP 서버나 커스텀 훅(Custom Hook)을 구현 중인 개발자

⚠️ Breaking Change (조직 관리자 대상)

매니지드 설정(Managed Setting)에서 버전 범위를 설정하면, 범위를 벗어난 Claude Code는 실행이 거부됩니다. 기존 설정에 추가할 경우에는 현재 팀에서 사용 중인 버전을 사전에 확인하시기 바랍니다.

조직에서 특정 버전의 Claude Code를 강제 배포하고 싶거나, 보안 심사를 마친 버전 이외의 사용을 금지하고 싶을 때 활용할 수 있습니다.

설치된 플러그인을 목록으로 표시할 수 있는 /plugin list 명령어가 추가되었습니다. --enabled / --disabled 플래그로 필터링이 가능합니다.

Stop 및 SubagentStop 훅(Hook)이 hookSpecificOutput.additionalContext를 반환함으로써, 훅 에러(Hook Error)로 처리되지 않고 Claude에게 피드백을 전달하면서 턴(Turn)을 계속할 수 있게 되었습니다.

claude -p의 행(Hang) 문제가 수정되었습니다 (stdin 종료 후 약 5초 뒤에 백그라운드 셸을 정지). v2.1.154~v2.1.162를 사용 중이며 CI가 불안정했다면 v2.1.163 이후 버전으로 업데이트할 것을 권장합니다.

CI=true 환경에서 ANTHROPIC_API_KEY를 설정하지 않았음에도 불구하고 ANTHROPIC_API_KEY required 에러가 발생하던 문제는 v2.1.163에서 수정되었습니다.

Before (v2.1.162 이전)

// hookSpecificOutput 에 additionalContext 를 반환해도 무시됨
// 후크(Hook)가 피드백을 반환하려면 exit code 를 사용하는 방법밖에 없었음
{
...

After (v2.1.163 이후)

// additionalContext 를 반환하면 후크 에러 없이 Claude 에게 피드백을 전달할 수 있음
{
"hookSpecificOutput": {
...

💡 Tips

additionalContext를 사용하면, 후크를 "에러"로 취급하지 않고 Claude의 턴(Turn)을 지속시키면서 추가 정보를 전달할 수 있습니다. 포스트 프로세스(Post-process)적인 체크나, 조건에 따른 추가 지시 사항 주입에 활용할 수 있습니다.

{
"requiredMinimumVersion": "2.1.163",
"requiredMaximumVersion": "2.1.165"
...

이 설정을 managed settings에 추가하면, v2.1.163 ~ v2.1.165 범위를 벗어난 버전에서는 Claude Code가 실행 시 거부 메시지를 표시하고, 승인된 버전으로의 업데이트를 안내합니다.

# v2.1.163 이전: 숫자 앞에 리터럴 $ 를 쓸 수 없었음
# v2.1.163 이후: \$ 로 이스케이프(Escape) 가능
echo "버전: \$1.2.3"
...

v2.1.163은 조직 거버넌스(Governance) 관점에서 중요한 신기능을 포함하고 있으며, claude -p 행(Hang) 현상이나 $TMPDIR 퇴행 등 실질적인 피해를 주던 버그를 다수 수정했습니다. 특히 CI/CD 환경에서 Claude Code를 사용 중이거나, Bedrock/Vertex/Foundry를 통해 이용하고 있는 경우에는 빠른 업데이트를 권장합니다.