무엇이 바뀌었나?
Claude Code 2.1.292가 2026년 10월 6일 출시됐습니다. 변경 항목이 많은 릴리스로, 중심은 세 가지입니다. 첫째, 플러그인 설치와 서브에이전트 실행을 더 세밀하게 다룰 수 있는 옵션이 추가됐습니다. 둘째, 네트워크 경로, 링크 바꿔치기, 변조된 캐시 등을 통해 권한 확인과 샌드박스 제한이 우회되던 경로를 막았습니다. 셋째, /resume 뒤의 예약 작업, /loop, plan mode 복원 같은 세션 이어가기 관련 문제와 플러그인(mod) 훅 엔진의 여러 문제를 고쳤습니다. 아래에는 사용자 영향이 큰 항목을 골라 정리했습니다.
새 기능
-
claude plugin install --marketplace <source>다른 마켓플레이스의 플러그인을 설치하려면
claude plugin marketplace add로 마켓플레이스를 먼저 추가한 뒤 따로 설치해야 했습니다. 이제--marketplace <source>를 붙이면 필요할 때 마켓플레이스를 추가하고 바로 그 마켓플레이스에서 플러그인을 설치합니다. 마켓플레이스 추가에는claude plugin marketplace add와 같은 정책 검사가 적용됩니다. -
Agent 도구의
effort파라미터서브에이전트를 어느 effort 수준(추론에 들이는 노력의 정도)으로 실행할지 지정할 방법이 없었습니다. 이제 Agent 도구에
effort파라미터가 추가돼, 사용자가 요청한 effort 수준으로 Claude가 서브에이전트를 실행합니다. -
과부하(529) 재시도 대기 시간 설정
서버 과부하(529)로 요청이 실패하면 정해진 간격으로 다시 시도할 뿐, 대기 시간을 늘릴 방법이 없었습니다. 이제
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS환경 변수로 재시도 간격을 점점 늘려 가는 방식(backoff)의 기본 대기 시간을 더 길게 잡을 수 있습니다. -
mod 작성자를 위한 훅 추가
mod가 프롬프트 입력창의 자동 완성 목록에 자기 항목을 넣을 수 있는
prompt.autocomplete이벤트가 추가됐습니다. mod용$.model.complete는 프롬프트 캐싱을 지원해,prompt와system에 텍스트 블록을 넘기고 블록에cache: true를 붙이면 그 블록까지의 요청이 캐시됩니다.agent.spawn훅에는 워크플로 에이전트도 실행 정보, 순번과 함께 전달돼, mod가 이를 거부할 수 있습니다. -
[Claude Tag] Allowed domains 편집 버튼
채널의 Configure 페이지에 있는 Allowed domains 카드에 Edit 버튼이 생겨, Enterprise 관리자가 채널의 도메인을 정하는 access bundle을 바로 열 수 있습니다.
-
[Code Review] 분석 차트 보강
Code Review 분석의 PRs reviewed 차트에 기간 합계와 이전 기간 대비 변화, 저장소별 분류가 추가됐습니다.
주요 개선
-
claude -p와 SDK 세션 시작 속도첫 턴이 HTTP, SSE 방식 MCP 서버의
resources/list응답을 기다리느라 늦게 시작됐습니다. 이제 이 응답을 기다리지 않습니다. -
오래된 방식의 로컬 MCP 서버 연결
새 프로토콜 확인에 응답하지 않는 로컬(stdio) MCP 서버는 연결할 때마다 대기 시간이 생겼습니다. 이제 한 번 느리게 연결되면 7일 동안 기억해 두고, 기다림 없이 이전 방식으로 연결합니다.
-
긴 목록 응답의 화면 그리기 속도
글머리표나 번호가 붙은 긴 응답은 스트리밍, 창 크기 조절, 대화 기록(ctrl+o)에서 다시 열기가 느렸습니다. 이제 훨씬 빨라졌습니다.
-
Ctrl+C로 지운 입력 복구
Ctrl+C로 지운 입력은 슬래시 명령이나 메시지를 보낸 뒤에는 되찾을 수 없었습니다. 이제 그 뒤에도 위 화살표로 다시 불러올 수 있습니다.
-
훅 출력의
<system-reminder>태그 이스케이프훅 출력에 쓴
<system-reminder>태그가 그대로 Claude에게 전달됐습니다. 이제 Claude에게 닿기 전에 이스케이프(일반 텍스트로 처리)됩니다. -
도구 입력 처리 완화
파라미터 이름이 조금 틀리거나 불필요한 값이 섞이면 도구 호출이 실패했습니다. 이제 Grep은
path대신file_path도 받아들이고, Write, WebFetch, Read는 일부 불필요한 파라미터를 무시합니다. -
샌드박스 자동 허용 범위
엄격한 샌드박스 모드에서
FOO=bar python3 app.py처럼 앞에 환경 변수를 붙인 인터프리터 명령은 승인을 요청했습니다. 이제 사용자, 관리형,--settings설정에서 엄격한 샌드박스 모드를 지정했다면 묻지 않고 실행됩니다. -
Artifact 목록 한도
Claude가 한 번에 볼 수 있는 게시된 artifact 목록이 50개였습니다. 이제 게시된 artifact가 몇 개인지 알 수 있고, 한 번에 최대 200개까지 목록을 볼 수 있습니다.
-
기타 개선
설정 파일에 선언된 마켓플레이스 이름이 Anthropic 공식 마켓플레이스처럼 보일 때 안내하는 단계가 개선됐습니다. 클라우드 세션은 재시작 뒤 멈춘 백그라운드 에이전트 중 어떤 것을 id로 재개할 수 있는지 Claude에게 알려 줍니다. claude.ai 클라우드 세션에서 Claude in Chrome이 브라우저에 연결되지 못하면, 사용자가 원할 경우 다른 방법으로 계속할 수 있다고 Claude에게 알려 줍니다.
동작이 바뀐 항목
-
로컬 MCP 서버의 기본 프로토콜 버전 (변경)
로컬(stdio) MCP 서버 연결이 이제 모든 설치 환경(Bedrock, Vertex, Foundry 포함)에서 기본으로 프로토콜 버전 2026-07-28을 협상합니다.
MCP_PROTOCOL_NEGOTIATION=legacy로 이전 방식을 유지할 수 있습니다. -
claude plugin test실패 판정 (변경)테스트가 등록한 훅 안의
expect가 실패하거나 엔진이 거부하는 stub 응답이 있어도 테스트가 말없이 통과했습니다. 이제 이런 경우 테스트가 실패합니다. -
예약 루틴의 artifact 게시 (변경)
예약 실행과 Run now로 실행한 루틴이 새 artifact를 게시할 때, 본인만 볼 수 있는 artifact는 승인을 묻지 않고 게시합니다. 커넥터나 다른 접근 권한을 요청하는 artifact는 계속 승인을 묻습니다.
-
에이전트 이름 최대 256자 (변경)
이보다 긴 에이전트 이름은 거부되고, 스킬이나 플러그인 파일의
name이 이보다 길면 무시됩니다. -
사용량 한도 메시지의 링크 (변경)
claude.ai 설정 링크가 https://를 붙인 형태로 표시돼, 터미널과 앱에서 클릭할 수 있습니다.
주요 버그 수정
권한과 보안
- [보안] PreToolUse 훅 승인과 auto mode가 네트워크(UNC) 경로의 파일 읽기에 대해 권한 프롬프트를 건너뛰던 문제 수정.
- 샌드박스에서 실행한 명령이
~/.claude/seed-admin아래에 준비된/ultrareview업로드 파일 사본을 읽을 수 있던 문제 수정. - 읽는 도중 링크를 바꿔치기하면 노트북, PDF 읽기(macOS, Windows)가 승인 범위 밖 파일을 읽을 수 있던 문제 수정.
- 세션 중에 생기거나 다른 곳을 가리키게 된 관리형 샌드박스 읽기 거부 경로가, 그 안의 프로젝트 권한을 해제하지 않고 해당 파일에서 자격 증명 주입도 멈추지 않던 문제 수정.
- 설정 가져오기가 실패한 동안, 디스크에 저장된 서버 관리형 설정 캐시를 변조하면 기본 정책 플러그인을 끄거나 밀어낼 수 있던 문제 수정.
- Windows에서 홈 폴더나 드라이브를 8.3 짧은 이름 등 다른 표기로 쓴
rm -rf를 해당 폴더 삭제로 인식하지 못하던 문제 수정. - auto mode를 쓸 수 없을 때(설정으로 꺼짐, circuit breaker 작동, 지원하지 않는 모델)도
permissionMode: auto인 서브에이전트가 auto mode로 들어가던 문제 수정. - 턴 도중 auto mode나 plan mode를 빠져나오면, 스킬이나 슬래시 명령의
allowed-tools규칙이 다음 턴에 다시 적용되던 문제 수정. - 요약에
/name이 반복된 대화 압축(compaction) 결과 때문에 Claude가 사용자 전용 스킬을 호출할 수 있던 문제 수정. - 플러그인의
tool.check훅이 허용하면, 사용자 응답이 필요한 도구(질문, 계획 승인)가 대화 상자 없이 실행되던 문제 수정. - 플러그인 훅 작업자가 재시작되는 동안의 도구 호출이 플러그인 권한 훅을 거치지 않던 문제 수정.
네트워크와 MCP
HTTPS_PROXY를 설정했을 때 Claude Code 자체 API 요청(로그인, 정책, 피드백, artifact)에NO_PROXY가 무시되던 문제 수정.- 이름이 128자를 넘는 MCP 도구 하나 때문에 모든 요청이 실패하던 문제 수정. 이제 그 도구는 빠지고, MCP 오류에 도구 이름이 표시됩니다.
- 처음 실행할 때 조직의 관리형 설정이 불러와지기 전에
marketplace add,install같은claude plugin명령이 실행되던 문제 수정.
세션 재개와 예약 작업
claude --resume세션 선택 화면이나/resume으로 세션을 재개할 때 plan mode가 복원되지 않던 문제 수정./resume,/branch,/clear뒤에 만든 예약 작업이 실행되지 않던 문제 수정. 작업 파일에 몇 밀리초 간격으로 두 번 쓰기가 일어난 뒤 이후 생성, 삭제가 무시되던 문제도 고쳐졌습니다.- 충돌 등으로 프로세스가 재시작되면 대기 중인 깨우기를 잃어 백그라운드 세션의
/loop가 말없이 멈추던 문제 수정. - 일회성
claude -p와 Agent SDK 실행이 최종 결과 5초 뒤 백그라운드 명령을 멈추고,claude -p가 예약된 깨우기를 버리던 문제 수정. 이제 둘 다 끝날 때까지 기다립니다. - 백그라운드 에이전트들이 이미 메인 대화를 멈춘 사용량 한도로 실패하면 한도 알림이 에이전트 수만큼 반복되던 문제 수정.
도구와 파일 읽기
- Grep, Glob이 지정한 파일이나 폴더를 읽을 수 없을 때 “일치 항목 없음”으로 보고하던 문제 수정. 이제 한 번 다시 시도하거나 사용자에게 알립니다.
- PDF의
pages에 “6,9,15” 같은 목록을 넘기면 Read 도구가 오류 없이 첫 항목만 돌려주던 문제 수정. 이제 페이지나 범위를 하나씩 읽으라는 오류를 돌려줍니다. - @-멘션한 256KB 초과 텍스트 파일이 말없이 빠지던 문제 수정. 이제 Claude에게 파일 크기와 나눠 읽으라는 안내가 전달됩니다.
- mod가 Write, Edit, NotebookEdit, LSP 호출이나 단일 Read, Grep, Glob 호출을 거부해도 이유가 보이지 않던 문제 수정.
입력과 화면
- 한 프롬프트에 여러 번 붙여 넣기가 겹치면 일부 붙여 넣은 텍스트가 직접 입력한 것처럼 전달되던 문제 수정.
- vim mode에서 커서가 줄 끝을 넘어가고, j/k가 짧은 줄에서 열 위치를 잃고,
f/t/F/T/;/,가 다른 줄의 문자로 이동하거나 삭제하던 문제 수정. - iTerm2에서 fullscreen mode가 창 크기 조절과 Ctrl+L마다 전체 화면 지우기를 보내 스크롤 기록이 오래된 화면으로 채워지던 문제 수정.
- 프롬프트 하단 행이 선택된 동안 빠른 입력, 입력기(IME) 텍스트, 분해된 악센트 문자가 사라지던 문제 수정.
/add-dir경로 입력창에서 Shift+Enter나 붙여 넣기로 줄바꿈이 들어가고, 빠르게 입력한 “tab”, “up”, “down”을 키 입력으로 처리하던 문제 수정./remote-env에서 Enter를 바로 누르면 저장된 기본 환경이 바뀌던 문제 수정. 이제 목록이 기본 환경에서 열립니다./bug,/share,/feedback <text>전송 중 Ctrl+O나 Ctrl+Z를 누르면 처음부터 다시 시작되고, 전송 뒤 취소로 닫히던 문제 수정.
플러그인과 mod
.catch가 있는 mod의 guard 훅이, 다른 mod 훅이 guard 자신의$호출 아래에서 한 호출에 대해 말없이 건너뛰어지던 문제 수정.- 턴이 중단된 동안
next(e)를 호출한 뒤 실패한 mod 훅이 호출을 통과시키던 문제 수정. 이제 호출이 거부됩니다. - mod의
config.set,state.set,env.set,agent.spawn훅이next(e)호출 뒤 거부하면 거절로 처리되던 문제 수정. 이제 훅 이름과 함께 실패로 보고됩니다. - 플러그인
tool.call훅이 잘못된 파라미터 이름이 고쳐지기 전의 호출을 보던 문제 수정. 이제 도구가 실제로 실행할 인자를 봅니다. - 사용자 mod가 추가한
$이름을 조직 플러그인이 돌려주면 조직 플러그인이 내려지던 문제 수정. 이제 해당 mod가 내려집니다. - 이유가 4,096자를 넘으면 플러그인의 프롬프트 차단이나 설정 거부가 무시되던 문제 수정.
- 한 const를 통해
$.state를 많이 호출하는 플러그인의 불러오기, 검증이 몇 분씩 걸리던 문제 수정.claude plugin validate가 엔진이 실제로는 다른 곳에서 읽는 matcher나 state 값을 목록에 표시하던 문제도 고쳐졌습니다. /theme,/configTheme 메뉴, 첫 실행 테마 단계가 플러그인의config.set훅에 묻기 전에 테마를 저장하던 문제 수정.
클라우드 세션, Remote Control, 데스크톱 앱
- [Cloud sessions] 대화 기록이 큰 세션이 승인한 권한을 다시 묻던 문제, 컨테이너 재시작 뒤 클라이언트에서 고른 thinking 설정을 잊던 문제, 메시지를 다시 시도하거나 편집할 때 예약 작업 알림이 사라지던 문제 수정.
- [Cloud sessions] 끝난 루틴 실행이 몇 시간 동안 실행 중으로 표시되던 문제, 루틴을 편집하거나 복제하면 푸시 알림이 꺼지던 문제 수정.
- [Cloud sessions] SVG, HEIC, TIFF 등 흔하지 않은 이미지 파일 첨부가 실패하던 문제 수정. 이제 일반 파일로 첨부됩니다.
- [Cloud sessions] 조직이 승인을 필수로 지정한 커넥터 도구에 효과 없는 “Always allow” 선택지가 표시되던 문제 수정.
- [Remote Control] claude.ai/code에서 시작한 새 세션의 첫 메시지가 이미지만 받던 문제 수정. 이제 PDF와 다른 파일도 받습니다.
- [Remote Control] 데스크톱 앱이나 IDE가 호스팅한 세션에서 백그라운드 서브에이전트 창이 비어 보이던 문제 수정.
- 데스크톱 앱에서 다른 메시지가 대기 중일 때 Send now가 턴이 기다리던 서브에이전트를 끝내던 문제 수정.
- Cowork 클라우드 세션이 조직 설정을 확인하지 못했을 때 프록시가 artifact를 막았다고 잘못 안내하던 문제 수정.
Claude Tag, Code Review
- [Claude Tag] Claude가 첫 요청을 처리하는 동안 Slack 스레드에 보낸 답장이 그 요청이 끝날 때까지 보류되거나, 몇 초 간격으로 보내면 누락되던 문제 수정.
- [Claude Tag] 조직의 사용량 크레딧이 소진됐는데 지출 한도 알림을 보내던 문제, Slack에서 답할 수 없는 권한 프롬프트가 자동 거부되면 세션이 멈추던 문제 수정.
- [Claude Tag] 관리자가 기본 모델을 바꿔도 GitHub PR 활동이나 루틴으로만 깨어나는 Slack 스레드가 원래 모델을 유지하던 문제 수정.
- [Code Review] PR이 CLAUDE.md를 수정하면 리뷰가 그 파일의 규칙을 무시하던 문제 수정. 이제 base 브랜치의 CLAUDE.md를 사용합니다.
- [Code Review] PR의 base 브랜치가 바뀌고 이전 브랜치가 삭제되면 대기 중인 리뷰가 실패하던 문제 수정. 이제 커밋을 다시 리뷰 대기열에 넣습니다.
알아두면 좋은 점
- 다른 마켓플레이스의 플러그인을 자주 설치한다면
claude plugin install --marketplace <source>로 마켓플레이스 추가와 설치를 한 번에 할 수 있습니다. - 로컬(stdio) MCP 서버 연결에 문제가 생겼다면 이번 버전부터 기본 프로토콜 버전이 2026-07-28로 바뀐 영향일 수 있습니다.
MCP_PROTOCOL_NEGOTIATION=legacy로 이전 방식으로 되돌릴 수 있습니다. - 과부하(529) 오류가 잦은 환경이라면
CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS로 재시도 대기 시간을 늘릴 수 있습니다. claude plugin test를 쓰는 mod 작성자라면 이전에 말없이 통과하던 테스트가 이번 버전부터 실패할 수 있습니다. 훅 안의expect와 stub 응답을 확인해 두면 좋습니다.- 에이전트, 스킬, 플러그인 파일의
name이 256자를 넘는다면 거부되거나 무시되므로 줄여야 합니다. - Code Review를 쓰는 저장소라면 CLAUDE.md를 수정하는 PR은 이제 base 브랜치의 CLAUDE.md 규칙으로 리뷰됩니다.