Claude Code v2.1.292, 서브에이전트를 위한 노력 제어 및 20개 이상의 버그 수정 추가

Claude Code v2.1.292가 출시되었습니다. 변경 사항의 대부분은 버그 수정이지만, 알아둘 만한 새로운 기능도 몇 가지 있습니다.

새로운 플래그와 파라미터

• claude plugin install에 --marketplace <source>가 추가되었습니다. 필요 시 마켓플레이스를 추가한 후(claude plugin marketplace add와 동일한 정책 검사 적용) 해당 마켓플레이스에서 플러그인을 설치합니다. 두 명령을 하나로 줄였습니다.
• Agent 도구가 이제 effort 파라미터를 받아, 서브에이전트를 특정 effort 레벨로 생성할 수 있습니다.
• CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 환경변수로 과부하(529) 요청 재시도 시 사용할 더 긴 기본 백오프 지연을 설정할 수 있습니다.

모드 훅 추가 사항

• prompt.autocomplete — 모드가 훅을 걸어 프롬프트 상자 자동완성 목록에 자체 항목을 추가할 수 있습니다.
• $.model.complete에 대한 프롬프트 캐싱: prompt와 system이 텍스트 블록을 받으며, 블록에 cache: true를 설정하면 해당 지점까지 요청이 캐시됩니다.
• Workflow 에이전트를 agent.spawn 훅에 run과 index와 함께 노출하여, 모드가 이를 거부할 수 있습니다.

보안 수정 사항

• PreToolUse 훅 승인과 자동 모드가 네트워크(UNC) 경로의 파일 읽기에 대해 더 이상 권한 프롬프트를 우회하지 않습니다.
• 샌드박스된 명령이 더 이상 ~/.claude/seed-admin 아래에 있는 /ultrareview 업로드의 스테이징된 파일 복사본을 읽을 수 없습니다.
• 세션 중간에 관리형 샌드박스 읽기 거부 경로(및 인접한 사용자 경로)가 나타나거나 재지정되면, 이제 그 안의 프로젝트 권한을 올바르게 제거하고 해당 파일의 자격 증명 주입을 종료합니다.
• macOS와 Windows에서 노트북/PDF 읽기가 읽기 도중 바뀐 링크로 인해 승인된 범위를 벗어난 파일을 반환할 수 없습니다.
• 서버 관리 설정의 변조된 디스크 캐시가 설정 가져오기 실패 중에 내장 정책 플러그인을 끄거나 해제할 수 없습니다.
• 홈 폴더나 드라이브의 8.3 단축 이름 또는 다른 Windows 대체 표기에 대한 rm -rf가 이제 삭제로 처리됩니다.

주요 동작 수정 사항

• permissionMode: auto인 서브에이전트 정의가 auto 모드를 사용할 수 없을 때(설정, 회로 차단기, 또는 지원되지 않는 모델로 비활성화된 경우) 더 이상 auto 모드로 진입하지 않습니다.
• HTTPS_PROXY가 설정된 경우 Claude Code 자체 API 요청(로그인, 정책, 피드백, 아티팩트)에 대해 NO_PROXY가 더 이상 무시되지 않습니다.
• 128자를 초과하는 MCP 도구 이름이 더 이상 모든 요청을 실패시키지 않습니다. 해당 도구는 제외되고 MCP 오류에 이름이 표시됩니다.
• marketplace add와 install 같은 claude plugin 명령이 최초 실행 시 조직의 관리 설정이 로드되기 전에 실행되지 않습니다.
• 일회성 claude -p와 Agent SDK 실행이 최종 결과 5초 후 백그라운드 명령과 예약된 웨이크업을 종료하는 대신 이제 대기합니다.
• claude --resume 선택기 또는 /resume에서 재개할 때 Plan 모드가 올바르게 복원됩니다.
• /resume, /branch, 또는 /clear 이후 생성된 예약 작업이 이제 실행됩니다.
• 백그라운드 세션의 /loop가 프로세스 재시작 후 더 이상 조용히 중지되지 않습니다.
• Grep과 Glob이 주어진 파일/폴더를 읽을 수 없을 때 일치 항목 없음으로 보고하는 대신 한 번 재시도하거나 알려줍니다.
• PDF의 pages가 "6,9,15" 같은 목록일 때 Read 도구가 첫 항목만 조용히 반환하는 대신 오류를 냅니다.
• 256KB를 초과하는 @-멘션 텍스트 파일이 이제 Claude에게 파일 크기와 부분적으로 읽으라고 알려줍니다.

샌드박스에서 에이전트를 실행 중이라면 UNC 경로와 샌드박스 읽기 거부 수정을 우선시하세요. 모드를 유지 관리한다면 자동완성 훅과 $.model.complete의 프롬프트 캐싱이 살펴볼 새로운 API 표면입니다.