핵심 요약
- PreToolUse 훅이 도구 입력을 수정할 수 있어 차단 대신 치환이 가능해졌습니다.
- 서브에이전트는 기본 백그라운드 실행이라 대기 시간이 줄지만 작업 범위 분리가 필요합니다.
- 권한 검사 보정과 managed settings 버전 범위 지정으로 팀 단위 통제가 쉬워졌습니다.
Claude Code에서 실무에 가장 영향이 큰 변경은 세 가지입니다. 훅이 PreToolUse에서 도구 입력을 고칠 수 있게 된 것, 서브에이전트가 기본으로 백그라운드에서 도는 것, 권한 검사가 촘촘해진 것입니다. 아래는 공식 CHANGELOG에서 이 변경들을 골라 정리하고, 팀에 적용할 때 어떻게 쓰면 좋을지 제안한 글입니다. 제가 직접 써 본 결과를 보고하는 글은 아니며, 변경 내용은 모두 체인지로그에 적힌 대로만 옮겼습니다.
훅: 막는 도구에서 고치는 도구로
훅은 체인지로그에 따르면 1.0.38에서 정식 공개됐습니다. 이어서 1.0.41에서 Stop 훅이 Stop과 SubagentStop으로 나뉘었습니다. 메인 에이전트의 종료와 서브에이전트의 종료를 따로 처리할 수 있다는 뜻입니다. 같은 문서에 따르면 1.0.64에서는 훅의 JSON 출력에 systemMessage 필드가 추가되어 경고와 맥락을 화면에 표시할 수 있습니다.
실무에서 가장 큰 변화는 2.0.10의 "PreToolUse 훅이 도구 입력을 수정할 수 있다"는 항목입니다. 그전에는 위험한 명령을 차단하는 정도였다면, 이제는 명령을 바꿔서 통과시킬 수 있습니다. 예를 들어 rm을 휴지통 이동 명령으로 바꾸거나, 테스트 명령에 팀 표준 플래그를 붙이는 식입니다. 다만 입력을 몰래 바꾸면 에이전트가 본 명령과 실제 실행된 명령이 달라집니다. 바꾼 내용은 systemMessage로 알려 주는 편이 디버깅에 안전합니다.
최신 체인지로그에는 Stop·SubagentStop 훅이 hookSpecificOutput.additionalContext로 Claude에게 피드백을 주고 턴을 이어 가게 하는 항목도 있습니다. 이때 훅 오류로 표시되지 않는다고 합니다. "린트가 통과할 때까지 끝내지 말라"는 규칙을 훅으로 걸 때 로그가 덜 지저분해질 것입니다.
서브에이전트: 기본값이 백그라운드로
최신 체인지로그에는 서브에이전트가 기본으로 백그라운드에서 실행된다는 항목이 있습니다. 설명에 따르면 Claude는 서브에이전트가 도는 동안 작업을 이어 가고, 끝나면 알림을 받습니다. 이전에는 점진적 롤아웃이었다고 합니다. 같은 문서에는 서브에이전트와 컨텍스트 압축이 세션의 extended thinking 설정을 물려받는다는 항목도 있습니다. 위임한 작업의 품질을 높이려는 변경으로 설명됩니다.
일하는 방식 면에서 이 변경은 "기다리는 시간"을 줄입니다. 코드베이스 조사, 테스트 실행, 문서 초안 작성을 나눠 맡기고 메인 대화는 계속 진행할 수 있습니다. 대신 결과가 비동기로 돌아오므로, 서브에이전트에 맡기는 작업은 서로 파일을 건드리지 않게 범위를 나누는 것이 좋습니다.
같은 체인지로그에 따르면 claude agents로 띄운 백그라운드 에이전트는 워크트리에서 코드 작업을 마치면 멈춰서 묻지 않고 커밋, 푸시, 드래프트 PR 생성까지 합니다. 리뷰 부담은 PR 단계로 옮겨 가는 셈이니, 브랜치 보호 규칙과 CI를 먼저 점검해 두세요. 완료된 서브에이전트가 계속 실행 중으로 표시되던 버그도 수정되었습니다.
권한: 세분화와 조직 단위 통제
권한 쪽은 눈에 띄는 신기능보다 보정이 많았습니다. 체인지로그에 따르면 1.0.57에서 권한 메시지가 개선되어 Claude가 허용된 도구를 더 잘 이해하게 됐습니다. 2.0.10에는 환경 변수가 들어간 bash 명령의 권한 검사 수정이 포함됐습니다. allowlist를 Bash(npm test:*) 같은 패턴으로 운영하는 팀이라면 이런 수정이 실제 차단과 허용 판단에 영향을 줍니다.
조직 관점에서는 managed settings에 requiredMinimumVersion과 requiredMaximumVersion이 추가된 것이 눈에 띕니다. 체인지로그에 따르면 Claude Code가 허용 범위를 벗어난 버전이면 시작을 거부하고 승인된 버전을 안내합니다. 도구가 빠르게 바뀌는 만큼 팀 전체를 같은 버전에 맞추는 장치가 생긴 것입니다.
--dangerously-skip-permissions는 이름 그대로 권한 확인을 건너뛰는 옵션입니다. 최신 체인지로그에는 이 옵션과 함께 쓴 daemon 서브커맨드가 채팅 프롬프트로 오인되던 문제를 고쳤다는 항목이 있습니다. 옵션 자체를 권장하는 내용은 아니니, 격리된 환경이 아니면 쓰지 않는 편이 낫습니다.
변경별 영향 요약
| 영역 | 변경 | 실무 영향 |
|---|---|---|
| 훅 | 1.0.38 정식 공개, 1.0.41 SubagentStop 분리 | 서브에이전트 종료 시점에 별도 검증 가능 |
| 훅 | 2.0.10 PreToolUse 입력 수정 | 명령 차단 대신 안전한 명령으로 치환 |
| 서브에이전트 | 기본 백그라운드 실행 | 병렬 작업, 결과는 비동기 수신 |
| 권한 | bash 환경 변수 검사 수정 | allowlist 판정 정확도 향상 |
| 관리 설정 | 최소/최대 버전 지정 | 팀 버전 통일 |
실천 가이드
첫째, 훅은 한 가지씩 작게 시작하세요. 설정 방법은 공식 문서에서 hooks 항목을 찾아 보면 됩니다. 처음에는 위험 명령 차단, 포맷터 실행처럼 결과가 분명한 것이 좋습니다. 입력을 수정하는 훅은 그다음에 추가하세요.
둘째, 서브에이전트에 일을 맡길 때는 담당 디렉터리나 파일을 겹치지 않게 지정하고, 완료 후 검증 규칙은 SubagentStop 훅에 넣으세요.
셋째, 권한은 allowlist를 최소로 두고, 팀 단위로는 managed settings로 버전 범위를 고정하세요. 업데이트 후에는 체인지로그에서 hooks, permissions, subagent 키워드를 검색해 설정과 맞는지 확인하는 습관을 권합니다. 이 글의 버전 번호와 동작은 작성 시점의 체인지로그 기준이며, 최신 내용은 저장소의 CHANGELOG가 가장 정확합니다.
자주 묻는 질문
Q. PreToolUse 훅으로 무엇을 할 수 있게 됐나요?
2.0.10부터 PreToolUse 훅이 도구 입력을 수정할 수 있습니다. 위험한 명령을 막는 데 그치지 않고 안전한 명령으로 바꿔 통과시킬 수 있습니다. 다만 바꾼 내용은 systemMessage로 알려 주는 편이 디버깅에 안전합니다.
Q. 서브에이전트가 백그라운드로 실행되면 무엇이 달라지나요?
Claude는 서브에이전트가 도는 동안 작업을 이어 가고 끝나면 알림을 받습니다. 기다리는 시간이 줄어드는 대신 결과가 비동기로 돌아옵니다. 서로 파일을 건드리지 않도록 작업 범위를 나누는 것이 좋습니다.
Q. 팀 전체의 Claude Code 버전을 맞출 수 있나요?
managed settings에 requiredMinimumVersion과 requiredMaximumVersion이 추가되었습니다. 체인지로그에 따르면 허용 범위를 벗어난 버전은 시작을 거부하고 승인된 버전을 안내합니다.
참고 자료
이 글은 웹 검색으로 확인한 위 출처를 바탕으로 AI(claude-sonnet-5-5)가 작성했습니다. 수치·가격은 출처 원문에서 다시 확인하세요.