Claude Code 데일리 브리핑 - 2026-06-05

최신 릴리스 요약

버전날짜핵심 변경
v2.1.1636/4requiredMinimumVersion/requiredMaximumVersion 버전 거버넌스, /plugin list, Stop·SubagentStop 훅 additionalContext, 다수 버그 수정
v2.1.1626/3claude agents --jsonwaitingFor, WebFetch 권한 우선순위·Windows 경로 규칙 수정
v2.1.1616/2OTEL 커스텀 라벨, 병렬 도구 호출 격리, claude mcp 시크릿 마스킹

어제(6/4) v2.1.163이 나왔습니다. 새 기능 한두 개와 함께 권한 규칙·헤드리스(claude -p)·Windows·Bedrock 경로의 버그 수정이 두툼하게 묶인 릴리스입니다. (v2.1.162·v2.1.161의 상세는 어제·그제 브리핑에서 다뤘습니다.)

전체 릴리스 노트


주요 신규 기능 & 실전 활용

팀 전체 Claude Code 버전을 고정 — requiredMinimumVersion/requiredMaximumVersion (v2.1.163)

v2.1.163에 버전 범위를 강제하는 managed setting 두 개가 추가됐습니다. requiredMinimumVersion/requiredMaximumVersion을 설정하면, Claude Code가 허용된 버전 범위를 벗어났을 때 아예 시작을 거부하고 승인된 버전으로 안내합니다.

// managed settings (조직 관리 설정)
{
  "requiredMinimumVersion": "2.1.160",
  "requiredMaximumVersion": "2.1.163"
}

플로팅 최신 버전이 조용히 올라가 무언가 깨지는 사고 — 예컨대 패키지 매니저나 도구 체인이 메이저로 점프해 빌드·배포가 망가지는 일 — 을 버전 핀으로 막는 흐름과 같은 발상입니다. 팀에서 “검증된 버전 범위”만 돌게 하고 싶거나, 특정 회귀가 있는 버전을 건너뛰게 하고 싶을 때, CI·온보딩 문서에 “이 버전 쓰세요”라고 적어두는 대신 설정으로 결정론적으로 강제할 수 있습니다.

GitHub v2.1.163


개발자 워크플로우 팁

Stop 훅으로 “끝났다고 멈추지 말고, 검증 통과까지 계속” — additionalContext (v2.1.163)

지금까지 Stop·SubagentStop 훅으로 “턴을 끝내지 말고 더 시키기”를 구현하려면 stop을 차단(block) 해야 했고, 그건 종종 훅 에러로 표시됐습니다. v2.1.163부터 Stop·SubagentStop 훅이 hookSpecificOutput.additionalContext를 반환하면, 에러로 찍히지 않고 그 피드백을 Claude에 전달하며 턴을 자연스럽게 이어갑니다.

이걸로 “테스트가 통과할 때까지 자동으로 계속 일하기” 같은 가드를 깔끔하게 만들 수 있습니다.

// .claude/settings.json
{
  "hooks": {
    "Stop": [
      { "hooks": [{ "type": "command", "command": ".claude/hooks/verify.sh" }] }
    ]
  }
}
#!/usr/bin/env bash
# .claude/hooks/verify.sh — 테스트가 통과할 때만 턴을 끝낸다
if npm test --silent; then
  exit 0   # 통과 → 정상 종료
fi
# 실패 → 무엇이 깨졌는지 알려주고 턴을 계속 (훅 에러로 찍히지 않음)
cat <<'JSON'
{ "hookSpecificOutput": { "additionalContext": "테스트가 아직 실패합니다. 실패 케이스를 고치고 다시 검증하세요." } }
JSON

“AI가 절반쯤 하다 끝내버린다”는 불만을, 권고가 아니라 종료 게이트로 막는 패턴입니다. 정확한 출력 스키마는 공식 hooks 문서를 따르세요. Claude Code Docs — Hooks | GitHub v2.1.163

팀 플러그인 표준화의 첫걸음 — /plugin list (v2.1.163)

v2.1.163에 설치된 플러그인을 나열하는 /plugin list가 추가됐습니다. --enabled/--disabled 필터로 무엇이 켜져 있고 꺼져 있는지 한눈에 점검할 수 있습니다.

/plugin list              # 설치된 모든 플러그인
/plugin list --enabled    # 활성화된 것만
/plugin list --disabled   # 비활성화된 것만

여러 머신·여러 팀원에 걸쳐 플러그인 세트가 제각각이 되기 쉬운데, 이 명령으로 인벤토리를 맞춘 뒤 위의 requiredMinimumVersion로 버전까지 고정하면 “내 환경에선 되는데”류의 편차를 줄일 수 있습니다.

GitHub v2.1.163


보안/제한 이슈

v2.1.163 — 권한 규칙이 실제로 막던 것을 다시 막도록 수정 (6/4)

v2.1.163에 권한 규칙이 의도대로 적용되지 않던 문제들이 수정됐습니다. 권한 규칙으로 접근을 통제하는 팀이라면 올린 뒤 규칙이 실제로 먹는지 재확인할 가치가 있습니다.

GitHub v2.1.163


커뮤니티 뉴스


알아두면 좋은 소소한 변경사항


추천 칼럼 & 읽을거리


흥미로운 프로젝트 & 도구