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가xhigheffort로 턴을 실행하고 채팅 상자에 무지개색으로 표시되도록 변경됨 - [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설정 시 SDKregister_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에서 클라우드 예약 작업의 실시간 상태 체크리스트가 완료되지 않은 상태로 멈추던 문제 수정됨(실행 중에 게시된 최상위 메시지를 해당 실행 중에 편집할 수 있도록 수정됨)