무엇이 바뀌었나?
Claude Code 2.1.314가 2026년 10월 30일 출시됐습니다. 작업 디렉터리 밖 쓰기를 막는 권한 설정, Claude apps gateway의 그룹별 업스트림 지정, VS Code와 Claude Desktop의 유휴 압축이 새로 들어왔습니다. 수정은 effort 제한, Bedrock과 Foundry 같은 클라우드 제공자, TLS 인증서, MCP 로그인, 관리 설정, 샌드박스와 훅, vim 모드, VS Code 확장, 클라우드 세션, Claude Tag에 걸쳐 100건이 넘습니다.
새 기능
-
permissions.blockWritesOutsideWorkingDirectories권한 모드에 따라서는 Claude가 작업 디렉터리 밖의 파일을 쓰거나 고칠 수 있었습니다. 이 설정을 켜면 Write, Edit, NotebookEdit 도구가 어떤 권한 모드에서든 작업 디렉터리 밖 경로를 거부합니다.
-
Claude apps gateway 업스트림의
groups목록업스트림(요청을 실제로 보낼 모델 제공자)마다 쓸 수 있는 사람을 나눌 방법이 없었습니다. 이제 업스트림에 선택 항목인
groups목록을 넣으면, IdP(사내 로그인 시스템)의 해당 그룹에 속한 개발자만 그 업스트림으로 보냅니다. 장애 조치(failover) 때도 같은 규칙이 적용됩니다. -
Bedrock 업스트림의
guardrail_traceClaude apps gateway의 Bedrock 업스트림에서 요청이 차단되면 어떤 Amazon Bedrock guardrail 필터 때문인지 알기 어려웠습니다.
guardrail_trace를 켜면 어떤 필터가 작동했는지 기록합니다. 걸린 텍스트 자체는 기록하지 않습니다. -
VS Code와 Claude Desktop Code 탭의 유휴 압축(idle compaction)
20만 토큰이 넘는 대화를 오래 두었다가 다시 이어 가면, 프롬프트 캐시가 만료돼 긴 대화 전체를 다시 처리해야 했습니다. 이제 유휴 상태인 긴 대화를 미리 요약해 두고, 다음 메시지를 보낼 때 프롬프트 캐시가 만료됐다면 그 요약을 사용합니다.
-
[Cloud sessions] 예약 작업의 Include completed 버튼
Scheduled tasks 페이지에서 완료된 일회성 작업만 숨겨져 있을 때, Sort 메뉴를 열지 않고도 Include completed 버튼으로 바로 보이게 할 수 있습니다.
주요 개선
-
서브에이전트가 많은 긴 턴의 메모리 사용량 감소
headless 실행이나 SDK에서 서브에이전트를 많이 띄우는 긴 턴은, 부모 세션이 턴이 끝날 때까지 각 서브에이전트의 도구 결과를 모두 들고 있어 메모리를 많이 썼습니다. 이제 부모 세션이 이 결과를 보관하지 않습니다.
-
auto 모드 차단 메시지와
/permissionsRecently blocked 탭auto 모드에서 호출이 막히면 무엇이 왜 막혔고 다음에 무슨 일이 일어나는지 알기 어려웠습니다. 이제 메시지에 명령 이름이 나오고, Claude가 다시 시도할 수 있으며 그때 auto 모드가 다시 검사한다고 알려 주고,
/permissions에서 검토하라고 안내합니다./permissions의 검토 탭은 Recently blocked로 이름이 바뀌었고, 하단에 표시한 항목을 Esc로 어떻게 처리하는지 보여 줍니다. 터미널이 짧아 전체를 볼 수 없는 호출은 이 탭에서 승인할 수 없게 바뀌었습니다. -
권한 확인 창의 긴 이유 표시
이유가 길면 확인 창에서 줄을 많이 차지해, 정작 승인할 명령이 화면 밖으로 밀려났습니다. 이제 이유가 더 적은 줄을 차지합니다.
-
Ctrl+R 기록 검색이 붙여 넣은 텍스트까지 검색
[Pasted text]로 접혀 있는 붙여 넣은 텍스트는 Ctrl+R 프롬프트 기록 검색에 걸리지 않았습니다. 이제 접힌 내용 안의 텍스트도 찾습니다. -
스킬이나 명령으로 시작한 세션의 자동 제목
스킬이나
/security-review같은 프롬프트 기반 명령으로 시작한 세션은 제목 없이 남았습니다. 이제 그 스킬이나 명령으로 제목을 만듭니다. -
--resume과/context속도손상된 대화 기록을
--resume으로 열 때의 속도와 메모리 사용량, MCP 도구가 1만 개 이상인 세션의/context속도가 개선됐습니다. -
/design-sync업로드 확인 창업로드 전에 어느 폴더와 프로젝트에서 어떤 파일을 올리거나 지우는지 보여 줍니다.
-
번들 스킬 갱신
/claude-api스킬의 API 추적용 Datadog 설정이 Console과 같이dd-llmobs-enabled: true헤더를 보내고,ant설치 안내에서 오래된 macOSxattr단계가 빠졌습니다. dataviz 스킬은 도넛과 파이 차트 요청에 순위 막대나 값을 표시하는 구간 막대로 답하도록 바뀌었습니다. -
Bash 도구의
which사용자 셸에서 물려받은
which별칭이나 함수 때문에which가 예상과 다르게 동작할 수 있었습니다. 이제 Bash 도구의 셸은 이를 지우고, 내보낸which,unsetenv함수를 명령에 넘기지 않아which가 시스템 명령이나 zsh 내장 명령으로 동작합니다. -
Monitor 도구와 훅
Bash에 매칭되는 훅이 Monitor 도구가 시작한 셸 명령에는 실행되지 않았습니다. 이제 실행되며, 이런 명령을 차단하거나 확인을 요청할 수는 있지만 승인하거나 고쳐 쓸 수는 없습니다. 훅의
if조건도Monitor(tail *)처럼 쓰면Bash(tail *)와 같은 방식으로 Monitor의 셸 명령에 매칭됩니다. -
오래된 Opus 모델만 남은 경우 다른 모델로 재시도
ANTHROPIC_DEFAULT_OPUS_MODEL,availableModels,deniedModels설정 때문에 오래된 Opus 모델만 남거나 아예 남지 않으면, 거부 대상으로 표시(flagged)된 요청이 거부로 끝났습니다. 이제 다른 모델로 다시 시도합니다. -
유휴 압축 적용 범위 확대
유휴 압축이 원격 측정(telemetry)을 끈 구독자에게도 적용되고, Bedrock, Vertex, Foundry, LLM gateway에서는 1시간 프롬프트 캐시를 켠 경우 적용됩니다.
-
조직의 서버 관리 설정 파일 편집 전 확인
Claude의 파일 도구가 조직의 서버 관리 설정(server-managed settings) 로컬 사본을 고칠 때도, 사용자 설정 파일과 마찬가지로 먼저 확인을 요청합니다.
-
[Cloud sessions] 설정 스크립트가 실패해도 세션 시작
웹, 데스크톱, 모바일 앱에서 시작한 클라우드 세션은 설정 스크립트가 오류로 끝나면 아예 시작하지 못했습니다. 이제 오류가 나도 세션이 시작됩니다. Anthropic 클라우드에서 실행되는 예약 작업은 claude.ai 계정에서 켠 플러그인을 불러옵니다.
주요 버그 수정
effort와 모델
- 조직 관리자가 모델의 effort 상한을 정해 두면 세션이 매 턴 “Invalid effort level”로 실패하던 문제 수정. 이제 effort를 낮춰 다시 시도하고, 어떤 수준을 쓰는지 알려 줍니다.
- LLM gateway에서
claude-opus-4.8처럼 점(.)으로 쓴 모델 ID가 오래된 모델로 취급되던 문제 수정. 이 때문에 컨텍스트 창, 출력 한도, effort, thinking 모드, 비용이 잘못 적용됐습니다. - Microsoft Foundry 리소스에 기본 Sonnet, Opus, Haiku 모델의 배포가 없으면 세션이 실패하던 문제 수정. 이제 같은 계열의 이전 모델로 대체합니다.
- 관리 설정이 모델을 고정했는데도 Bedrock과 Vertex의 모델 업그레이드 제안이 시작할 때마다 다시 나오던 문제 수정.
- 관리 플러그인 설정이 있는 컴퓨터에서
--plugin-dir,--plugin-url로 불러온 내 플러그인 중 하나가 깨져 있으면 모델 전환이 거부되던 문제 수정.
클라우드 제공자와 네트워크
- 이미지가 많은 Bedrock 세션이 매 턴과
/compact에서 “400 Input is too long.”으로 실패하던 문제 수정. 이제 오래된 이미지를 빼고 압축합니다. - gateway나 클라우드 제공자가 Claude Code의 beta 헤더 하나를 이름으로 거부하면 요청이 실패하던 문제 수정. 이제 그 헤더를 빼고 다시 보냅니다.
- tool search의
tool_reference블록을 받지 않는 gateway 뒤에서 요청이 계속 거부되던 문제 수정. 이제 tool search 없이 한 번 다시 보내고, 세션이 이를 기억합니다. - 시스템 인증서 저장소에 이전 인증서와 교차 서명된 갱신 루트 인증서가 있으면 TLS 연결이
UNABLE_TO_GET_ISSUER_CERT로 실패하던 문제 수정. - Claude apps gateway의 Vertex 업스트림이 응답하지 않는 Google 토큰 엔드포인트 때문에 몇 분씩 멈추던 문제 수정.
관리 설정과 보안
- 원격 관리 설정에만 둔
forceRemoteSettingsRefresh가 저장된 사본이 만료된 뒤 적용되지 않던 문제 수정. 이 때문에 서버에 연결할 수 없으면 정책 없이 세션이 시작될 수 있었습니다. - 관리 설정에 둔 관리자의 TLS 신뢰 설정이 Claude Desktop 세션에 적용되지 않던 문제 수정.
--setting-sources로 제외한 설정 파일이 auto 모드 규칙, 저장된 권한 동의 같은 일부 설정을 여전히 제공하던 문제 수정.claude -p --resume이나--continue로 들어간 worktree(별도 작업 폴더)에 샌드박스 보호가 적용되지 않던 문제 수정.- 터미널이 있는 CI 작업에서
claude ultrareview,claude remote-control이 작업 공간 신뢰 질문을 하던 문제 수정.CI가 설정돼 있으면 신뢰하지 않은 폴더를 바로 거부합니다./ultrareview도 git을 실행하기 전에 작업 공간 신뢰를 확인합니다. - auto 모드의 안전 검사가 판단을 내리지 못했을 때 호출을 차단된 것으로 보고하고
/permissions에 올리던 문제 수정.
MCP와 로그인
- 로그인 없이도 동작하는 MCP 서버가 저장된 로그인이 만료된 뒤 “needs authentication”으로 표시되던 문제 수정. 이제 로그아웃 상태로 사용합니다.
- SSH로 접속해 macOS 키체인이 잠겨 있을 때처럼 MCP 로그인이 지워지지 않았는데도
claude mcp logout이 성공을 보고하던 문제 수정. - 여러 세션이 같은 Anthropic 프로필 로그인을 공유하고 자격 증명 잠금이 사용 중일 때 로그인 갱신이 불필요하게 반복되던 문제 수정.
- App Store나 Google Play로 결제한 요금제에서
/upgrade가 브라우저를 열고 새 로그인을 시작하던 문제 수정. 이제 요금제를 바꿀 수 있는 곳을 알려 줍니다.
헤드리스 실행과 자동화
- 시작에 실패한
claude -p가 아무것도 출력하지 않고 종료 코드 0으로 끝나던 문제 수정. 이제 오류를 출력하고 종료 코드 1로 끝납니다. - 작업이 대기 사이에 스스로 다시 시작되면(/goal 확인, 백그라운드나 예약 작업) “Continue automatically at usage limit”이 사용자 입력 없이 세 번 넘게 이어지던 문제 수정.
- 꺼 둔 Ultracode가 백그라운드 세션과 클라우드 세션을 다음에 시작할 때 다시 켜지던 문제 수정.
- 출력이 아주 큰 PreCompact 훅 때문에 압축이 실패하거나 반복되던 문제 수정. 이제 각 훅의 출력을 10,000자에서 자릅니다.
- 백그라운드 diff 갱신이 저장소의 index 잠금을 잠깐 잡아, 같은 순간 실행한 git 명령이 “Unable to create ‘.git/index.lock’: File exists”로 실패할 수 있던 문제 수정.
화면과 입력
- 스트리밍 중 마크다운 표가 덜 입력된 행에서 격자와 세로 배치 사이를 오가고, 긴 표가 원래
|기호로 보이던 문제 수정. - 슬래시 명령만 실행한 세션의 제목으로
/resume목록에 CLAUDE.md나 CLAUDE.local.md 내용이 나오던 문제 수정. - SSH로 Linux 컴퓨터에 이미지를 붙여 넣으면 아무 안내 없이 무시되던 문제 수정. 이제 파일을 복사한 뒤 경로를 붙여 넣으라고 안내합니다.
- 클라우드 세션이나 IDE에서 Esc 또는 Stop으로 멈춘 명령에 대해 Claude가 거절됐다는 사실만 전달받던 문제 수정. 이제 명령이 이미 실행됐을 수 있다는 점도 전달됩니다.
- vim 모드의
dw,dW,yw,yW가 줄 끝을 넘어 계속 동작하던 문제 수정.w,W는 빈 줄에서 멈춥니다.aw,iw가 줄 끝의 줄바꿈까지 잡던 문제, 문자 선택 위의p가 줄 단위 복사 여부를 무시하던 문제도 수정됐습니다. - Claude의 질문 대화 상자에서 “Other” 행에 포커스가 없으면 붙여 넣은 텍스트와 끌어온 파일이 사라지던 문제 수정.
스킬과 파일 정리
~/.claude/skills/.trash와~/.claude/plugins/.trash가 끝없이 커지던 문제 수정. 이제cleanupPeriodDays설정과 관계없이 각각 약 1024개 항목까지만 보관합니다. 스킬 파일 감시가.trash에 있는 삭제된 스킬까지 확인하던 문제도 수정됐습니다.- git 줄바꿈 변환을 쓰는 CRLF 파일을 바꾸지 않고 다시 저장하거나 한 줄만 고쳐도 Bash 편집 diff가 파일 전체를 바뀐 것으로 표시하던 문제 수정.
VS Code 확장
- MCP 서버의 “Clear authentication”이 저장된 로그인을 지우지 못했는데도 성공을 보고하던 문제 수정.
- 러시아어, 그리스어, 히브리어처럼 라틴 문자가 아닌 키보드 배열에서 음성 받아쓰기 단축키(Ctrl+D)가 동작하지 않던 문제 수정.
- 확장이 채팅 없이 열렸을 때 놓친 일회성 예약 작업이 묻지 않고 삭제되던 문제 수정.
- 삭제처럼 저장할 수 없는 세션 그룹 변경이 아무 안내 없이 실패하던 문제 수정. 이제 오류 알림이 나옵니다.
Cloud sessions와 Remote Control
- 세션 서비스가 잠깐 느려지면
claude remote-control세션이 시작되지 않던 문제 수정. 이제 대기 시간을 늘려 가며 등록을 다시 시도합니다. - 실행 중인 클라우드 세션이나 Remote Control 세션이 모드 전환을 거부해도 권한 모드 선택기가 Auto로 남던 문제 수정. 이제 실제 모드를 보여 주고 알려 줍니다.
- Cowork 클라우드 세션의 WebFetch가 PDF의 100,000자 이후 텍스트를 아무 안내 없이 버리던 문제 수정. 이제 읽지 않은 분량과 이어서 읽을 위치를 알려 줍니다.
- 다른 worktree에서 push한 커밋으로 Claude가 브랜치를 옮긴 뒤 클라우드 세션이 매 턴 커밋하지 않은 변경이 있다고 보고하던 문제 수정.
Claude Tag
- Enterprise Grid 워크스페이스 간 공유 채널에서
@Claude !restart가 워크스페이스 확인 한 번 실패로 포기하던 문제 수정. 이제 다시 시도하고, 그래도 안 되면 다시 실행하라고 안내합니다. - Claude 세션이 셀프 호스팅 러너를 기다리는 동안 Slack 후속 메시지에 진행 표시가 없던 문제 수정. 이제 스레드에 대기 안내를 올립니다.
- 양쪽 조직 모두 Claude를 설치한 Slack Connect 채널에서 Claude가 자기 스레드의 태그에 가끔 답하지 않던 문제 수정.
알아두면 좋은 점
- Claude가 작업 디렉터리 밖 파일을 고치지 못하게 하려면
permissions.blockWritesOutsideWorkingDirectories를 켜세요. 권한 모드와 관계없이 Write, Edit, NotebookEdit가 작업 디렉터리 밖 경로를 거부합니다. FORCE_HYPERLINK=false를 쓰고 있었다면 동작이 바뀝니다. 지금까지는false(그리고no,off)가 오히려 하이퍼링크를 켰지만, 이제 끕니다.- Cowork 클라우드 세션에서 훅으로 MCP 도구 호출을 허용하고 있었다면 이제 그 허용은 응답 없음으로 취급되고, 분류기나 권한 확인 창이 결정합니다.
- VS Code에서
CLAUDE_CODE_DISABLE_CFC_PROMPT를 쓴다면 이제 확장이 세션 메시지에 Claude in Chrome 안내를 넣지 않습니다. 브라우저 도구는 계속 사용할 수 있습니다. - macOS에서는 Claude가 실행하는 대부분의 명령에서
git grep이 C 로캘로 실행됩니다. UTF-8이 아닌 파일에서 macOS 정규식 라이브러리의 메모리 누수가 보고돼 바뀐 것입니다. - 이 글은 주요 항목만 정리했습니다. 전체 변경 목록은 GitHub 릴리스 노트에서 볼 수 있습니다.