Claude Code v2.1.163: 버전 고정, 플러그인 목록, 후크 개선 및 주요 버그 수정

Claude Code v2.1.163에는 여러 관리 설정 추가, 새로운 명령어, 그리고 중요한 버그 수정이 포함되어 있습니다. 변경된 내용은 다음과 같습니다.

관리 설정: 버전 고정

requiredMinimumVersion 및 requiredMaximumVersion 관리 설정이 추가되었습니다. Claude Code 버전이 허용 범위를 벗어나면 시작이 거부되며 승인된 버전으로 안내합니다. 조직 전체의 규정 준수와 모든 개발자가 통제된 버전을 사용하도록 보장하는 데 유용합니다.

새 명령어: /plugin list

설치된 플러그인을 나열하는 /plugin list 명령어가 도입되었으며, --enabled 및 --disabled 필터가 제공됩니다. 더 이상 설정 파일을 뒤져 활성화된 플러그인을 확인할 필요가 없습니다.

개선된 훅: 추가 컨텍스트

Stop 및 SubagentStop 훅이 이제 hookSpecificOutput.additionalContext를 반환하여 훅 오류를 발생시키지 않고 Claude에게 피드백을 전달할 수 있습니다. 이를 통해 훅이 추가 컨텍스트를 제공하여 대화 흐름을 유지할 수 있습니다.

스킬: 달러 기호 이스케이프

명령 본문에서 숫자 앞에 리터럴 $를 포함할 수 있는 \$ 이스케이프 문법이 추가되었습니다. 이전에는 이러한 시퀀스가 변수 확장으로 해석되었습니다.

MCP 서버: 재개 시 세션 ID

stdio MCP 서버가 이제 --resume으로 재개할 때 훅/Bash와 동일한 CLAUDE_CODE_SESSION_ID를 수신합니다.

버그 수정

• claude -p 중단: 백그라운드 명령어가 종료되지 않으면 포그라운드 claude -p가 무한히 대기하는 문제가 수정되었습니다. 이제 stdin이 닫힌 후 최종 결과가 나오면 약 5초 후에 백그라운드 셀이 중지됩니다.
• Bedrock/Vertex/Foundry + CI: CI=true이고 Anthropic API 키가 설정되지 않은 상태에서 claude -p가 ANTHROPIC_API_KEY required 오류를 발생시키는 문제가 수정되었습니다.
• Bazel/EDR 워크플로우: v2.1.154에서 발생한 회귀 문제로 모든 명령어에 $TMPDIR이 /tmp/claude-{uid}로 잘못 재정의되어 Bash 명령어가 실패하는 문제가 수정되었습니다. 이제 샌드박스 처리된 명령어에만 적용됩니다.
• Windows EEXIST: 세션-env 디렉터리가 읽기 전용 속성이거나 OneDrive 내에 있을 때 Windows에서 Bash 명령어가 EEXIST: file already exists 오류로 실패하는 문제가 수정되었습니다.
• 권한 규칙 타이밍: 새 설정 디렉터리에서 시작 중 관리 설정 가져오기가 완료될 때 조직 관리 권한 규칙이 전체 세션에 적용되지 않는 문제가 수정되었습니다.
• 업데이트 후 백그라운드 세션: Claude Code 업데이트 후 재연결 시 claude agents의 백그라운드 세션이 실행 중인 백그라운드 작업을 잃는 문제가 수정되었습니다. 또한 백그라운드 에이전트 세션은 이제 백그라운드에서 새 버전으로 업데이트되므로 업데이트 후 세션을 열 때 콜드 리스타트를 기다릴 필요가 없습니다.
• 터미널/UI 결함: Esc 키로 에이전트 보기를 종료할 때 터미널 정렬 불량 및 다중 초 지연 문제 수정; 프로세스가 이미 종료된 경우 백그라운드 작업 칩의 중지 버튼이 지워지지 않는 문제 수정; 종료 마커가 누락된 붙여넣기 작업 후 키보드 입력이 영구적으로 응답하지 않는 문제 수정.
• 훅 조건 매칭: $() 또는 $VAR을 포함하는 모든 Bash 명령어에서 if: "Bash(...)" 조건이 발동되는 문제 수정. 이제 서브셸과 백틱 내의 명령어도 패턴이 일치합니다.
• $HOME이 포함된 거부 규칙: 홈 디렉터리 경로(예: Read(~/Desktop/**))에 대한 거부 규칙이 $HOME을 통해 경로를 참조하는 Bash 명령어를 차단하지 못하는 문제 수정.
• 기록 아티팩트: /mcp 및 /plugins 같은 패널 대화 상자를 닫은 후 기록에 불필요한 "(no content)" 줄이 남는 문제 수정.

UI/UX 개선

• / 메뉴에 내장 명령어와 스킬에 대한 설명이 더 명확해졌습니다.
• 구독 전환 제안이 이제 토스트 대신 시작 알림 슬롯에 표시됩니다.
• 상태 그룹화 보기에서 전송하는 claude agents는 이제 에이전트 보기가 열린 디렉터리에서 세션을 시작합니다.