무엇이 바뀌었나?
Claude Code 2.1.304가 2026년 10월 19일 출시됐습니다. auto mode 안내 설정, Managed Agents 보안 점검, 대화 재개 시 사용량 경고가 추가됐고, mod(세션 안에서 Claude가 만드는 인터페이스, 동작 확장)의 권한 판단과 설정 훅이 확장됐습니다. 수정은 worktree와 파일 삭제 안전장치, 압축과 컨텍스트, 서브에이전트, 훅과 스킬, 샌드박스와 Bash, LLM 게이트웨이, Remote Control, 클라우드 세션, VS Code 확장, Code Review에 걸쳐 있습니다. 변경 항목이 많아 아래에는 사용자 영향이 큰 항목을 골라 정리했습니다.
새 기능
-
/auto-mode-setupauto mode(도구 호출을 허용할지 분류기가 자동으로 판단하는 권한 모드)는 사용자의 프로젝트나 작업 환경을 모른 채 판단했습니다. 이제
/auto-mode-setup이 프로젝트와 최근 세션을 읽고 단계별로 안내하며 auto mode에 환경을 알려 줍니다. Bedrock, Vertex, Foundry, Claude apps gateway, telemetry를 끈 세션에서도 쓸 수 있습니다. -
/claude-api managed-agents-secureManaged Agents 에이전트의 설정이 Anthropic이 공개한 보안 가이드에 맞는지 직접 하나하나 대조해야 했습니다. 이제 이 명령이 에이전트 설정을 보안 가이드와 비교해 보여 줍니다. 설정은 바꾸지 않습니다.
-
오래 쉰 대화를 재개할 때의 사용량 경고 (Pro, Max)
한동안 쉰 대화를 재개하면 미리 알 방법 없이 5시간 사용 한도의 상당 부분을 쓸 수 있었습니다. 이제 Pro, Max 플랜에서는 재개가 사용 한도를 눈에 띄게 쓸 때 경고가 나오고, 그대로 재개하거나 새 대화를 시작할 수 있습니다. 새 대화에서 이전 대화를 언급하면 Claude가 찾아볼 수 있습니다.
-
압축 요약에 이전 도구 이름 표시
transcript 화면(Ctrl+O)의 압축 요약만 보고는 압축 전에 어떤 도구를 썼는지 알 수 없었습니다. 이제 요약에 앞서 호출한 도구 이름이 함께 표시됩니다.
-
mod의 권한 판단 확장
mod의
tool.check응답에decider: "person"을 넣으면 권한 대화상자나 호스트의 콜백만 승인할 수 있고, 물어볼 사람이 없는 환경에서는 mod가 적은 이유와 함께 거부됩니다.tool.check이벤트에는 읽기 전용 도구 호출인지 알려 주는e.isReadOnly가 추가됐습니다. 먼저 실행되는 플러그인이 mod의 훅을 건너뛰면 transcript에 해당 이벤트와 플러그인 이름이 한 줄로 남습니다. -
[Code Review] 리뷰 수준과 조직 전체 리뷰
Owner가 조직의 리뷰 수준을 Quick, Standard(기본값), Deep 중에서 고르고, 저장소마다 다른 수준을 줄 수 있습니다. 관리자 설정에서 GitHub 조직의 모든 저장소를, 나중에 추가되는 저장소까지 하나씩 고르지 않고 리뷰하도록 지정할 수도 있습니다.
주요 개선
-
서브에이전트를 여러 개 동시에 돌릴 때의 반응 속도
서브에이전트를 동시에 많이 실행하면 응답이 느려졌습니다. 이번 버전에서 반응 속도와 처리량이 개선됐습니다.
-
긴 대화, 큰 세션의 메모리와 재개 속도
길거나 재개한 대화에서 요청을 보낼 때 메모리 사용이 줄었고, SDK와 headless 모드에서 크게 압축된 세션을 재개하면 첫 요청이 더 빨리 나갑니다. auto mode에서는 안전 분류기의 컨텍스트를 요청마다 저장하지 않아 세션 파일이 작아집니다.
-
클라우드 세션의 첫 턴
claude.ai에서 동기화한 플러그인의 로컬(stdio) MCP 서버가 준비될 때까지 새 대화의 첫 턴이 기다렸습니다. 이제 서버가
alwaysLoad: true를 설정하지 않았다면 기다리지 않습니다. -
더 정확한 안내 메시지
/usage는 사용량 데이터 조회 제한에 걸리면 “try again in a moment” 대신 제한이 끝나는 시점을 알려 줍니다.claude -p의 잘못된 설정 경고는 불러오지 못한 파일에 대해 원인만 보여 주고, 긴 목록은 파일마다 줄여 보여 줍니다. self-hosted runner에서 git 호스트가 저장소를 “not found”로 답하면 저장소 이름과 문의할 대상을 알려 줍니다. -
[Windows] git 명령 시작 속도
표준 Git for Windows 설치에서는 cmd 실행기를 거쳐 git을 실행했습니다. 이제 git.exe를 직접 실행해 시작이 빨라집니다.
동작이 바뀐 항목
-
LLM 게이트웨이에서 tool search 기본 활성화 (변경)
사용자 지정
ANTHROPIC_BASE_URL뒤에서도 tool search가 기본으로 켜집니다. 게이트웨이가 400이나 422로 답하면 tool search 없이 다시 요청합니다. -
압축 뒤 스킬 목록 재전송 (변경)
압축이 끝나면 스킬 목록을 Claude에게 다시 보냅니다.
/reload-skills는 새로 생기거나 바뀐 스킬만 보냅니다. -
스킬 훅 등록 상한 (변경)
한 출처(저장소, 사용자 폴더, 플러그인 하나)의 스킬은 세션당 최대 1,024개의 훅과 16,384자의 matcher만 등록할 수 있습니다. 플러그인 훅만 허용하는 정책에서 훅이 막힌 스킬을 메인 대화에서 쓰면 그 스킬의
allowed-tools도 적용되지 않습니다. -
mod의
settings.read훅 (변경)settings.read훅이 설정 계층을 하나씩 받아 병합된 설정을 다시 쓸 수 있습니다. 관리형 mod가 조직 설정을 상한으로 정할 수 있고, 보존 기간 정리에 쓰이는cleanupPeriodDays도 포함됩니다. -
확인 질문의 표시 방식 (변경)
/artifacts의 삭제 확인은 번호 선택지로 바뀌었습니다. 1이나 Enter는 아티팩트를 남기고, 2는 삭제하며, y, n, Esc도 그대로 동작합니다. 세션에서 Claude가 만든 mod를 켜는 질문은 링크나 세션 ID 없는 일반 텍스트로 바뀌었고, 새 턴이 시작돼도 남아 있으며, 켜고 나면 무엇이 불러와졌는지 알려 줍니다. -
[VSCode] 백그라운드 서브에이전트 표시 (변경)
백그라운드 서브에이전트의 모든 단계가 채팅에 흘러나왔습니다. 이제 Agent 카드 아래 상태 한 줄로 표시되고, 전체 기록은 /tasks에서 볼 수 있습니다.
-
기타 (변경)
/claude-api 스킬은 Claude Platform on AWS에서 SDK나 curl 대신
antCLI를 씁니다. Opus 5.5의/fast대화상자 제목에서 “(research preview)” 표시가 빠졌습니다.
주요 버그 수정
데이터 손실과 안전장치
- HEAD가 분리됐거나 다른 브랜치에 있을 때
claude --worktree가 종료하며 묻지 않고 worktree와 브랜치를 지워 커밋을 잃을 수 있던 문제 수정. - 마운트된 드라이브나 최상위 폴더(
/Volumes,/media, WSL의/mnt/c)를rm -r로 지울 때,rm -rf /Applications에는 나오는 안전 확인이 나오지 않던 문제 수정. - 파일을 줄이는 도중 디스크가 가득 차면
CLAUDE_CODE_TRANSCRIPT_LOCAL_GC가 저장된 transcript에서 메시지를 잃던 문제 수정. - 큰 명령 결과 파일을 세션의 tool-results 폴더로 복사하지 못하면 Bash, PowerShell이 그 파일을 지우던 문제 수정. 디스크가 가득 찬 경우는 예외입니다.
압축과 컨텍스트
- API가 너무 길다고 거절한 대화를 압축하는 도중 턴을 멈추면 “Context limit reached”나 “Prompt is too long” 오류가 나던 문제 수정.
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200k가 아무 안내 없이 100K 창으로 설정되던 문제 수정. 이제--autocompact처럼k,M접미사를 받고, 범위를 벗어나거나 무시된 값은 경고합니다.- 자체 속도 조절
/loop에서 최대값인 1시간 뒤로 예약한 깨우기가 1시간 prompt cache(이미 처리한 프롬프트를 재사용해 비용과 시간을 줄이는 기능)가 만료된 직후 실행돼, 대화를 캐시 없이 다시 읽던 문제 수정. - 재개한 세션과 클라우드 세션에서 시작 중 플러그인을 다시 불러올 때마다 전체 스킬 목록을 Claude에게 다시 보내던 문제 수정.
서브에이전트와 에이전트 팀
- 작업을 막 끝낸 서브에이전트에 메시지를 보내거나 재개하면 가장 최근 작업을 잊어버리던 문제 수정.
- 플러그인이 서브에이전트를 띄우거나 끝난 서브에이전트를 다시 실행해 headless 실행이
--max-turns, Stop, 입력 종료를 넘어 계속되던 문제 수정. - 에이전트 팀에서 메인 세션이 종료 요청을 승인하면 CLI 전체가 종료되던 문제 수정.
훅, 스킬, mod
- 같은 도구 호출에 걸린 Agent SDK 콜백 훅이 시간 초과되면 PreToolUse 훅의 거부 이유가 시간 초과 오류로 바뀌던 문제 수정.
- 한 스킬의
once훅이 실행된 뒤 다른 스킬의 같은 훅까지 지워지던 문제 수정. - mod 다시 불러오기에 실패하면 계속 남아 있는 이전 버전의 도구와 명령까지 사라지고, 이전 버전이 남아 있는지 메시지가 틀리거나 아무 말이 없던 문제 수정.
key없이 같은 이름을 가진 mod 버튼이 그대로 다시 그려질 때 클릭이 사라지던 문제 수정.- 관리형 설정이 있는 기기, Team, Enterprise 플랜에서 내장
plugin-authoring스킬의 mod 공유가 비밀 정보 검사 단계에서 멈추던 문제 수정.
샌드박스, Bash, 도구
- Linux에서
sandbox.filesystem.denyReadglob에 문자 클래스가 아닌 대괄호(예:[user-id]라우트 폴더)가 있으면 샌드박스 명령이 시작되지 않던 문제 수정. - macOS, Linux의 Claude Desktop Code 탭에서 샌드박스 밖 Bash 명령이
~/.zshrc같은 셸 시작 파일에서 내보낸 환경 변수를 보지 못하던 문제 수정. - 이미지처럼 이름 붙은 유휴 파이프나 장치를 기다리는 Read를 중단으로 끝낼 수 없던 문제 수정.
- Write 결과와 거절된 편집에서 작업 디렉터리 밖의 파일이
../../…로 표시되던 문제 수정. 이제~/…나 전체 경로로 표시됩니다.
인증, 정책, 게이트웨이
- LLM 게이트웨이 뒤에서
context_management: Extra inputs are not permitted오류가 나던 문제 수정. 이제 그 필드를 빼고 다시 요청합니다. - 시작 시
ANTHROPIC_API_KEY를 승인하거나/config에서 “Use custom API key”를 바꾼 뒤 조직 정책이 1시간마다 하는 확인 전까지 갱신되지 않던 문제 수정. - 최초 설정이나 /logout 후 첫 시작에서 로그인하면 서버 관리 설정으로 받은 OpenTelemetry 설정이 세션 내내 무시되던 문제 수정.
- 서버 오류 뒤 Consumer Terms 안내가 하루 이상 건너뛰어지던 문제, 네트워크나 서버 오류 뒤
/privacy-settings가 해당하지 않을 수 있는 선택지를 보여 주던 문제 수정.
터미널 표시와 명령
CLAUDE_CODE_EFFORT_LEVEL이auto나unset이고 보낸 수준이 없을 때/effort status,/effort ultracode, 프롬프트의 effort 표시가 추측한 수준을 보여 주던 문제 수정.- 약 100열보다 좁은 터미널에서 미리보기가 있는 객관식 질문에 입력한 메모가 ”…”로 잘려 입력 내용이 보이지 않던 문제 수정 (#82768).
- transcript 모드의
{,}가 transcript 첫 행 대신 일정하지 않은 행이나 화면 밖으로 이동하던 문제, agents 화면에서 마우스 버튼을 떼기 전에 Ctrl+C를 누르면 선택한 텍스트를 복사하지 않고 지우던 문제 수정. claude --help의--tools,--resume,--debug,--json-schema,--disable-slash-commands,--system-prompt-snapshot,claude update설명이 실제 동작과 다르던 문제 수정.
Remote Control, SDK, 클라우드 세션
- 터미널에 다른 계정으로 로그인돼 있으면 Remote Control이 데스크톱 대화의 기록을 계속 보내지 않던 문제 수정.
- 유료 플랜에서 DISABLE_TELEMETRY나 DO_NOT_TRACK을 설정하면 Claude Desktop에서 Remote Control이 시작되지 않던 문제 수정.
- SDK와 데스크톱 세션에서 모델 전환, 메시지, 중단이 컨텍스트 사용량 확인 뒤에서 기다리던 문제 수정.
- 예약된 Cowork 클라우드 세션에서 WebFetch에 URL 승인이 필요한 서브에이전트마다, 승인할 사람이 없는데도 다시 5분씩 기다리던 문제 수정.
- Cowork 클라우드 세션의 ”/” 메뉴에서 claude.ai Directory 플러그인의 스킬을 골라도 명령으로 실행되지 않던 문제, 클라우드 세션의 @ 목록에서 폴더 이름이 비어 있어 고르면 멘션 대신 공백만 들어가던 문제 수정.
VSCode
- SessionStart 명령 훅이 실행되는 시간이 시작 제한 시간에 포함돼 “Subprocess initialization did not complete within 60000ms”로 세션이 시작되지 않던 원인 하나 수정. 이제 훅 실행 시간은 총 10분까지 제한 시간에 들어가지 않습니다.
- 시작 중에 닫은 세션의 Claude Code 프로세스가 시작이 끝날 때까지 남아 있던 문제 수정.
- 오래된 Claude Code도 함께 실행되는 기기에서 오래 열어 둔 패널의 mod 그림이 다음 턴까지 사라지던 문제 수정.
claudeCode.claudeProcessWrapper를 설정하면 Past conversations에서 세션이 숨겨지던 문제 수정.
Amazon Bedrock, Google Vertex AI, Microsoft Foundry 세션, LLM 게이트웨이 뒤의 세션, telemetry를 끈 세션에서도 채팅 패널에 mod를 그릴 수 있게 됐습니다.
Claude Tag (Slack), Code Review
- 작업 도중 채널이 Enterprise Grid 워크스페이스 사이에 공유되면 Claude가 스레드에서 응답하지 않던 문제 수정. 이제 새 스레드에서 @-멘션하라는 안내를 한 번 남깁니다.
- 스레드 밖에서
@Claude !fork를 입력하면 보이는 응답이 없던 문제 수정. 이제 스레드 안에서 실행하라는 개인 메모를 보여 줍니다. - [Code Review] 관리자가 Code Review를 켠 뒤 1-2분 안에 열린 pull request가 아무 안내 없이 건너뛰어지던 문제 수정. 이제 다시 시도해 리뷰합니다.
알아두면 좋은 점
claude --worktree를 쓴다면 이전 버전에서는 HEAD가 분리됐거나 다른 브랜치에 있을 때 종료하며 worktree와 브랜치가 묻지 않고 지워질 수 있었습니다. 업데이트를 권장합니다.CLAUDE_CODE_AUTO_COMPACT_WINDOW에200k처럼 접미사를 넣어 지정했다면 이전 버전에서는 100K로 설정됐습니다. 이번 버전부터k,M접미사가 의도대로 적용됩니다.- 사용자 지정
ANTHROPIC_BASE_URL(LLM 게이트웨이)을 쓴다면 tool search가 기본으로 켜집니다. 게이트웨이가 400이나 422로 답하면 tool search 없이 다시 요청합니다. - 스킬에 훅을 많이 등록한다면 한 출처당 세션마다 1,024개의 훅과 16,384자의 matcher가 상한입니다.
- auto mode를 쓴다면
/auto-mode-setup으로 프로젝트와 작업 환경을 auto mode에 알려 줄 수 있습니다.