Claude Code v2.1.163 신기능 및 버그 수정: 버전 강제 기능 추가

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는 실행이 거부됩니다. 기존 설정에 추가할 경우에는 현재 팀에서 사용 중인 버전을 사전에 확인하시기 바랍니다.

설정 키	설명
requiredMinimumVersion	이 값보다 오래된 버전의 실행을 거부함
requiredMaximumVersion	이 값보다 최신 버전의 실행을 거부함

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

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

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

수정 내용	영향 범위
claude -p가 백그라운드 명령어 종료 후 무한 행(Hang) 상태가 되는 문제	CI/CD 이용자
$TMPDIR이 모든 명령어에서 /tmp/claude-{uid}로 덮어씌워지는 퇴행 (v2.1.154에서 혼입)	bazel·EDR 보호 환경 이용자
CI=true이면서 API 키가 설정되지 않았을 때 Bedrock/Vertex/Foundry에서 잘못된 에러가 발생하는 문제	클라우드 프로바이더 경유 이용자
Windows의 OneDrive 하위 디렉토리 등에서 EEXIST 에러가 발생하는 문제	Windows 이용자
조직의 권한 규칙이 신규 config 디렉토리 실행 중에 적용되지 않는 문제	매니지드 설정 이용자
claude agents 백그라운드 세션이 재어태치(Re-attach) 후에 태스크를 잃는 문제	에이전트 이용자
훅(Hook)의 if: "Bash(...)" 조건이 $() 또는 $VAR를 포함하는 명령어에서 잘못 발화하는 문제	훅 구현자
$HOME을 통한 거부 규칙 (예: Read(~/Desktop/**))이 Bash 명령어를 차단하지 않는 문제	권한 설정 이용자
stdio MCP 서버가 --resume 시 CLAUDE_CODE_SESSION_ID를 받지 못하는 문제	MCP 서버 개발자

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.165	버그 수정 및 신뢰성 향상 (상세 내용 비공개)	낮음 (수시 업데이트 권장)
v2.1.163	버전 강제 기능 추가 및 다수의 버그 수정	높음 (CI/CD 및 조직 사용자는 조기 대응 권장)

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