Claude Code 주간 브리핑 Week 19 — 플러그인 URL 설치·히스토리 전체 검색
Claude News

Claude Code 주간 브리핑 Week 19 — 플러그인 URL 설치·히스토리 전체 검색

hiwony7933 6월 3, 2026 1 min read

시리즈: Claude Code 주간 브리핑 | Week 19

2026년 5월 첫째 주, 플러그인과 히스토리 검색이 달라졌다

2026년 5월 4일부터 8일까지 Claude Code는 v2.1.128에서 v2.1.136으로 업데이트됐다. 이 포스팅은 Claude Code 공식 docs(code.claude.com) 기반으로 작성됐다. 공식 문서 기준 동작을 정리하는 방식임을 먼저 밝혀둔다.

이번 주 메인 기능은 2건 — URL에서 플러그인을 바로 로드하는 --plugin-url 플래그, 그리고 Ctrl+R 히스토리 검색을 전체 프로젝트로 확장하는 복원. 거기에 worktree 분기 기준 제어·auto mode 강제 차단 규칙·서브에이전트 캐시 절감 등 Other wins도 파이프라인 자동화·git 제어·비용 최적화 관점에서 직결되는 내용이 담겼다. 릴리스 노트 기준으로 공식 동작을 정리하고, 다중 에이전트·발행 파이프라인·git 규율 관점의 시사점을 분석으로 덧붙인다.

1. Plugins from .zip / URL — URL에서 플러그인 바로 설치

공식 docs 기준 동작

기존 --plugin-dir는 디렉토리 경로만 받았다. v2.1.128부터 .zip 플러그인 아카이브도 직접 받아들인다. 여기에 신규 --plugin-url 플래그가 추가됐다. URL에서 플러그인 아카이브를 가져와 현재 세션에 즉시 로드하는 방식이다.

claude --plugin-url https://example.com/my-plugin.zip

공식 docs가 명시한 용도는 두 가지다.

  • 마켓플레이스 등록 전 시험: 정식 배포 전 플러그인을 URL만으로 세션에 로드해 동작을 확인할 수 있다.
  • 아티팩트 스토어 배포: 조직 내부 플러그인을 아티팩트 스토어에 올려두고 URL 하나로 팀 전체에 배포하는 시나리오를 지원한다.

적용 시사점 ★

플러그인 개발 흐름의 마찰이 줄어드는 변경이다. 마켓플레이스에 올리지 않아도, 디렉토리를 직접 공유하지 않아도 URL만 전달하면 테스트가 가능해졌다. 예를 들어 조직 내부 Git 저장소에 플러그인 아카이브를 올려두고, CI/CD 파이프라인에서 --plugin-url로 해당 URL을 지정해 특정 버전 플러그인을 자동으로 로드하는 식의 배포가 가능하다. 단, 신뢰할 수 없는 URL의 아카이브를 그대로 로드하는 것은 보안 위험을 수반한다. 출처가 확인된 URL만 사용하는 것이 원칙이다.

2. History search across all projects — Ctrl+R 히스토리 전체 프로젝트로

공식 docs 기준 동작

Ctrl+R 역방향 검색이 v2.1.129에서 v2.1.124 이전 동작으로 복원됐다. 이제 기본 검색 대상은 현재 프로젝트에 국한되지 않고, 모든 프로젝트의 전체 프롬프트 히스토리를 포함한다.

검색 중 Ctrl+S를 누르면 현재 프로젝트 또는 현재 세션으로 범위를 좁힐 수 있다.

단축키동작
Ctrl+R전체 프로젝트 역방향 검색 (기본)
Ctrl+S (검색 중)현재 프로젝트·세션으로 범위 좁힘

공식 docs는 “지난주 다른 레포에서 실행한 명령을 기억할 때 유용하다”고 명시했다.

적용 시사점

멀티 레포 환경에서 작업 중 자주 겪는 상황이 있다. 특정 명령을 분명히 어딘가에서 실행했는데 어느 프로젝트였는지 기억이 안 나는 경우다. 전체 히스토리를 기본으로 검색하는 방식이 복원되면서 이 불편이 줄어든다. Ctrl+S로 좁히는 옵션이 함께 제공되므로 현재 프로젝트만 보고 싶을 때도 한 번의 키 입력으로 전환할 수 있다.

3. Other wins — 파이프라인 운영에 직결되는 개선 3가지

W19의 Other wins 중 파이프라인·자동화 관점에서 눈에 띄는 항목 3가지를 각각 정리한다.

worktree.baseRef 설정 (fresh | head) ★

--worktree, EnterWorktree 도구, agent-isolation worktree가 어떤 기준으로 브랜치를 분기할지를 제어하는 설정이다. 값은 두 가지다.

  • fresh(기본): 원격 default 브랜치에서 분기. 미푸시 커밋은 새 worktree에서 제외된다.
  • head: 로컬 HEAD에서 분기. 미푸시 커밋이 새 worktree에 포함된다.

기본값 fresh는 “새 worktree에는 이미 원격에 올라간 상태만 포함”이라는 안전한 출발점을 보장한다. main 브랜치에 직접 커밋하는 방식으로 운영하는 파이프라인이라면 이 기본값이 의도에 맞는다. 미푸시 상태를 worktree에서 이어가야 하는 시나리오라면 head로 전환할 수 있다.

settings.autoMode.hard_deny 규칙 ★

auto mode에서 allow 예외가 설정돼 있어도 특정 액션을 무조건 차단하는 규칙이다. 공식 docs는 “더 넓은 allow 규칙이 적용되더라도 자동으로 실행되어선 안 되는 액션”을 막기 위한 용도라고 설명한다.

자동화 파이프라인에서 의도치 않게 특정 명령이 실행되는 상황을 설정 레벨에서 원천 차단할 수 있는 수단이 생겼다. 파이프라인 설계 시 “이것만은 자동으로 절대 실행 안 된다”는 규칙을 공식 설정으로 고정할 수 있다.

서브에이전트 진행 요약 캐시 적중 — cache_creation 토큰 비용 약 3배 절감

서브에이전트가 생성하는 진행 요약이 이제 prompt cache에 적중한다. 공식 docs 기준 cache_creation 토큰 비용이 약 3배 절감되는 효과다. 서브에이전트를 대규모로 운용하는 파이프라인에서는 비용 부담이 실질적으로 줄어든다.

Week 19 정리

기능버전분류
Plugins from .zip / URL (--plugin-url)v2.1.128+플러그인 확장 ★★
History search across all projectsv2.1.129터미널 UX ★
worktree.baseRef 설정Other winsgit 제어 ★
settings.autoMode.hard_denyOther wins자동화 보안 ★
서브에이전트 캐시 절감 (~3×)Other wins비용 최적화

이번 주 핵심은 --plugin-url과 Ctrl+R 전체 검색 복원 두 가지다. 플러그인은 URL만으로 테스트·배포 흐름이 가능해졌고, 히스토리 검색은 멀티 레포 환경 기본값이 전체 범위로 복원됐다. Other wins의 worktree.baseRef와 settings.autoMode.hard_deny는 파이프라인 설계 단계에서 한 번 점검할 만한 설정이다.

이 시리즈의 다른 글

이 포스팅은 Claude Code 주간 브리핑 시리즈의 일부입니다. 다른 주차 브리핑은 시리즈 전체 목록에서 확인할 수 있습니다.

출처: Claude Code 공식 docs — code.claude.com (릴리스 v2.1.128–v2.1.136, 2026-05-04 ~ 2026-05-08)

Tags: