워크트리 실행과 백그라운드 에이전트 제어 강화
isolated git worktree 실행, 백그라운드 에이전트 제어, MCP 인증 및 시작 성능이 개선됐습니다.
교안에 영향
기존 안내에서 `--scope` 기본값이 user scope라고 설명한 내용은 더 이상 맞지 않을 수 있습니다.
요약
- `--worktree`와 `subagents`의 `isolation: "worktree"`로 격리된 git worktree 실행을 지원합니다. - `background: true`와 Ctrl+F 종료 키바인드로 백그라운드 에이전트 실행과 제어가 강화됐습니다. - MCP OAuth 인증, HTTP/SSE MCP 서버 인증 실패 캐시, 시작 성능이 개선됐습니다. - 파일 경로 안내, 권한 프롬프트, `/config`의 verbose 표시, `--resume` 세션 선택기 관련 버그를 수정했습니다. - `Simple mode`, `plugin enable`/`plugin disable`, SDK 모델 정보, `ConfigChange` hook 등 관련 동작과 노출 정보가 추가·정리됐습니다.
바뀐 것
새 기능
- `--worktree` (`-w`) 플래그로 Claude를 격리된 git worktree에서 시작할 수 있게 했습니다.
- `subagents`가 `isolation: "worktree"`를 지원해 임시 git worktree에서 작업할 수 있게 했습니다.
- Ctrl+F 키바인드로 background agents를 종료할 수 있게 했으며, 두 번 눌러 확인하도록 했습니다.
- Agent definitions가 `background: true`를 지원해 항상 background task로 실행할 수 있게 했습니다.
- Plugins가 기본 설정용 `settings.json`을 함께 제공할 수 있게 했습니다.
- 구성 파일 변경 시 동작하는 `ConfigChange` hook event를 추가했습니다.
개선
- MCP OAuth authentication에 step-up auth 지원과 discovery caching을 추가해 서버 연결 시 중복 네트워크 요청을 줄였습니다.
- Simple mode (`CLAUDE_CODE_SIMPLE`)에 Bash tool 외에 file edit tool을 포함해 직접 파일 편집이 가능해졌습니다.
- safety checks가 ask response를 트리거할 때 permission suggestions가 채워지도록 해 SDK 소비자가 권한 옵션을 표시할 수 있게 했습니다.
- 비대화형 모드(`-p`)에서 시작 시 불필요한 API 호출을 건너뛰어 성능을 개선했습니다.
- HTTP 및 SSE MCP 서버에서 인증 실패를 캐시해 인증이 필요한 서버에 대한 반복 연결 시도를 줄였습니다.
- SDK model info에 `supportsEffort`, `supportedEffortLevels`, `supportsAdaptiveThinking` 필드를 추가했습니다.
- startup performance를 위해 MCP auth failures 캐시, analytics token counting HTTP 호출 축소, MCP tool token counting 배치 처리를 적용했습니다.
- path safety와 working directory blocks에 대한 permission prompts가 제한 사유를 보여주도록 개선했습니다.
수정
- 모델이 repo 폴더를 놓쳤을 때 file-not-found 오류가 수정된 경로를 제안하도록 했습니다.
- background agents가 실행 중이고 main thread가 idle일 때 Ctrl+C와 ESC가 무시되던 문제를 수정했습니다. 3초 안에 두 번 누르면 모든 background agents를 종료합니다.
- prompt suggestion cache regression으로 cache hit rate가 떨어지던 문제를 수정했습니다.
- `plugin enable`과 `plugin disable`이 `--scope`가 없을 때 올바른 scope를 자동 감지하도록 수정했습니다.
- `/config`로 verbose mode를 전환할 때 thinking block 표시가 갱신되지 않던 문제를 수정했습니다.
- 장시간 세션에서 tree-sitter parser를 주기적으로 재설정해 WASM memory growth 문제를 수정했습니다.
- stale yoga layout references로 인한 렌더링 문제 가능성을 수정했습니다.
- 장시간 실행 중 Yoga WASM linear memory가 줄지 않아 발생하던 메모리 증가 문제를 수정했습니다.
- `disableAllHooks` 설정이 managed settings hierarchy를 존중하도록 수정해 정책으로 설정된 managed hooks를 non-managed settings가 비활성화할 수 없게 했습니다.
- `--resume` session picker가 `/clear` 같은 명령으로 시작한 세션에서 raw XML tags를 보여주던 문제를 수정했습니다.
지원 종료
- Max plan에서 Sonnet 4.5 with 1M context를 제거하고, 1M context를 지원하는 Sonnet 4.6으로 전환하도록 안내했습니다.