관리 설정이 있거나 팀·엔터프라이즈로 로그인한 기기에서는 내장 보호 모드가 사용자 모드의 승인보다 거부(deny) 규칙을 앞세우는데, 10월 3일 나온 v2.1.289 이전에는 `cd x && rm …`처럼 복합 명령의 안쪽 부분에 걸린 거부·확인(ask) 규칙이 모드의 승인에 밀렸어요. 같은 버전에서 샌드박스가 명령을 자동 허용할 때 `TZ="$HOME" rm -rf build`처럼 환경변수 접두어나 변수 대입이 앞에 붙은 명령이 Bash 거부·확인 규칙을 빠져나가던 문제와, IDE 에서 심볼릭 링크로 연 파일에 Read 거부 규칙이 걸리지 않던 문제도 고쳤어요. 모드를 만드는 쪽에는 agent.spawn 이 팀원(teammate)에도 쓰이고, 플러그인 훅 이벤트가 한 에이전트를 같은 아이디로 가리키며, $.agent.list() 가 대기(idle)·기다림(waiting) 상태를 알려 주는 변경이 들어왔어요.
용어 풀이
- IDE
- 통합 개발 환경. VS Code·젯브레인스 같은 코드 편집 프로그램
- 모드(mod)
- 클로드 코드 안에서 코드로 동작하며 도구 호출·화면을 바꿀 수 있는 플러그인
- 샌드박스
- 명령이 접근할 수 있는 파일·네트워크를 제한해 격리된 공간에서 실행하는 장치
운영자 인사이트
모드를 켜 둔 채 거부 규칙으로 rm·git push 같은 명령을 막아 온 조직이라면 2.1.289 로 올리고, 샌드박스 자동 허용을 쓰는 팀은 변수 접두어나 && 로 이은 명령에서도 거부 규칙이 실제로 막히는지 한 번 시험해 보세요. 확인 규칙은 공식 문서가 여전히 사용자 모드가 넘어설 수 있다고 적고 있으니 막아야 하는 명령은 거부 규칙에 두는 편이 안전해요.
여러 관점으로 보기
- 공식 문서: 관리 기기에서의 규칙 우선순위 관리 설정이나 팀·엔터프라이즈 로그인이 있는 기기에서는 내장 보호 모드가 먼저 돌아 사용자 모드가 거부 규칙을 넘지 못하지만, 확인 규칙과 관리 설정 밖의 PreToolUse 훅은 사용자 모드가 승인으로 넘어설 수 있다고 적혀 있어요. Claude Code Docs
- 공식 문서: 복합 명령 규칙 매칭 거부·확인 규칙은 &&·;·파이프로 이은 명령뿐 아니라 서브셸, 명령 치환, for 문 본문 안의 명령에도 걸린다고 설명해요. Claude Code Docs