Claude Code 주간 브리핑 Week 24 (v2.1.166~176) — /cd 세션 이동·중첩 서브에이전트·Safe Mode 등 3가지
이 글은 Claude Code 주간 브리핑 시리즈의 Week 24편이다. 시리즈 전체 목록: claude-code-weekly-series
Week 24 업데이트 개요
2026년 6월 8일부터 12일 사이, Claude Code는 v2.1.166에서 v2.1.176까지 총 10개 패치를 배포했다. 이번 주의 메인 feature는 세 가지다. /cd 명령으로 세션을 재시작 없이 다른 작업 디렉토리로 이동할 수 있게 됐고, 서브에이전트가 자체 서브에이전트를 생성하는 중첩 구조가 공식 지원됐으며, --safe-mode 플래그로 모든 커스터마이징을 끈 상태에서 설정 오류를 격리 진단할 수 있게 됐다.
세 기능 모두 정식 릴리스 상태다. 이전 주차와 달리 preview 표기 기능은 없다.
출처: Claude Code 공식 What’s New (Week 24, 2026-06-08~12) · Changelog v2.1.166→v2.1.176 공식 docs: https://code.claude.com/docs/llms.txt
1. /cd — 세션을 다른 디렉토리로 이동 (v2.1.169) ★
공식 docs상 동작
/cd 명령은 현재 세션을 다른 작업 디렉토리로 이동시킨다. 핵심 동작은 다음과 같다.
- 프롬프트 캐시를 재빌드하지 않는다. 이동 후에도 이전까지 쌓인 캐시가 유지된다.
- 새 디렉토리의
CLAUDE.md는 시스템 프롬프트를 교체하지 않고 메시지로 append된다. 기존 시스템 프롬프트는 그대로 남는다. - 세션이 새 디렉토리의 project storage로 재배치된다. 이후
--resume과--continue는 새 디렉토리에서 이 세션을 찾는다. - 이전에 작업한 적 없는 디렉토리라면 trust 여부를 묻는 프롬프트가 뜬다.
아래와 같이 입력하면 세션이 해당 경로로 이동한다 (공식 docs 원문):
> /cd ../other-project공식 docs 경로: /docs/en/commands#all-commands
실무 시사점 (★)
econ-monitor, aprox_fe 같은 서브프로젝트를 독립 git으로 운영하는 멀티 레포 환경에서는, 공식 docs상 /cd가 세션을 재시작하지 않고 다른 디렉토리로 전환하므로 컨텍스트를 이어가며 디렉토리를 바꿀 수 있다는 점이 실무 활용 맥락에서 주목할 부분이다.
다만 CLAUDE.md append 방식이라는 점은 주의해야 한다. 기존 시스템 프롬프트 위에 새 디렉토리의 CLAUDE.md가 쌓이는 구조이므로, 헌법 레이어가 혼재될 가능성이 있다. 또한 --resume/--continue가 새 디렉토리 기준으로 재배치된다는 동작을 명확히 인지하지 못하면 이전 세션을 찾지 못하는 상황이 발생할 수 있다. trust 프롬프트 동작도 사전에 파악해 두는 것이 좋다.
2. 중첩 서브에이전트 — 서브에이전트가 서브에이전트를 생성 (v2.1.172) ★★★
공식 docs상 동작
서브에이전트가 이제 자체 서브에이전트를 생성할 수 있다. 주요 동작:
- 프롬프트 아래 subagent 패널이 전체 트리를 표시한다. 각 행에 자손 수(count)와
main까지의 경로(path)가 표기된다. - 백그라운드 서브에이전트는 최대 5단계(five levels deep)로 제한된다. 동시에 실행되는 트리가 무제한 확장되는 것을 막는 안전장치다.
- 포그라운드 체인은 어떤 깊이로도 생성 가능하며, self-limiting(자기 종료) 방식으로 동작한다. 에이전트가 더 이상 서브에이전트를 생성할 필요가 없다고 판단하면 스스로 멈춘다는 의미다.
에이전트 트리 확인 방법 (공식 docs 원문):
> /agents공식 docs 경로: /docs/en/sub-agents#spawn-nested-subagents
실무 시사점 (★★★)
CLI 세션을 분리해 운영하던 환경(각 세션을 독립 bash 프로세스로 체이닝하는 구조)에서는 서브에이전트 중첩을 명시적으로 피해왔다. 이번 릴리스는 그 중첩을 공식 지원 범위로 올렸다는 점에서 아키텍처 관점에서 의미가 있다.
특히 백그라운드 5단계 제한이라는 안전장치가 함께 설계됐다는 점은 주목할 만하다. 무제한 트리 확장을 막는 상한이 공식 스펙에 명시된 것이다. 포그라운드 체인은 깊이 제한 없이 self-limiting으로 운영되므로, 두 모드의 제약 방식이 다르다는 것도 인지해야 한다.
다만 이 구조를 바로 도입할 수 있는지는 별도 검증이 필요하다. 기존 CLI 세션 분리 규칙과의 충돌 여부, 실제 트리 깊이와 비용 구조, 감사 추적 가능성 등 실무 변수가 남아있다. 이 기능은 심층편에서 검증 예정이다.
3. Safe Mode — 설정 오류 격리 진단 (v2.1.169) ★★
공식 docs상 동작
--safe-mode 플래그 또는 환경변수 CLAUDE_CODE_SAFE_MODE를 설정하면 모든 커스터마이징이 비활성화된 상태로 Claude Code가 시작된다.
로드되지 않는 것: CLAUDE.md, skills, plugins, hooks, MCP servers, custom commands 및 custom agents
여전히 동작하는 것: 인증(Authentication), 모델 선택, 빌트인 툴, 권한(permissions)
safe mode에서 문제가 사라지면, 위 비활성화 대상 중 하나가 원인이라는 뜻이다. 이분 탐색식으로 원인 레이어를 좁혀갈 수 있다.
실행 예시 (공식 docs 원문):
claude --safe-mode공식 docs 경로: /docs/en/debug-your-config#test-against-a-clean-configuration
실무 시사점 (★★)
다층 설정 구조(각 팀·에이전트별 CLAUDE.md 헌법, hooks, MCP 서버, custom agents가 레이어를 이루는 환경)에서 어느 레이어에서 문제가 발생했는지 진단하는 것은 쉽지 않다.
공식 docs상 safe mode는 이 다층 구조를 일시에 끄고 베이스라인 동작만 남기는 진단 도구다. 예를 들어 특정 에이전트 세션에서 예상치 못한 동작이 발생했을 때, claude --safe-mode로 기동해 문제가 재현되는지 확인한다. 재현되지 않는다면 비활성화 대상(CLAUDE.md, hooks, MCP 등) 중 하나가 원인이라고 범위를 좁힐 수 있다. 설정 레이어가 많을수록 이 진단 도구의 가치가 높아진다.
그 외 주목할 변경
실무 영향 있는 변경
claude agents --json --all 추가 및 필드 확장
claude agents --json에 --all 플래그가 추가돼 완료된 세션까지 포함해 조회할 수 있다. 새로운 id와 state 필드가 추가됐으며, blocked 상태나 새로 dispatch된 세션도 누락 없이 표시된다. 다중 에이전트 세션 관리 시 전체 상태 파악이 더 정확해진다.
Deny 규칙에 glob 허용
deny 규칙의 tool-name 위치에 glob 패턴을 사용할 수 있다. "*"를 지정하면 전체 툴을 deny할 수 있다. 알 수 없는 tool 이름이 deny 규칙에 있으면 시작 시 경고가 뜬다. 권한 규율을 더 유연하게 설계할 수 있게 됐다.
disableBundledSkills 설정 및 CLAUDE_CODE_DISABLE_BUNDLED_SKILLS 환경변수 추가
번들로 제공되는 skills, workflows, 빌트인 커맨드를 모델에서 숨길 수 있다. 커스텀 환경을 엄격하게 제어하고 싶을 때 활용 가능하다.
enforceAvailableModels 관리형 설정 추가
availableModels allowlist가 Default 모델에도 제약을 가하도록 강제한다. 팀 단위 모델 허용 범위를 엄격히 관리하는 환경에서 유효하다.
크로스세션 메시징 보안 강화
다른 세션이 SendMessage로 중계한 메시지는 더 이상 사용자 명령과 동등한 신뢰 수준을 갖지 않으며, auto mode가 이를 차단한다. 세션 간 메시지 신뢰 수준을 명확히 구분하는 방향으로 강화됐다.
fallbackModel 구성 지원 및 인터랙티브 세션 적용
기본 모델이 과부하 상태이거나 사용 불가일 때 순서대로 시도할 폴백 모델을 최대 3개까지 구성할 수 있다. --fallback-model 플래그가 인터랙티브 세션에도 적용된다.
기타 소소한 변경
- 세션 제목 언어 자동 생성: 대화 언어에 맞춰 세션 제목이 생성된다.
language설정으로 특정 언어를 고정할 수 있다. /plugin검색 바 추가: 마켓플레이스 플러그인 탐색 시 검색 바가 제공된다.- Amazon Bedrock 리전 자동 읽기:
AWS_REGION이 미설정이면~/.awsconfig 파일에서 리전을 읽는다./status에서 리전 출처를 확인할 수 있다. - Claude in Chrome 배치 호출 전환: 브라우저 툴이 툴별 개별 호출 대신 단일 배치 호출로 로드된다.
claude update사전 알림: 업데이트 다운로드 전에 대상 버전을 먼저 알린다.footerLinksRegexes설정 추가: 정규식으로 매칭되는 링크 배지를 footer 행에 추가할 수 있다.
Week 24 요약 표
| 기능 | 중요도 | 상태 | 핵심 |
|---|---|---|---|
| 중첩 서브에이전트 (sub-agents spawn sub-agents) | ★★★ | 정식 릴리스 (v2.1.172) | 서브에이전트가 자체 서브에이전트 생성 가능. 백그라운드 5단계 제한 |
Safe Mode (--safe-mode) | ★★ | 정식 릴리스 (v2.1.169) | 모든 커스터마이징 비활성화 후 설정 오류 격리 진단 |
| /cd 세션 이동 | ★ | 정식 릴리스 (v2.1.169) | 세션 재시작 없이 다른 작업 디렉토리로 이동 |
이 시리즈의 다른 주차 브리핑은 시리즈 전체 목록에서 확인할 수 있다. → Claude Code 주간 브리핑 시리즈 전체 목록
출처
- Claude Code 공식 What’s New, Week 24 (2026-06-08~12)
- Claude Code Changelog v2.1.166→v2.1.176
- Commands reference:
https://code.claude.com/docs/en/commands#all-commands - Spawn nested subagents:
https://code.claude.com/docs/en/sub-agents#spawn-nested-subagents - Test against a clean configuration:
https://code.claude.com/docs/en/debug-your-config#test-against-a-clean-configuration - Fallback model chains:
https://code.claude.com/docs/en/model-config#fallback-model-chains