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

Claude Code 2.1.261

불러온 스킬 중 쓰이지 않는 것과 각각이 차지하는 컨텍스트 비용을 보여주는 `/skill-doctor`가 추가되고, 명령 출력과 백그라운드 작업 출력을 파일로 넘기기 전까지 인라인으로 받는 양을 최대 128K자까지 올리는 `bashOutputMaxChars`, `taskOutputMaxChars` 설정이 생겼습니다. `/status`와 `claude doctor`는 조직 정책을 왜 불러오지 못했는지 알려주고, 프롬프트의 단어 단위 편집 키가 Bash와 같은 방식으로 바뀌면서 `keybindingFlavor` 설정은 더 이상 동작하지 않습니다. 버그 수정 47건은 빠르게 입력하거나 키를 누르고 있을 때 글자 순서가 바뀌거나 일부가 사라지던 문제, 세션을 재개하면 병렬 도구 호출 주변의 훅 출력과 맥락이 사라지던 문제, Remote Control의 권한 모드 표시와 정지 처리, 재개할 수 없는 백그라운드 에이전트가 CPU를 계속 쓰던 문제 등을 다룹니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.261이 2026년 9월 4일 출시됐습니다. 새로 들어온 것들은 “왜 안 되는지, 무엇이 낭비되는지 보이게 하는” 쪽에 몰려 있습니다. 조직 정책을 불러오지 못한 이유를 알려주는 /status 항목, 쓰이지 않는 스킬과 그 컨텍스트 비용을 정리해주는 /skill-doctor가 그렇습니다. 잘려서 파일로 넘어가던 명령 출력을 인라인으로 더 받게 하는 설정도 추가됐습니다. 나머지 대부분은 수정으로, VS Code 확장이 20건으로 가장 많고 CLI 쪽에서는 Remote Control과 원격 세션, 세션 재개, 기업 환경의 프록시가 주를 이룹니다.

새 기능

  • /skill-doctor

    스킬을 여러 개 설치해 두면 매 요청마다 그 설명이 컨텍스트에 실리지만, 어느 스킬이 실제로 쓰이고 있고 어느 것이 자리만 차지하는지 알 방법이 없었습니다. 이제 /skill-doctor가 불러온 스킬 중 쓰이지 않는 것과 각각이 차지하는 컨텍스트 비용을 보여줘서, 정리할 대상을 고를 수 있습니다.

  • bashOutputMaxChars, taskOutputMaxChars 설정

    명령이나 백그라운드 작업의 출력이 길면 일정 지점부터 파일로 저장되고 Claude는 그 내용을 직접 보지 못했습니다. 이제 이 두 설정으로 파일로 넘기기 전까지 Claude가 인라인으로 받는 분량을 최대 128K자까지 올릴 수 있습니다.

  • /status와 claude doctor의 “Organization policy” 항목

    조직 정책이 적용되지 않았을 때 그 이유를 알 수 없었습니다. 이제 정책을 불러오지 못한 원인이 표시됩니다. 예를 들어 프록시가 해당 엔드포인트를 통과시키지 않는 경우가 여기에 해당합니다.

  • --append-subagent-system-prompt-file

    서브에이전트 시스템 프롬프트는 명령줄 인자로만 넘길 수 있어서, 길어지면 넘길 방법이 없었습니다. 이제 이 옵션으로 파일에서 읽어올 수 있습니다.

  • [VSCode] Output styles 메뉴의 “Build a custom style” 안내, MCP 서버 추가와 제거

    사용자 정의 출력 스타일을 만들려면 파일을 직접 작성해야 했고, MCP 서버를 추가하거나 지우려면 IDE 밖으로 나가야 했습니다. 이제 Output styles 메뉴의 안내를 따라가면 사용자 정의 출력 스타일 파일이 만들어지고 목록에 바로 나타나며, MCP servers 대화상자에 Add server 양식과 Remove 동작이 생겼습니다.

  • [VSCode] 세션 목록의 열림 표시와 Archive session, 권한 프롬프트 접기 버튼

    터미널이나 다른 VS Code 창, Claude Desktop에서 열려 있는 세션이 목록에서는 닫힌 것처럼 보였고, 권한이나 질문 프롬프트가 떠 있으면 뒤쪽 대화를 읽을 수 없었습니다. 이제 다른 곳에서 열린 세션에는 속이 빈 고리 표시가 붙고, 프롬프트에 접기 버튼이 생겨 답하지 않은 채로 대화를 읽을 수 있습니다(프롬프트 옆 여백에서도 대화가 스크롤됩니다). 세션 목록 오른쪽 클릭 메뉴에는 Archive session이 추가되고 Unarchive에는 별도 아이콘이 붙었습니다.

주요 개선

  • 프롬프트의 단어 단위 편집 키가 Bash와 같은 방식으로

    Ctrl+W, Alt+F, Alt+D의 동작 범위가 Bash와 달라 익숙한 대로 눌렀다가 예상과 다르게 지워지는 일이 있었습니다. 이제 Ctrl+W는 공백까지 뒤로 지우고, Alt+F와 Alt+D는 단어 끝에서 멈추며, 구두점이 단어를 나눕니다. 이에 따라 keybindingFlavor 설정은 더 이상 동작에 영향을 주지 않습니다.

  • /model 선택 화면과 VS Code 모델 표시의 모델 이름

    Bedrock, Vertex AI, LLM 게이트웨이를 쓰면 목록에 원본 ID 문자열이 그대로 나와 어떤 모델인지 알아보기 어려웠습니다. 이제 Claude Code가 아는 ID면 모델 이름으로 표시합니다.

  • 응답 헤더가 없을 때의 재시도 대기

    API가 응답 헤더를 전혀 보내지 않으면 재시도가 3분을 더 기다린 뒤에야 끝났고, 메시지만으로는 무엇을 바꿔야 하는지 알 수 없었습니다. 이제 API_TIMEOUT_MS(기본 10분)까지 기다리며, 안내 메시지에 무엇을 조정해야 하는지 나옵니다.

  • 위험한 rm 확인 범위 확대

    rm -rf가 위치 매개변수에 적용되거나 큰따옴표로 묶인 sh -c 스크립트 안에 들어 있으면 안전 확인이 걸리지 않았습니다. 이제 이 두 경우도 확인 대상에 들어갑니다.

  • auto mode에서 다이어그램 렌더러 링크를 업로드로 취급

    내용을 URL 안에 그대로 담아 보내는 공개 다이어그램 렌더러 링크는 사실상 그 사이트에 내용을 올리는 것인데도 auto mode에서 자동 승인됐습니다. 이제 사용자가 요청한 경우가 아니면 자동 승인되지 않습니다.

  • forceLoginMethod: "gateway"가 남아 있는 자격 증명보다 우선

    관리형 설정으로 게이트웨이 로그인을 지정해도, 기기에 예전 API 키나 claude.ai 로그인이 남아 있으면 그쪽이 쓰였습니다. 이제 이런 기기는 남은 자격 증명을 무시하고 /login을 요구합니다. Bedrock, Vertex AI, Foundry 세션은 영향을 받지 않습니다.

  • /context의 로컬 토큰 추정

    토큰 계산 API를 쓸 수 없으면 작은 모델에 추가 요청을 보내 개수를 셌습니다. 이제 그런 경우 로컬 추정값을 사용합니다.

  • Vertex AI 시작 속도

    GOOGLE_APPLICATION_CREDENTIALS가 설정돼 있어도 API 클라이언트를 만들 때마다 Google Cloud 프로젝트 탐색이 다시 돌고 gcloud 프로세스가 추가로 떴습니다. 이제 이 과정이 반복되지 않습니다.

  • 스트리밍 중 화면 갱신 성능

    화면이 갱신될 때마다 이미 그려진 블록까지 레이아웃 계산을 다시 거쳤습니다. 이제 그 부분을 건너뜁니다.

  • 관리형 설정 로드가 403으로 막힐 때의 안내

    시작할 때나 /login 뒤에 Claude apps gateway가 403을 돌려주면 다시 로그인하라는 안내가 나왔습니다. 이제 조직에 Claude Code가 활성화되지 않았을 수 있다는 안내로 바뀌었습니다.

  • [VSCode] 모델 선택 화면을 하나의 평면 목록으로

    모델이 나뉘어 있어 찾기 번거로웠습니다. 이제 전체 모델이 한 목록에 나오며, 예전 표기의 모델 항목은 목록 맨 뒤에 남습니다.

주요 버그 수정

입력과 화면

  • 빠르게 입력하거나 붙여넣을 때, 또는 키를 누르고 있을 때 글자 순서가 바뀌거나 일부가 사라지던 문제 수정.
  • 프롬프트 입력창에서 인라인 [Image #N] 표시 바로 앞 글자를 지울 수 없던 문제 수정.
  • 터미널 진행 표시(iTerm2, Ghostty, ConEmu)가 백그라운드 워크플로나 에이전트가 아직 도는 중인데도 세션이 끝난 것으로 표시하던 문제 수정.
  • 컨테이너의 배치 방향이 가로에서 세로로(또는 반대로) 바뀐 뒤 상자가 잘못된 높이로 그려지던 드문 문제 수정.

Remote Control과 원격 세션

  • 휴대폰, 브라우저, claude.ai 앱이 터미널 세션에 붙을 때나 터미널에서 모드를 바꾼 뒤 Remote Control이 예전 권한 모드를 표시하던 문제 수정.
  • 연결된 휴대폰이나 브라우저에서 턴을 정지시키거나 /clear 같은 로컬 슬래시 명령을 쓴 뒤에도 세션이 계속 작업 중인 것처럼(회전 표시와 Stop 버튼이 남은 채로) 보이던 문제 수정.
  • SDK와 클라우드 세션이 첫 프롬프트 직후, 턴이 시작되기 전에 보낸 정지 요청을 무시하던 문제 수정. 이제 끝까지 실행되지 않고 그 자리에서 멈춥니다.
  • Remote Control이 /teleport로 가져온 세션을 연결된 세션에 올려보내, 휴대폰과 웹에서 원래 세션 뒤에 이어 붙은 것처럼 보이던 문제 수정.
  • 네이티브 Windows에서 HTTPS 트래픽을 열어 검사하는 회사 프록시 뒤에 있으면 Remote Control의 수신 이벤트 스트림이 실패하던 문제 수정.
  • effort level을 설정에서 지정한 경우 Remote Control 세션이 claude.ai에서 기본값으로 표시되던 문제 수정.
  • 다른 기기의 접속이 끊긴 Remote Control 세션에 보낸 SendMessage가 전달 완료로 표시되던 문제 수정. 이제 그 기기가 다시 연결될 때까지 대기 중이라고 알려줍니다.

세션 재개와 백그라운드 작업

  • 세션을 재개하면 병렬 도구 호출 주변의 훅 출력과 그 밖의 맥락이 사라져 재개된 요청 내용이 달라지던 문제 수정.
  • claude -p --resume <file>이 대화 기록에 잘못된 형식으로 남은 세션 ID를 그대로 가져다 쓰던 문제 수정. 이제 새 세션 ID로 재개합니다.
  • 재개할 수 없는 백그라운드 에이전트의 깨우기 시도가 짧은 간격으로 반복되면서 CPU 사용량이 계속 높게 유지되던 문제 수정.
  • 같은 프로세스에서 도는 에이전트 팀 구성원이 두 번째 턴에도 첫 턴의 도구, 스킬 안내를 다시 보내던 문제 수정. 요청 앞부분이 매번 달라져 프롬프트 캐시에 적중하지 못했습니다.
  • 아티팩트의 갱신만 지켜보고 있는 세션을 데스크톱 앱과 웹이 작업 중으로 표시하던 문제 수정.

기업 환경과 게이트웨이

  • AWS나 AWS 자격 증명 도우미가 응답하지 않을 때 Bedrock 설정 마법사가 멈춰 있던 문제 수정. 이제 시간이 지나면 원인을 알려주며 종료됩니다. HTTPS 트래픽을 열어 검사하는 프록시 뒤에서 모델 확인이 실패하던 문제도 함께 수정됐습니다.
  • Google 자격 증명 확인이 느릴 때 gcpAuthRefresh가 자격 증명이 아직 유효한데도 시작 시 브라우저를 띄우던 문제 수정.
  • 시작할 때 커넥터 목록을 가져오는 요청이 시간 초과되면 claude.ai 커넥터가 그 세션 내내 나타나지 않던 문제 수정. 이제 백그라운드에서 다시 시도합니다.
  • 신뢰된 프록시가 X-Forwarded-For에 포트를 덧붙이면 Claude apps gateway가 클라이언트 IP를 잘못 읽던 문제 수정. 접근 목록이 설정된 상태에서 읽을 수 없는 항목이 오면 403으로 처리됩니다.
  • 터미널 CLI가 protobuf를 쓰는데도 Claude apps gateway가 Claude Desktop에는 OpenTelemetry를 JSON으로 보내라고 지시하던 문제 수정. protobuf만 받는 수집기가 데스크톱 앱의 데이터를 거부하고 있었습니다.
  • 더 높은 버전에만 적용되는 기능 플래그가 같은 기기에서 도는 이전 버전 Claude Code에 간헐적으로 적용되던 문제 수정.

플러그인, 커넥터, 사용량 표시

  • 관리형 설정의 enabledPlugins가 강제로 켠 플러그인일 때 클라우드 세션이 claude.ai에서 동기화된 플러그인을 버리고, 실패할 수 있는 마켓플레이스 복제본으로 되돌아가던 문제 수정.
  • 백그라운드 Bash 명령으로 실행한 CLI의 플러그인 설치 안내가 인식되지 않고, <claude-code-hint> 태그가 대화에 그대로 노출되던 문제 수정.
  • Claude Desktop 앱에서 실행한 로컬 Cowork 세션에서 Claude in Chrome의 file_upload가 “paths: expected array, received undefined” 오류로 실패하던 문제 수정.
  • 사용량 엔드포인트가 요청 제한에 걸렸거나 시작 직후에 열었을 때 /usage와 VS Code 사용량 패널에서 모델별 주간 한도 줄이 빠지던 문제 수정.
  • 작업 디렉터리가 /net 자동 마운트 경로에 있으면 /add-dir <subdirectory>가 경로를 해석하지 못했다는 잘못된 오류를 내던 문제 수정.

[VSCode]

  • Claude Code on the web에서 가져온 세션에서, 클라우드 세션이 종료되며 잘린 질문을 거절한 것으로 처리하던 문제 수정.
  • 창과 함께 복원된 탭의 Rename 입력창이 비어서 열리던 문제 수정. 이제 현재 이름이 채워진 상태로 열립니다.
  • 세션 목록 패널을 불러올 때마다 접어둔 항목이 잠깐 펼쳐져 보이던 문제 수정.
  • Claude가 이미 다음 작업으로 넘어갔는데도(예: 질문에 대한 답을 기다리는 동안) Focus 화면에 도구 호출이 실행 중으로 남던 문제 수정.
  • 포커스가 없는 Claude 탭의 세션 ID가 바로잡히면 세션 목록의 현재 항목 강조가 어긋나던 문제 수정.
  • Claude 탭에 포커스가 있을 때 Cmd/Ctrl+Shift+T로 다시 열거나 딥 링크로 여는 탭이 Claude 편집기 그룹 밖에 놓이던 문제 수정.
  • Claude Code on the Web에서 연 세션에 “Add to group”을 쓰면 그룹에 항목이 둘로 늘어나던 문제 수정. 이제 세션 목록에 표시되는 항목이 이동합니다.
  • 조직이 이후에 사용을 중지한 모델이 창을 두 번 다시 불러올 때까지 모델 선택 화면에 남아 있던 문제 수정.
  • VS Code가 탭의 화면을 다시 불러온 뒤, 세션 목록에서 연 탭이 그 세션으로 되돌아가거나 웹 세션에서 연 탭이 teleport를 다시 시작하거나 빈 채로 남던 문제 수정.
  • 창을 다시 불러온 직후나 설정 파일에 오류가 있는 상태에서 질문하면 이전 세션의 /btw 질문 기록이 덮어써지던 문제 수정.
  • Claude.ai나 Console 계정으로 로그인한 상태에서 Claude 패널을 다시 불러오면 대기 중이던 질문 카드가 나타나지 않던 문제 수정.
  • 한 패널이 설정 파일에서 서드파티 제공자를 읽어들인 뒤에도 같은 창의 다른 Claude 패널에 claude.ai 전용 기능이 남아 있던 문제 수정.
  • Claude Code가 로그인 정보 없음을 알리거나 로그인이 없어 요청이 실패했을 때, Disable Login Prompt 설정을 켜 두었는데도 로그인 화면이 뜨던 문제 수정.
  • 다음 순번의 권한 프롬프트가 이전 프롬프트에 입력한 글자를 그대로 가지고 있고, 바로 이어진 두 번째 클릭까지 받아들이던 문제 수정.
  • 세션 목록만 열려 있던 창에서 플러그인 설치 링크를 누르면 설치 대화상자 없이 Claude 사이드바만 열리던 문제 수정.
  • 새 창에서 Account & usage 대화상자를 열기 전까지 사이드바 사용량 표시가 비어 있고, 0%인 사용량 한도가 표시에서 빠지던 문제 수정.
  • New conversation 뒤에 “Start new session in this group”이 그룹을 잃던 문제와, 사이드바의 읽지 않음 목록이 로드되기 전에 끝난 세션에 읽지 않음 표시가 붙지 않던 문제 수정.
  • 턴이 도는 중에 편집기 탭 배지가 읽지 않음으로 표시되거나 세션 목록에서 연 탭에는 배지가 나타나지 않던 문제, 보관된 세션에 “Add Session Tab to Group”이 아무 반응이 없던 문제 수정.
  • “Enable Remote Control for all sessions”를 켜도 다른 VS Code 창에 열린 세션에는 바로 적용되지 않던 문제 수정.
  • claude.ai에서 이어온 세션의 탭이 웹 세션 쪽에 기록돼 세션 목록의 Open 필터에 걸리지 않던 문제 수정. 필터 메뉴의 각 구역에는 화면 낭독기용 이름이 붙었습니다.

알아두면 좋은 점

  • keybindingFlavor 설정은 더 이상 동작하지 않습니다 — 프롬프트의 단어 단위 편집 키가 Bash와 같은 방식으로 통일됐습니다. 이 설정으로 다른 방식을 쓰고 있었다면 업그레이드 후 Ctrl+W, Alt+F, Alt+D의 동작 범위가 달라집니다.
  • forceLoginMethod: "gateway" 기기는 남아 있는 API 키나 claude.ai 로그인을 무시합니다 — 업그레이드 후 /login을 다시 해야 할 수 있습니다. Bedrock, Vertex AI, Foundry 세션은 해당하지 않습니다.
  • auto mode에서 공개 다이어그램 렌더러 링크는 자동 승인되지 않습니다 — 내용을 URL에 담아 보내는 링크는 그 사이트에 올리는 것으로 취급되므로, 사용자가 요청하지 않았다면 확인을 묻습니다.
  • bashOutputMaxChars, taskOutputMaxChars의 상한은 128K자입니다 — 그보다 긴 출력은 여전히 파일로 저장되어 Claude가 필요할 때 읽는 방식으로 처리됩니다.
  • 응답 헤더가 없는 요청의 재시도 대기가 길어질 수 있습니다 — 기존 3분 대신 API_TIMEOUT_MS(기본 10분)까지 기다립니다. 더 빨리 끊기를 원한다면 이 값을 낮춰야 합니다.
  • /context 수치가 추정값일 수 있습니다 — 토큰 계산 API를 쓸 수 없을 때는 추가 요청을 보내는 대신 로컬 추정값을 사용합니다.