Claude Code v2.1.129 — 플러그인 URL 가져오기, 자동 업데이트, Ctrl+R 개선
AI

Claude Code v2.1.129 — 플러그인 URL 가져오기, 자동 업데이트, Ctrl+R 개선

zaq · · 4 min read

Claude Code v2.1.129이 출시되었습니다. 웹에서 직접 플러그인을 가져오고, 패키지 매니저로 자동 업데이트할 수 있게 되면서 플러그인 관리가 훨씬 편해졌습니다.

한마디로 요약하면

--plugin-url <url> 플래그로 URL에서 플러그인 zip을 직접 가져올 수 있고, Homebrew/WinGet 설치 시 자동 업데이트가 가능해졌습니다. Ctrl+R 히스토리 픽커가 모든 프로젝트를 검색하도록 변경되었고, Gateway /v1/models discovery는 이제 옵트인입니다.

플러그인 URL 직접 가져오기

--plugin-url <url> 플래그가 추가되었습니다. GitHub 릴리스 페이지에서 플러그인 zip URL을 복사해서 명령줄에 붙여넣으면 다운로드와 설치가 한 번에 끝납니다. 로컬 파일을 다운로드하고 설치 경로를 지정하는 번거로운 절차가 없어졌습니다.

claude --plugin-url https://github.com/user/plugin/archive/main.zip

자동 업데이트 지원

CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 환경변수를 설정하면 Homebrew나 WinGet으로 설치된 Claude Code가 백그라운드에서 업그레이드를 실행하고, 재시작을 프롬프트합니다. 이제 brew update && brew upgrade claude-code를 수동으로 돌릴 필요가 없습니다. 설정은 .bashrc나 .zshrc에 추가합니다.

export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1

Gateway Model Discovery 옵트인

2.1.126–2.1.128에서는 Gateway의 /v1/models 엔드포인트에서 자동으로 모델을 디스커버리했는데, 이번 버전부터는 옵트인으로 변경되었습니다. Bedrock, Vertex, Foundry, 또는 ANTHROPIC_BASE_URL gateway를 사용하는 서드파티 배포에서 더 이상 Anthropic 퍼스트파티 서피스로 가르키는 스피너 팁이 표시되지 않습니다.

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Ctrl+R과 UX 개선

Ctrl+R 히스토리 픽커가 이제 모든 프로젝트의 모든 프롬프트를 검색하도록 기본 동작이 변경되었습니다. 이전(2.1.124 이전) 동작으로 되돌리고 싶다면 Ctrl+S를 누르면 현재 프로젝트나 세션으로 검색 범위를 좁힐 수 있습니다.

다른 UX 개선 사항:

  • skillOverrides 설정이 이제 작동합니다: off로 모델과 /에서 숨기기, user-invocable-only로 모델에서만 보이기, name-only로 설명 접기
  • 플러그인 매니페스트에서 themes와 monitors는 이제 "experimental": { ... } 아래에 선언해야 합니다 (top-level 선언도 여전히 동작하지만 경고가 표시됨)
  • 정책 거부 에러 메시지에 API Request ID가 포함되어 지원 티켓팅 시 디버깅이 편해졌습니다.
  • /clear 실행 후 터미널 탭브 타이틀이 정상적으로 리셋됩니다.
  • 권한/다이얼로그 활성 중 /rename 세션 타이틀 칩이 사라지는 버그가 수정되었습니다.
  • 서브에이전트 실행 중 프롬프트 아래 에이전트 패널이 가려지는 회귀 버그가 수정되었습니다(2.1.122 회귀).
  • 외부 에디터 핸드오프(Ctrl+G) 시 프롬프트 위에 대화 히스토리가 비어지는 버그가 수정되었습니다.
  • /context의 ASCII 그리드 시각화가 중단되지 않도록 수정되었습니다.

OTel 메트릭 개선

claude_code.pull_request.count 메트릭이 이제 셸 명령뿐만 아니라, MCP 툴을 통해 생성된 PR/MR도 카운트합니다. 에이전트가 직접 PR을 만들 때도 메트릭에 반영됩니다.

API 에러 메시지 개선

인식할 수 없는 400 상태 코드의 API 에러가 이제 원본 에러 메시지를 보여줍니다. 이전에는 raw JSON만 표시되어서 어떤 문제인지 파악하기 어려웠습니다. 이제 명확한 에러 메시지와 함께 API Request ID도 포함되어 지원 티켓팅이 편해졌습니다.

마무리

이번 업데이트는 플러그인 생태계를 더 쉽게 활용할 수 있게 하고, 일반적인 UX 버그를 잡아 사용 경험을 개선했습니다. 특히 --plugin-url로 웹에서 직접 플러그인을 가져올 수 있게 된 점이 개발자들에게 유용합니다. 자동 업데이트는 Homebrew/WinGet 사용자에게 필수적인 기능일 겁니다.

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.129