Claude Code 2.1.147

무엇이 바뀌었나?

Claude Code 2.1.147은 2026년 5월 21일에 출시됐습니다. 결정론적 멀티 에이전트 오케스트레이션을 위한 Workflow 도구가 새로 추가되었고(CLAUDE_CODE_WORKFLOWS=1로 활성화), 핀 고정 백그라운드 세션의 수명 관리가 다듬어졌으며, /simplify가 /code-review로 이름·동작을 바꿔 정확성 검토 도구로 재정비됐습니다. 보안 관련으로 엔터프라이즈 로그인 제한(forceLoginOrgUUID·forceLoginMethod)이 서드파티 제공자·API 키 세션에 적용되지 않던 우회가 닫혔습니다. 나머지는 REPL·Workflow 샌드박스 강화, 자동 업데이터 진단 개선, 큰 파일 diff 렌더링 성능, 프롬프트 히스토리 중복 제거, 그리고 PowerShell·Windows·MCP 페이지네이션·플러그인·터미널 UI 전반의 버그 수정입니다.

새 기능

• Workflow 도구 — 결정론적 멀티 에이전트 오케스트레이션

  여러 에이전트를 묶어 정해진 순서로 실행하는 워크플로를 지금까지는 외부 도구나 직접 작성한 스크립트로 표현해야 했습니다. 이번 릴리스에서 결정론적 오케스트레이션을 직접 다루는 Workflow 도구가 내장됐습니다. 기본 비활성 상태로 들어와 있으며, CLAUDE_CODE_WORKFLOWS=1 환경 변수를 설정해 활성화합니다.

주요 개선

• claude agents의 핀 고정 백그라운드 세션 수명 관리 다듬음

  핀 고정한 세션이 유휴 상태에서 정리되거나 업데이트 적용 후 별도 위치에서 다시 살아나는 경우가 있어, 작업 컨텍스트가 깨졌습니다. 이제 핀 고정 세션은 유휴 상태에서도 살아 있고, Claude Code 업데이트를 적용하기 위해 자리에서 재시작되며(Ctrl+T로 핀 고정), 메모리 압박 시 비핀 세션 다음에야 정리됩니다.

• /simplify → /code-review로 이름·동작 변경 — 정확성 버그를 effort 단계별로 보고, --comment로 GitHub PR 인라인 코멘트

  기존 /simplify는 코드를 정리·수정하는 동작에 머물러, 버그 자체를 찾는 검토 흐름에 적합하지 않았습니다. 이번 릴리스에서 /code-review로 이름이 바뀌고, 정확성 버그를 effort 단계별로(/code-review high처럼) 보고하도록 동작이 바뀌었습니다. --comment 플래그로 결과를 GitHub PR 인라인 코멘트로 직접 게시할 수 있습니다. 기존 /simplify의 정리·수정 동작은 제거됐습니다.

• REPL·Workflow 도구 샌드박스 강화 — 프로토타입 오염·thenable 기반 탈출 차단

  REPL과 Workflow 도구의 샌드박스에서 프로토타입 오염(prototype pollution)이나 thenable 패턴을 이용한 탈출 경로가 노출돼 있었습니다. 이번 릴리스에서 두 경로 모두 차단됐습니다.

• 자동 업데이터 — 재시도·오류 분류·OS 오류 코드·현재 버전 표시

  업데이트가 실패하면 원인 진단이 어려웠습니다. 이제 일시적 네트워크 오류는 재시도하고, 실패 시 오류 분류와 OS 오류 코드, 그리고 현재 설치된 버전을 함께 보고합니다.

• 큰 파일 편집의 diff 렌더링 성능 개선

  파일 크기가 클 때 diff 렌더링이 눈에 띄게 느려졌습니다. 렌더링 경로가 최적화되어 큰 편집에서도 반응성이 개선됐습니다.

• 프롬프트 히스토리의 연속 중복 제거

  방향키 위로 이전 프롬프트를 다시 제출하면 같은 항목이 히스토리에 누적되어, 위로 스크롤할수록 같은 내용이 반복돼 보였습니다. 이제 연속된 중복 항목은 한 번만 기록됩니다.

주요 버그 수정

보안·엔터프라이즈 인증

• forceLoginOrgUUID·forceLoginMethod 관리형 설정이 서드파티 제공자·API 키 세션에 적용되지 않던 우회 — 적용 범위가 확장되어 정책이 정상 강제됩니다.

헤드리스·SDK

• 헤드리스/SDK 모드에서 알 수 없는 슬래시 명령이 조용히 아무 일도 하지 않던 문제 — 이제 오류 메시지를 표시합니다.
• Agent SDK 경유 스트리밍 세션 종료 시 잡히지 않은 예외가 발생하던 문제 — 정리.

플러그인·스킬

• tools: frontmatter에 여러 Agent(...) 유형을 선언한 플러그인 에이전트가 마지막 항목만 남기고 모두 누락되던 문제 — 전체 항목이 보존되도록 수정.
• claude plugin details와 /plugin의 플러그인 구성요소 카운트가, 플러그인 매니페스트의 경로가 기본 디렉토리와 겹칠 때 두 배로 잡히던 문제 — 정확한 카운트로 정리.
• 슬래시 명령 뒤에 탭이나 줄바꿈이 붙으면 알 수 없는 명령으로 처리되던 문제 — 정상 해석.

터미널·UI

• ! 명령 출력에 포함된 &가 &로 표시돼, gcloud auth login 같은 명령의 URL을 헤드리스 머신에서 복사·붙여넣기할 때 깨지던 문제 — 원문 그대로 표시.
• /help가 작은 터미널·풀스크린이 아닌 모드에서 탭 헤더가 깨지고 페이지당 한 명령만 표시되던 문제 — 정리.
• /effort가 슬라이더를 잘못된 단계에서 시작하던 문제 — 이제 현재 effort에서 시작.
• /theme의 ‘New custom theme’·색상 편집기 다이얼로그가 Esc에 반응하지 않던 문제 — 정상 동작.
• GNOME Terminal에서 우클릭·가운데 클릭 붙여넣기가 텍스트를 삽입하지 않던 문제 — 정상 동작.
• /plugin·/status·/mobile·/sandbox·/permissions 메뉴의 간격·레이아웃 깨짐 — 정리.
• 붙여넣은 텍스트가 실제 내용 대신 [Pasted text #N] 자리표시자로 에이전트에게 전달되던 문제 — 원문이 전달되도록 수정.
• 이미 제거된 미디어를 모델이 반복해서 다시 읽도록 유도하던 문제(stripped images) — 정리.

셸 스냅샷

• 이름이 단일 언더스코어로 시작하는 사용자 함수가 셸 스냅샷에서 누락되어, 해당 함수를 참조하는 별칭이 깨지던 문제 — 보존되도록 수정.

PowerShell·Windows

• PowerShell(git push*) 같은 훅 if 조건이 한 번도 매칭되지 않고, PowerShell(*)만 동작하던 문제 — 패턴이 정상 매칭.
• PowerShell 도구가 기본 포매터에 의존하는 명령의 출력을 누락하던 문제 — 출력 보존.
• Windows에서 PowerShell 스크립트 호출에 ‘Yes, and don’t ask again’을 선택해도 이후 실행에 매칭되는 규칙이 작성되지 않던 문제 — 매칭되는 규칙 작성.
• pwsh가 winget이나 Microsoft Store로 설치된 환경에서 PowerShell 도구가 종료 코드 1로 실패하던 문제 — 정리.
• Windows에서 백그라운드 작업 워크트리를 제거할 때 NTFS 정션(junction)을 따라가 메인 리포까지 영향을 주던 문제 — 정션은 추적하지 않도록 수정.
• Windows에서 스크롤이 진정되기를 기다리는 동안 드물게 행이 걸리던 문제 — 정리.
• Claude가 스트리밍하는 동안 Windows Terminal에 첨부된 백그라운드 세션이 전체 화면 스트로빙(strobing)으로 깜빡이던 문제 — 정리.
• Windows에서 백그라운드 세션 결과에 CJK(한·중·일) 같은 폭이 넓은 문자가 포함될 때 에이전트 뷰 목록에 오래된·중복된 행이 남던 문제 — 정리.

MCP

• MCP 서버의 페이지네이션된 resources·templates·prompts 응답에서 1페이지 이후 항목이 누락되던 문제 — 모든 페이지가 수신됩니다. (참고: 2.1.144에서 같은 페이지네이션 누락이 tools/list에 대해 수정됐고, 이번 릴리스가 나머지 엔드포인트를 마저 정리합니다.)

백그라운드 세션·에이전트

• /background가 타이핑 입력이 스킬이나 커스텀 슬래시 명령뿐인 세션을 거부하던 문제 — 허용.
• 사용자나 스킬이 명시적으로 AskUserQuestion을 필요로 하는데 auto 모드가 이를 억제하던 문제 — auto 모드 분류기가 사용자의 답변을 의도 신호로 인식하도록 수정.
• ‘don’t ask again’으로 이미 부여한 도구 권한을 백그라운드로 돌린 세션이 다시 묻던 문제 — 권한 유지.
• CLAUDE_CODE_SUBAGENT_MODEL이 에이전트 팀에서 spawn된 팀원 프로세스에는 적용되지 않던 문제 — 적용 범위 확장.

알아두면 좋은 점

• Workflow 도구는 기본 비활성: 결정론적 멀티 에이전트 오케스트레이션을 시도하려면 CLAUDE_CODE_WORKFLOWS=1을 설정해야 합니다. 활성화 후에는 샌드박스 강화 항목(프로토타입 오염·thenable 탈출 차단)이 함께 적용됩니다.
• /simplify → /code-review 동작 변경: 단순 이름 변경이 아니라 동작이 바뀌었습니다. 기존 /simplify의 정리·수정 흐름은 제거되었고, 정확성 버그를 effort 단계로 보고하는 검토 흐름으로 재정비됐습니다. /simplify에 의존하던 스크립트는 새 동작을 기준으로 다시 평가해야 합니다.
• 엔터프라이즈 인증 우회 차단: forceLoginOrgUUID·forceLoginMethod가 서드파티 제공자·API 키 세션에 강제되지 않던 우회가 막혔습니다. 관리자 정책이 이전 버전에서 우회되어 왔다면, 이 릴리스 이후 적용이 강해진다는 점을 인지해야 합니다.
• MCP 페이지네이션 두 번째 정리: 2.1.144가 tools/list의 페이지네이션 누락을 잡았고, 이번 릴리스가 resources·templates·prompts의 같은 문제를 정리합니다. 페이지네이션을 제공하는 MCP 서버에서 노출 항목이 적게 보였다면 다시 점검할 가치가 있습니다.
• 자동 업데이터 진단 강화: 업데이트 실패 시 오류 분류·OS 오류 코드·현재 버전이 함께 표시되므로, 사내 IT 지원·이슈 보고 시 첨부할 정보가 더 명확해졌습니다.
• PowerShell 훅 매칭: PowerShell(git push*)처럼 인자에 와일드카드를 쓴 if 조건이 그동안 한 번도 매칭되지 않고 PowerShell(*)만 동작해 왔습니다. 기존 정책 파일에서 의도와 다르게 광범위 매칭이 실제로는 항상 적중하지 않았을 수 있으므로, 이번 버전에서 의도대로 좁혀지는지 확인이 필요합니다.