claudekit / updates / claude-code-2-1-292
[ PATCH · ]

Claude Code 2.1.292

`claude plugin install --marketplace`로 마켓플레이스 추가와 플러그인 설치를 한 번에 할 수 있고, Agent 도구에 서브에이전트의 effort 수준을 지정하는 `effort` 파라미터가 생겼습니다. 네트워크(UNC) 경로 읽기가 권한 프롬프트를 건너뛰던 보안 문제와, 재개 뒤 예약 작업이 실행되지 않던 문제도 고쳐졌습니다.

공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

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, /config Theme 메뉴, 첫 실행 테마 단계가 플러그인의 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 규칙으로 리뷰됩니다.