> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

<div className="digest-meta">
  <span>릴리스 <a href="/ko/changelog#2-1-128">v2.1.128 → v2.1.136</a></span>
  <span>2가지 기능 · 5월 4–8일</span>
</div>

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

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

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

  ```bash terminal theme={null}
  claude --plugin-url https://example.com/my-plugin.zip
  ```

  <a className="digest-feature-link" href="/ko/plugins">플러그인 가이드</a>
</div>

<div className="digest-feature">
  <div className="digest-feature-header">
    <span className="digest-feature-title">모든 프로젝트의 기록 검색</span>
    <span className="digest-feature-pill">v2.1.129</span>
  </div>

  <p className="digest-feature-lede"><code>Ctrl+R</code> 역방향 검색은 이제 기본적으로 모든 프로젝트의 모든 프롬프트로 기본값이 설정되어 v2.1.124 이전의 동작을 복원합니다. 검색 중에 <code>Ctrl+S</code>를 눌러 현재 프로젝트 또는 세션으로 범위를 좁힙니다. 지난주 다른 저장소에서 실행한 명령을 기억하고 있지만 찾기 위해 파고 싶지 않을 때 유용합니다.</p>

  <a className="digest-feature-link" href="/ko/interactive-mode#command-history">대화형 모드: 명령 기록</a>
</div>

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

  <div className="digest-wins-grid">
    <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>
    <div>새로운 <code>settings.autoMode.hard\_deny</code> 규칙은 더 광범위한 허용 규칙이 적용되더라도 자동 모드에서 일치하는 작업을 무조건 차단하며, 자동으로 실행되면 안 되는 작업의 경우입니다.</div>
    <div>훅은 이제 `effort.level` JSON 입력 필드 및 `$CLAUDE_EFFORT` 환경 변수를 통해 활성 노력 수준을 수신하며, Bash 도구 명령은 <code>\$CLAUDE\_EFFORT</code>를 읽을 수 있습니다.</div>
    <div><code>CLAUDE\_CODE\_DISABLE\_ALTERNATE\_SCREEN=1</code>은 전체 화면 대체 화면 렌더러를 거부하고 대화를 터미널의 기본 스크롤백에 유지합니다.</div>
    <div><code>CLAUDE\_CODE\_PACKAGE\_MANAGER\_AUTO\_UPDATE</code>는 Homebrew 또는 WinGet 설치가 백그라운드에서 업그레이드를 실행하고 다시 시작하라는 메시지를 표시하도록 합니다.</div>
    <div><code>CLAUDE\_CODE\_SESSION\_ID</code>는 이제 Bash 도구 하위 프로세스 환경에 있으며, 훅에 전달된 <code>session\_id</code>와 일치합니다.</div>
    <div><code>/mcp</code>는 이제 연결된 서버의 도구 수를 표시하고 0개의 도구로 연결된 서버에 플래그를 지정합니다.</div>
    <div><code>--channels</code>는 이제 콘솔(API 키) 인증과 함께 작동합니다.</div>
    <div>Bash, 훅, MCP 및 LSP와 같은 하위 프로세스는 더 이상 <code>OTEL\_\*</code> 환경 변수를 상속하지 않으므로 Bash 도구를 통해 실행되는 OTEL 계측 앱은 더 이상 CLI의 자체 OTLP 엔드포인트를 선택하지 않습니다.</div>
    <div>하위 에이전트 진행 요약은 이제 프롬프트 캐시에 도달하여 <code>cache\_creation</code> 토큰 비용을 대략 3배 줄입니다.</div>
    <div>여러 OAuth 및 자격 증명 안정성 수정: 병렬 세션은 더 이상 새로 고침 토큰 경쟁 후 401에서 막히지 않으며, MCP OAuth 새로 고침 토큰은 여러 서버가 동시에 새로 고칠 때 더 이상 손실되지 않으며, 동시 자격 증명 쓰기로 인한 드문 로그인 루프가 수정됩니다.</div>
    <div>새로운 <code>parentSettingsBehavior</code> 관리자 키를 통해 관리자는 SDK <code>managedSettings</code>를 정책 병합에 선택할 수 있습니다.</div>
  </div>
</div>

[v2.1.128–v2.1.136의 전체 변경 로그 →](/ko/changelog#2-1-128)