Claude Code v2.1.316, 서브에이전트 노력 제어, 풀링 예산 추가 및 고아 셸 수정

Claude Code v2.1.316이 출시되었습니다. 이 버전은 하위 에이전트 동작과 정책 병합을 제어하는 여러 환경 변수를 추가하고, Claude 앱 게이트웨이에 공유 예산과 Bedrock 가드레일 태깅을 확장하며, 셸, 훅, 모델 대체와 관련된 긴 목록의 버그를 수정합니다.

새로운 환경 변수

• CLAUDE_CODE_DISABLE_ULTRATHINK — ultrathink 키워드를 비활성화합니다.
• CLAUDE_CODE_SUBAGENT_EFFORT — 다른 곳에서 지정하지 않았을 때 하위 에이전트가 실행될 노력 수준을 세션의 노력 수준을 상속하는 대신 설정합니다.
• CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP — 서로를 루프로 인증하는 시스템 교차 인증서를 유지합니다. 프라이빗 CA가 이를 필요로 하는 서버용입니다.

게이트웨이 변경 사항

이제 Claude 앱 게이트웨이에서 풀링된 그룹 예산을 사용할 수 있습니다. 그룹 구성원이 공유하는 월간 예산으로, 각 구성원의 개별 한도에 추가됩니다. 지출 한도 관리 API의 pooled_budget으로 설정합니다.

managed.policy_mode: layered를 사용하면 개발자와 일치하는 모든 정책이 적용되며, 각 정책은 그 아래 나열된 정책 위에 병합됩니다. 첫 번째 일치 정책만 적용되는 방식이 아닙니다.

Bedrock 업스트림의 경우, guardrail.input_tagging은 Amazon Bedrock 가드레일의 프롬프트 공격 필터에 필요한 입력 태그로 프롬프트를 감쌉니다. all_messages_and_system은 시스템 프롬프트도 태깅합니다.

지원 중단: Opus 4.8 빠른 모드

Opus 4.8의 빠른 모드는 2026년 10월 30일부로 지원 중단되며, 2026년 11월 30일에 제거됩니다. 제거 후에는 Opus 4.8에서 빠른 모드 요청이 오류를 반환하며 표준 Opus 4.8로 대체되지 않습니다. 속도 향상을 유지하려면 Opus 5.5로 마이그레이션하세요.

주요 수정 사항

• Claude Code가 자체적으로 종료될 때(예: 자격 증명 거부, 클라우드 세션 보관) macOS/Linux에서 셸 명령이 더 이상 실행 중인 상태로 남지 않습니다.
• 줄바꿈이 포함된 Bash 별칭(Git Bash 제외)과 이름이 대시로 시작하는 함수가 Bash 도구의 셸에서 더 이상 깨지거나 누락되지 않습니다.
• SHELLOPTS가 내보내진 경우 Bash 도구에서 시작된 Bash 스크립트가 첫 번째 명령 후에 중지되지 않습니다.
• PowerShell 훅은 명령이 타입 캐스트, param, using 또는 속성으로 시작할 때 종료 코드 2에서 차단됩니다.
• 압축된 응답이 잘리거나 손상된 경우 네트워크 요청이 더 이상 중단되지 않습니다.
• Vertex AI 및 Amazon Bedrock에서 sonnet, opus, haiku는 최신 모델을 계정이나 리전에서 사용할 수 없을 때 오류를 발생시키는 대신 세션 중간에 이전 모델로 전환됩니다.
• 게이트웨이는 이제 요청에 명시된 모든 모델을 availableModels, deniedModels, models에 대해 확인합니다. 차단된 모델은 해당 필드를 명시한 400을 반환합니다.
• claude auth login은 관리 설정이 게이트웨이를 요구하는 경우 실행되며 터미널에 게이트웨이 로그인을 표시합니다.
• --restricted 세션은 Read 허용 규칙이 적용된 경우 작업 디렉터리 외부의 파일을 더 이상 업로드하지 않습니다.
• 보이지 않는 문자가 포함된 프롬프트는 첫 Enter에서 정리되어 전송됩니다. 명령은 여전히 검토를 기다립니다.
• 상위 하위 에이전트의 모델을 상속한 하위 에이전트는 백그라운드 작업이나 메시지로 깨어날 때 더 이상 기본 모델로 점프하지 않습니다.
• "$defaults" 없이 관리되는 autoMode.allow 목록은 호스트 --settings, /permissions 또는 /auto-mode-setup의 내장 예외를 유지합니다.
• 서버가 안전 판정을 반환하지 않아 자동 모드가 턴을 중지하면 클라우드 세션 및 클라우드 예약 작업이 실패로 표시됩니다.
• claude -p 텍스트 출력은 백그라운드 에이전트가 계속 실행 중일 때 자동 모드가 턴을 중지한 이유를 이제 표시합니다.
• CLAUDE_CODE_AUTO_MODE_SERVER=1은 실험적 베타가 꺼진 프록시 또는 LLM 게이트웨이 뒤의 호스트 앱 세션(예: Claude Desktop)에서 적용됩니다.
• 플러그인 MCP headersHelper 스크립트는 자격 증명으로 명명된 환경 변수가 1과 같은 스위치 값으로 설정된 경우 더 이상 손상된 CLAUDE_PLUGIN_ROOT 및 서버 URL을 받지 않습니다.
• SDK register_repo_root 제어 요청은 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1이 설정된 경우 작업 디렉터리 외부 디렉터리의 CLAUDE.md를 로드합니다.
• Artifact 도구는 self 수준 아티팩트 DB 액세스 규칙에 대해 더 이상 ?를 표시하지 않으며, 해당 규칙을 삭제하는 재게시를 거부할 때 이를 인용하여 표시합니다.
• /model <id>는 이 버전에서 모델을 인식하지 못하고 자동 압축이 200K 컨텍스트 창을 가정할 경우 경고합니다.
• Grep 및 Glob은 시간 초과 시 검색 프로세스가 종료되지 않고 종료된 경우 중단되는 대신 반환됩니다.

하위 에이전트를 기본 세션과 다른 노력 수준으로 실행하거나 공유 게이트웨이를 관리하는 경우 이 릴리스를 적용할 가치가 있습니다.