2026년 5월 4주차 Claude Code 업데이트 (v2.1.145 ~ v2.1.149)

v2.1.145: 에이전트 JSON·플러그인 미리보기와 다수 버그를 수정 · v2.1.146: 코드리뷰 명령 변경과 세션·업데이터 안정성 개선 · v2.1.147: 백그라운드 세션·명령어·권한·Windows 버그 전반 수정 · v2.1.147: 자동업데이트·백그라운드·PowerShell 등 다수 버그 수정 · v2.1.148: Bash 도구의 127 종료 코드 회귀를 수정 · v2.1.149:…

Claude Code release notes cover image

이번 주 요약

  • v2.1.145 — 에이전트 JSON·플러그인 미리보기와 다수 버그를 수정
  • v2.1.146 — 코드리뷰 명령 변경과 세션·업데이터 안정성 개선
  • v2.1.147 — 백그라운드 세션·명령어·권한·Windows 버그 전반 수정
  • v2.1.147 — 자동업데이트·백그라운드·PowerShell 등 다수 버그 수정
  • v2.1.148 — Bash 도구의 127 종료 코드 회귀를 수정
  • v2.1.149 — 사용량 세부화·체크박스 렌더링 추가, 다수 버그 수정

v2.1.145 — v2.1.145

공개일: 2026-05-20 · 원문 보기

변경 사항

  • 스크립팅용으로 실행 중인 Claude 세션을 JSON으로 나열하는 claude agents --json을 추가했습니다(tmux-resurrect, 상태 바, 세션 선택기용).
  • claude_code.tool OTEL span에 agent_idparent_agent_id 속성을 추가했고, 추적 부모-자식 관계를 수정하여 백그라운드 서브에이전트 span이 이를 전달하는 Agent 도구 span 아래에 중첩되도록 했습니다.
  • 이제 상태 줄 JSON 입력에는 감지된 경우 GitHub 저장소 및 PR 정보가 포함됩니다.
  • /plugin의 Discover 및 Browse 화면에서 설치 전에 플러그인의 명령, 에이전트, 스킬, 훅, MCP/LSP 서버를 이제 표시합니다.
  • claude agents 터미널 탭 제목이 이제 입력 대기 수를 표시하므로, 다른 탭으로 전환한 창에서도 에이전트가 주의가 필요한지 알 수 있습니다.
  • 슬래시 명령과 @-멘션 제안 목록이 이제 전체 화면 모드에서 마우스 호버와 클릭을 지원합니다.
  • Stop 및 SubagentStop 훅 입력에 이제 background_taskssession_crons 필드가 포함됩니다.
  • Bash 명령에서 허용 목록에 없는 환경 변수에 대한 단순 변수 할당이 자동 승인되던 권한 프롬프트 우회 문제를 수정했습니다.
  • 필수 인자가 생략되었을 때 MCP 프롬프트 슬래시 명령이 원시 서버 검증 오류를 표시하던 문제를 수정했습니다. 이제 오류는 누락된 인자를 이름으로 표시하고 예상 사용법을 보여 줍니다.
  • 터미널 크기 변경 후 또는 다시 포커스했을 때 키 입력이 있을 때까지 스피너와 경과 시간 표시가 멈추던 문제를 수정했습니다.
  • 기본 Windows PowerShell 5.1에서 프로젝트 간 이어하기 힌트가 실패하던 문제를 수정했습니다. 이제 Windows에서는 명령 구분자로 ;를 사용합니다.
  • 에이전트 보기의 답장 창에서 음성 push-to-talk가 동작하지 않던 문제를 수정했습니다.
  • 여러 작업이 한 번에 생성될 때 작업 목록이 무작위 순서로 렌더링되던 문제를 수정했습니다.
  • 마켓플레이스가 이미 설치되어 있는데도 오래된 “Failed to install Anthropic marketplace” 배너가 표시되던 문제를 수정했습니다.
  • 세션 중 gh pr create 및 기타 PR 상태를 변경하는 명령 실행 후 바닥글의 PR 배지가 즉시 갱신되지 않던 문제를 수정했습니다.
  • 비 ASCII 이름을 가진 Agent Teams 팀원이 잘못된 헤더 인코딩 때문에 모든 API 호출에 실패하던 문제를 수정했습니다.
  • /review가 Classic Projects가 있는 저장소에서 오류를 내던 deprecated projectCards GraphQL 쿼리를 사용하던 문제를 수정했습니다.
  • claude plugin validate가 파일을 가리키는 skills: 항목을 디렉터리로 표시하지 못하던 문제를 수정했습니다. 이제 오류가 상위 디렉터리를 제안합니다.
  • context: fork를 사용하는 스킬이 실행되지 않고 반복해서 자기 자신을 다시 호출할 수 있던 무한 루프를 수정했습니다.
  • Read 도구를 개선하여, 전체 파일 읽기가 토큰 한도를 초과할 때는 치명적 오류 대신 “PARTIAL view” 안내와 함께 잘린 첫 페이지를 반환하도록 했습니다.

v2.1.146 — v2.1.146

공개일: 2026-05-21 · 원문 보기

변경 사항

  • /simplify를 선택적 노력 수준을 받는 /code-review로 이름 변경(예: /code-review high)
  • 자동 모드는 사용자가 직접, 또는 스킬이 명시적으로 AskUserQuestion에 의존할 때 더 이상 이를 억제하지 않음
  • Windows PowerShell 도구가 pwsh가 winget 또는 Microsoft Store를 통해 설치된 경우 “command line is invalid”로 실패하던 문제 수정(v2.1.124의 회귀)
  • 페이지가 나뉘는 서버에서 MCP resources/list, resources/templates/list, prompts/list가 1페이지 이후의 항목을 누락하던 문제 수정
  • Claude가 스트리밍 중일 때 Windows Terminal의 첨부된 백그라운드 세션에서 전체 화면 깜박임 수정
  • 업데이트 실패 시 자동 업데이트 상태 줄에 현재 버전이 표시되지 않던 문제 수정
  • Windows에서 백그라운드 작업 worktree를 제거할 때 더 이상 NTFS 정션을 따라 메인 저장소로 이동하지 않음
  • 입력한 내용이 스킬 또는 사용자 정의 슬래시 명령뿐인 세션을 /background가 거부하던 문제 수정
  • 백그라운드 세션이 이미 “다시 묻지 않음”으로 허용한 도구 권한을 다시 요청하던 문제 수정
  • /theme 색상 편집기와 “새 사용자 정의 테마” 대화 상자가 Esc에 반응하지 않던 문제 수정
  • Agent SDK를 통해 실행할 때 스트리밍 세션 종료 시 처리되지 않은 예외가 발생하던 문제 수정
  • forceLoginOrgUUIDforceLoginMethod 관리 설정 정책이 제3자 공급자 및 API 키 세션에 대해 적용되지 않던 문제 수정
  • GNOME Terminal의 오른쪽 클릭 및 가운데 클릭 붙여넣기가 텍스트를 삽입하지 않던 문제 수정
  • CLAUDE_CODE_SUBAGENT_MODEL이 다중 에이전트 세션에서 자식 프로세스로 전달되지 않던 문제 수정
  • 자동 업데이트 안정성 개선: 네이티브 버전 확인 및 다운로드가 일시적인 네트워크 오류 시 즉시 실패하지 않고 재시도함
  • 대용량 파일 편집에 대한 diff 렌더링 성능 개선

v2.1.147 — v2.1.147

공개일: 2026-05-22 · 원문 보기

변경된 내용

  • 고정된 백그라운드 세션(claude agents에서 Ctrl+T)은 이제 유휴 상태에서도 계속 살아 있으며, Claude Code 업데이트를 적용하기 위해 제자리에서 다시 시작되고, 메모리 압박 시에는 고정되지 않은 세션 이후에만 제거됩니다
  • /simplify/code-review로 이름을 변경했습니다. 이제 선택한 노력 수준(예: /code-review high)에서 정확성 버그를 보고합니다. --comment를 전달하면 발견 사항을 인라인 GitHub PR 댓글로 게시합니다. 기존의 정리 및 수정 동작은 제거되었습니다
  • 자동 업데이트 프로그램을 개선했습니다: 일시적인 네트워크 실패를 재시도하고, 실패 시 특정 오류 범주와 OS 오류 코드를 보고하며, 업데이트 실패 시 현재 버전을 표시합니다
  • 큰 파일 편집에 대한 diff 렌더링 성능을 개선했습니다
  • 이제 프롬프트 기록은 연속된 중복 항목을 더 이상 기록하지 않습니다. 위쪽 화살표로 프롬프트를 다시 불러와 다시 제출해도 또 다른 복사본이 추가되지 않습니다
  • enterprise 로그인 제한(forceLoginOrgUUIDforceLoginMethod 관리 설정)이 서드파티 제공자 및 API 키 세션에 대해 적용되지 않던 문제를 수정했습니다
  • ! 명령 출력에서 &&로 표시되어, 헤드리스 머신에서 gcloud auth login 같은 명령의 URL을 복사해 붙여넣을 때 문제가 생기던 것을 수정했습니다
  • 헤드리스/SDK 모드에서 알 수 없는 슬래시 명령이 아무 일도 하지 않던 문제를 수정했습니다. 이제 오류 메시지를 표시합니다
  • /help가 작은 터미널에서 전체 화면이 아닐 때 깨진 탭 헤더를 렌더링하고 한 페이지에 명령 하나만 표시하던 문제를 수정했습니다
  • 이름이 밑줄 하나로 시작하는 사용자 함수를 shell snapshot이 버려서, 그것들을 참조하는 별칭이 깨지던 문제를 수정했습니다
  • tools: frontmatter에 여러 Agent(...) 유형을 선언한 플러그인 에이전트가 마지막 항목만 남기고 나머지를 버리던 문제를 수정했습니다
  • PowerShell(git push) 같은 hook if 조건이 전혀 일치하지 않던 문제를 수정했습니다. PowerShell()만 동작했습니다
  • PowerShell 도구가 기본 포맷터에 의존하는 명령의 출력을 버리던 문제를 수정했습니다
  • Windows에서 PowerShell 스크립트 호출에 대해 “예, 그리고 다시 묻지 않음”을 선택하면, 이제 이후 실행에서 실제로 일치하는 규칙을 쓰도록 수정했습니다
  • pwsh가 winget 또는 Microsoft Store를 통해 설치된 경우 Windows에서 PowerShell 도구가 종료 코드 1로 실패하던 문제를 수정했습니다
  • /effort가 잘못된 수준의 슬라이더로 열리던 문제를 수정했습니다. 이제 현재 노력 수준에서 시작합니다
  • MCP 서버 페이지네이션에서 1페이지 이후의 리소스, 템플릿, 프롬프트가 누락되던 문제를 수정했습니다
  • Claude가 스트리밍 중일 때 Windows Terminal의 연결된 백그라운드 세션에서 전체 화면 깜박임이 발생하던 문제를 수정했습니다
  • Windows에서 백그라운드 작업 worktree를 제거할 때 더 이상 NTFS junction을 따라 메인 저장소로 들어가지 않도록 수정했습니다
  • 사용자의 유일한 입력이 스킬 또는 사용자 정의 슬래시 명령인 경우 /background가 세션을 거부하던 문제를 수정했습니다
  • 사용자가 또는 스킬이 명시적으로 의존하는 AskUserQuestion을 auto mode가 억제하던 문제를 수정했습니다. 이제 auto-mode 분류기가 사용자의 답변을 의도 신호로 봅니다
  • /theme의 “New custom theme” 및 색상 편집기 대화상자가 Esc에 응답하지 않던 문제를 수정했습니다
  • Agent SDK를 통해 실행할 때 스트리밍 세션 끝에서 포착되지 않은 예외가 발생하던 문제를 수정했습니다
  • Windows에서 스크롤이 안정되기를 기다릴 때 드물게 멈추던 문제를 수정했습니다
  • 백그라운드 세션 결과에 넓은 문자(CJK)가 포함될 때 Windows의 에이전트 보기 목록에 오래된 행과 중복 행이 표시되던 문제를 수정했습니다
  • 붙여넣은 텍스트가 실제 내용 대신 읽을 수 없는 [Pasted text #N] 자리표시자로 에이전트에 전달되던 문제를 수정했습니다
  • 플러그인의 manifest가 기본 디렉터리와 겹치는 경로를 나열할 때 claude plugin details/plugin의 플러그인 구성 요소 수가 두 배로 계산되던 문제를 수정했습니다
  • “don’t ask again”으로 이미 권한을 부여한 도구에 대해 백그라운드 세션이 다시 권한을 요청하던 문제를 수정했습니다
  • GNOME Terminal의 우클릭 및 가운데 클릭 붙여넣기가 텍스트를 삽입하지 않던 문제를 수정했습니다
  • CLAUDE_CODE_SUBAGENT_MODEL이 에이전트 팀이 생성한 팀원 프로세스에 적용되지 않던 문제를 수정했습니다
  • 탭이나 개행이 뒤따르는 슬래시 명령이 알 수 없는 명령으로 처리되던 문제를 수정했습니다
  • /plugin, /status, /mobile, /sandbox, /permissions 메뉴의 여러 간격 및 레이아웃 결함을 수정했습니다
  • 제거된 이미지가 다시 존재하지 않는 미디어를 모델이 반복해서 다시 읽도록 유발하던 문제를 수정했습니다

v2.1.147 — v2.1.147

공개일: 2026-05-22 · 원문 보기

변경 사항

  • 고정된 백그라운드 세션(claude agentsCtrl+T)은 이제 유휴 상태에서도 계속 살아 있으며, Claude Code 업데이트를 적용하기 위해 제자리에서 재시작되고, 메모리 압박 시에는 비고정 세션 다음에만 정리됩니다
  • /simplify/code-review로 이름을 바꿨습니다. 이제 선택한 노력 수준으로 정확성 버그를 보고합니다(예: /code-review high); --comment를 전달하면 발견 사항을 인라인 GitHub PR 댓글로 게시합니다. 이전의 정리 및 수정 동작은 제거되었습니다
  • 자동 업데이트 기능을 개선했습니다: 일시적인 네트워크 실패를 재시도하고, 실패 시 구체적인 오류 범주와 OS 오류 코드를 보고하며, 업데이트 실패 시 현재 버전을 표시합니다
  • 대용량 파일 편집에 대한 diff 렌더링 성능을 개선했습니다
  • 프롬프트 기록은 더 이상 연속된 중복 항목을 기록하지 않습니다 — 위쪽 화살표로 프롬프트를 다시 불러와 다시 제출해도 또 다른 복사본이 추가되지 않습니다
  • 기업 로그인 제한(forceLoginOrgUUIDforceLoginMethod 관리 설정)이 서드파티 제공자 및 API 키 세션에 대해 적용되지 않던 문제를 수정했습니다
  • ! 명령 출력에서 &&로 표시되어, 헤드리스 머신에서 gcloud auth login 같은 명령의 URL 복사-붙여넣기가 깨지던 문제를 수정했습니다
  • 헤드리스/SDK 모드에서 알 수 없는 슬래시 명령이 조용히 아무 일도 하지 않던 문제를 수정했습니다 — 이제 오류 메시지를 표시합니다
  • /help가 작은 터미널에서 전체 화면 모드가 아닐 때 깨진 탭 헤더를 렌더링하고 페이지당 하나의 명령만 표시하던 문제를 수정했습니다
  • 셸 스냅샷이 이름이 단일 밑줄(_)로 시작하는 사용자 함수를 제외해, 이를 참조하는 별칭이 깨지던 문제를 수정했습니다
  • tools: frontmatter에 여러 Agent(...) 타입을 선언한 플러그인 에이전트가 마지막 항목만 남기고 모두 버리던 문제를 수정했습니다
  • PowerShell(git push) 같은 hook if 조건이 절대 일치하지 않던 문제를 수정했습니다 — PowerShell()만 동작했습니다
  • PowerShell 도구가 기본 포매터에 의존하는 명령의 출력을 버리던 문제를 수정했습니다
  • Windows에서 PowerShell 스크립트 호출에 대해 “Yes, and don’t ask again”을 선택하면, 이제 이후 실행에서 실제로 일치하는 규칙을 쓰도록 수정했습니다
  • pwsh가 winget 또는 Microsoft Store로 설치된 경우 Windows에서 PowerShell 도구가 종료 코드 1로 실패하던 문제를 수정했습니다
  • /effort가 슬라이더가 잘못된 수준으로 열리던 문제를 수정했습니다 — 이제 현재 노력 수준에서 시작합니다
  • 페이지 매김된 MCP 서버가 1페이지 이후의 리소스, 템플릿, 프롬프트를 버리던 문제를 수정했습니다
  • Claude가 스트리밍하는 동안 Windows Terminal에서 연결된 백그라운드 세션의 전체 화면 깜빡임을 수정했습니다
  • Windows에서 백그라운드 작업 worktree를 제거할 때 더 이상 NTFS 정션을 따라 메인 저장소로 들어가지 않습니다
  • 유일한 타입 입력이 스킬이나 사용자 정의 슬래시 명령이었던 세션을 /background가 거부하던 문제를 수정했습니다
  • 자동 모드가 사용자나 스킬이 명시적으로 의존하는 AskUserQuestion을 억제하던 문제를 수정했습니다. 이제 자동 모드 분류기가 사용자의 답변을 의도 신호로 봅니다
  • /theme의 “새 사용자 지정 테마” 및 색상 편집기 대화상자가 Esc에 반응하지 않던 문제를 수정했습니다
  • Agent SDK를 통해 실행할 때 스트리밍 세션 끝에서 포착되지 않은 예외가 발생하던 문제를 수정했습니다
  • Windows에서 스크롤이 안정되기를 기다릴 때 드물게 멈추는 문제를 수정했습니다
  • 백그라운드 세션 결과에 넓은(CJK) 문자가 포함될 때 Windows의 에이전트 보기 목록에 오래되거나 중복된 행이 표시되던 문제를 수정했습니다
  • 붙여넣은 텍스트가 실제 내용 대신 읽을 수 없는 [Pasted text #N] 자리표시자로 에이전트에 전달되던 문제를 수정했습니다
  • 플러그인의 manifest가 기본 디렉터리와 겹치는 경로를 나열할 때 claude plugin details/plugin의 플러그인 구성 요소 수가 두 배로 표시되던 문제를 수정했습니다
  • 이미 “don’t ask again”으로 허용한 도구 권한을 백그라운드 세션이 다시 요청하던 문제를 수정했습니다
  • GNOME Terminal에서 오른쪽 클릭 및 가운데 클릭 붙여넣기가 텍스트를 삽입하지 않던 문제를 수정했습니다
  • CLAUDE_CODE_SUBAGENT_MODEL이 에이전트 팀에서 생성된 팀원 프로세스에 적용되지 않던 문제를 수정했습니다
  • 탭이나 새 줄이 뒤따르는 슬래시 명령이 알 수 없는 명령으로 처리되던 문제를 수정했습니다
  • /plugin, /status, /mobile, /sandbox, /permissions 메뉴의 여러 간격 및 레이아웃 결함을 수정했습니다
  • 이미지가 제거된 뒤에도 스트리핑된 이미지가 모델에 더 이상 존재하지 않는 미디어를 반복해서 다시 읽도록 요청하던 문제를 수정했습니다

v2.1.148 — v2.1.148

공개일: 2026-05-22 · 원문 보기

변경 사항

  • 일부 사용자에게서 Bash 도구가 모든 명령에 대해 종료 코드 127을 반환하던 문제를 수정했습니다(2.1.147에서 도입된 회귀).

v2.1.149 — v2.1.149

공개일: 2026-05-23 · 원문 보기

변경 사항

  • /usage에서 이제 한도 사용량을 유발하는 항목에 대한 카테고리별 세부 내역을 표시합니다. — 스킬, 서브에이전트, 플러그인, 그리고 MCP 서버별 비용
  • /diff 세부 보기에서 이제 키보드로 스크롤할 수 있습니다. (방향키, j/k, PgUp/PgDn, Space, Home/End)
  • Markdown 출력이 이제 일반 글머리표 대신 GFM 작업 목록 체크박스(- [ ] todo / - [x] done)를 렌더링합니다
  • Enterprise: managed-mcp.json과 함께 claude.ai 클라우드 MCP 커넥터를 로드할 수 있도록 allowAllClaudeAiMcps 관리 설정을 추가했습니다
  • PowerShell 권한 우회 문제를 수정했습니다: 내장 cd 함수(cd.., cd, cd~, X:)가 작업 디렉터리를 감지되지 않게 변경하여, 이후 명령이 워크스페이스 밖을 읽을 수 있었습니다
  • git worktree에서의 샌드박스 쓰기 허용 목록이 공유 .git 디렉터리뿐 아니라 전체 main repository root를 덮고 있었던 문제를 수정했습니다(hooks/config는 거부됨)
  • PowerShell 접두사/와일드카드 허용 규칙(예: PowerShell(dotnet.exe build *))이 네이티브 실행 파일과 스크립트를 사전 승인하지 못하던 문제를 수정했습니다
  • 파서가 cd/pushd/popd 전반에서 PWD/OLDPWD/DIRSTACK에 대한 오래된 변수 추적 값을 신뢰하던 권한 분석의 간극을 수정했습니다
  • Bash 도구의 find가 macOS 시스템 파일/vnode 테이블을 소진하여 큰 디렉터리 트리에서 호스트를 크래시시키던 문제를 수정했습니다
  • 시작 시 수락한 뒤 관리 설정 승인 대화상자가 터미널을 멈춘 상태로 남겨두던 문제를 수정했습니다
  • 작업 트리에 실제 변경 사항이 없을 때 /ultraplan 및 원격 세션 생성이 “Could not capture uncommitted changes” 오류와 함께 실패하던 문제를 수정했습니다
  • otelHeadersHelper가 스크립트 경로에 공백이 있을 때 조용히 실패하던 문제를 수정했습니다. 이제 헬퍼 실패가 /doctor와 디버그 로그에 보고됩니다
  • 생각 중 스피너가 도구 호출을 거쳐 새 생각 구간까지 계속 호박색으로 남아 있던 문제를 수정했습니다
  • 접힌 Bash 출력에서 짧은 줄이 많은 출력에 대해 잘못된 숨김 줄 수를 보고하던 문제를 수정했습니다
  • 슬래시 명령 인자 힌트가 입력 상자를 넘칠 때 사용자가 입력한 뒤쪽 문자를 잘라내던 문제를 수정했습니다
  • frontmatter의 name:이 디렉터리 basename과 다른 스킬을 Tab 완성한 뒤 인자 힌트와 점진적 인자 제안이 나타나지 않던 문제를 수정했습니다
  • 상태 표시줄이 스킬/에이전트 effort: frontmatter에 의해 적용된 노력 수준이 아니라 사용자의 기본 /effort 설정을 표시하던 문제를 수정했습니다
  • Ctrl+O 대화록 보기에서 열리는 순간 멈추고 새 메시지를 따라가지 않던 문제를 수정했습니다
  • 다시 불러온 프롬프트 기록 항목을 편집하면 화살표 키로 더 위/아래로 이동할 때 편집 내용이 사라지던 문제를 수정했습니다
  • /config 종료 요약이 관련 없는 설정을 토글할 때 자동 압축 및 테마에 대한 가짜 변경 사항을 보고하던 문제를 수정했습니다
  • 캐시된 세션 메타 파일에 선택적 필드가 없을 때 /insights가 크래시하던 문제를 수정했습니다
  • 입력이 없는 잘못된 PowerShell 및 History 도구 호출이 대화록 축약에서 읽기로 잘못 분류되던 문제를 수정했습니다
  • claude.ai 또는 Claude 모바일 앱에서 Remote Control 세션 이름을 변경해도 claude --resume용 로컬 세션 이름이 갱신되지 않던 문제를 수정했습니다
  • 방금 제출한 프롬프트가 위 화살표 기록에 두 번 나타날 수 있던 경쟁 상태를 수정했습니다
  • 전체화면 모드에서 “맨 아래로 이동” pill을 탭해도 즉시 닫히지 않던 문제를 수정했습니다
  • /feedback 보고서가 컨텍스트 압축 이전에 있었던 대화를 포함하도록 개선하여, 긴 세션의 초반부에서 발생한 문제를 더 쉽게 분류할 수 있게 했습니다

이 글은 Claude Code 공식 릴리스 노트를 자동 번역·요약한 결과입니다. 원문은 GitHub releases에서 확인할 수 있습니다.

관련 글

@robocom

정리를 위해 작성하는 개인노트