2026년 7월, Claude Code의 최신 버전 v2.1.198이 출시되었습니다. 이번의 핵심은 Chrome 확장 기능인 "Claude in Chrome"의 일반 제공(GA) 시작이지만, 그 이상으로 주목해야 할 점은 백그라운드 에이전트(Background Agent)의 자율 운용이 한 단계 더 진보했다는 것입니다.

구체적으로는 에이전트의 상태 변화를 감지하는 Notification フック(Hook)가 추가되었으며, 나아가 작업 완료 후 확인 절차 없이 자동으로 commit / push / 드래프트 PR(Draft PR) 생성까지 수행하게 되었습니다. 이는 개발 워크플로우에 직접적인 영향을 미치는 기본 동작의 변경이며, CI/CD나 브랜치 보호 규칙(Branch Protection Rule)을 운용하고 있는 팀은 특히 주의가 필요합니다.

또한, 대화형 /agents 위저드(Wizard)가 폐지되는 등 기존의 운영 절차서나 문서의 검토가 필요한 변경 사항도 포함되어 있습니다. 본 기사에서는 이러한 변경점들을 "무엇이 바뀌었는가"뿐만 아니라 "왜 중요한가", "어떻게 대응해야 하는가"의 관점에서 정리합니다.

📌 영향을 받는 사람

• Claude Code의 claude agents (백그라운드 에이전트)를 업무 흐름에 포함시키고 있는 개발자 및 팀
• /agents 위저드를 사용하여 서브 에이전트(Sub-agent)를 생성 및 관리하던 사람
• Gateway를 통해 여러 LLM 프로바이더(Provider)를 페일오버(Failover) 구성하고 있는 사람
• Chrome 확장판 Claude를 프리뷰로 테스트했거나, 앞으로 사용하고자 하는 사람

v2.1.198의 변경 사항은 크게 "에이전트 자율화 강화", "에코시스템 확장", "비권장 사항(Deprecated) 대응"의 3가지 계통으로 분류할 수 있습니다.

빨간색 테두리는 특히 운용 흐름에 영향이 큰 변경, 파란색 테두리는 이용 범위가 넓어지는 긍정적인 변경입니다. 이후에는 severity(심각도)가 high인 변경을 중심으로, 영향도가 높은 것부터 해설하겠습니다.

브라우저 확장 기능인 "Claude in Chrome"이 프리뷰를 거쳐 정식 제공되었습니다. 지금까지 일부 사용자만 이용할 수 있었던 브라우저 내 Claude 연동이 모든 사용자에게 개방됩니다. 브라우저 조작 자동화나 페이지 내용을 바탕으로 한 질문 응답 등의 유스케이스(Use case)를 더 많은 개발자가 이용할 수 있게 됩니다.

claude agents로 기동한 세션이 "입력 대기" 또는 "완료" 상태가 된 타이밍에, agent_needs_input / agent_completed라는 두 종류의 Notification フック(Hook)가 발화하게 되었습니다.

이를 통해 여러 백그라운드 에이전트를 병행 가동하더라도, 멈춰 있는 세션이나 완료된 세션을 능동적으로 감시할 필요가 없어집니다.

이번 릴리스에서 가장 운용 임팩트가 큰 변경입니다. 기존에 백그라운드 에이전트는 worktree에서의 코드 변경이 완료되면 그곳에서 정지하여 사용자에게 확인을 요청했습니다. v2.1.198 이후부터는 확인 없이 자동으로 commit → push → 드래프트 PR 생성까지 실행합니다.

⚠️ Breaking Change

사용자의 명시적인 승인 없이 원격 리포지토리(Remote Repository)로의 push가 발생하게 되었습니다. 브랜치 보호 규칙이나 PR 리뷰 체제를 운용하고 있는 팀은 의도하지 않은 브랜치로의 push나 드래프트 PR이 난립하지 않는지 확인하십시오.

Gateway의 상류 프로바이더로서 anthropicAws (AWS 상의 Claude Platform)가 추가되었습니다. 기존에는 모델을 찾을 수 없는(model-not-found) 응답을 받으면 그곳에서 에러가 발생하며 정지했지만, 앞으로는 페일오버 체인의 다음 프로바이더로 자동 전환됩니다.

멀티 클라우드 구성이나 AWS를 경유한 Claude 이용을 조합하고 있는 경우, 가용성이 향상됩니다.

대화형 /agents 위저드가 삭제되었습니다.

항목	구 버전 (~v2.1.197)	신 버전 (v2.1.198~)
서브 에이전트 생성	/agents 위저드로 대화하며 생성	Claude에게 요청 또는 .claude/agents/를 직접 편집
관리·편집	위저드 내에서 완결	파일 기반의 직접 편집
문서 기재	/agents 절차를 전제로 한 기술이 유효	해당 부분의 수정이 필요

⚠️ Breaking Change

/agents

를 전제로 한 사내 문서나 온보딩 (Onboarding) 자료가 있는 경우 업데이트가 필요합니다.

변경 사항	개요
Explore 에이전트의 모델 상속	기존에는 haiku로 고정되었으나, 메인 세션의 모델 (상한 opus)을 상속
...

브랜치 보호 및 PR 리뷰 체계 확인: 백그라운드 에이전트의 자동 push / 드래프트 PR (Draft PR) 생성이 팀의 브랜치 보호 정책과 충돌하지 않는지 확인하십시오 -
Notification 후크 설정: agent_needs_input, agent_completed를 활용하여 Slack이나 데스크톱 알림과 연동하는 체계를 정비하면, 여러 에이전트의 병행 운용이 용이해집니다 -
: 사내 Wiki나 온보딩 자료에서 /agents 관련 문서의 재고를 조사하고, /agents 위저드 (Wizard) 절차가 남아있지 않은지 확인하여 .claude/agents/ 직접 편집 절차로 교체하십시오 -
Gateway 구성 재검토: 여러 프로바이더 (Provider)를 이용하고 있는 경우, anthropicAws를 상류 (Upstream)에 추가함으로써 페일오버 (Failover) 신뢰성을 높일 수 있습니다 -
Chrome 확장 프로그램 도입 검토: 그동안 프리뷰 (Preview)를 기다려온 팀은 GA (General Availability) 전환에 따라 본격적인 도입을 검토할 수 있습니다

{
"hooks": {
"Notification": [
...

Before (폐지된 절차):

$ /agents
> 위저드에 따라 대화형으로 작성...

After (.claude/agents/ 직접 편집):

---
name: code-reviewer
description: 코드 변경 리뷰를 전문으로 수행하는 서브 에이전트
...

또는 메인 세션에서 Claude에게 직접 요청하여 생성할 수도 있습니다.

이 리포지토리용으로 코드 리뷰 전문 서브 에이전트를
.claude/agents/code-reviewer.md 로 생성해줘

Claude Code v2.1.198은 Chrome 확장 프로그램의 GA 전환이라는 표면적인 큰 뉴스 이면에, 백그라운드 에이전트의 자율 운용을 크게 진전시킨 릴리스입니다. 특히 '완료 시 자동 commit/push/드래프트 PR 생성'은 기본 동작 (Default behavior)의 변경이므로, 기존 개발 플로우에 미치는 영향을 사전에 확인해 둘 것을 강력히 권장합니다.

또한 /agents 위저드의 폐지는 작은 변경처럼 보일 수 있으나, 문서나 온보딩 자료의 업데이트 누락으로 이어지기 쉬우므로 잊지 말고 재고를 조사해 두시기 바랍니다. Gateway에 AWS 프로바이더를 추가하거나 Explore 에이전트의 모델 상속 등, 눈에 띄지는 않지만 가용성 및 품질 측면의 개선도 착실히 쌓여가고 있습니다.

팀에서의 도입 및 운용 규칙을 재검토하기 좋은 타이밍으로서, 이번 업데이트 내용을 확인해 보시기 바랍니다.