4 4 

5# 19주차 · 2026년 5월 4–8일5# 19주차 · 2026년 5월 4–8일

6 6 

7> .zip 아카이브 및 URL에서 플러그인을 로드하고, Ctrl+R로 모든 프로젝트의 명령 기록을 검색하고, 로컬 HEAD 또는 원격 기본값에서 새 worktree를 분기하고, 자동 모드 하드 거부 규칙으로 작업을 무조건 차단합니다.7> .zip 아카이브 및 URL에서 플러그인을 로드하고, Ctrl+R로 모든 프로젝트에서 명령 기록을 검색하고, 로컬 HEAD 또는 원격 기본값에서 새 worktree를 분기하고, 자동 모드 hard deny 규칙으로 작업을 무조건 차단합니다.

8 8 

9<div className="digest-meta">9<div className="digest-meta">

10 <span>릴리스 <a href="/docs/en/changelog#2-1-128">v2.1.128 → v2.1.136</a></span>10 <span>릴리스 <a href="/docs/en/changelog#2-1-128">v2.1.128 → v2.1.136</a></span>

11 <span>2가지 기능 · 5월 4–8일</span>11 <span>2가지 기능 · 5월 4–8</span>

12</div>12</div>

13 13 

14<div className="digest-feature">14<div className="digest-feature">

16 <span className="digest-feature-title">.zip 아카이브 및 URL의 플러그인</span>16 <span className="digest-feature-title">.zip 아카이브 및 URL의 플러그인</span>

17 </div>17 </div>

18 18 

19 <p className="digest-feature-lede">`--plugin-dir`은 이제 디렉토리 외에도 <code>.zip</code> 플러그인 아카이브를 허용하며, 새로운 `--plugin-url` 플래그는 현재 세션을 위해 URL에서 플러그인 아카이브를 가져옵니다. 플러그인을 마켓플레이스에 추가하기 전에 시도하거나 아티팩트 저장소에서 내부 플러그인을 배포하는 데 유용합니다.</p>19 <p className="digest-feature-lede">`--plugin-dir`은 이제 디렉터리 외에도 <code>.zip</code> 플러그인 아카이브를 허용하며, 새로운 `--plugin-url` 플래그는 현재 세션을 위해 URL에서 플러그인 아카이브를 가져옵니다. 플러그인을 마켓플레이스에 추가하기 전에 시도하거나 아티팩트 저장소에서 내부 플러그인을 배포하는 데 유용합니다.</p>

20 20 

21 <p className="digest-feature-try">URL에서 직접 플러그인을 로드합니다:</p>21 <p className="digest-feature-try">URL에서 직접 플러그인을 로드합니다:</p>

22 22 

29 29 

30<div className="digest-feature">30<div className="digest-feature">

31 <div className="digest-feature-header">31 <div className="digest-feature-header">

32 <span className="digest-feature-title">모든 프로젝트의 기록 검색</span>32 <span className="digest-feature-title">모든 프로젝트에서 기록 검색</span>

33 <span className="digest-feature-pill">v2.1.129</span>33 <span className="digest-feature-pill">v2.1.129</span>

34 </div>34 </div>

35 35 

42 <p className="digest-wins-title">기타 개선 사항</p>42 <p className="digest-wins-title">기타 개선 사항</p>

43 43 

44 <div className="digest-wins-grid">44 <div className="digest-wins-grid">

45 <div>새로운 <code>worktree.baseRef</code> 설정(<code>fresh</code> | <code>head</code>)은 <code>--worktree</code>, <code>EnterWorktree</code> 도구 및 에이전트 격리 worktree가 원격 기본 분기에서 분기할지 또는 로컬 <code>HEAD</code>에서 분기할지를 제어합니다. 기본값 <code>fresh</code>는 새 worktree에서 푸시되지 않은 커밋을 유지합니다.</div>45 <div>새로운 <code>worktree.baseRef</code> 설정(<code>fresh</code> | <code>head</code>)은 `--worktree`, <code>EnterWorktree</code> 도구 및 에이전트 격리 worktree가 원격 기본 분기에서 분기하는지 또는 로컬 <code>HEAD</code>에서 분기하는지를 제어합니다. 기본값 <code>fresh</code>는 새 worktree에서 푸시되지 않은 커밋을 제외합니다.</div>

46 <div>새로운 <code>settings.autoMode.hard\_deny</code> 규칙은 더 광범위한 허용 규칙이 적용되더라도 자동 모드에서 일치하는 작업을 무조건 차단하며, 자동으로 실행되면 안 되는 작업의 경우입니다.</div>46 <div>새로운 <code>settings.autoMode.hard\_deny</code> 규칙은 더 광범위한 allow 규칙이 적용되더라도 자동 모드에서 일치하는 작업을 무조건 차단하며, 자동으로 실행되어서는 안 되는 작업의 경우입니다.</div>

47 <div>훅은 이제 `effort.level` JSON 입력 필드 및 `$CLAUDE_EFFORT` 환경 변수를 통해 활성 노력 수준을 수신하며, Bash 도구 명령은 <code>\$CLAUDE\_EFFORT</code>를 읽을 수 있습니다.</div>47 <div>훅은 이제 `effort.level` JSON 입력 필드 및 `$CLAUDE_EFFORT` 환경 변수를 통해 활성 노력 수준을 수신하며, Bash 도구 명령은 <code>\$CLAUDE\_EFFORT</code>를 읽을 수 있습니다.</div>

48 <div><code>CLAUDE\_CODE\_DISABLE\_ALTERNATE\_SCREEN=1</code>은 전체 화면 대체 화면 렌더러를 거부하고 대화를 터미널의 기본 스크롤백에 유지합니다.</div>48 <div><code>CLAUDE\_CODE\_DISABLE\_ALTERNATE\_SCREEN=1</code>은 전체 화면 대체 화면 렌더러를 거부하고 대화를 터미널의 기본 스크롤백에 유지합니다.</div>

49 <div><code>CLAUDE\_CODE\_PACKAGE\_MANAGER\_AUTO\_UPDATE</code>는 Homebrew 또는 WinGet 설치가 백그라운드에서 업그레이드를 실행하고 다시 시작하라는 메시지를 표시하도록 합니다.</div>49 <div><code>CLAUDE\_CODE\_PACKAGE\_MANAGER\_AUTO\_UPDATE</code>는 Homebrew 또는 WinGet 설치가 백그라운드에서 업그레이드를 실행하고 다시 시작하라는 메시지를 표시하도록 합니다.</div>

50 <div><code>CLAUDE\_CODE\_SESSION\_ID</code>는 이제 Bash 도구 하위 프로세스 환경에 있으며, 훅에 전달된 <code>session\_id</code>와 일치합니다.</div>50 <div><code>CLAUDE\_CODE\_SESSION\_ID</code>는 이제 Bash 도구 하위 프로세스 환경에 있으며, 훅에 전달된 <code>session\_id</code>와 일치합니다.</div>

51 <div><code>/mcp</code>는 이제 연결된 서버의 도구 수를 표시하고 0개의 도구로 연결된 서버에 플래그를 지정합니다.</div>51 <div><code>/mcp</code>는 이제 연결된 서버의 도구 개수를 표시하고 0개의 도구로 연결된 서버에 플래그를 지정합니다.</div>

52 <div><code>--channels</code>는 이제 콘솔(API 키) 인증과 함께 작동합니다.</div>52 <div>`--channels`는 이제 콘솔(API 키) 인증과 함께 작동합니다.</div>

53 <div>Bash, 훅, MCP 및 LSP와 같은 하위 프로세스는 더 이상 <code>OTEL\_\*</code> 환경 변수를 상속하지 않으므로 Bash 도구를 통해 실행되는 OTEL 계측 앱은 더 이상 CLI의 자체 OTLP 엔드포인트를 선택하지 않습니다.</div>53 <div>Bash, 훅, MCP 및 LSP와 같은 하위 프로세스는 더 이상 <code>OTEL\_\*</code> 환경 변수를 상속하지 않으므로 Bash 도구를 통해 실행되는 OTEL 계측 앱은 더 이상 CLI의 자체 OTLP 엔드포인트를 선택하지 않습니다.</div>

54 <div>하위 에이전트 진행 요약은 이제 프롬프트 캐시에 도달하여 <code>cache\_creation</code> 토큰 비용을 대략 3배 줄입니다.</div>54 <div>하위 에이전트 진행 요약은 이제 프롬프트 캐시에 도달하여 <code>cache\_creation</code> 토큰 비용을 대략 3배 줄입니다.</div>

55 <div>여러 OAuth 및 자격 증명 안정성 수정: 병렬 세션은 더 이상 새로 고침 토큰 경쟁 후 401에서 막히지 않으며, MCP OAuth 새로 고침 토큰은 여러 서버가 동시에 새로 고칠 때 더 이상 손실되지 않으며, 동시 자격 증명 쓰기로 인한 드문 로그인 루프가 수정됩니다.</div>55 <div>여러 OAuth 및 자격 증명 안정성 수정: 병렬 세션은 더 이상 새로 고침 토큰 경쟁 후 401에서 막히지 않으며, MCP OAuth 새로 고침 토큰은 여러 서버가 동시에 새로 고칠 때 더 이상 손실되지 않으며, 동시 자격 증명 쓰기로 인한 드문 로그인 루프가 수정됩니다.</div>

56 <div>새로운 <code>parentSettingsBehavior</code> 관리자 키를 통해 관리자는 SDK <code>managedSettings</code>를 정책 병합에 선택할 수 있습니다.</div>56 <div>새로운 <code>parentSettingsBehavior</code> 관리자 키를 통해 관리자는 SDK <code>managedSettings</code>를 정책 병합에 옵트인할 수 있습니다.</div>

57 </div>57 </div>

58</div>58</div>

59 59