무엇이 바뀌었나?
Claude Code 2.1.301이 2026년 10월 15일 출시됐습니다. 무인 재시도 모드와 OpenTelemetry 관측 항목, vim 모드, mod API, VS Code 확장에 새 기능이 들어갔고, 컨텍스트 창이 작은 모델로 바꿀 때의 처리 방식이 개선됐습니다. 수정은 worktree 정리, 모델 별칭과 로그인, Grep, Glob, Read 도구, 스킬 인자, 압축, 터미널 표시, self-hosted runner에 걸쳐 있습니다. 변경 항목이 많아 아래에는 사용자 영향이 큰 항목을 골라 정리했습니다.
새 기능
-
무인 재시도 모드의 사용량 한도 대기 상한
무인 재시도 모드(
CLAUDE_CODE_RETRY_WATCHDOG)는 사용량 한도에 걸리면 한도가 초기화될 때까지 기다렸습니다. 초기화 시점이 한참 뒤라면 작업이 그만큼 멈춰 있었습니다. 이제CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS로 최대 대기 시간을 정하면, 초기화가 그보다 늦을 때는 기다리지 않고 요청을 끝냅니다. -
OpenTelemetry
tool_decision이벤트의 분류기 정보tool_decision이벤트만으로는 도구 호출이 auto mode 분류기(도구 호출을 허용할지 자동으로 판단하는 기능)의 판정으로 허용, 차단됐는지, 권한 규칙 때문인지 구분하기 어려웠습니다. 이제classifier_verdict와permission_mode가 추가돼 둘을 나눠 볼 수 있습니다.OTEL_LOG_TOOL_DETAILS=1을 설정하면 분류기가 차단할 때 일치한 기본 규칙 이름을 담은classifier_category도 기록됩니다. -
claude-api스킬의 OpenTelemetry tracing 안내claude-api스킬에 OpenTelemetry tracing 설정 안내가 추가됐습니다.antCLI로 trace를 보낼 곳을 설정하는 방법도 포함돼 있습니다. -
vim 모드의
%이동vim 모드에서 짝이 맞는 괄호로 이동하는
%를 쓸 수 없었습니다. 이제%단독으로 짝 괄호로 이동할 수 있고, d, c, y와 함께 사용해 괄호 범위를 지우거나 바꾸거나 복사할 수 있습니다. -
mod
Input의rowsmod(Claude Code의 화면과 동작을 바꾸는 확장)의
Input은 한 줄 입력만 받았습니다. 이제rows를 지정하면 터미널에서 여러 줄 입력란이 되며, Enter로 제출하고 Shift+Enter나 Enter 앞의 백슬래시로 줄을 바꿉니다. -
[VSCode] LaTeX 수식 렌더링
Claude 응답에 들어 있는 수식이 원문 기호 그대로 보였습니다. 이제
$$블록, 여러 줄\[ … \]블록, 인라인$…$,\(…\)수식이 렌더링됩니다. -
[VSCode] 사용량 한도 배너의 “Get more usage” 링크
VS Code와 JetBrains 패널에서 Pro, Max 요금제의 사용량 한도 배너에 “Get more usage” 링크가 추가됐습니다.
주요 개선
-
컨텍스트 창이 작은 모델로 전환
대화가 새 모델의 컨텍스트 창(한 번에 처리할 수 있는 대화 분량)보다 길면 새 모델이 그대로 이어받을 수 없습니다. 이제 이런 대화는 이전 모델이 먼저 요약한 뒤 새 모델로 넘어갑니다. 함께 고쳐진 문제로, 이 요약에 사용량 크레딧이 쓰이는데도 먼저 묻지 않던 경우가 있었습니다.
-
오래 실행되는 서브에이전트의 렌더링 성능
서브에이전트가 오래 작업하면 화면을 그릴 때마다 진행 기록 전체를 다시 처리해 느려졌습니다. 이제 진행 기록이 바뀐 부분만 갱신됩니다.
-
아티팩트의 sticky 헤더
모바일 앱에서 Claude가 만든 페이지를 스크롤하면 고정(sticky) 헤더 위쪽 띠 영역에 본문 텍스트가 비쳐 보였습니다. 이제 이 영역도 칠해서 텍스트가 보이지 않습니다.
-
mod의 질문 창 위 트리 표시
VS Code, 데스크톱 앱, 모바일 앱에서 질문 창 위에 그리는 트리는 일반 텍스트만 담을 수 있었습니다. 이제 Markdown과 최대 48행까지 담을 수 있습니다. 터미널은 기존대로 일반 텍스트 12행입니다.
동작이 바뀐 항목
-
mod 훅의
.catch처리 (변경)이제
.catch핸들러는 훅 자체가 예외를 던지거나 시간 초과됐을 때만 실행됩니다. 훅이 호출한 작업 아래에서 발생한 이벤트는.catch를 거치지 않고 그 훅을 건너뜁니다. -
mod의
$.env.set반환값 (변경)변수를 설정하거나 해제하면
{}로, 쓰기가 이뤄지지 않으면 이유를 담은{ deny }로 결과를 돌려줍니다. 호출한 쪽에서 쓰기 성공 여부를 확인할 수 있습니다.
주요 버그 수정
worktree와 git
WorktreeCreate훅이 만든 worktree에 푸시하지 않은 커밋이 있을 수 있는데도, 종료할 때 묻지 않고 지우던 문제 수정.- reftable 저장소에서 git 확인 중 하나가 시간 초과되거나 실패하면
/diff가 충돌 상태의 cherry-pick, revert를 감지하지 못하던 문제 수정.
모델과 로그인
- 조직에서 최신 Fable 모델을 쓸 수 없을 때
fable(과best) 별칭이 Anthropic API에서 오류를 내던 문제 수정. 이제 이전 Fable 모델로 한 번 재시도합니다. - 디스크가 가득 차 로그인 정보를 갱신하지 못할 때 “Please run /login”이라는 엉뚱한 오류가 나오던 문제 수정. 이제 디스크 문제임을 알리고 파일을 지우라고 안내합니다.
claude auth status,claude plugin list같은 짧은 명령이 토큰 갱신 도중 끝나면, 이후 로그인 갱신이 시간 초과되거나 예기치 않게 로그아웃되던 문제 수정.- Bedrock이 아닌 환경에서 이름에
application-inference-profile이 들어간 모델로 바꾸면awsAuthRefresh명령이 실행되고 모델 전환 훅이 늦어지던 문제 수정. - 요청과 다른 모델 이름을 응답에 담는 LLM 게이트웨이 뒤에서, 고르지 않은 모델로 대화가 반복해서 압축되던 문제 수정.
도구와 스킬
- 검색 프로그램이 결과를 내기 전에 예기치 않게 실패하면 Grep, Glob이 “일치 없음”으로 보고하던 문제 수정. 이제 검색이 실패했다는 오류를 돌려줍니다.
- Read 도구가 .xlsm, .parquet, .epub, .heic 같은 바이너리 파일을 텍스트로 읽던 문제 수정.
- 인자 이름이 아주 많거나 긴 스킬, 명령을 실행하면 몇 초씩 멈추던 문제 수정. 이제 앞의 64개 이름까지, 각 이름은 64자까지만 채워 넣습니다.
- 인자가 많은 자리 표시자(placeholder)를 채우는 스킬, 명령, 훅이 메모리를 매우 많이 쓰던 문제 수정.
/rewind를 쓴 뒤 스킬 목록이 모델에게 더 이상 전달되지 않던 문제 수정./claude-api스킬이 Claude Platform on AWS에서 CMEK 외부 키 엔드포인트를 쓸 수 없다고 안내하던 문제 수정.
워크플로, 아티팩트, 권한
- 작업 텍스트에 사용자 권한이 없다는 안내를 읽은 workflow 에이전트가 단계를 건너뛰고도 실행이 성공으로 보고되던 문제 수정.
- 같은 세션에서 Bash로
cd한 뒤 workflow 스크립트를 읽거나 고치거나 다시 실행하면 권한을 묻거나 거부되던 문제 수정. - PreToolUse 훅이 Edit, Write를 감시하는 환경에서 아티팩트 업데이트가 거부되던 문제 수정. 이제 파일을 먼저 수정한 뒤 다시 게시합니다.
- 권한 확인 중 턴 도중 보낸 메시지 때문에 끊긴 도구 호출이 모델에게 “사용자가 거부함”으로 전달되던 문제 수정.
- 플러그인이나 스킬 훅이
ask결정을 내릴 때 권한 확인 창에 어느 플러그인, 스킬의 훅인지 표시되지 않던 문제 수정.
vim 모드와 입력
- 느리거나 바쁜 컴퓨터에서 Escape를 눌러도 vim 모드가 INSERT에 머무는 경우가 있던 문제 수정.
- vim 모드에서 AskUserQuestion 답을 입력하다 Esc를 누르면 입력한 내용이 사라지던 문제 수정. 이제 자유 입력란도 vim NORMAL 모드를 지원하고, Esc는 NORMAL 모드에서만 취소로 동작합니다.
압축과 세션
- [Fullscreen]
/compact와 자동 압축 중 화면에 보이는 대화 기록을 다시 만드는 동안 UI가 잠시 멈추던 문제 수정. - 재개한 세션의 압축 표시 줄이 불러오지 않은 기록을 보여 주겠다며 ctrl+o를 안내하던 문제 수정. 이제 이전 메시지가 저장된 위치를 알려 주며, fullscreen에서도 표시됩니다.
- 응답을 중단한 직후 “new task? /clear to save tokens” 안내가 다시 나타나던 문제 수정.
터미널 표시
- VTE 0.53 미만 기반 터미널(RHEL 8의 MATE Terminal 등)에서 폴더 신뢰 확인 창을
>0q같은 문자가 가리고, 종료 시 셸 프롬프트 앞에>4m이 남던 문제 수정. - 일부 iTerm2 버전에서 시작할 때 프롬프트에
GOK문자가 나타나던 문제 수정. - 머리글 행만 있는 Markdown 표가 터미널보다 넓으면 아무것도 그려지지 않던 문제 수정. 계획 승인 카드의 계획에도 해당합니다.
- dark ANSI 테마와 16색 터미널에서 흐린 텍스트가 상황에 맞지 않게 표시되던 문제 수정. 채워진 상자 안에서는 흐리게, 선택과 검색 강조 위에서는 흐리지 않게, 목록 설명은 다른 보조 텍스트처럼 흐리게 표시됩니다.
mod
- 새 Claude Code 프로세스의 첫 응답이 끝나기 전에 mod의
$.model.fork를 호출하면nothing-to-fork를 돌려주던 문제 수정.claude -p실행과 클라우드 세션에서 발생했습니다.
Self-hosted runner
- 관리형 설정이 MCP 서버를 제한하면 Slack에서 시작한 세션이 저장소를 찾거나 연결하지 못하던 문제 수정. 해당 도구를 막아 두려면
deniedMcpServers를 사용합니다. - 관련 없는 설정이나 세션 실패 메시지에 git의 참조 없음 문구가 들어 있으면, 세션이 원본 브랜치가 삭제된 것으로 보고되고 재시도되지 않던 문제 수정.
- 종료 중인 세션에 대해서도 실패하거나 거절된 세션 해제를 재시도하겠다고 로그에 표시되던 문제 수정. 반복 실패는 이제 횟수로 표시됩니다.
Windows
- 중지한 백그라운드 PowerShell 명령의 출력 파일에 마지막
[killed]줄이 빠지던 문제 수정.
VSCode
- 패널을 충돌시키거나 멈추게 한 대화가 다시 불러올 때마다 또 열리던 문제 수정.
- 긴 thinking 도중 thinking 텍스트 전체를 업데이트마다 다시 분석해 채팅 패널이 느려지던 문제 수정.
- 일부 language server의 진단에서 규칙 코드(예: MD013) 대신 “[object Object]“가 표시되던 문제 수정.
- 받아쓰기 기능을 제공하지 않는 환경(claude.ai가 아닌 로그인, 원격 창)에서도 마이크 권한을 확인하려고 기본 받아쓰기 오디오 모듈을 불러오던 문제 수정.
알아두면 좋은 점
CLAUDE_CODE_RETRY_WATCHDOG로 무인 작업을 돌린다면CLAUDE_CODE_RETRY_WATCHDOG_MAX_USAGE_LIMIT_WAIT_MS로 사용량 한도 대기 상한을 정해, 초기화가 먼 경우 요청이 바로 끝나게 할 수 있습니다.- OpenTelemetry로 권한 판정을 분석한다면
tool_decision이벤트의classifier_verdict,permission_mode로 auto mode 분류기 판정과 권한 규칙을 구분할 수 있습니다. 차단 규칙 이름(classifier_category)까지 보려면OTEL_LOG_TOOL_DETAILS=1이 필요합니다. - mod를 만든다면 훅의
.catch가 실행되는 조건과$.env.set의 반환값이 바뀌었습니다. 이 동작에 기대는 코드가 있으면 확인합니다. WorktreeCreate훅으로 worktree를 만들어 쓴다면 이번 버전부터 푸시하지 않은 커밋이 있을 수 있는 worktree는 종료 시 묻지 않고 지우지 않습니다.fable이나best별칭을 쓰는데 오류가 났다면 이번 버전부터 최신 Fable 모델을 쓸 수 없을 때 이전 Fable 모델로 한 번 재시도합니다.