Claude Code 2.1.316 릴리스 노트

📌 이 글은 Claude Code 2.1.316 릴리스 노트를 한국어로 번역한 것입니다.

✨ 새 기능

  • ultrathink 키워드를 비활성화하는 CLAUDE_CODE_DISABLE_ULTRATHINK 환경 변수 추가됨
  • Claude apps gateway에 그룹 풀 예산(pooled group budgets) 추가됨: 각 멤버의 개별 한도 외에 그룹 멤버들이 공유하는 월별 예산으로, 지출 한도 관리자 API의 pooled_budget으로 설정 가능함
  • 프라이빗 CA에 루프 교차 인증서가 필요한 서버를 위해 서로를 루프로 인증하는 시스템 교차 인증서를 유지하는 CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP 환경 변수 추가됨
  • 서브에이전트가 세션 설정을 상속받는 대신 별도로 지정된 값이 없을 때 실행할 effort level을 지정하는 CLAUDE_CODE_SUBAGENT_EFFORT 환경 변수 추가됨
  • Claude apps gateway에 managed.policy_mode: layered 추가됨: 첫 번째 정책만 적용되는 것이 아니라 개발자와 일치하는 모든 정책이 하위 정책 위에 병합되어 적용됨
  • Claude apps gateway Bedrock 업스트림에 guardrail.input_tagging 추가됨: Amazon Bedrock 가드레일의 프롬프트 공격 필터에 필요한 입력 태그로 프롬프트를 감싸며, all_messages_and_system 설정 시 시스템 프롬프트도 태깅됨
  • [VS Code] 터미널 없이 채팅 패널에서 Claude apps gateway에 로그인하는 기능 추가됨
  • [Cloud sessions] MCP 서버가 요청하는 양식을 취소되지 않고 직접 작성하거나 거절할 수 있는 양식 카드 추가됨
  • [Cloud sessions] 다시 전환한 클라우드 또는 Remote Control 세션이 메시지를 최신 상태로 동기화하는 동안 표시되는 "Catching up…" 문구 추가됨
  • [Code Review] Code Review 분석 페이지에 심각도별 결과(findings-by-severity) 카드가 추가되어 기간 내 총 발견 건수, 심각도별 누적 일일 차트 및 심각도별 건수가 표시됨

🔧 개선 및 변경 사항

  • 2026년 10월 30일부로 Opus 4.8의 fast mode 지원 중단(deprecated) 예정이며 2026년 11월 30일에 제거됨. 제거 후 Opus 4.8의 fast mode 요청은 오류를 반환하며 표준 Opus 4.8로 폴백되지 않음. 속도 향상을 유지하려면 Opus 5.5로 마이그레이션 필요함
  • Claude Desktop 또는 웹의 Code 탭에서 시작된 /code-review 개선됨: 클라우드 및 claude remote-control 세션에서 일반 텍스트 목록 대신 결과 카드를 표시함
  • 대규모 리포지토리에서의 /diff 개선됨: 새로고침 시 전체 리포지토리 대상 git 명령 실행 횟수가 일반적으로 1회 줄어들며, git이 느릴 경우 새로고침 간격이 조정됨
  • /ultrareview, 클라우드 세션 또는 클라우드 에이전트에서 GitHub 원격 저장소를 찾을 수 없을 때 표시되는 메시지 개선됨: https://github.com/new 에서 리포지토리를 생성하도록 안내하며, /ultrareview가 gh에서 거부되는 gh 명령을 더 이상 제안하지 않음
  • SSL 인증서 오류 시 중간 인증서가 누락된 서버 등 예상되는 원인과 각 해결 방법을 명시하도록 개선됨
  • auto mode 변경: "$defaults"가 없는 autoMode.allow 목록이 예약된 작업(scheduled-task) 프롬프트의 내장 규칙을 더 이상 제거하지 않음
  • Team 및 Enterprise 로그인의 서버 관리형 설정 변경됨: Anthropic API에서 가져온 설정이 승인 프롬프트 없이 즉시 적용되며, 검증되지 않은 저장된 복사본은 거부됨
  • [VS Code] 터미널과 동일하게 ultrathink가 xhigh effort로 턴을 실행하고 채팅 상자에 무지개색으로 표시되도록 변경됨
  • [Cloud sessions] Enterprise 멤버가 자체 클라우드 환경의 네트워크 시크릿을 조회만 하는 대신 추가 및 삭제할 수 있도록 변경됨
  • [Cloud sessions] 클라우드 세션의 Changes 패널 개선됨: 목록에서 제외된 항목에 대한 안내가 diff 상단 행이 아닌 브랜치 이름 옆의 배지로 표시됨
  • [Claude Tag] Slack 채널의 자동 응답(Respond automatically) 스위치가 채널의 Configure 페이지 및 Claude Tag 관리자 설정의 "How Claude participates" 선택 항목으로 변경됨

🐛 버그 수정

  • 자격 증명이 거부되거나 클라우드 세션이 아카이브되는 등 Claude Code가 자체 종료될 때 macOS 및 Linux에서 셸 명령이 계속 실행 중인 상태로 남던 문제 수정됨
  • Git Bash를 제외하고 값에 줄바꿈이 포함된 bash 별칭과 하이픈(-)으로 시작하는 함수 이름이 Bash 도구의 셸에서 깨지거나 유실되던 문제 수정됨
  • SHELLOPTS가 export된 환경에서 Bash 도구로 시작된 bash 스크립트가 첫 번째 명령 실행 후 중단되던 문제 수정됨
  • 명령이 타입 캐스트, param, using 또는 속성으로 시작할 때 PowerShell 훅이 exit code 2에서 차단되지 않던 문제 수정됨
  • 압축된 응답이 잘리거나 손상되었을 때 일부 네트워크 요청이 멈추던 문제 수정됨
  • Vertex AI 및 Amazon Bedrock의 sonnet, opus, haiku 모델 사용 시 계정이나 리전에서 최신 모델을 아직 사용할 수 없을 때 구형 모델로 전환하지 않고 세션 중간에 오류가 발생하던 문제 수정됨
  • Claude apps gateway가 요청에 명시된 모든 모델을 availableModels, deniedModels, models와 비교 검증하지 않던 문제 수정됨(차단된 모델이 지정된 요청은 해당 필드를 명시한 400 오류를 반환함)
  • 관리형 설정에서 Claude apps gateway가 필요한 환경에서 claude auth login 실행이 거부되던 문제 수정됨(터미널에서 게이트웨이 로그인이 표시됨)
  • Read 허용 규칙이 적용되어 있을 때 --restricted 세션이 작업 디렉터리 외부의 파일을 업로드하던 문제 수정됨
  • 보이지 않는 문자가 포함된 프롬프트 전송 시 Enter 키를 두 번 입력해야 하던 문제 수정됨(일반 프롬프트는 첫 번째 Enter 시 정리되어 전송되며, 명령어는 여전히 검토 대기함)
  • 상위 서브에이전트의 모델을 상속받은 서브에이전트가 백그라운드 작업이나 메시지로 인해 깨어날 때 메인 모델로 변경되던 문제 수정됨
  • "$defaults"가 없는 관리형 autoMode.allow 목록이 호스트 앱의 --settings, /permissions에서 추가된 첫 번째 규칙, 또는 /auto-mode-setup을 통해 내장 예외를 다시 가져오던 문제 수정됨
  • 서버가 안전성 판정을 반환하지 않아 auto mode가 턴을 중단했을 때 클라우드 세션 및 클라우드 예약 작업이 실패로 표시되지 않던 문제 수정됨
  • 백그라운드 에이전트가 여전히 실행 중일 때 claude -p 텍스트 출력이 auto mode의 턴 중단 이유를 표시하지 않던 문제 수정됨
  • 실험적 베타 기능이 꺼진 프록시 또는 LLM 게이트웨이 뒤의 호스트 애플리케이션(예: Claude Desktop)에서 시작된 세션에서 CLAUDE_CODE_AUTO_MODE_SERVER=1 설정이 무시되던 문제 수정됨
  • 자격 증명 관련 환경 변수가 1과 같은 스위치 값으로 설정되었을 때 플러그인 MCP headersHelper 스크립트가 손상된 CLAUDE_PLUGIN_ROOT 및 서버 URL을 전달받던 문제 수정됨
  • CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 설정 시 SDK register_repo_root 제어 요청이 작업 디렉터리 외부 디렉터리의 CLAUDE.md를 로드하지 못하던 문제 수정됨
  • Artifact 도구가 self 레벨의 아티팩트 데이터베이스 액세스 규칙에 대해 ?를 표시하고, 해당 규칙이 삭제될 수 있는 재게시를 거부할 때 해당 규칙을 인용하지 않던 문제 수정됨
  • 현재 버전에서 인식할 수 없는 모델이 지정되어 자동 압축 시 200K 컨텍스트 윈도우로 가정될 때 /model <id>가 경고를 표시하지 않던 문제 수정됨
  • "hold space to speak" 힌트가 단일 세션에서 노출 횟수(3회)를 모두 소진하고 push-to-talk 키가 바인딩되지 않았을 때 빈 키를 표시하던 문제 수정됨
  • Windows 환경에서 Grep 및 Glob 검색 프로세스가 타임아웃으로 강제 종료되었으나 완전히 빠져나오지 못해 무한 대기하던 문제 수정됨
  • 대화의 일부가 저장되는 도중에 /clear 또는 /resume을 실행했을 때 대화를 재개해도 계획(plan)이 복원되지 않던 드문 문제 수정됨
  • 좁은 터미널에서 초기 실행 설정 시 보안 관련 참고 사항 및 터미널 설정 설명의 단어가 누락되던 문제 수정됨
  • Enterprise 설문 조사 카드에서 잠시 멈췄을 때 1 또는 0 입력이 바로 반영되던 문제 수정됨(이제 Enter 키를 눌러야 입력이 완료됨)
  • Self-hosted runner: 세션 프로세스가 교체된 후 Claude가 작업 중일 때 보낸 메시지가 Stop 이후에 응답되던 문제 수정됨
  • Self-hosted runner: 세션이 새 머신으로 이동할 때 MCP 서버의 켜짐/꺼짐 스위치가 가끔 유실되던 문제 수정됨
  • Windows: rc 파일에 errexit 및 pipefail이 설정되어 있고 winpty 별칭만 정의되었거나 아무것도 정의되지 않았을 때 Git Bash의 Bash 도구에서 별칭과 함수가 유실되던 문제 수정됨
  • [VS Code] 모델 설정에 opus[1m]과 같이 [1m] 태그가 있을 때 Effort 슬라이더, Ultracode 스위치 및 모델 이름이 표시되지 않던 문제 수정됨
  • [VS Code] 설정 파일에 오류가 있을 때 저장된 /btw 부가 질문 기록이 너무 일찍 삭제되던 문제 수정됨
  • [VS Code] 계획이 "Yes, and manually approve edits"로 승인되었을 때 다시 로드하거나 재시작한 후 대화가 Auto 모드로 돌아오던 문제 수정됨
  • [Cloud sessions] Claude가 디렉터리를 변경한 후 Files 패널의 파일 검색에서 폴더가 ../.. 경로로 표시되던 문제 수정됨(검색 결과가 프로젝트 루트 기준 경로로 표시됨)
  • [Claude Tag] Slack 채널에서 생성된 캔버스가 다른 채널이나 DM으로 공유된 후 해당 채널에서 캔버스 편집이나 내용 추가가 거부되던 문제 수정됨
  • [Claude Tag] 양쪽 조직 모두 Claude를 설치한 Slack Connect 스레드에서 Slack이 다른 조직의 앱으로 답글을 전달했을 때 태그되지 않은 답글에 응답하지 않던 문제 수정됨
  • [Claude Tag] Slack에서 클라우드 예약 작업의 실시간 상태 체크리스트가 완료되지 않은 상태로 멈추던 문제 수정됨(실행 중에 게시된 최상위 메시지를 해당 실행 중에 편집할 수 있도록 수정됨)