무엇이 바뀌었나?
Claude Code 2.1.302가 2026년 10월 16일 출시됐습니다. auto mode 분류기 모델 선택, 유휴 압축 끄기, 클라우드 routine 안내 배너가 추가됐고, fork 서브에이전트와 서브에이전트 실행 방식이 터미널과 다른 환경 사이에서 통일됐습니다. 수정은 압축과 prompt cache, 모델 제공자 전환, Read와 PowerShell 도구, 플러그인 설정, MCP, OpenTelemetry, 터미널 표시, 클라우드 세션, Slack의 Claude Tag, VS Code 확장에 걸쳐 있습니다. 변경 항목이 많아 아래에는 사용자 영향이 큰 항목을 골라 정리했습니다.
새 기능
-
auto mode 분류기 모델 선택 (
CLAUDE_CODE_AUTO_MODE_MODEL)auto mode(도구 호출을 허용할지 분류기가 자동으로 판단하는 권한 모드)에서 클라이언트 측 분류기가 어떤 모델을 쓸지 사용자가 정할 수 없었습니다. 이제
CLAUDE_CODE_AUTO_MODE_MODEL로 지정할 수 있습니다. 서버 측 auto mode가 쓰는 모델은 이 변수로 바뀌지 않습니다. -
/config의Idle compaction설정대화를 한동안 쉬면 자동으로 압축하는 유휴 압축을 끄는 방법이 바로 보이지 않았습니다. 이제
/config에Idle compaction행이 생겨 끄거나 다시 켤 수 있고, 유휴 압축 뒤에 나오는 안내에도 끄는 방법이 적혀 있습니다. -
단독 Claude Design 종료 안내
/design-sync와/design-login에 단독 Claude Design(claude.ai/design)이 2026년 12월 14일까지 종료된다는 안내가 추가됐습니다. -
[클라우드 세션] routine이 시작되지 않은 이유 배너
routine(예약 실행되는 클라우드 작업)의 마지막 실행이 시작되지 않으면 이유를 알기 어려웠습니다. 이제 routine 페이지에 조직의 동시 클라우드 세션 한도 도달처럼 실행되지 않은 이유를 알려 주는 배너가 표시됩니다.
주요 개선
-
플러그인이 많을 때의 시작 속도
플러그인을 많이 켜 두면 플러그인의 명령, 에이전트 파일을 불러오느라 시작이 느렸습니다. 이제 파일 시스템 호출이 크게 줄어 시작이 빨라졌고, Windows에서 효과가 가장 큽니다.
-
서버 측 분류기를 쓰는 auto mode의 긴 대화 처리
대화가 너무 길어 안전 검사에 넣을 수 없으면, 검사 대상인 도구 호출이 모두 거부됐습니다. 이제 이런 대화는 압축한 뒤 검사합니다.
-
더 정확한 오류 메시지
다른 폴더에서 다시 연 백그라운드 세션에 LLM 게이트웨이가 없으면 “Not logged in”만 표시됐는데, 이제 원인을 알려 줍니다. 클라우드 세션 시작에 실패했을 때도 “Something went wrong” 대신 “Connection lost”나 “Server error”로 구분해 보여 줍니다.
동작이 바뀐 항목
-
fork 서브에이전트 기본 활성화 (변경)
fork 서브에이전트(
subagent_type: "fork")는 터미널에서만 기본으로 켜져 있었습니다. 이제claude -p, Agent SDK, 데스크톱 앱, VS Code에서도 기본으로 켜집니다. 끄려면CLAUDE_CODE_FORK_SUBAGENT=0을 설정하며,claude mcp serve에서는 제공되지 않습니다. -
데스크톱 앱, VS Code의 서브에이전트 실행 방식 (변경)
데스크톱 앱과 VS Code에서는 메인 대화의 서브에이전트를 백그라운드로 돌릴지 Claude가 정했습니다. 이제 터미널처럼 항상 백그라운드로 실행합니다. 반대로
claude -p, Agent SDK, 데스크톱 앱, VS Code에서 서브에이전트가 스스로 호출한 Agent는 기본으로 포그라운드에서 실행됩니다. -
서드파티 제공자의
claude -p, Agent SDK 기본 권한 모드 (변경)권한 모드를 지정하지 않은
claude -p와 Agent SDK 세션은 서드파티 제공자(Bedrock, Vertex 등)를 쓰면서 telemetry가 꺼져 있거나 새로 설치한 경우default모드로 시작합니다. auto mode를 유지하려면--permission-mode auto를 지정합니다. -
prompt, agent 훅의 동시 실행 상한 (변경)
한 이벤트에 대한 prompt 훅과 agent 훅은 한 번에 최대 12개까지만 실행되고, 나머지는 차례를 기다립니다.
-
Claude in Chrome 안내의 위치 (변경)
Claude in Chrome 안내가 시스템 프롬프트 안에서 자리를 옮겨, 새 대화가 공유 prompt cache(이미 처리한 프롬프트를 재사용해 비용과 시간을 줄이는 기능)에서 읽을 수 있게 됐습니다.
-
기타 표시 변경 (변경)
← for agents하단 안내는 세션을 연 지 10초 뒤 사라지며, 응답을 기다리는 에이전트 수는 계속 표시됩니다. 조직 정책으로/feedback이 꺼져 있을 때 안내는 조직 관리자 대신 GitHub issues를 가리킵니다.
주요 버그 수정
압축과 prompt cache
- 대화를 압축하는 도중 턴을 멈추면 “Prompt is too long” 오류가 나던 문제 수정.
- 세션 중간에 추가한 도구를 ToolSearch나 압축 뒤에 다시 불러올 때 prompt cache를 놓치던 문제 수정.
모델과 제공자
- 세션 도중 Vertex나 Bedrock으로 바꾸면 요청이 “diagnostics: Extra inputs are not permitted”로 실패하던 문제 수정.
- 게이트웨이가 Opus 4, 4.1 이름에
anthropic/claude-opus-4-1같은 접두어를 붙이면/autocompact,/effort설정이 다른 모델에 저장되던 문제 수정. - 크레딧으로만 쓸 수 있는 모델에서 프롬프트 제안이 사용량 크레딧을 쓰던 문제 수정. 이제 크레딧으로 과금된 응답 뒤에는 프롬프트 제안을 건너뜁니다.
도구와 worktree
- Read 도구가 크기와 관계없이 이미지 파일을, 또는 이미지처럼 이름 붙은 파이프, 장치를 통째로 메모리에 올리던 문제 수정. 이제 128MB를 넘는 이미지는 거부합니다.
- PowerShell 도구가 플러그인
bin/폴더의 명령을 찾지 못하던 문제, 결과가 없는 검색(rg, grep, findstr, git grep)을Select-Object같은 서식 cmdlet으로 넘기면 오류로 보고하던 문제 수정. - git 2.56 이상에서 존재하지 않는 디렉터리를 가리키는
.git파일이 남아 있으면 worktree 격리가 worktree를 만들거나 재개하지 못하던 문제 수정.
플러그인과 설정
claude plugin같은 하위 명령이 대기 중인 설정 쓰기가 끝나기 전에 종료돼, 변경이 사라지거나.tmp파일이 남을 수 있던 문제 수정.- git 기본 ref 형식이 reftable일 때 플러그인 마켓플레이스가 새로 고칠 때마다 다시 clone되고, 새로 설치한 git 플러그인 버전이 “unknown”으로 표시되던 문제 수정.
claude plugin details <name>@builtin에서 플러그인을 찾지 못하면 내장 플러그인을 보여 주지 않는claude plugin list를 안내하던 문제 수정. 이제/plugin을 안내합니다.
MCP와 OpenTelemetry
- 서버가 프로토콜 버전 2026-07-28을 협상하면서
resultType,ttlMs,cacheScope를 빠뜨리면 MCP 서버의 도구가 보이지 않거나 모든 도구 호출이 실패하던 문제 수정. - 데스크톱 앱에서 MCP 서버를 인증하거나 다시 연결하라며, 그 옵션이 없는 claude.ai 설정이나
/mcp를 안내하던 문제 수정. - 대부분의 auto mode 분류기 차단에서 OpenTelemetry
tool_decision이벤트에classifier_category가 빠지던 문제 수정.OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT가 낮을 때 새 속성 때문에tool_use_id,tool_source,tool_parameters가 밀려나던 문제도 함께 고쳐졌습니다.
아티팩트와 Claude Design
- Claude가 빈 수정 목록을 보내면 아티팩트 게시가 실패하고, 더 새 버전 때문에 거절된 뒤 잘못된 방식으로 다시 시도하던 문제 수정.
- 클라우드 세션에서
/design consent,/design revoke가 실패하면 그 환경에서 쓸 수 없는/design-login을 안내하던 문제 수정. 이제 claude.ai/design/settings를 안내합니다.
터미널 표시
- 긴 목록을 내려가거나 섹션을 접으면 agents 화면의 행이 빈칸으로 남던 문제 수정.
- 백틱으로 감싼 URL이 줄바꿈되면 첫 줄만 클릭되던 문제 수정. 하이퍼링크를 지원하는 터미널에서는 URL 전체가 하나의 링크가 됩니다.
- 링크 안에서 시작하는 이모지가 한 칸 넓게 줄바꿈돼 질문 미리보기에서 가려지고 표가 목록으로 바뀌던 문제 수정.
- 로그인하지 않은 상태에서
claude remote-control --help가 사용법을 출력하지 않고 종료하던 문제 수정.
클라우드 세션과 Remote Control
- 클라우드 세션에서 가장 최근 메시지를 제외한 모든 메시지에서 “Rewind to here”가 실패하던 문제 수정. self-hosted runner는 Claude Code v2.1.246 이상이 필요합니다.
- 도중에 실패한 예약 routine 실행이 한 시간 이상 지나 처음부터 다시 실행돼, 같은 보고서를 두 번 올리는 식으로 작업이 반복될 수 있던 문제 수정.
- 클라우드 세션이 예기치 않게 멈춘 routine 실행은 Completed로, 시작 전에 보관된 실행은 Cancelled로 표시되던 문제 수정. 이제 실패로 표시됩니다.
- 세션이 새 프로세스에서 재개되면 클라우드 세션의 비용과 사용량이 0부터 다시 집계되던 문제 수정.
- GitHub 저장소 이름이 바뀌거나 옮겨진 뒤 클라우드 세션의 diff 화면에 변경이 빠지거나 불러오지 못하던 문제 수정.
- GitHub가 다시 확인하는 동안 병합 충돌이 있는 pull request가 상태 표시줄에서 ready로 돌아가던 문제 수정.
- 다른 기기에서 보낸 메시지가 열려 있는 클라우드 세션에 새로 고침 전까지 보이지 않던 문제 수정.
- [Remote Control] 컴퓨터가 오프라인이 되면 서브에이전트 창이 계속 로딩 중으로 남던 문제 수정. 이제 Remote Control 연결이 끊겼다고 표시합니다.
Claude Tag (Slack)
- Slack에 첨부한 HEIC, SVG, TIFF, BMP 이미지가 Claude에게 전달되지 않던 문제 수정. 이제 다른 파일처럼 작업 파일로 들어옵니다.
- 역할로 Claude Tag를 제한하는 조직에서 새 채널 관리자가 Slack의 Claude에 접근하지 못하던 문제 수정. 이제 관리자 역할에도 Claude Tag 권한이 포함됩니다.
- Slack 조회 하나가 지연되면 DM에 “DMs are temporarily unavailable”로 답하고 메시지를 버리던 문제 수정. 이제 먼저 다시 시도합니다.
- Slack Enterprise Grid에서 Claude와의 DM이 워크스페이스 선택을 무시하던 문제 수정. 이제 마지막으로 Claude를 연 연결 워크스페이스에서 실행됩니다.
- 번호나 글머리표 단계 아래 코드 블록의 URL이 꺾쇠괄호로 감싸져 복사한 명령이 깨지던 문제, 링크가 바로 뒤의 굵게, 기울임 표시나 전각 문장부호를 흡수하던 문제 수정.
- Claude가 이전 메시지를 수정해 답한 뒤에도 멘션 아래 “is thinking…”이 남던 문제 수정.
- 같은 호스트를 쓰는 MCP 서버들로 만든 사용자 지정 커넥터가 관리자 설정에서 하나로 합쳐 보이던 문제, 채널 월 지출 한도 안내가 채널 관리자가 올릴 수 있다고 잘못 안내하던 문제 수정.
Claude Tag 관리자 설정도 개선됐습니다. Claude의 접근 권한이 Bundles, Connectors, Skills and plugins, Channels 네 개 탭으로 정리됐고, 저장소 검색은 연결된 GitHub 계정 최대 100개와 GitHub App 설치의 첫 5,000개를 넘는 비공개 저장소까지 찾습니다.
VSCode
- 응답이 스트리밍되는 동안 목록 안의 닫히지 않은 코드 블록 뒤 텍스트가 일반 텍스트로 보였다가 코드로 바뀌던 문제 수정.
- 서버 URL에 쿼리 문자열이 있으면 패널에서 MCP 서버 로그인 시 깨진 인증 페이지가 열리던 문제 수정.
- Claude 확장이 설치된 브라우저에 연결할 수 없는데도
@browser배너가 “Browser connected”로 표시되던 문제 수정.
Windows와 self-hosted runner
- [Windows] exFAT, FAT32 드라이브의 프로젝트에서 모든 파일 쓰기가 거부되거나 매번 확인을 요구하던 문제 수정.
--plugin-dir로 시작한 세션도 포함됩니다. - [Self-hosted runner] reftable 형식으로 저장된 checkout을 재사용하는 세션에서 git fetch가 “bad object refs/heads”로 실패하던 문제 수정.
- [Code Review] GitHub 연결을 위해 설정을 벗어났다 돌아오면 Code Review 설정이 이어지지 않던 문제 수정. 이제 저장소 선택 화면부터 다시 열립니다.
알아두면 좋은 점
claude -p나 Agent SDK를 서드파티 제공자로 쓴다면 권한 모드를 지정하지 않은 세션이 조건에 따라default모드로 시작할 수 있습니다. auto mode가 필요하면--permission-mode auto를 명시합니다.claude -p, Agent SDK, 데스크톱 앱, VS Code에서 fork 서브에이전트를 원하지 않는다면CLAUDE_CODE_FORK_SUBAGENT=0으로 끌 수 있습니다.- prompt 훅이나 agent 훅을 한 이벤트에 많이 걸어 두었다면 이번 버전부터 동시에 최대 12개까지만 실행되고 나머지는 대기합니다.
- 유휴 압축을 원하지 않는다면
/config의Idle compaction에서 끌 수 있습니다. - 단독 Claude Design(claude.ai/design)을 쓰고 있다면 2026년 12월 14일까지 종료된다는 안내가 나왔습니다.
/design-sync등으로 연동한 작업이 있으면 일정을 확인합니다.