Claude Code v2.1.314 업데이트 안내

10월 30, 2026

글: MinoSui

Claude Code v2.1.314 버전이 배포되었습니다. 이번 릴리스는 파일 시스템 쓰기 범위를 제한하는 보안 옵션과 대규모 대화의 프롬프트 캐시 만료에 대응하는 유휴 압축 기능을 제공합니다. 엔터프라이즈 게이트웨이 환경과 클라우드 세션 작업 흐름을 개선하는 옵션도 포함되었습니다.

핵심 요약

작업 디렉터리 외부 쓰기 차단 옵션 추가
20만 토큰 이상 유휴 세션 자동 요약 압축 지원
게이트웨이 업스트림 IdP 그룹별 라우팅 및 가드레일 로깅 추가
헤드리스 및 SDK 환경의 서브에이전트 메모리 사용량 개선

릴리스 노트 전체
새로 쓸 수 있게 된 기능
업데이트 효과 직접 재보기
업데이트 방법과 버전 확인

릴리스 노트 전체

아래 119개 항목은 공식 릴리스 노트에 실린 순서 그대로 한 줄에 하나씩 옮긴 것입니다. 빠지거나 덧붙인 항목은 없습니다.

`permissions.blockWritesOutsideWorkingDirectories` 설정을 추가하여 모든 권한 모드에서 Write, Edit, NotebookEdit가 작업 디렉터리 외부 경로를 거부하도록 했습니다.
Claude 앱 게이트웨이 업스트림에 선택 사항인 `groups` 목록을 추가하여 장애 조치 시에도 지정된 IdP 그룹의 개발자만 해당 업스트림으로 전송되도록 했습니다.
Claude 앱 게이트웨이 Bedrock 업스트림에 `guardrail_trace`를 추가하여 일치한 텍스트 없이 요청에서 작동한 Amazon Bedrock 가드레일 필터만 기록하도록 했습니다.
VS Code 및 Claude Desktop의 Code 탭에 유휴 압축 기능을 추가하여 20만 개 이상의 토큰 대화가 유휴 상태로 방치되면 요약하고 프롬프트 캐시가 만료된 경우 다음 메시지에서 해당 요약을 사용하도록 했습니다.
조직 관리자가 모델의 effort를 제한할 때 세션이 턴마다 "Invalid effort level" 오류로 실패하던 문제를 고쳤으며, 이제 Claude Code가 effort를 낮춰 재시도하고 사용하는 단계를 안내합니다.
시작에 실패했을 때 `claude -p`가 출력 없이 종료 코드 0으로 종료되던 문제를 고쳤으며, 이제 오류를 출력하고 1로 종료합니다.
이미지가 많은 Bedrock 세션이 오래된 이미지를 제거하고 압축하는 대신 매 턴 및 `/compact` 실행 시 "400 Input is too long." 오류로 실패하던 문제를 고쳤습니다.
기본 Sonnet, Opus 또는 Haiku 모델에 대한 배포가 리소스에 없을 때 Microsoft Foundry 세션이 실패하던 문제를 고쳤으며, 이제 Claude Code가 해당 계열의 이전 모델로 대체합니다.
도구 검색의 `tool_reference` 블록을 수락하지 않는 게이트웨이 뒤에서 요청이 반복해서 거부되던 문제를 고쳤으며, 도구 검색 없이 요청을 한 번 다시 전송하고 세션에서 이를 기억합니다.
시스템 인증서 저장소에 이전 루트 인증서와 교차 서명된 갱신 루트 인증서가 있을 때 TLS 연결이 `UNABLE_TO_GET_ISSUER_CERT` 오류로 실패하던 문제를 고쳤습니다.
로그인 없이도 작동하는 MCP 서버의 저장된 로그인이 작동을 멈춘 후 "needs authentication"으로 표시되던 문제를 고쳤으며, 이제 로그아웃된 상태로 사용됩니다.
SSH 연결 상태에서 macOS 키체인이 잠겨 있는 등 MCP 로그인이 제거되지 않았음에도 `claude mcp logout`이 성공으로 보고되던 문제를 고쳤습니다.
여러 세션이 Anthropic 프로필 로그인을 공유하고 자격 증명 잠금이 사용 중일 때 로그인이 불필요하게 추가 갱신되던 문제를 고쳤습니다.
터미널이 있는 CI 작업에서 `claude ultrareview` 및 `claude remote-control`이 워크스페이스 신뢰 여부를 묻던 문제를 고쳤으며, `CI`가 설정되어 있으면 신뢰할 수 없는 폴더를 즉시 거부합니다.
관리형 설정에 지정된 관리자의 TLS 신뢰 설정이 Claude Desktop 세션에 적용되지 않던 문제를 고쳤습니다.
직접 지정한 `--plugin-dir` 또는 `--plugin-url` 플러그인의 매니페스트가 손상되었거나 다운로드에 실패했을 때, 플러그인 설정이 관리되는 머신에서 모델 전환이 거부되던 문제를 고쳤습니다.
관리형 설정에서 모델을 고정했을 때 시작할 때마다 Bedrock 및 Vertex 모델 업그레이드 제안이 다시 나타나던 문제를 고쳤습니다.
원격 관리형 설정에만 지정된 `forceRemoteSettingsRefresh`가 저장된 사본이 만료되면 더 이상 적용되지 않아 서버에 연결할 수 없을 때 정책 없이 세션이 시작되던 문제를 고쳤습니다.
대기 시간 사이에 작업이 자체 재시작될 때(/goal 확인, 백그라운드 또는 예약된 작업) 사용자의 프롬프트 없이 "Continue automatically at usage limit"가 3회 넘게 계속 진행되던 문제를 고쳤습니다.
Ultracode로 시작된 백그라운드 및 클라우드 세션이 전원을 끈 후 다음 시작 시 다시 켜지던 문제를 고쳤습니다.
Claude가 구문 분석할 수 없는 도구 호출을 포기한 후에도 마지막 손상된 응답과 재시도 프롬프트가 대화에 남아 있던 문제를 고쳤습니다.
출력이 매우 큰 PreCompact 훅으로 인해 압축이 실패하거나 반복되던 문제를 고쳤으며, 이제 각 훅의 출력이 10,000자에서 잘립니다.
백그라운드 diff 새로고침이 저장소의 인덱스 잠금을 짧게 획득하여 동시에 실행된 git 명령이 "Unable to create '.git/index.lock': File exists" 오류로 실패할 수 있던 문제를 고쳤습니다.
스트리밍 중 부분적으로 입력된 행에서 마크다운 표가 격자형과 누적형 레이아웃 사이를 오가거나 긴 표가 원시 파이프 형태로 대체되던 문제를 고쳤습니다.
세션에서 슬래시 명령만 실행했을 때 /resume 선택 창에서 CLAUDE.md 또는 CLAUDE.local.md의 텍스트가 세션 제목으로 표시되던 문제를 고쳤습니다.
서브에이전트의 열린 트랜스크립트에서 `/btw`를 요청했을 때 기본 대화에서 답변하던 문제를 고쳤습니다.
Linux 머신에 SSH를 통해 이미지를 붙여넣을 때 아무 반응 없이 무시되던 문제를 고쳤으며, 이제 프롬프트에 파일을 복사해 와서 경로를 붙여넣으라고 안내합니다.
세션 서비스가 일시적으로 느려졌을 때 `claude remote-control` 세션 시작에 실패하던 문제를 고쳤으며, 이제 대기 시간을 늘려가며 워커 등록을 재시도합니다.
Remote Control을 통한 모델 전환이 8초 이상 걸릴 때 최종 결과 대신 "still pending" 오류가 발생하던 문제를 고쳤습니다.
`sandbox.excludedCommands` 설정 설명에 나열된 명령이 항상 샌드박스 외부에서 실행된다고 안내하던 문제를 고쳤으며, 이제 호출의 모든 명령이 항목과 일치해야 한다고 명시합니다.
자동 모드, 거부 규칙 또는 PreToolUse 훅에 의해 차단되었거나 실행되지 않은 셸 및 MCP 호출이 접힌 도구 그룹에서 실행된 것처럼 표시되던 문제를 고쳤습니다.
`claude -p --resume` 또는 `--continue`로 들어간 워크트리에 샌드박스 보호 기능이 적용되지 않던 문제를 고쳤습니다.
Monitor 도구로 시작된 셸 명령에서 Bash와 일치하는 훅이 실행되지 않던 문제를 고쳤으며, 이러한 훅은 해당 명령을 차단하거나 확인할 수는 있지만 승인하거나 다시 작성할 수는 없습니다.
`--setting-sources`로 제외된 설정 파일이 자동 모드 규칙이나 저장된 권한 동의 등 일부 설정을 여전히 제공하던 문제를 고쳤습니다.
보안 검사 결과가 나오지 않았을 때 자동 모드가 호출을 차단된 것으로 보고하고 `/permissions`에 나열하던 문제를 고쳤습니다.
Google 토큰 엔드포인트가 연결을 수락한 뒤 응답하지 않을 때 Claude 앱 게이트웨이 Vertex 업스트림이 몇 분 동안 멈추던 문제를 고쳤습니다.
사용 중단되었지만 여전히 작성된 대로 지원되는 Claude Desktop 키에 대한 Claude 앱 게이트웨이의 시작 경고가 키 만료일 이후에 "stops being accepted"로 표시되던 문제를 고쳤습니다.
App Store 또는 Google Play를 통해 결제되는 플랜에서 `/upgrade` 실행 시 브라우저가 열리고 새 로그인이 시작되던 문제를 고쳤으며, 이제 플랜을 변경할 수 있는 위치를 안내합니다.
거부 후 다른 모델로 전환한 지점을 되돌리거나 `--resume`을 사용할 때, Claude Code가 인식하지 못하는 모델 이름의 세션이 다른 모델로 변경되던 문제를 고쳤습니다.
게이트웨이나 클라우드 제공업체가 Claude Code의 베타 헤더 중 하나를 이름으로 거부할 때 요청이 실패하던 문제를 고쳤으며, 해당 헤더 없이 요청을 다시 전송합니다.
LLM 게이트웨이 뒤에서 `claude-opus-4.8`과 같이 점이 포함된 모델 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 호스트에 승인되지 않던 문제를 고쳤습니다.
첫 번째 프롬프트가 실패(예: 사용량 제한)한 뒤 대화가 이어졌을 때 세션 제목이 지정되지 않은 상태로 유지되던 문제를 고쳤습니다
`~/.claude/skills/.trash`에 보관된 삭제된 스킬을 스킬 파일 감시자가 매번 확인하여 삭제할 때마다 파일 시스템 부하가 증가하던 문제를 고쳤습니다
Claude가 권한이나 계획 결정을 요청하는 동안 /rename으로 설정한 세션 이름이 사라져 병렬 세션을 식별하기 어렵던 문제를 고쳤습니다
디스크에 데몬 바이너리가 여전히 존재함에도 시작에 실패한 백그라운드 세션이 삭제된 바이너리로 보고되던 문제를 고쳤습니다
`/config`에서 푸시 설정이 숨겨져 있거나 조직에서 원격 제어를 비활성화했을 때도 푸시 알림 팁 및 유휴 알림이 표시되던 문제를 고쳤습니다
`~/.claude/skills/.trash` 및 `~/.claude/plugins/.trash`가 무제한으로 증가하던 문제를 고쳐, `cleanupPeriodDays` 설정과 관계없이 각각 약 1024개의 항목만 유지하도록 고쳤습니다
git의 줄 바꿈 변환이 적용된 CRLF 파일이 변경 없이 다시 저장되거나 한 줄만 수정되었을 때 Bash 편집 diff에서 파일 전체가 변경된 것으로 표시되던 문제를 고쳤습니다
자체 호스팅 러너: 러너의 일시 중지 요청이 Anthropic의 응답 전에 연결이 끊어졌을 때 유휴 세션이 일시 중지되지 않고 다른 러너로 이동하던 문제를 고쳤습니다
수많은 하위 에이전트를 실행하는 긴 헤드리스 및 SDK 턴의 메모리 사용량을 개선하여, 상위 세션이 각 하위 에이전트의 도구 결과를 턴이 끝날 때까지 유지하지 않도록 했습니다
프롬프트 기록을 개선하여 Ctrl+R이 접힌 `[Pasted text]` 배지 내부의 텍스트와도 일치하도록 했습니다
`/design-sync` 업로드 프롬프트를 개선하여 폴더, 프로젝트 및 업로드하거나 삭제할 파일을 표시하도록 했습니다
최근 차단됨으로 이름이 바뀐 `/permissions` 검토 탭을 개선하여, 선택된 행에 대해 Esc 키를 누르면 어떻게 동작하는지 하단에 표시하도록 했습니다
자동 모드의 차단된 호출을 개선하여 메시지에 명령어를 명시하고, Claude가 재시도할 수 있으며 자동 모드가 다시 확인함과 함께 검토를 위해 `/permissions`를 안내하도록 했습니다
권한 요청 프롬프트를 개선하여 긴 사유가 더 적은 행을 차지하도록 함으로써 터미널 화면 밖으로 승인할 명령어가 밀려나는 현상을 줄였습니다
claude.ai 로그인 거부로 인한 요청이 재시도되는 동안 표시되는 클라우드 세션 오류를 개선하여 `claude auth login`도 제안하도록 했습니다
MDM과 원격 설정의 기본 URL 또는 `apiKeyHelper`가 서로 다를 때 저장된 claude.ai, Team, Enterprise 로그인의 동작을 개선했습니다
에이전트 뷰의 `/config`를 개선하여 에이전트 뷰가 기본으로 열리지 않도록 설정하는 방법을 안내하도록 했습니다
세션 자동 제목 지정을 개선하여 스킬이나 `/security-review` 같은 프롬프트 기반 명령어로 시작하는 세션이 제목 없음 상태로 유지되지 않고 해당 명령어를 기반으로 제목이 지정되도록 했습니다
손상된 트랜스크립트에서 `--resume` 실행 속도와 메모리 사용량을 개선했습니다
MCP 도구가 1만 개 이상인 세션에서 `/context`의 속도를 개선했습니다
자체 호스팅 러너: 세션의 브랜치가 git 원격에 없을 때 표시되는 오류를 개선하여 한 번도 푸시되지 않은 브랜치를 다루고 각 사례의 해결 방법을 안내하며 재시도 제안을 제거했습니다
`/claude-api` 스킬을 업데이트했습니다. 이제 API 트레이싱용 Datadog 설정이 콘솔처럼 `dd-llmobs-enabled: true` 헤더를 전송하며, `ant` 설치 안내에서 구버전 macOS용 `xattr` 단계를 제외했습니다
기본 제공 dataviz 스킬을 업데이트하여 y축 눈금 라벨은 10,000 미만, 가로 눈금 라벨은 공간이 허용하는 한 1,000,000 미만일 때 전체 숫자를 출력하도록 권장했습니다
기본 제공 dataviz 스킬을 업데이트하여 도넛 및 파이 차트 요청에 순위 막대 또는 값이 출력되는 분할 막대로 응답하도록 했습니다
Claude의 파일 도구가 사용자의 설정 파일을 수정할 때와 마찬가지로, 조직의 서버 관리 설정의 로컬 복사본을 편집하기 전에 확인하도록 변경했습니다
`claude ultrareview`와 마찬가지로 `/ultrareview`도 git을 실행하기 전에 작업 영역 신뢰 여부를 확인하도록 변경했습니다
Bash 도구의 셸이 상속된 `which` 별칭이나 함수를 지우고 내보낸 `which`/`unsetenv` 함수를 명령어로 전달하지 않도록 변경하여, `which`가 시스템 명령어 또는 zsh 내장 명령어로 동작하도록 했습니다
터미널 높이가 부족해 잘리는 경우를 포함하여 전체 내용을 읽을 수 없는 호출의 승인을 거부하도록 `/permissions` 최근 차단됨을 변경했습니다
Cowork 클라우드 세션의 자동 모드를 변경하여 훅이 MCP 도구 호출을 허용하더라도 무응답으로 처리되어 분류기나 권한 프롬프트가 결정을 내리도록 했습니다
`Bash(tail *)`가 Bash의 명령어와 일치하듯이 `Monitor(tail *)`와 같은 훅 `if` 조건이 Monitor 도구의 셸 명령어와 일치하도록 변경했습니다
`claude-api` 스킬이 실행 결과를 개선하기 위해 에이전트를 수정하기 전 Managed Agents 워크플로 실행의 워크플로를 읽도록 확인을 요청하게 변경했습니다
`ANTHROPIC_DEFAULT_OPUS_MODEL`, `availableModels`, 또는 `deniedModels`로 인해 구버전 Opus 모델만 남거나 모델이 아예 남지 않았을 때 플래그가 지정된 요청이 거부로 끝나지 않고 다른 모델로 재시도되도록 변경했습니다
원격 측정을 비활성화한 구독자와 1시간 프롬프트 캐시가 켜진 Bedrock, Vertex, Foundry 및 LLM 게이트웨이에서도 유휴 상태 압축이 실행되도록 변경했습니다
`FORCE_HYPERLINK=false`(`no`, `off` 포함) 설정 시 하이퍼링크가 활성화되지 않고 꺼지도록 변경했습니다
macOS: 유효한 UTF-8이 아닌 파일에서 발생하는 macOS 정규식 라이브러리의 메모리 누수를 방지하기 위해 Claude가 실행하는 대부분의 명령어에서 `git grep`이 C 로캘을 사용하도록 변경했습니다
[VSCode] 저장된 로그인을 삭제할 수 없을 때도 MCP 서버의 "인증 정보 지우기"가 성공으로 보고되던 문제를 고쳤습니다
[VSCode] 대기열에 있는 메시지의 훅이 실행되는 동안 스피너와 중지 버튼이 표시되지 않던 문제를 고쳤습니다
[VSCode] 삭제 등 세션 그룹 변경 사항을 저장할 수 없을 때 알림 없이 실패하던 문제를 고쳐 오류 알림이 표시되도록 했습니다
[VSCode] 계획 미리보기 탭에서 Cmd+F / Ctrl+F를 눌러도 찾기 위젯이 열리지 않던 문제를 고쳤습니다
[VSCode] 러시아어, 그리스어, 히브리어 등 라틴 문자가 아닌 키보드 배열에서 음성 받아쓰기 단축키(Ctrl+D)가 동작하지 않던 문제를 고쳤습니다
[VSCode] 채팅창 없이 확장 프로그램이 열렸을 때 기한을 놓친 일회성 예약 작업이 확인 없이 삭제되던 문제를 고쳤습니다
[VSCode] `CLAUDE_CODE_DISABLE_CFC_PROMPT` 설정 시 확장 프로그램이 세션 메시지에 Claude in Chrome 지침을 추가하는 동작도 중단하도록 변경했습니다(브라우저 도구는 계속 사용 가능)
[Cloud sessions] 완료된 일회성 작업만 숨겨져 있을 때 정렬 메뉴를 열지 않고도 표시할 수 있도록 예약된 작업 페이지에 완료 항목 포함 버튼을 추가했습니다
[Cloud sessions] 새 세션 카드의 최근 환경 목록에 최근 사용한 자체 호스팅 환경이 표시되지 않던 문제를 고쳤습니다
[Cloud sessions] Claude가 다른 작업 트리에서 푸시한 커밋으로 브랜치를 이동한 후 매 턴마다 커밋되지 않은 변경 사항이 보고되던 클라우드 세션 문제를 고쳤습니다
[Cloud sessions] 관리자 설정의 자체 호스팅 환경 세부 정보 대화 상자가 매우 낮은 창 높이나 높은 화면 배율에서 내용을 가리던 문제를 고쳐 대화 상자가 스크롤되도록 했습니다
[Cloud sessions] 실행 중인 클라우드 세션이나 원격 제어 세션에서 전환을 거부한 후에도 권한 모드 선택기가 Auto로 유지되던 문제를 고쳐, 현재 사용 중인 모드를 표시하고 안내하도록 했습니다
[Cloud sessions] 예약된 작업을 개선하여 Anthropic 클라우드에서의 실행이 claude.ai 계정에 활성화된 플러그인을 로드하도록 했습니다
[Cloud sessions] 관리자 설정의 GitHub Enterprise 연결 테스트를 개선하여 클라우드 세션과 동일한 방식으로도 연결하고 두 번째 테스트 실패 시 경고를 표시하도록 했습니다
[Cloud sessions] 클라우드 세션 트랜스크립트를 개선하여 이름 변경 행에 새 제목을 표시하고 저장소 및 환경 목록을 한 줄의 JSON 대신 표로 표시하도록 했습니다
[Cloud sessions] 웹, 데스크톱 및 모바일 앱의 클라우드 세션이 설정 스크립트의 오류 종료 시 시작 실패로 끝나지 않고 그대로 시작되도록 변경했습니다
[Remote Control] 원격 제어 세션의 권한 모드 버튼이 입력을 시작하기 전까지 잘못된 모드를 표시하던 문제를 고쳐, 컴퓨터가 온라인 상태일 때 열자마자 실제 모드를 표시하도록 했습니다
[Claude Tag] Slack이 연결된 Enterprise 조직을 위해 관리자 설정의 번들과 채널 탭에 닫을 수 있는 Claude Tag API 문서 링크를 추가했습니다
[Claude Tag] Enterprise Grid 워크스페이스 간에 공유된 채널에서 워크스페이스 확인이 한 번 실패한 후 `@Claude !restart`가 중단되던 문제를 고쳐, 재시도한 뒤 다시 실행하도록 요청하게 했습니다
[Claude Tag] 몇 분 이내에 같은 링크로 Slack에서 Claude 계정을 두 번 연결했을 때 확인 DM과 채널 안내가 중복 발송되던 문제를 고쳤습니다
[Claude Tag] Claude 세션이 자체 호스팅 러너를 기다리는 동안 Slack의 후속 메시지에 진행 상태가 표시되지 않던 문제를 고쳐 스레드에 대기 안내를 게시하도록 했습니다
[Claude Tag] 두 조직 모두 Claude를 설치한 Slack Connect 채널의 자체 스레드에서 Claude가 태그에 응답하지 않던 문제를 고쳤습니다
[Claude Tag] Claude Tag 관리자 설정의 플러그인 및 스킬 페이지에서 로드 실패 후 다시 시도 시 저장되지 않은 접근 권한 변경 사항이 사라지던 문제를 고쳐 수정한 내용이 유지되도록 했습니다
[Claude Tag] Claude Tag 관리자 설정의 저장소 컨트롤에 동일한 작업이 두 번 표시되던 문제를 고쳐 버튼에 할당되지 않은 동작만 메뉴에 표시되도록 했습니다

함께 읽기: Claude Code v2.1.308 업데이트 안정성 개선 사항 · Claude Code v2.1.307 업데이트: API 버전 관리 및 모니터링 강화

▲ 맨 위로

새로 쓸 수 있게 된 기능

이번 업데이트로 새로 쓸 수 있게 된 기능은 5가지입니다. 근거 항목은 위 릴리스 노트의 번호입니다.

기능	달라진 점	근거 항목
작업 디렉터리 외부 쓰기 제한 설정	permissions.blockWritesO	1번
게이트웨이 업스트림 IdP 그룹 라우팅	Claude apps 게이트웨이 업스트림	2번
Bedrock 가드레일 필터 로깅	Claude apps 게이트웨이의	3번
유휴 상태 대화 자동 압축	20만 토큰을 초과한 세션이 유휴 상태로	4번, 93번
완료된 일회성 예약 작업 보기	클라우드 세션의 예약 작업 목록에서 숨겨진	103번

작업 디렉터리 외부 쓰기 제한 설정(달라진 점): permissions.blockWritesOutsideWorkingDirectories 설정을 켜면 모든 권한 모드에서 Write, Edit, NotebookEdit 도구가 작업 디렉터리 바깥 경로를 수정하지 못하도록 거부합니다.

게이트웨이 업스트림 IdP 그룹 라우팅(달라진 점): Claude apps 게이트웨이 업스트림 설정에 groups 목록을 지정하여 지정된 IdP 그룹 소속 개발자만 해당 업스트림으로 라우팅되도록 제한합니다.

Bedrock 가드레일 필터 로깅(달라진 점): Claude apps 게이트웨이의 Bedrock 업스트림에 guardrail_trace 설정을 추가하여 매칭 텍스트 노출 없이 어떤 필터가 동작했는지 로그로 남깁니다.

유휴 상태 대화 자동 압축(달라진 점): 20만 토큰을 초과한 세션이 유휴 상태로 방치되고 프롬프트 캐시가 만료된 경우 대화를 자동 요약하여 다음 메시지 처리에 활용합니다.

완료된 일회성 예약 작업 보기(달라진 점): 클라우드 세션의 예약 작업 목록에서 숨겨진 완료 단일 작업을 메뉴 이동 없이 바로 확인할 수 있는 버튼을 제공합니다.

▲ 맨 위로

업데이트 효과 직접 재보기

에이전트, effort, 속도, 재시도에 관한 변경이 내 작업에서 얼마나 차이 나는지는 직접 재 보면 숫자로 확인됩니다. claude -p를 JSON 출력으로 실행하면 걸린 시간과 턴 수, 서브에이전트 결과가 함께 나옵니다.

claude -p "<작업 지시>" \
  --output-format json < /dev/null

작업 지시는 옵션보다 앞에 둡니다. --allowedTools Agent "<작업 지시>"처럼 쓰면 --allowedTools가 값을 여러 개 받는 옵션이라 작업 지시까지 도구 이름으로 읽습니다. 옵션을 뒤에 쓰려면 --allowedTools=Agent처럼 =로 붙입니다. 아무것도 보내지 않는 파이프에 표준 입력이 연결돼 있으면 3초를 기다린 뒤 경고를 띄우고 진행하는데, < /dev/null로 표준 입력을 막아 두면 이 대기가 없습니다.

duration_ms: 실행 전체에 걸린 시간(밀리초)
num_turns: 결과가 나오기까지 걸린 턴 수
subagent_stats.completed / subagent_stats.failed: 서브에이전트가 끝까지 마친 수와 실패한 수

단순 조회 작업 하나(예: 어떤 함수가 어디서 호출되는지 찾기)와 코드 수정 작업 하나(예: 함수 하나에 테스트 추가)를 정해 둡니다. 같은 저장소에서 설정마다(업데이트 전후, effort 수준별) 두 작업을 각각 여러 번 실행하고, 조회와 수정의 기록을 따로 모아 비교합니다.

아래는 Claude Code 2.1.292에서 서브에이전트 한 개를 띄운 실행의 실제 출력에서 위 네 값만 남긴 것입니다. 나머지 키는 ...로 줄였습니다.

{
  "duration_ms": 14271,
  "num_turns": 4,
  "subagent_stats": {
    "completed": 1,
    "failed": 0,
    ...
  },
  ...
}

기록표의 첫 줄은 이 실행을 옮긴 것입니다. 조회 작업과 코드 수정 작업을 나눠, 실행할 때마다 한 줄씩 더합니다.

작업	설정	시간(ms)	턴
예시	2.1.292	14271	4

작업	완료/실패
예시	1 / 0

함께 읽기: Claude Code v2.1.309 업데이트: 개발 워크플로우 지원 향상

▲ 맨 위로

업데이트 방법과 버전 확인

이 글의 변경을 모두 쓰려면 Claude Code 2.1.314 이상이 필요합니다. 터미널에서 claude update로 새 버전을 받고, claude --version으로 2.1.314 이상인지 확인합니다.

claude update
claude --version

▲ 맨 위로

글쓴이 MinoSui · 블로그 운영자·편집 책임

편집 방침. 오류 제보는 문의로 받습니다. 글쓴이·블로그 소개

출처

Claude Code v2.1.314 릴리스 노트 · github.com

#IT·AI#클로드AI#ClaudeCode

작성일 2026-10-30 12:30

이 블로그 검색

미노쓰의 글log