Claude Code 2.1.314 릴리스 노트

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

✨ 새 기능

  • permissions.blockWritesOutsideWorkingDirectories 설정 추가: 모든 권한 모드에서 Write, Edit, NotebookEdit 도구가 작업 디렉터리 외부의 경로에 대한 접근을 거부함
  • Claude 앱 게이트웨이 업스트림에 선택적 groups 목록 추가: 지정된 IdP 그룹에 속한 개발자만 해당 업스트림으로 라우팅되며, 장애 조치(failover) 시에도 동일하게 적용됨
  • Claude 앱 게이트웨이 Bedrock 업스트림에 guardrail_trace 추가: 요청 시 매칭된 텍스트 없이 어떤 Amazon Bedrock 가드레일 필터가 실행되었는지만 로깅함
  • VS Code 및 Claude Desktop의 Code 탭에 유휴 압축(idle compaction) 기능 추가: 200K 이상의 토큰 대화가 유휴 상태로 유지되면 요약되며, 프롬프트 캐시가 만료된 경우 다음 메시지에서 해당 요약을 사용함
  • [Cloud sessions] 예약된 작업 페이지에 '완료된 항목 포함(Include completed)' 버튼 추가: 완료된 단발성 작업만 숨겨져 있을 때 정렬 메뉴를 열지 않고도 표시할 수 있도록 지원함
  • [Claude Tag] Slack이 연결된 Enterprise 조직을 위해 관리자 설정의 번들 및 채널 탭에 닫기 가능한 Claude Tag API 문서 링크 추가

🔧 개선

  • 여러 서브에이전트를 실행하는 긴 헤드리스 및 SDK 턴의 메모리 사용량 개선: 부모 세션이 턴이 끝날 때까지 각 서브에이전트의 도구 결과를 유지하지 않도록 최적화함
  • 프롬프트 기록 개선: 이제 Ctrl+R 검색 시 접혀 있는 [Pasted text] 캡슐 내부의 텍스트도 매칭됨
  • /design-sync 업로드 프롬프트 개선: 업로드 또는 삭제될 폴더, 프로젝트 및 파일 목록을 명확히 표시하도록 개선함
  • /permissions 검토 탭 개선(이름이 '최근 차단됨(Recently blocked)'으로 변경): 하단 푸터에 선택된 항목에 대해 Esc를 눌렀을 때의 동작을 안내함
  • auto mode 차단 호출 개선: 차단 메시지에 명령 이름을 표시하고, Claude가 재시도할 수 있으며 auto mode가 다시 검사함을 안내하며, 검토를 위해 /permissions를 확인하도록 유도함
  • 권한 승인 프롬프트 개선: 긴 사유 설명이 차지하는 행 수를 줄여, 더 많은 터미널 환경에서 승인 대상 명령이 화면 밖으로 밀려나지 않도록 개선함
  • claude.ai 로그인 거부로 재시도 중일 때 표시되는 클라우드 세션 오류 안내 개선: 이제 claude auth login 실행을 함께 제안함
  • MDM과 원격 설정의 기본 URL 또는 apiKeyHelper가 서로 다를 때 저장된 claude.ai, Team, Enterprise 로그인의 동작 개선
  • 에이전트 뷰의 /config 개선: 에이전트 뷰가 기본으로 열리지 않도록 설정하는 방법 안내 추가
  • 세션 자동 제목 지정 개선: 스킬이나 /security-review 같은 프롬프트 기반 명령으로 시작된 세션이 제목 없음 상태로 남지 않고 해당 명령을 기반으로 제목을 지정받도록 개선함
  • 손상된 대화 기록(transcript)에 대한 --resume 실행 속도 및 메모리 사용량 개선
  • MCP 도구가 10,000개 이상 등록된 세션에서의 /context 처리 속도 개선
  • 자체 호스팅 러너(Self-hosted runner): 세션 브랜치가 git 원격 저장소에 없을 때 표시되는 오류 안내 개선(푸시된 적 없는 브랜치 케이스를 다루고, 해결 방법을 안내하며, 무의미한 재시도 제안을 제거함)
  • /claude-api 스킬 업데이트: API 추적을 위한 Datadog 설정 시 Console과 동일하게 dd-llmobs-enabled: true 헤더를 전송하도록 수정하고, ant 설치 안내에서 오래된 macOS xattr 단계를 제거함
  • 기본 탑재된 dataviz 스킬 업데이트: y축 틱 레이블의 값이 10,000 미만일 경우 전체 숫자를 표시하고, 가로 레이블은 공간이 허용되면 1,000,000 미만까지 전체 숫자를 표시하도록 권장함
  • 기본 탑재된 dataviz 스킬 업데이트: 도넛 및 파이 차트 요청에 대해 순위별 막대 차트나 값이 표시된 누적 막대 차트로 응답하도록 변경함
  • 사용자 설정 파일과 마찬가지로 조직의 서버 관리 설정 로컬 복사본을 수정하기 전에도 확인을 요청하도록 Claude의 파일 도구 동작 변경
  • claude ultrareview와 동일하게 /ultrareview 실행 전에도 작업 공간 신뢰(workspace trust) 상태를 확인하도록 변경
  • Bash 도구 셸 변경: 상속된 which 별칭(alias)이나 함수를 초기화하고 내보낸 which/unsetenv 함수를 명령으로 전달하지 않도록 하여, which가 항상 시스템 명령 또는 zsh 내장 명령으로 동작하도록 보장함
  • /permissions의 '최근 차단됨' 탭에서 터미널 화면이 좁아 전체 내용을 확인할 수 없는 호출의 승인을 거부하도록 변경
  • Cowork 클라우드 세션의 auto mode 변경: 훅(Hook)의 MCP 도구 호출 허용을 무응답으로 처리하여, 분류기 또는 권한 프롬프트가 최종 결정을 내리도록 수정함
  • Monitor(tail *)와 같은 훅 if 조건이 Bash(tail *)가 Bash 명령을 매칭하듯 Monitor 도구의 셸 명령과 매칭되도록 변경
  • claude-api 스킬 변경: Managed Agents 워크플로 실행을 개선하기 위해 에이전트를 수정하기 전 해당 실행의 워크플로 조회를 먼저 요청하도록 수정함
  • ANTHROPIC_DEFAULT_OPUS_MODEL, availableModels, deniedModels로 인해 이전 Opus 모델만 남거나 모델이 아예 없는 경우, 플래그가 지정된 요청이 거부로 끝나지 않고 다른 모델로 재시도되도록 변경
  • 원격 측정(telemetry)이 비활성화된 구독자 및 1시간 프롬프트 캐시가 활성화된 Bedrock, Vertex, Foundry, LLM 게이트웨이 환경에서도 유휴 압축이 실행되도록 변경
  • FORCE_HYPERLINK=false(no 및 off 포함) 설정 시 하이퍼링크가 켜지는 대신 꺼지도록 수정
  • macOS: 유효하지 않은 UTF-8 파일에서 macOS 정규식 라이브러리의 메모리 누수 문제를 방지하기 위해 Claude가 실행하는 대부분의 명령에서 git grep이 C 로캘(locale)을 사용하도록 변경
  • [VSCode] CLAUDE_CODE_DISABLE_CFC_PROMPT 설정 시 익스텐션이 세션 메시지에 Claude in Chrome 지침을 추가하지 않도록 변경(브라우저 도구는 계속 사용 가능)
  • [Cloud sessions] 예약된 작업 개선: Anthropic 클라우드 실행 시 claude.ai 계정에 활성화된 플러그인을 불러오도록 개선함
  • [Cloud sessions] 관리자 설정의 GitHub Enterprise '연결 테스트' 개선: 클라우드 세션과 동일한 방식으로 연결을 시도하고 두 번째 테스트 실패 시 경고를 표시하도록 개선함
  • [Cloud sessions] 클라우드 세션 대화 기록 개선: 이름 변경 행에 새 제목을 표시하고, 저장소 및 환경 목록을 단일 JSON 라인 대신 테이블 형태로 출력하도록 개선함
  • [Cloud sessions] 웹, 데스크톱, 모바일 앱에서 설정 스크립트가 오류로 종료되더라도 클라우드 세션이 실패하지 않고 시작되도록 변경

🐛 버그 수정

  • 조직 관리자가 모델의 effort 레벨을 제한했을 때 세션이 턴마다 "Invalid effort level" 오류로 실패하던 문제 수정: Claude Code가 effort를 낮춰 재시도하고 사용 중인 레벨을 안내하도록 수정됨
  • 시작에 실패했을 때 claude -p가 아무런 출력 없이 종료 코드 0으로 끝나던 문제 수정: 오류를 출력하고 종료 코드 1로 종료되도록 수정됨
  • 이미지가 많은 Bedrock 세션에서 이전 이미지를 제거하고 압축하는 대신 매 턴 및 /compact 실행 시 "400 Input is too long." 오류로 실패하던 문제 수정
  • 리소스에 기본 Sonnet, Opus, Haiku 모델 배포가 없을 때 Microsoft Foundry 세션이 실패하던 문제 수정: 동일 계열의 이전 모델로 대체 실행되도록 수정됨
  • 도구 검색(tool search)의 tool_reference 블록을 지원하지 않는 게이트웨이 환경에서 요청 거부가 반복되던 문제 수정: 도구 검색 없이 1회 재요청하고 세션이 이를 기억하도록 수정됨
  • 시스템 인증서 저장소에 이전 인증서와 교차 서명된 갱신 루트 인증서가 있을 때 TLS 연결이 UNABLE_TO_GET_ISSUER_CERT 오류로 실패하던 문제 수정
  • 로그인 없이도 동작하는 MCP 서버의 저장된 인증 정보가 만료되었을 때 "needs authentication"을 표시하던 문제 수정: 이제 로그아웃 상태로 정상 사용됨
  • SSH 환경에서 macOS 키체인이 잠겨 있는 등 MCP 로그인이 삭제되지 않았음에도 claude mcp logout이 성공으로 보고되던 문제 수정
  • 여러 세션이 하나의 Anthropic 프로필 로그인을 공유하고 인증 정보 락(lock)이 사용 중일 때 불필요하게 로그인이 재갱신되던 문제 수정
  • 터미널이 있는 CI 작업 환경에서 claude ultrareview 및 claude remote-control이 작업 공간 신뢰 여부를 묻던 문제 수정: CI 환경 변수가 설정되어 있으면 신뢰할 수 없는 폴더를 즉시 거부하도록 수정됨
  • 관리형 설정(managed settings)의 관리자 TLS 신뢰 설정이 Claude Desktop 세션에 적용되지 않던 문제 수정
  • 관리형 플러그인 설정이 적용된 머신에서 자체 --plugin-dir 또는 --plugin-url 플러그인의 매니페스트가 손상되었거나 다운로드에 실패했을 때 모델 전환이 거부되던 문제 수정
  • 관리형 설정에서 모델을 고정했을 때 매 시작마다 Bedrock 및 Vertex 모델 업그레이드 제안이 표시되던 문제 수정
  • 원격 관리형 설정에만 지정된 forceRemoteSettingsRefresh가 저장된 복사본 만료 후 적용되지 않아 서버 접속 불가 시 정책 없이 세션이 시작되던 문제 수정
  • 대기 간격 사이에 작업이 재시작될 때(/goal 확인, 백그라운드 또는 예약된 작업) "Continue automatically at usage limit" 옵션이 사용자 프롬프트 없이 3회 이상 계속 진행되던 문제 수정
  • Ultracode로 시작된 백그라운드 및 클라우드 세션에서 기능을 끈 후 다음 시작 시 다시 켜지던 문제 수정
  • 도구 호출 파싱 실패로 Claude가 작업을 포기한 후에도 마지막 손상된 응답과 재시도 프롬프트가 대화에 남아 있던 문제 수정
  • 매우 큰 출력을 생성하는 PreCompact 훅으로 인해 압축이 실패하거나 반복되던 문제 수정: 각 훅의 출력이 10,000자로 제한됨
  • 백그라운드 diff 새로고침이 저장소의 index 락을 일시적으로 점유하여 동시에 실행된 git 명령이 "Unable to create '.git/index.lock': File exists" 오류로 실패하던 문제 수정
  • 스트리밍 중 일부만 입력된 행에서 마크다운 테이블이 그리드와 스택 레이아웃 사이를 오가거나 긴 테이블이 원시 파이프(|) 형태로 강등되던 문제 수정
  • 세션에서 슬래시 명령만 실행했을 때 /resume 선택기에서 CLAUDE.md 또는 CLAUDE.local.md의 텍스트가 세션 제목으로 표시되던 문제 수정
  • 서브에이전트의 열린 트랜스크립트에서 /btw를 실행했을 때 메인 대화 내용을 바탕으로 응답하던 문제 수정
  • SSH를 통해 Linux 머신으로 이미지를 붙여넣을 때 아무런 반응이 없던 문제 수정: 파일을 복사해 경로를 붙여넣도록 안내 메시지가 표시됨
  • 세션 서비스가 일시적으로 느려졌을 때 claude remote-control 세션 시작에 실패하던 문제 수정: 점진적 대기 시간을 적용해 워커 등록을 재시도하도록 수정됨
  • Remote Control을 통한 모델 전환이 8초 이상 걸릴 때 최종 결과 대신 "still pending" 오류가 반환되던 문제 수정
  • sandbox.excludedCommands 설정 설명에 등록된 명령이 항상 샌드박스 외부에서 실행된다고 잘못 기재되어 있던 내용 수정: 호출 내 모든 명령이 항목과 일치해야 함을 명시하도록 수정됨
  • auto mode, 거부 규칙 또는 PreToolUse 훅에 의해 차단되었거나 실행되지 않은 셸 및 MCP 호출이 접힌 도구 그룹 내에서 실행된 것처럼 표시되던 문제 수정
  • claude -p --resume 또는 --continue로 진입한 worktree에 샌드박스 보호 기능이 적용되지 않던 문제 수정
  • Bash와 매칭되는 훅이 Monitor 도구에 의해 시작된 셸 명령에 대해 실행되지 않던 문제 수정: 이제 해당 훅이 명령을 차단하거나 확인할 수 있음 (단, 승인하거나 재작성할 수는 없음)
  • --setting-sources로 제외된 설정 파일이 auto mode 규칙 및 저장된 권한 동의 등 일부 설정을 여전히 제공하던 문제 수정
  • 안전 검사에서 판정을 내리지 못했을 때 auto mode가 호출을 차단된 것으로 보고하고 /permissions에 등록하던 문제 수정
  • Google 토큰 엔드포인트가 연결만 수락하고 응답하지 않을 때 Claude 앱 게이트웨이 Vertex 업스트림이 수 분 동안 멈추던 문제 수정
  • 지원 중단된 Claude Desktop 키에 대해 Claude 앱 게이트웨이가 유효 기간 만료 후에도 "stops being accepted" 경고를 표시하던 문제 수정
  • App Store 또는 Google Play를 통해 결제되는 플랜에서 /upgrade 실행 시 브라우저를 열고 새 로그인을 시작하던 문제 수정: 요금제를 변경할 수 있는 위치를 안내하도록 수정됨
  • 거부 처리 후 다른 모델로 전환된 시점을 지나 뒤로 되감거나 --resume을 실행했을 때 Claude Code가 인식하지 못하는 모델명을 가진 세션을 다른 모델로 변경해 버리던 문제 수정
  • 게이트웨이나 클라우드 제공업체가 Claude Code의 베타 헤더 중 하나를 이름 기준으로 거부할 때 요청이 실패하던 문제 수정: 해당 헤더를 제외하고 재전송하도록 수정됨
  • claude-opus-4.8과 같이 LLM 게이트웨이 뒤에서 마침표가 포함된 모델 ID가 잘못된 컨텍스트 창, 출력 제한, effort, 사고 모드 및 비용을 가진 이전 모델로 취급되던 문제 수정
  • /compact 실행 후 Remote Control 클라이언트에 불필요한 "Compacted (ctrl+o to see full summary)" 행이 표시되던 문제 수정
  • 조직 정책으로 해당 기능이 비활성화되었음에도 클라우드 세션 팁 및 Remote Control 유휴 알림이 표시되던 문제 수정
  • 이전 워커가 새 대화의 파일을 받은 직후 중단되었을 때 재개된 claude.ai 클라우드 세션이 요청되지 않은 모델 호출을 수행하던 문제 수정
  • Cowork 클라우드 세션의 WebFetch가 100,000자를 초과하는 PDF 텍스트를 경고 없이 누락하던 문제 수정: 읽지 못한 분량과 이어서 읽을 위치를 안내하도록 수정됨
  • 클라우드 세션이나 IDE에서 Esc 또는 Stop으로 명령을 중단했을 때 Claude에게 명령이 거부되었다는 사실만 전달되던 문제 수정: 명령이 이미 실행되었을 수 있음을 함께 전달하도록 수정됨
  • 코드 블록이 인용구를 열 때 상단의 빈 줄이 사라지던 문제 수정
  • 대화 기록 뷰(Ctrl+O)에서 일부 ⎿ 행 위에 빈 줄이 표시되던 문제 수정
  • vim 모드에서 dw, dW, yw, yW가 줄 끝을 넘어 계속 동작하던 문제를 수정하고, w 및 W가 빈 줄에서 멈추도록 수정됨
  • 다른 에이전트가 시작되거나 종료될 때 에이전트 패널에서 x 및 Enter가 엉뚱한 에이전트에 동작하던 문제 수정
  • Claude 질문 대화 상자에서 "Other" 행에 포커스가 있지 않으면 붙여넣은 텍스트나 드래그한 파일이 유실되던 문제 수정
  • 프롬프트 하단 푸터의 특정 행이 선택되어 있을 때 붙여넣은 텍스트가 유실되던 문제 수정
  • vim 모드에서 문자 단위 선택 영역 위에 p 실행 시 복사된 텍스트가 전체 줄 단위였는지 여부를 무시하던 문제 수정
  • vim 모드에서 aw 및 iw가 줄 끝의 줄바꿈까지 포함하던 문제 수정
  • ? 도움말 메뉴, 명령 목록 또는 붙여넣기 힌트에 가려진 푸터 항목이 ↓ 방향키로 선택되던 문제 수정
  • /btw 등 명령 패널에서 Esc를 누르면 대화 기록이 열려 있는 서브에이전트까지 함께 중단되던 문제 수정
  • 전체 화면 모드의 시작 헤더가 다른 모델로 실행 중인 서브에이전트나 팀원을 볼 때도 세션 기본 모델을 표시하던 문제 수정
  • 위로 스크롤한 상태에서 되감기 메뉴의 "Restore conversation"을 실행한 후 전체 화면 대화 기록이 대화 중간에 머물러 있던 문제 수정
  • 삭제된 세션이 거의 빈 항목으로 재개 목록에 다시 나타나던 드문 문제 수정
  • <bash-stdout> 또는 <local-command-stdout> 같은 태그가 포함된 프롬프트가 로컬 stream-json 호스트에 승인(acknowledged)되지 않던 문제 수정
  • 사용량 제한 등으로 첫 번째 프롬프트가 실패한 후 대화가 계속되었을 때 세션 제목이 지정되지 않고 유지되던 문제 수정
  • 스킬 파일 감시자(watcher)가 ~/.claude/skills/.trash에 보관된 삭제된 스킬까지 모두 확인하여 삭제가 늘어날수록 파일 시스템 부하를 가중시키던 문제 수정
  • Claude가 권한이나 계획 승인을 요청하는 동안 /rename으로 지정한 세션 이름이 사라지던 문제 수정: 나란히 열린 세션의 식별 상태가 유지되도록 수정됨
  • 백그라운드 세션 시작 실패 시 데몬 바이너리가 디스크에 남아 있음에도 바이너리가 삭제된 것으로 보고되던 문제 수정
  • /config의 푸시 설정이 숨겨져 있거나 조직에서 Remote Control을 비활성화했을 때 푸시 알림 관련 팁과 유휴 알림이 표시되던 문제 수정
  • ~/.claude/skills/.trash 및 ~/.claude/plugins/.trash 폴더가 무제한으로 커지던 문제 수정: cleanupPeriodDays 설정과 관계없이 각각 약 1,024개의 항목만 유지하도록 수정됨
  • git 줄바꿈 변환이 적용된 CRLF 파일이 변경 없이 다시 저장되거나 한 줄만 편집되었을 때 Bash 편집 diff가 파일 전체를 변경된 것으로 표시하던 문제 수정
  • 자체 호스팅 러너(Self-hosted runner): 러너의 일시 중지 요청이 Anthropic 응답 전에 연결이 끊어졌을 때 유휴 세션이 일시 중지되지 않고 다른 러너로 이동하던 문제 수정
  • [VSCode] MCP 서버의 저장된 로그인을 삭제할 수 없을 때도 "Clear authentication"이 성공으로 보고되던 문제 수정
  • [VSCode] 대기 중인 메시지의 훅이 실행되는 동안 로딩 스피너 및 Stop 버튼이 표시되지 않던 문제 수정
  • [VSCode] 삭제 등 저장할 수 없는 세션 그룹 변경 사항이 알림 없이 조용히 실패하던 문제 수정: 오류 알림이 표시되도록 수정됨
  • [VSCode] 계획 미리보기 탭에서 Cmd+F / Ctrl+F로 찾기 위젯이 열리지 않던 문제 수정
  • [VSCode] 러시아어, 그리스어, 히브리어 등 비라틴계 키보드 레이아웃에서 음성 받아쓰기 단축키(Ctrl+D)가 동작하지 않던 문제 수정
  • [VSCode] 채팅창 없이 익스텐션이 열렸을 때 누락된 1회성 저장 예약 작업이 확인 없이 삭제되던 문제 수정
  • [Cloud sessions] 최근 사용한 자체 호스팅 환경이 새 세션 카드의 최근 환경 목록에 나타나지 않던 문제 수정
  • [Cloud sessions] Claude가 다른 worktree에서 푸시한 커밋으로 브랜치를 이동한 후 매 턴마다 커밋되지 않은 변경 사항이 있다고 보고하던 문제 수정
  • [Cloud sessions] 창 높이가 매우 낮거나 화면 배율이 높을 때 관리자 설정의 자체 호스팅 환경 상세 대화 상자 내용이 화면 밖으로 밀려나던 문제 수정: 대화 상자에 스크롤이 적용됨
  • [Cloud sessions] 실행 중인 클라우드 또는 Remote Control 세션이 모드 전환을 거부한 후에도 권한 모드 선택기가 Auto 상태로 유지되던 문제 수정: 현재 사용 중인 모드를 표시하고 사용자에게 알리도록 수정됨
  • [Remote Control] 입력하기 전까지 Remote Control 세션의 권한 모드 버튼이 잘못된 모드를 표시하던 문제 수정: 컴퓨터가 온라인 상태일 때 열리는 즉시 실제 모드를 표시하도록 수정됨
  • [Claude Tag] Enterprise Grid 워크스페이스 간 공유 채널에서 1회 워크스페이스 확인 실패 후 @Claude !restart가 중단되던 문제 수정: 재시도 후 다시 실행을 요청하도록 수정됨
  • [Claude Tag] 몇 분 내에 동일한 링크를 통해 Slack에서 Claude 계정을 두 번 연결했을 때 확인 DM 및 채널 알림이 중복 전송되던 문제 수정
  • [Claude Tag] Claude 세션이 자체 호스팅 러너를 대기하는 동안 Slack의 후속 메시지에 진행 상태가 표시되지 않던 문제 수정: 스레드에 대기 안내를 게시하도록 수정됨
  • [Claude Tag] 양쪽 조직 모두 Claude를 설치한 Slack Connect 채널에서 자체 스레드의 태그에 Claude가 간혹 응답하지 않던 문제 수정
  • [Claude Tag] 로드 실패 후 Claude Tag 관리자 설정의 플러그인 및 스킬 페이지에서 '재시도(Retry)' 클릭 시 저장되지 않은 접근 권한 변경 사항이 사라지던 문제 수정: 수정 내용이 유지되도록 수정됨
  • [Claude Tag] Claude Tag 관리자 설정의 저장소 컨트롤에서 동일한 작업이 중복 표시되던 문제 수정: 버튼에 이미 지정된 작업을 메뉴 목록에서 제외하도록 수정됨