Claude Code v2.1.147 출시 | 매일 Changelog 해설

2026-05-21에 출시된 v2.1.147을 읽어봅니다. 핵심은 새로운 Workflow 도구와, /simplify를 대체한 /code-review의 동작 변경입니다. 내부적으로 PowerShell 및 Windows 관련 세부 수정 사항도 함께 포함되어 있습니다.

• 결정적인 멀티 에이전트(Multi-agent) 편성. Workflow 도구 신규 등장. CLAUDE_CODE_WORKFLOWS=1로 옵트인(Opt-in)
• effort 레벨 지정과 PR(Pull Request)에 직접 댓글 게시가 가능한 /simplify가 /code-review로 이름 변경
• 핀 고정(Pinning)된 백그라운드 세션이 잘 끊기지 않게 됨 - Ctrl+T로 핀 고정하면 업데이트도 그 자리에서 반영
• REPL과 Workflow의 샌드박스(Sandbox) 강화 - prototype-pollution과 thenable을 통한 탈출을 동시에 차단
• 자동 업데이트 실패 시 진단이 구체화됨 - OS 에러 코드, 현재 버전 표시, 통신 실패 시 재시도
• 프롬프트 이력의 연속 중복 제거 - ↑로 호출하여 재전송해도 이력이 늘어나지 않음

대상: 여러 에이전트를 매번 동일한 절차로 실행하고 싶은 리뷰어·자동화 담당자

Workflow 도구는 에이전트의 조합·분기·순서를 스크립트로 고정하기 위한 메커니즘입니다. LLM의 판단에 맡기지 않고 플로우(Flow)를 고정하고 싶은 경우에 사용합니다.

기본적으로는 비활성화되어 있습니다. 사용하려면 환경 변수를 설정한 후 Claude Code를 실행합니다.

CLAUDE_CODE_WORKFLOWS=1 claude

보안 측면에서 동시에 강화된 것이 Workflow 도구와 REPL의 샌드박스입니다. Object.prototype을 오염시키는 경로와, Promise의 then을 잡아 실행 컨텍스트를 벗어나는 경로를 이번 릴리스에서 모두 차단했습니다.

기존 /simplify의 클린업(Clean-up) 및 수정 동작은 폐지되었습니다. 새로운 /code-review는 버그 지적 전용 명령어가 되었습니다.

조작	효과
/code-review	기본 effort로 정확성 버그를 지적
/code-review high	높은 effort로 깊게 검사
/code-review --comment	검출 결과를 GitHub PR의 인라인 댓글로 게시

--comment를 붙이면 리뷰 결과가 그대로 PR 상의 댓글이 됩니다. 로컬에 로그를 쌓아두지 않아도 PR 상에서 논의를 계속할 수 있는 구성입니다. 단, /simplify의 클린업 기능은 /code-review로 승계되지 않았으므로, 계속 사용하던 분들은 주의하시기 바랍니다.

claude agents 화면에서 세션을 선택하고 Ctrl+T로 핀 고정해 두면, 기존에 유휴(Idle) 상태일 때 끊겼던 세션이 그대로 유지됩니다. 동작은 다음과 같습니다.

• 유휴 상태에서도 종료되지 않음
• Claude Code 본체의 업데이트는 핀 고정된 세션을 그 자리에서 재시작하여 반영
• 메모리 부족 시 해제 대상은 핀 고정되지 않은 세션을 우선하며, 핀 고정된 세션은 마지막에 처리

모니터링 계열·폴링(Polling) 계열의 에이전트를 Ctrl+T로 고정해 두면, 재시작할 때마다 상태를 다시 구성해야 하는 번거로움이 줄어듭니다.

버전	카테고리	변경 사항	개요
v2.1.147	성능 (Performance)	대용량 파일 편집의 diff 렌더링	대규모 편집 (edit) 시 diff 표시 속도 향상
v2.1.147	경험 (UX)	프롬프트 이력의 연속 중복 제거	↑ 키를 연타하여 동일한 프롬프트를 재전송해도 이력에 쌓이지 않음
v2.1.147	업데이트 (Updater)	자동 업데이트 실패 시 메시지 강화	에러 카테고리, OS 에러 코드, 현재 버전을 표시. 일시적인 통신 실패 시 재시도
v2.1.147	엔터프라이즈 (Enterprise)	forceLoginOrgUUID / forceLoginMethod	서드파티 프로바이더나 API 키 세션에도 관리 설정이 적용되도록 수정
v2.1.147	헤드리스 (Headless)	알 수 없는 슬래시 명령어 (Slash Command)	SDK / headless 환경에서 반응이 없던 현상을 에러 표시로 수정
v2.1.147	클립보드 (Clipboard)	붙여넣기 내용 유지	[Pasted text #N] 플레이스홀더(Placeholder) 대신 실제 텍스트가 전달되도록 수정
v2.1.147	백그라운드 (Background)	권한 프롬프트 재표시	「Don't ask again」을 선택한 권한이 백그라운드 세션에서 다시 요청되던 동작 수정

버그 수정 (v2.1.147)

• ! 명령어 출력의 &가 &로 표시되어 gcloud auth login 등의 URL을 복사하여 붙여넣을 수 없는 문제
• /help의 탭 헤더가 깨져서, 작은 터미널에서 한 페이지에 명령어가 하나만 표시되는 문제
• 쉘 스냅샷 (Shell Snapshot)이 언더스코어(_)로 시작하는 사용자 함수(_func)를 누락하여 관련 에일리어스 (Alias)가 깨지는 문제
• 플러그인의 에이전트 프론트매터 (Agent frontmatter) 내 tools:에 여러 개의 Agent(...)를 작성하면 마지막 하나를 제외하고 모두 삭제되는 문제
• 후크 (Hook) 조건 PowerShell(git push*)이 전혀 매칭되지 않고 PowerShell(*)만 적용되던 문제
• PowerShell 도구가 기본 포맷터 (Default Formatter)에 의존하는 명령어를 실행할 때 출력을 누락하는 문제
• Windows에서 「Yes, and don't ask again」이 스크립트 호출에 대해 후속 실행과 매칭되지 않는 규칙을 작성했던 문제
• winget / Microsoft Store를 통해 설치한 pwsh에서 PowerShell 도구가 종료 코드 1로 종료되는 문제
• /effort가 슬라이더를 현재 값이 아닌 다른 레벨로 여는 문제
• MCP 서버의 페이지네이션 (Pagination) 2페이지 이후부터 resources / templates / prompts가 누락되는 문제
• 어태치 (Attach) 중인 백그라운드 세션이 Windows Terminal에서 스트리밍 중에 전체 화면이 깜빡이는(strobe) 문제
• Windows에서 백그라운드 작업의 워크트리 (Worktree) 삭제 시 NTFS 정션 (Junction)을 따라가 메인 리포지토리를 포함해 버리는 문제
• 입력이 스킬(Skill)이나 커스텀 슬래시 명령어뿐인 세션을 /background가 거부하는 문제
• 사용자나 스킬이 AskUserQuestion을 필요로 하는 상황에서 자동 (Auto) 모드가 이를 억제하는 문제
• /theme의 「신규 커스텀 테마」와 컬러 에디터에서 Esc 키가 작동하지 않는 문제
• 에이전트 SDK (Agent SDK)의 스트리밍 세션 종료 시 발생하는 처리되지 않은 예외 (Uncaught Exception)
• Windows에서 스크롤 끝 감지가 드물게 행(Hang)되는 문제
• Windows의 에이전트 목록에서 백그라운드 세션 결과에 CJK 등 광폭 문자 (Wide Character)가 포함되면 행이 이전 상태로 남거나 중복되는 문제
• claude plugin details와 /plugin의 플러그인 구성 요소 카운트가, 매니페스트(Manifest)에서 기본 디렉토리와 중복되는 경로를 선언했을 때 두 배로 계산되는 문제
• GNOME Terminal에서 우클릭/휠 클릭 붙여넣기가 본문에 포함되지 않는 문제
• CLAUDE_CODE_SUBAGENT_MODEL이 에이전트 팀의 자식 프로세스에 전달되지 않는 문제
• 슬래시 명령어 직후의 탭/줄바꿈이 알 수 없는 명령어로 취급되는 문제
• /plugin / /status / /mobile / /sandbox / /permissions 관련 문제

메뉴의 간격 및 레이아웃의 미세한 어긋남 - 삭제된 이미지를 모델이 반복적으로 다시 불러오려고 시도하는 문제

Workflow 툴이 도입되어, Claude Code는 대화형 에이전트 (Conversational Agent)뿐만 아니라 정해진 절차를 실행하는 실행 기반 (Execution Infrastructure)으로서도 동작할 수 있습니다. /code-review --comment와 조합하면, PR 리뷰의 1차 분류까지 Claude Code 내에서 완결됩니다. 이와 함께 Windows 및 PowerShell 주변의 미세한 수정 사항도 함께 포함되었습니다.