Claude Code 2.1.286

무엇이 바뀌었나?

Claude Code 2.1.286이 2026년 9월 30일 출시됐습니다. 권한 확인 창과 전체 화면 목록 화면이 정리됐습니다. 쌓인 권한 요청에 순서가 표시되고, 모든 권한 확인 창이 파일 편집 확인 창과 같은 모양을 갖추며, /hooks, /mcp, /skills 같은 목록 화면의 세부 정보가 한 열로 정렬됩니다. 동작 변경으로는 API 재시도 한도 통합, --bare 모드의 범위 축소, 플러그인 npm 설치 출처 제한이 있습니다. 수정 사항은 claude --resume 기록 유실, 로그와 transcript에서 비밀 값이 드러나던 문제, Remote Control 메시지와 첨부 파일, 서브에이전트, MCP 연결에 많이 모였습니다.

새 기능

• 권한 확인 창의 요청 순서 표시

  권한 요청이 여러 개 쌓여도 지금 보는 요청이 몇 번째인지, 몇 개가 더 남았는지 알 수 없었습니다. 이제 확인 창에 “2 of 5”처럼 순서와 전체 개수가 표시됩니다.

• 전체 화면 목록의 “N more” 행 마우스 지원

  전체 화면 모드에서 목록 위아래에 표시되는 “N more” 행은 키보드로만 넘길 수 있었습니다. 이제 이 행을 클릭하면 목록의 해당 끝으로 바로 이동하며, 마우스를 올리거나 누를 때 상태가 표시됩니다.

• [VSCode] 기능 추가

  • Claude의 답변을 북마크로 저장하고 Bookmarks 사이드 패널에서 계속 볼 수 있습니다.
  • Claude가 질문 카드로 물은 내용과 사용자의 답이 대화에 남습니다. 질문 카드에 답하면 Questions 행에 각 질문과 고른 항목이 표시됩니다.
  • 채팅 패널의 질문 카드에서 선택한 항목의 목업이나 코드 조각이 선택지 옆이나 아래에 미리보기로 표시됩니다.
  • 메시지 아래에 함께 보낸 터미널 출력, 브라우저 탭, 브라우저 지시 사항, 선택한 코드를 펼쳐 볼 수 있는 행이 추가됐습니다.

• [Claude Tag] 지출 한도 페이지의 Add channel 버튼

  관리자 설정의 지출 한도 페이지에서 원하는 채널에 한도를 걸기 어려웠습니다. Add channel 버튼으로 채널 ID나 Slack 링크를 입력해 비공개 채널을 포함한 모든 채널에 한도를 설정할 수 있습니다.

주요 개선

• 커밋 전 verify 스킬 실행 안내

  프로젝트나 사용자 스킬에 검증용 스킬을 두어도 Claude가 커밋 전에 실행한다는 보장이 없었습니다. 이제 verify라는 이름의 스킬이 있으면 Claude가 커밋 직전에 이를 실행하라는 안내를 받습니다. 문서만 바꾸거나 테스트만 바꾸는 커밋은 제외됩니다.

• 권한 확인 창 모양 통일

  권한 확인 창마다 생김새가 달라 무엇을 승인하는지 한눈에 비교하기 어려웠습니다. fetch, 스킬, 파일 읽기, 샌드박스 네트워크, Claude in Chrome, 워크플로 스크립트, 노트북 편집 확인 창이 파일 편집 확인 창과 같은 모양이 됐습니다. Bash, PowerShell, Monitor 확인 창은 실행할 명령을 점선 사이에 표시합니다.

• 서브에이전트 화면의 send now(ctrl+enter)

  서브에이전트가 명령을 실행하는 동안에는 보낸 메시지가 명령이 끝날 때까지 읽히지 않았습니다. 이제 ctrl+enter를 누르면 실행 중인 명령이 백그라운드로 옮겨지고 메시지가 바로 읽힙니다.

• WebFetch의 claude.ai 아티팩트 링크 읽기

  WebFetch로 claude.ai 아티팩트 링크를 읽을 때와 Artifact 도구로 읽을 때 확인 방식이 달랐습니다. 이제 둘 다 같은 질문을 합니다. 세션의 네트워크 접근이 켜져 있으면 묻지 않고, 꺼져 있으면 아티팩트마다 한 번 묻습니다. 사용자만 답할 수 있는 확인에는 auto mode의 승인이 적용되지 않습니다.

• 전체 화면 목록의 스크롤 막대

  “N more” 행이 나타났다 사라질 때마다 스크롤 막대 위치가 흔들렸습니다. 대부분의 목록에서 막대가 고정되고, 클릭하거나 누르고 있으면 스크롤되는 ↑/↓ 화살표가 생겼습니다.

• 모델 대체 안내의 컨텍스트 크기 표시

  대체 모델로 바뀌면서 컨텍스트 창이 줄어들어도 이를 알 수 없었습니다. 모델 대체 안내와 자동 압축이 반복될 때의 오류가 컨텍스트 창이 1M에서 200K 토큰으로 줄었는지 알려 줍니다.

• 기타 개선

  • 백그라운드 에이전트가 사용자 메시지에 답할 때 받은 내용을 다시 요약하는 문단으로 시작하지 않습니다.
  • 외부 편집기(Ctrl+G)가 줄 번호를 받는 편집기라면 프롬프트에서 커서가 있던 줄로 열립니다.
  • 스킬이나 플러그인 명령이 많이 설치돼 있어도 슬래시 명령 제안이 입력 중에 빠르게 반응하며, 명령 설명은 단어 앞부분으로 일치 여부를 판단합니다.
  • 출력 스타일 선택 화면이 Default 대신 현재 스타일에서 열리고, 이름 아래 줄에 각 스타일의 설명이 표시됩니다. 숫자 키로는 더 이상 스타일을 고르지 않습니다.
  • /hooks의 훅 상세 화면 마지막 줄이 “it” 대신 “this hook”으로 표시됩니다.
  • 이미 연결된 MCP 서버를 호스트가 다시 활성화하라고 보내도 SDK와 -p 세션의 반응이 느려지지 않습니다.
  • Claude apps 게이트웨이가 /protocol에서 제공하는 프로토콜 페이지가 모르는 입력을 거부하지 말라고 안내하고, 현재 Claude Code가 보내는 내용과 일치하도록 갱신됐습니다.
  • [VSCode] Manage plugins에서 끈 플러그인이 다른 설정 때문에 여전히 켜져 있으면 이를 알려 주고, 플러그인 폴더 충돌을 설명합니다.
  • [Claude Tag] Slack에서 시작한 세션이 claude.ai에서 Slack 사용자 ID나 이스케이프 코드 없이 입력한 문장 그대로의 제목으로 표시됩니다.

동작이 바뀐 항목

• API 재시도 한도 통합 (변경)

  실패한 API 요청이 실제로 몇 번 다시 전송될지 예측하기 어려웠습니다. 이제 한 번의 모델 호출 전체에 하나의 한도가 적용되며, 기본 재시도 설정에서는 실패하는 호출이 최대 14번 요청을 보냅니다.

• --bare 모드 범위 축소 (변경)

  --bare는 명령줄에 지정한 MCP 서버만 연결하고, 모델에 시스템 알림(system reminder)을 보내지 않으며, 백그라운드 작업을 시작하지 않습니다. --bare에서 셸 명령이 시간 제한에 걸리면 백그라운드로 옮겨지지 않고 멈춥니다.

• 플러그인 설치 출처 제한 (변경)

  플러그인 설치가 git 저장소나 폴더를 가리키는 npm 출처를 거부하고, 플러그인 의존성은 레지스트리 패키지에서만 설치합니다.

• send now(ctrl+enter)와 스킬의 셸 명령 (변경)

  ctrl+enter를 누르면 스킬이 직접 실행한 셸 명령을 끝내지 않고 백그라운드로 옮깁니다.

• 목록 화면 정렬과 표기 (변경)

  • /artifacts, /mcp, /skills, /hooks 등 목록 화면에서 각 행의 세부 정보가 이름 뒤 한 열에 맞춰 정렬됩니다.
  • 목록의 넘친 행 표기가 “N more above” / “N more below”에서 ”↑ N more” / ”↓ N more”로 바뀌었습니다.
  • /hooks가 설정된 훅을 이벤트별로 묶은 하나의 목록으로 열립니다. 훅을 보려면 Enter를 세 번 눌러야 했지만 이제 한 번이면 됩니다.
  • 테마 선택 화면이 터미널 크기에 맞는 스크롤 목록으로 바뀌어 미리보기가 화면 밖으로 밀려나지 않습니다. 숫자 키로는 더 이상 테마를 고르지 않습니다.

• /exit의 Remove worktree 순서 (변경)

  Remove worktree가 Claude Code가 그 worktree에서 시작한 서버와 셸을 멈춘 뒤에 실행됩니다. Windows에서는 이 프로세스들 때문에 폴더가 삭제되지 않을 수 있었습니다.

• 기타 동작 변경

  • 실행 중이거나 대기 중인 작업이 없을 때 보낸 프롬프트가 회색이 아닌 일반 글자 색으로 바로 표시됩니다.
  • 속도 제한에 걸린 도메인 안전 확인에 대한 WebFetch 오류가 Claude에게 반복 재시도하지 말라고 안내합니다.
  • claude-api 스킬의 Managed Agents 예제가 네트워크가 제한된 환경을 만들도록 바뀌었습니다.
  • /ultrareview, claude ultrareview 출력에서 브라우저 링크가 빠졌습니다.
  • [VSCode] Stop과 Escape는 현재 턴만 끝냅니다. 백그라운드 에이전트는 계속 실행되며 에이전트 맵에서 하나씩 멈출 수 있습니다.
  • [VSCode] ”✻ Claude Code” 상태 표시줄 항목이 모든 창에 표시돼 열린 파일이 없어도 Claude를 열 수 있습니다.
  • [Cloud sessions] 예약 실행이 늦어져 아직 시작되지 않았으면 루틴 페이지에 지난 시각의 다음 실행 시간 대신 “Due”와 예약 시각이 표시됩니다.

주요 버그 수정

세션 재개와 인증

• 이전 세션이 비정상 종료되거나 강제로 끝난 경우, 병렬 도구 호출 묶음 이후의 모든 턴을 claude --resume과 --continue가 잃던 문제 수정.
• gcpAuthRefresh나 awsAuthRefresh 인증 정보가 만료되면 여러 Claude Code 프로세스와 IDE 확장이 각자 로그인 브라우저를 열던 문제 수정.
• macOS에서 ~/.claude/.credentials.json이 남아 있으면 다른 Claude Code 창에서 /login에 성공해도 “Not logged in”, “Login expired”가 계속 표시되던 문제 수정.
• 기본 모델이나 모델 별칭이 가리키는 모델을 Anthropic API가 거부하면 모든 턴이 실패하던 문제 수정. 같은 등급의 이전 모델로 한 번 재시도합니다.
• 대체 모델이 fast 속도로 실행될 수 없을 때 거절(refusal) 재시도와 --fallback-model 재시도가 실패하던 문제 수정. 표준 속도로 실행되며, 대화형 세션에서는 한 번 안내가 표시됩니다.
• claude auth status가 Console 로그인으로 저장된 API 키를 claude.ai로 보고하던 문제 수정. 이제 api_key로 보고하고, VS Code 확장도 이 세션을 API 키 세션으로 다룹니다.
• /status가 API 키 옆에 Anthropic 프로필을 둘 다 적용 중인 것처럼 표시하던 문제 수정. 프로필은 사용 중이 아니라고 표시됩니다.
• 도구나 훅이 텍스트 대신 객체, 숫자, 불리언을 반환한 뒤 API 400 오류가 나던 문제 수정. 재개한 세션에도 적용됩니다.
• 모델 대체가 한 턴만 이어질 때 커밋 작성자 표기 안내가 도구 출력 안에 다시 전송되던 문제 수정.
• [Windows] 신뢰 기록이 다른 대소문자로 저장된 경우, claude가 이미 신뢰하는 폴더를 claude --bg와 에이전트 화면이 거부하던 문제 수정.

로그와 transcript의 비밀 값 가리기

• “Bearer”나 “Basic”이 키 이름 앞에 오면 MCP 오류 메시지에 인증 정보 값이 표시되던 문제 수정.
• 퍼센트 인코딩된 Bearer 토큰이 오류 메시지에서 일부만 가려지던 문제 수정.
• 키 이름에 폭이 없는 공백(zero-width space) 같은 보이지 않는 문자가 들어간 비밀 값이 가린 로그와 transcript에 드러나던 문제 수정.
• URL 비밀번호에 ), 따옴표, ], &, 두 번째 @ 같은 문장 부호가 있거나, ssh URL에서 비밀번호가 /를 지나 [::1] 같은 대괄호 호스트까지 이어지면 로그와 transcript에 일부가 보이던 문제 수정.
• /feedback이 디스크에 저장하는 zip의 세션 transcript에 비밀 값을 가린 뒤 잘못된 JSON 줄이 남던 문제 수정.

Remote Control과 클라우드 세션

• 조직 정책이 Remote Control을 끈 뒤에도 Remote Control 세션(claude remote-control 포함)이 연결된 채로 남던 문제 수정. 이제 안내와 함께 연결이 끊깁니다.
• Remote Control로 보낸 메시지의 첨부 파일이 도착하지 않아도 Claude가 알지 못하던 문제, 파일의 마지막 다운로드 시도에 10초만 주어지던 문제 수정.
• Claude Code가 종료되는 도중 도착한 Remote Control 메시지가 전달됨으로 표시되고 답을 받지 못하던 문제 수정. 세션이 다음에 실행될 때까지 대기열에 남습니다.
• 기록이 매우 긴 클라우드 세션이 transcript를 불러오는 중에 컨테이너가 멈춰 다시 깨어나지 못하던 문제 수정.
• 이름이 매우 긴 파일을 클라우드 세션에 첨부하면 전달되지 않던 문제 수정.
• [Cloud sessions] Claude가 메시지를 보낸 뒤 세션이 유휴 상태가 되면, 답한 질문 카드나 승인한 도구 호출에 응답이 없던 문제 수정.
• [Cloud sessions] 관리자 설정에서 조직 환경의 설정 스크립트를 지워도 새 클라우드 세션이 이전 스크립트를 실행하던 문제 수정.
• [Cloud sessions] self-hosted 환경 관리자 페이지의 Runner actions 메뉴가 열린 지 몇 초 뒤 저절로 닫히던 문제 수정.
• [Cloud sessions] 클라우드 세션이 시작조차 되지 않은 루틴 실행이 Runs 창, 루틴 페이지, 사이드바에 Succeeded로 표시되던 문제 수정. 이제 Failed로 표시됩니다.
• [Cloud sessions] Outputs 카드에서 오디오, 비디오 파일을 클릭하면 재생 대신 빈 파일 검색이 열리던 문제 수정.

MCP와 플러그인

• 서버가 이전 MCP 핸드셰이크 지원을 중단하면 MCP 커넥터의 도구 목록이 최대 하루 동안 비어 있던 문제 수정.
• Claude가 MCP 로그인을 다시 요청하면 대기 중인 로그인 링크가 교체돼 기존 링크가 작동하지 않을 수 있던 문제 수정.
• MCP 디스커버리 캐시가 켜진 headless 세션에서 다시 인증에 성공한 뒤에도 “MCP servers require authentication” 알림이 반복되던 문제 수정.
• 서버가 아직 연결 중이거나 막 연결된 시점(예: 재시작 직후)에 실행된 도구 호출이 /usage에서 해당 MCP 서버에 집계되지 않던 문제 수정.
• 일시적인 서버 오류 뒤 claude.ai에서 켠 플러그인이 한 세션 동안 Claude Code에서 사라지던 문제 수정.
• Claude Code가 불러오기를 거부한 마켓플레이스의 플러그인 오류가 “not found”로만 표시되던 문제 수정. 이제 이유와 해결 방법을 알려 줍니다.
• /plugin의 Discover 탭에서 행에는 따옴표로 표시된 마켓플레이스 이름이 “Checking … for new plugins” 줄에서는 따옴표 없이 표시되던 문제 수정.

서브에이전트와 백그라운드 작업

• 실행 중인 서브에이전트에 입력한 메시지가 서브에이전트가 읽은 뒤 transcript에 두 번 표시되던 문제 수정.
• 등록된 이름이 없는 서브에이전트가 결과를 넘길 때 에이전트 이름 대신 원시 작업 id가 표시되던 문제 수정.
• 작업 추적 도구가 켜진 세션에서 포그라운드 서브에이전트에 TaskCreate/Get/Update/List, TodoWrite가 빠지던 문제 수정.
• worktree 격리로 실행한 서브에이전트가 첫 파일 읽기에서 worktree 사본의 프로젝트 CLAUDE.md와 그 import를 한 번 더 불러오던 문제 수정.
• 응답 도중 연결이 몇 분간 멈추면 Workflow 도구의 서브에이전트가 원래 프롬프트부터 다시 시작하던 문제 수정.
• 백그라운드 에이전트나 팀원의 transcript를 보는 중에 입력한 /compact, /clear, /rewind가 알림 없이 메인 대화에 적용되던 문제 수정. 이제 대상을 밝히는 확인 창이 먼저 뜹니다.
• 사용자 승인을 기다리는 백그라운드 작업이 완료로 표시되던 문제 수정.

화면 표시

• 전체 화면 모드에서 접힌 행(“Thought for 4s” 등)의 단어 사이 빈 곳을 클릭하면 펼쳐지지 않고 강조만 되던 문제 수정.
• 목록 화면에서 세부 정보가 없는 행(이름이 긴 동작 행 등)이 다른 모든 행의 세부 정보를 오른쪽으로 밀어내던 문제 수정.

Claude apps 게이트웨이

• 게이트웨이의 지출 측정기가 1시간 프롬프트 캐시 쓰기를 더 저렴한 5분 요금으로 계산하던 문제 수정.
• 웹 검색 같은 서버 측 도구를 실행하는 스트리밍 턴에서 첫 번째 모델 호출의 입력 토큰만 집계하던 문제 수정.

[VSCode]

• 사이드바에 이미 열린 대화를 탭에서 하나 더 열던 문제 수정. 사이드바가 해당 대화로 전환됩니다.
• Claude Code의 출력이 1MB를 넘으면 설정 창이 다시 확인하지 않고 저장 실패로 보고하던 문제 수정.
• 확장이 응답하지 않을 때 “Teleporting session…” 표시가 끝없이 돌던 문제 수정.

[Claude Tag]

• 기본 Sonnet 모델을 쓸 수 없는 조직에서 메모리 검색(memory recall)이 아무것도 찾지 못하던 문제 수정.
• Enterprise Grid 관리자가 Slack 채널을 다른 워크스페이스로 옮기고 그 뒤 첫 게시글이 Claude를 언급하지 않으면 채널의 Claude 설정이 사라지던 문제 수정.
• Claude가 방금 한 질문에 Slack 스레드에서 답하면 Claude가 가끔 새 머신에서 처음부터 다시 시작해 푸시하지 않은 작업을 잃던 문제 수정.
• 규모가 큰 조직에서 지출 한도 페이지의 공개 채널 이름이 원시 Slack ID로 표시되던 문제 수정.

알아두면 좋은 점

• 실패한 API 요청은 모델 호출 하나당 최대 14번까지 전송됩니다 — 기본 재시도 설정 기준이며, 재시도 한도가 모델 호출 전체에 하나로 적용됩니다.
• --bare로 실행하는 스크립트는 명령줄에 지정한 MCP 서버만 연결됩니다 — 시스템 알림을 보내지 않고 백그라운드 작업도 시작하지 않으며, 시간 제한에 걸린 셸 명령은 백그라운드로 넘어가지 않고 멈춥니다.
• git 저장소나 폴더를 npm 출처로 쓰는 플러그인은 설치되지 않습니다 — 플러그인 의존성도 레지스트리 패키지에서만 설치됩니다.
• 프로젝트나 사용자 스킬에 verify라는 스킬을 두면 Claude가 커밋 직전에 실행합니다 — 문서만, 테스트만 바꾸는 커밋은 제외됩니다.
• 테마와 출력 스타일 선택 화면에서 숫자 키로 고르던 방식은 더 이상 동작하지 않습니다.
• [VSCode] Stop과 Escape가 백그라운드 에이전트를 멈추지 않습니다 — 백그라운드 에이전트는 에이전트 맵에서 하나씩 멈춥니다.