Claude Code 2.1.141 업데이트

💡

훅이 데스크톱 알림·창 제목·벨을 제어 단말 없이 보낼 수 있도록 `terminalSequence` 필드가 추가되고, SSH 키 없이 GitHub 플러그인을 받을 수 있는 `CLAUDE_CODE_PLUGIN_PREFER_HTTPS`, 워크로드 ID 페더레이션 토큰의 범위를 좁히는 `ANTHROPIC_WORKSPACE_ID`, 디렉터리로 세션 목록을 좁히는 `claude agents --cwd`가 도입되었습니다. `/feedback`이 최근 24시간/7일 세션을 묶어 보낼 수 있고, Rewind 메뉴에는 "Summarize up to here"가 추가되어 이전 맥락을 압축할 수 있습니다. Bedrock/Vertex/Foundry 게이트웨이의 백그라운드 Haiku 모델 폴백, Remote Control MCP의 401 처리, plugin 마켓플레이스 `ref` 누락 시 설치 실패, MCP 서버 환경변수 검증과 403 vs `needs auth` 표시 등 인증·세션·MCP·플러그인·UI 영역의 결함이 한 차례에 폭넓게 정리되었습니다.

#Claude Code#업데이트
🔗 공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.141이 2026년 5월 13일(현지 시간) 릴리스되었습니다. 훅이 제어 단말 없이도 데스크톱 알림·창 제목·벨을 직접 제어할 수 있게 해주는 terminalSequence 필드, SSH 키 없이 GitHub에서 플러그인을 받을 수 있는 CLAUDE_CODE_PLUGIN_PREFER_HTTPS, 워크로드 ID 페더레이션 토큰의 적용 범위를 워크스페이스 단위로 좁히는 ANTHROPIC_WORKSPACE_ID, 디렉터리 기준으로 claude agents 세션 목록을 좁히는 --cwd 옵션이 새로 들어왔습니다. /feedback은 이번 세션뿐 아니라 최근 24시간 또는 7일치 세션을 함께 묶어 보낼 수 있고, Rewind 메뉴에는 “Summarize up to here”가 추가되어 이전 맥락을 압축한 채 최근 턴만 살릴 수 있습니다. 동시에 Bedrock/Vertex/Foundry 게이트웨이에서 백그라운드 작업이 존재하지 않는 Haiku 모델 ID를 던지던 문제, Remote Control MCP가 워커 세션 토큰 회전 도중 일제히 401로 떨어지던 문제, claude plugin install이 업스트림에서 ref가 사라진 마켓플레이스 항목 때문에 실패하던 문제, MCP HTTP/SSE 서버의 403을 “failed”로만 표시하던 문제처럼 운영에 직접 영향을 주는 결함들이 한 번에 정리되었습니다.

새 기능

  • terminalSequence 훅 출력 필드 — 단말 없이 알림·창 제목·벨 제어

    훅이 데스크톱 알림·창 제목·벨을 보내려면 제어 단말이 필요해 백그라운드 환경에서는 활용하기 어려웠습니다. 훅 JSON 출력에 terminalSequence 필드가 추가되어, 제어 단말 없이도 훅이 직접 단말 시퀀스를 emit할 수 있게 되었습니다.

  • CLAUDE_CODE_PLUGIN_PREFER_HTTPS — SSH 키 없이 GitHub 플러그인 받기

    GitHub 플러그인 소스는 SSH로 클론되어 GitHub SSH 키가 없는 환경에서는 설치가 막혔습니다. CLAUDE_CODE_PLUGIN_PREFER_HTTPS를 설정하면 HTTPS로 클론하도록 전환되어 키리스 환경에서도 동작합니다.

  • ANTHROPIC_WORKSPACE_ID — 페더레이션 토큰 범위 워크스페이스 단위로 좁히기

    워크로드 ID 페더레이션 규칙이 여러 워크스페이스를 포괄할 때 발급된 토큰이 의도보다 넓은 범위를 갖는 문제가 있었습니다. 환경변수 ANTHROPIC_WORKSPACE_ID로 페더레이션 토큰을 특정 워크스페이스에 고정할 수 있습니다.

  • claude agents --cwd <path> — 디렉터리 기준 세션 필터

    claude agents로 세션 목록을 보면 다른 프로젝트의 세션까지 한 번에 표시되어 작업 중인 디렉터리만 추리기 번거로웠습니다. --cwd <path> 옵션을 추가해 특정 디렉터리에 속한 세션만 보여주도록 좁힐 수 있습니다.

  • /feedback — 최근 24시간 또는 7일 세션 동봉

    버그가 한 세션을 넘어 여러 세션에 걸쳐 발생할 때, 이번 세션만 첨부하면 재현 단서가 부족한 경우가 많았습니다. /feedback에서 최근 24시간 또는 7일치 세션을 함께 포함할 수 있도록 옵션이 추가되었습니다.

  • Rewind 메뉴 — “Summarize up to here” 추가

    이전 맥락이 길어졌을 때 부분만 잘라내고 최근 턴을 유지하려면 수동으로 옮겨야 했습니다. Rewind 메뉴에 “Summarize up to here”가 추가되어, 지정 지점까지의 이전 맥락을 요약으로 압축하고 최근 턴은 그대로 보존할 수 있습니다.

주요 개선

  • Auto 모드 권한 다이얼로그 — permissions.ask 규칙이 원인일 때 사유 표시

    Auto 모드 환경에서 권한 프롬프트가 떠도 어떤 규칙 때문에 떠 있는지 추적이 어려웠습니다. 이제 permissions.ask 규칙이 프롬프트를 유발한 경우 다이얼로그에 그 사유가 함께 표시됩니다.

  • 파일 편집 권한 프롬프트 — IDE 연결 시 “view diff in your IDE” 복원

    IDE가 연결되어 있을 때 권한 프롬프트에서 IDE 뷰로 diff를 여는 옵션이 사라져 검토 흐름이 끊겼는데, 이번 릴리스에서 다시 복원되었습니다.

  • 백그라운드 에이전트 — 현재 권한 모드 유지

    /bg나 ←←로 백그라운드 에이전트를 띄우면 권한 모드가 기본값으로 되돌아가, 호출 시점의 모드를 유지하지 못했습니다. 이제 현재 권한 모드가 보존됩니다.

  • claude agents — 백그라운드 셸이 남은 완료 세션을 Completed로 이동

    실제 작업이 끝났지만 백그라운드 셸이 남아 있는 에이전트가 계속 Working 영역에 머물러 상태 구분이 어려웠습니다. 이런 세션은 이제 Completed로 분류됩니다.

  • 긴 사고 구간의 스피너 피드백 강화

    사고 시간이 길어질 때 정상 동작 중인지 멈춘 건지 가늠하기 어려웠습니다. 10초가 지나면 스피너가 앰버 색조로 변하며 “여전히 작업 중”임을 시각적으로 알립니다.

  • 플러그인 메뉴 내비게이션 개선

    플러그인 메뉴에서 탭 전환이 직관적이지 않았는데, →/Tab으로 탭 전환, ↑로 탭 스트립 이동이 동작하고 풀스크린 모드에서는 탭 헤더와 검색 박스를 클릭으로도 조작할 수 있게 되었습니다.

주요 버그 수정

인증·게이트웨이

  • Bedrock/Vertex/Foundry/게이트웨이의 백그라운드 사이드 쿼리가 사용 불가능한 Haiku 모델 ID를 보내던 문제 — ANTHROPIC_SMALL_FAST_MODEL 오버라이드가 없으면 메인 루프 모델로 폴백합니다.
  • ANTHROPIC_BASE_URL 커스텀 게이트웨이에서 백그라운드 작업이 자동 명명되지 않던 문제 — Haiku 모델이 설정되어 있지 않으면 네이머가 메인 모델을 사용하도록 수정.
  • 데스크톱 및 서드파티 프로바이더 세션이 호스트 관리형 설정에서 apiKeyHelper/ANTHROPIC_AUTH_TOKEN을 잘못 상속하던 문제 수정.
  • Bedrock — 환경에 AWS 자격 증명이 이미 풀려 있을 때 awsCredentialExport가 건너뛰어져 크로스 어카운트 인증이 실패하던 문제 수정. 이제 설정되어 있으면 항상 실행됩니다.

Remote Control·세션

  • Remote Control MCP 커넥터가 워커 세션 토큰 회전 중 일제히 401로 떨어지던 문제 수정.
  • Remote Control이 서버가 stale 토큰을 거절했을 때 자동으로 신뢰된 기기를 재등록하던 문제 — 이제 자동 재등록 대신 /login 플로우를 거치도록 수정.

플러그인·MCP

  • claude plugin install이 마켓플레이스 ref가 업스트림에 더 이상 존재하지 않는데 sha가 핀 고정된 경우 실패하던 문제 수정.
  • .mcp.json으로 MCP 서버를 선언한 플러그인의 상세 패널이 “MCP 서버 0개”로 표시되던 문제 수정.
  • 설정 변수가 빠진 플러그인 MCP 서버가 일반 연결 실패 메시지로 표시되던 문제 — 이제 “config issue” 메시지와 함께 수정 힌트가 표시되며, 잘못된 .mcp.json 항목이 다른 MCP 서버를 함께 누락시키지 않습니다.
  • POSIX 셸 파라미터 확장(${var%pattern} 등)을 쓴 MCP 서버 설정이 환경변수 누락으로 잘못 표시되던 문제 수정.
  • MCP HTTP/SSE 서버가 연결 시 403을 반환하면 “failed”로만 표시되던 문제 — 이제 “needs auth”로 정확히 구분됩니다.
  • 원격 MCP 서버가 선택적 server-events 스트림 재연결에 실패했을 때 불필요하게 연결을 끊던 문제 수정. 툴 호출은 POST로 계속 동작합니다.

/model·권한·훅

  • 한 세션에서 /model을 바꾸면 다른 동시 세션의 autocompact 임계값이 조용히 함께 바뀌던 문제 수정.
  • 툴 권한 프롬프트가 열려 있는 동안 권한 모드를 바꿔도 프롬프트가 자동으로 닫히지 않던 문제 수정. 새 설정이 해당 툴을 허용하면 자동 해제됩니다.
  • 권한·대화 프롬프트가 열린 상태에서 Enter를 누르면 입력 박스의 텍스트도 함께 제출되던 문제 수정.
  • EnterWorktree로 작업 디렉터리가 바뀐 뒤 훅이 존재하지 않는 transcript_path를 받던 문제 수정.
  • “Allowed by PermissionRequest hook” 메시지가 접힌 read/search 그룹에서 툴 호출마다 반복되던 문제 수정.

입력·키바인딩·기록

  • 취소된 프롬프트가 입력 박스로 자동 복원될 때 ↑ 히스토리에서 사라지던 문제 수정. 중복 항목도 더 이상 추가되지 않습니다.
  • 응답이 시작되기 전 Ctrl+C/Esc로 취소한 프롬프트가 ↑ 히스토리에서 빠지던 문제 수정.
  • vim INSERT/VISUAL 모드에서 Ctrl+C로 진행 중인 턴을 인터럽트하지 못하던 문제 수정.
  • enter가 chat:newline으로 리바인딩된 경우 meta+enter·ctrl+enter 같은 대체 chat:submit 키바인딩이 동작하지 않던 문제 수정.
  • 출력 스타일이 설정되면 프롬프트 추천이 조용히 비활성화되던 문제 수정.
  • spinnerVerbs 설정이 턴 완료 메시지에서 무시되던 문제 수정.
  • 커스텀 voice:pushToTalk 키바인딩과 "space": null 언바인드가 조용히 무시되던 문제 수정.

UI·렌더링

  • 셀 래핑이 들어간 마크다운 테이블이 테두리 그리드 대신 세로 키-값 레이아웃으로 폴백되던 문제 수정 (2.1.136 회귀).
  • AskUserQuestion 팝업이 직전 대화 마지막 줄을 가리던 문제 수정.
  • Web Search 상태가 검색이 에러로 끝났을 때 “Did 0 searches”로 표시되던 문제 수정.
  • statusline 출력이 단말 너비를 넘는 줄을 포함하면 다른 줄이 잘리거나 깨지던 문제 수정.
  • light-ansi 테마가 밝은 배경에서 diff 컨텍스트 줄에 보이지 않는 흰색을 쓰던 문제 — 검정으로 변경.
  • 에러 오버레이가 미니파이된 번들 소스를 그대로 덤프해 원본 에러 메시지를 가리던 문제 수정.
  • 피드백 설문 평점 숫자를 입력한 뒤 Enter를 누르면 평점이 아니라 채팅 메시지로 제출되던 문제 수정.
  • 에이전트 패널에서 선택된 서브에이전트 위에 x를 누르면 에이전트를 멈추는 대신 프롬프트에 문자가 입력되던 문제 수정.
  • 사용자의 첫 프롬프트 이전에 플러그인 모니터 알림에서 세션 제목이 도출되던 문제 수정.
  • /mcp 서버 목록이 풀스크린 모드의 짧은 단말에서 포커스된 서버를 화면에 유지하지 못하던 문제 수정.
  • /tui가 실행 중인 백그라운드 셸·서브에이전트를 조용히 떨어뜨리던 문제 — 이제 거절하고 종료를 대기하도록 안내합니다.
  • Bedrock/Vertex/Foundry 등 서드파티 프로바이더 환경의 welcome 배너가 “API Usage Billing”으로 표시되던 문제 — 프로바이더 이름이 표시됩니다.

윈도우·플랫폼·SDK

  • Windows에서 claude daemon status·/doctor가 데몬 파이프 키 파일이 잠겨 있거나 읽을 수 없을 때 불투명한 실패로 끝나던 문제 — 이제 원인 오류를 노출합니다.
  • claude agents가 플래그를 덧붙이는 래퍼로 실행되면 대시보드 대신 에이전트 타입 목록을 보여주던 문제 수정.
  • 작업 디렉터리가 삭제된 상태에서 claude agents로 크래시된 세션을 열면 중복 디스패치가 발생하던 문제 수정.
  • Windows에서 Alt+V 이미지 붙여넣기가 클립보드에 스크린샷이 있어도 “no image found”로 보고하던 문제 수정.
  • Linux에서 glibc·musl 플랫폼 패키지가 둘 다 설치되어 있을 때 SDK가 “Claude Code native binary not found”로 실패하던 문제 수정.
  • 베타 트레이싱이 켜진 SDK/헤드리스 모드에서 초기 OTel 스팬이 조용히 누락되던 경쟁 조건 수정.
  • 로거 초기화 전에 발생한 초기 분석 이벤트가 조용히 버려지던 문제 수정.
  • /feedback 번들의 리댁션이 세션 ID 같은 인용된 값에서 잘못된 JSON을 만들던 문제 수정.
  • [VSCode] 인-챗 마이크가 무음만 캡처할 때 피드백이 표시되지 않던 문제 — 이제 “No audio detected”가 표시됩니다.
  • [VSCode] WSL 음성 모드 오류 메시지가 WSLg 사용자에게 sox libsox-fmt-pulse 설치를 안내하도록 보강.

claude agents 디스패치

  • 프리워밍된 백그라운드 워커가 비정상일 때 세션 실행이 실패하던 문제 — 이제 새 실행으로 폴백합니다.
  • 신선한 REPL을 백그라운딩한 뒤 남은 빈 placeholder 세션이 표시되던 문제 수정. 다른 에이전트가 없을 때 ←로 진입하면 온보딩 텍스트를 보여줍니다.
  • ←로 남은 빈 유휴 백그라운드 세션이 데몬에 의해 5분 뒤 자동 정리되도록 변경.

알아두면 좋은 점

  • terminalSequence 훅 출력 활용 — 훅에서 데스크톱 알림·창 제목·벨을 띄우고 싶을 때 제어 단말 유무에 의존하지 않아도 됩니다. 백그라운드 작업 알림 같은 자동화에 바로 쓸 수 있습니다.
  • GitHub SSH 키가 없는 환경에서 플러그인 설치가 실패한다면 — CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1로 HTTPS 클론으로 전환할 수 있습니다. 사내 CI 러너나 키리스 도커 환경에서 유용합니다.
  • 워크로드 ID 페더레이션 토큰 범위가 넓어 보일 때 — 페더레이션 규칙이 여러 워크스페이스를 포괄하면 발급 토큰이 그 모두에 통한다는 점을 잊지 마세요. ANTHROPIC_WORKSPACE_ID로 특정 워크스페이스로 좁혀야 안전합니다.
  • 여러 동시 세션에서 /model을 바꾸는 운영 — 이전에는 한 세션의 /model 변경이 다른 세션의 autocompact 임계값에 영향을 줬습니다. 회귀 우회용으로 깔아둔 워크어라운드가 있다면 제거 가능합니다.
  • 테이블 렌더링 회귀 복구(2.1.136) — 셀이 길어 줄바꿈되는 마크다운 테이블이 다시 정상 테두리 그리드로 표시됩니다. 외부 도구가 만든 출력 형식을 단말 검토 흐름에 다시 끼워 넣어도 됩니다.
  • Remote Control 401 재발 환경 — 워커 세션 토큰 회전 중 일제히 401이 떨어지던 증상이 사라졌지만, 자격 증명 자체가 만료되는 환경이면 결국 /login이 필요합니다. 401이 반복되면 원인을 확인하세요.
  • MCP 서버가 “needs auth”로 표시될 때 — 더 이상 일반 “failed”가 아니라 정확히 “needs auth”로 구분되므로, OAuth/토큰 갱신이 필요한 케이스를 시각적으로 빨리 분리할 수 있습니다.