Claude Code v2.1.296, 게이트웨이 정책 키, autoCompactWindow, Read allow_large 추가

Claude Code v2.1.296(10월 9일 출시)은 새로운 관리 정책 키, 서브에이전트 컴팩션 오버라이드, 그리고 게이트웨이, 훅, 자체 호스팅 러너, 플러그인 전반에 걸친 여러 수정 사항을 제공합니다.

새로운 기능

• Claude apps 게이트웨이의 managed.policies[]에 code 키가 추가되었습니다. 이 키는 cli와 동일한 설정을 사용하며 Claude Desktop의 Code 탭에서도 적용됩니다. desktop 옆에 있으면 Claude Desktop의 게이트웨이 모드를 켭니다.
• 서브에이전트 frontmatter 및 --agents 정의에 autoCompactWindow가 추가되어, 서브에이전트가 메인 대화의 윈도우보다 더 일찍 자동 컴팩트할 수 있습니다.
• CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL을 사용하면 모든 워크플로 에이전트를 하나의 모델에서 실행하면서 다른 서브에이전트는 각자의 모델을 유지할 수 있습니다.
• CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS로 과부하(529) 요청 재시도 시 백오프의 최대 지연 시간을 더 길게 설정할 수 있습니다.
• /plugin에서 다른 활성화된 플러그인이 같은 이름을 가지고 있어 플러그인의 훅이 제외될 때 알림이 표시됩니다.
• Read 도구에 allow_large 옵션이 추가되어, Claude가 전체 파일이 필요하고 컨텍스트에 여유가 있을 때 한 번의 호출로 일반 크기 제한을 넘는 텍스트 파일을 읽을 수 있습니다.

주요 수정 사항

• 관리 설정의 PreToolUse 훅이 "continue": false로 도구 호출을 거부하고, 관리 prompt 훅이 이를 차단하면 이제 턴을 종료하지 않고 호출을 거부합니다.
• 관리 설정의 PostToolUse 훅이 이전에는 건너뛰었던 세션에서도 updatedMCPToolOutput을 적용합니다.
• 헤드리스 세션은 디렉터리 변경이나 플러그인 재로드 후 해당 폴더에 대해 꺼진 .mcp.json 또는 플러그인 MCP 서버를 더 이상 시작하지 않습니다.
• allowedProviders에 "gateway"를 제공하는 Claude apps 게이트웨이가 사용자 설정에서 해당 게이트웨이를 지정한 노트북을 더 이상 차단하지 않습니다.
• 관리 설정에서 forceLoginMethod를 forceLoginGatewayUrl 없이 gateway로 설정한 경우 저장된 Claude apps 게이트웨이 로그인이 더 이상 무시되지 않습니다(2.1.295의 회귀).
• 적응형 사고만 사용하는 Haiku 5.5 및 기타 모델의 토큰 수가 수정되었습니다. 이들은 일부 게이트웨이 뒤에서 실패했고 다른 곳에서는 예산 사고로 계산되었습니다.
• 자체 호스팅 러너: 등록 거부 시 더 명확한 오류(조직 관리자 설정을 명시하거나, 재시작된 온디맨드 러너에 새 작업 지시가 필요함을 알림)가 표시되며, git fetch/pull/push는 --capacity가 1보다 큰 러너에서 같은 저장소의 다른 세션이 시작될 때 더 이상 실패하지 않습니다.
• 워크플로 스크립트는 결과와 약 20,000레벨보다 깊게 중첩된 에이전트 옵션을 더 이상 조용히 잘라내지 않습니다.
• 플러그인 $ 메서드는 이제 호출 에이전트의 작업 디렉터리에서 실행되며 해당 훅이 보유한 턴을 존중합니다. $.agent.register는 모드가 재로드되거나 제거된 후에도 실행 중인 훅에서 거부됩니다. $.http.fetch는 선언된 Content-Length가 4MiB 본문 제한을 초과하는 HEAD 요청을 더 이상 거부하지 않습니다.
• 공유 트랜스크립트 및 디버그 로그의 시크릿 리댁션이 이제 값 없이 키 뒤에 오는 값(셸 문자열 내 JSON 포함)을 잡아냅니다.
• constructor와 같은 마켓플레이스 이름이 더 이상 plugin marketplace add, marketplace update, plugin install을 중단시키지 않습니다. add는 이러한 이름을 명확히 거부합니다. constructor 또는 prototype이라는 이름의 플러그인 시크릿은 다음 옵션 저장 시 더 이상 삭제되지 않습니다.
• UserPromptSubmit 훅 또는 모드의 prompt.submit 훅 도중 Esc 또는 인터럽트는 더 이상 헤드리스 세션을 종료하거나 입력된 프롬프트를 지우거나 검사되지 않은 프롬프트를 통과시키지 않습니다.
• 토스트 및 알림은 /diff 패널이나 대화 상자가 열려 있는 동안 더 이상 보이지 않고 기다리지 않습니다.
• --teleport는 세션 기록을 읽을 수 없을 때 더 이상 빈 대화를 열지 않습니다.

관리 설정을 유지 관리하거나 자체 호스팅 러너를 실행하거나 서브에이전트 워크플로에 의존하는 경우, 이 릴리스는 해당 경로에 직접적인 영향을 미칩니다.