실전 가이드 · 3분 · 07.09

Claude Code v2.1.198로 잠자면서 Draft PR 쌓기 — 5분 셋업 가이드와 옵트아웃 체크

loopy vibecoder

#draft #Claude Code #배경에이전트 #GitHub #DraftPR #worktree #자동화 #Anthropic

핵심 요약 (TL;DR)

2026-07-01 배포된 Claude Code v2.1.198(32 changes)은 배경 에이전트가 워크트리에서 작업을 마치면 자동으로 git commit → git push → gh pr create --draft까지 수행합니다. 이슈 트리아지 → 에이전트 트리거 → Draft PR 알림까지 인간 개입 0으로 굴러가고, 리뷰 시점만 사람이 잡는 구조가 됐어요. 다만 자동 푸시가 기본이라 옵트아웃 훅을 미리 준비해두는 게 안전합니다.

뭐가 바뀌었길래

지금까지 배경 에이전트 워크플로의 실제 병목은 모델의 지능이 아니었습니다. 완료 후 사람이 수동으로 커밋 메시지 쓰고, gh pr create 치고, 리뷰어 지정하는 오퍼레이션 오버헤드가 발목을 잡았어요. claude agents로 밤새 워크트리를 굴려놔도, 아침에 앉아서 30분씩 PR 정리를 해야 했습니다.

v2.1.198은 그 갭을 닫았습니다. 배경 에이전트가 워크트리에서 작업을 완결하면 세 가지가 자동으로 갑니다.

git add . && git commit — 에이전트가 자동으로 메시지 생성
git push origin <branch> — 원격으로 자동 푸시
gh pr create --draft — Draft PR로 오픈, 사람에게 리뷰 요청

여기까지 개입 없이 갑니다. 아침에 확인하는 건 GitHub 알림 목록의 Draft PR들뿐인 거죠.

부수적인 변화도 있습니다. Explore 서브에이전트가 haiku 기본에서 세션 메인 모델(opus 캡)로 승격됐고, extended thinking 설정도 서브에이전트가 상속합니다. 스트림 워치독이 기본 활성화(5분 이벤트 없으면 재시도)돼서 야간 세션이 조용히 죽는 사고가 줄었습니다. 새 알림 훅으로 agent_needs_input과 agent_completed도 추가됐어요.

셋업 — 텔레그램 알림까지 5분 안에

agent_completed 훅을 텔레그램으로 붙이는 최소 구성입니다. ~/.claude/settings.json에 이렇게 넣어두면:

{
  "hooks": {
    "agent_completed": "curl -s -X POST https://api.telegram.org/bot$TG_TOKEN/sendMessage -d chat_id=$TG_CHAT -d text=\"에이전트 완료: $CLAUDE_TASK_ID\""
  }
}

밤새 에이전트가 Draft PR을 만들 때마다 폰이 짧게 울립니다. 아침에 커피 마시면서 PR 목록만 리뷰하면 됩니다. agent_needs_input을 별도 훅으로 연결해두면, 에이전트가 애매한 지점에서 승인을 요구할 때만 원격에서 답할 수 있어요.

옵트아웃이 필요한 경우

좋은 소식만 있는 건 아닙니다. Anthropic GitHub 리포의 Issue #73197에는 옵트아웃 요청이 폭주하고 있어요. 이유는 두 가지입니다. 하나는 프라이빗 리포에서 실수로 프로덕션 브랜치에 자동 푸시가 나갈 리스크. 다른 하나는 커밋 상태를 감지하던 레거시 스크립트가 자동 커밋 때문에 오작동하는 경우입니다.

공식 옵트아웃 스키마는 아직 안착되지 않았습니다. 그 사이 실전 방어로는 세 가지가 있어요. 첫째, GitHub 브랜치 보호에서 main·production 등 크리티컬 브랜치에 push 금지를 걸어두기. 둘째, 배경 에이전트를 항상 별도 워크트리(git worktree add)에서만 실행하기. 셋째, 스트림 워치독을 끄고 싶다면 CLAUDE_ENABLE_STREAM_WATCHDOG=0 환경변수로 비활성화. 규정 있는 조직이라면 이 셋을 먼저 세팅한 뒤 v2.1.198을 켜는 게 안전합니다.

워크플로가 어디로 이동했는가

바이브코더의 하루가 "IDE에서 편집"에서 "이슈 트리아지 + PR 리뷰"로 완전히 옮겨갔습니다. 코드 자체를 손으로 짜는 시간은 줄고, 어떤 이슈를 에이전트에게 맡길지 결정하는 시간과 올라온 PR을 검토하는 시간이 늘어납니다. v2.1.198은 그 이동의 마지막 조각을 채운 릴리즈인 셈이에요. 릴리즈 노트는 code.claude.com/docs/en/changelog에서, 옵트아웃 논의는 github.com/anthropics/claude-code/issues/73197에서 실시간으로 확인할 수 있습니다.

FAQ

Q. 자동 커밋/푸시/PR을 완전히 끄는 공식 옵션이 있나요?
2026-07-09 시점에서는 공식 스키마가 없습니다. Issue #73197에서 논의 중이니 프로덕션 도입 전 최신 상태를 확인하세요. 임시로는 브랜치 보호 규칙과 워크트리 격리가 실전 방어선입니다.

Q. 워크트리 밖에서 실행하면 어떻게 되나요?
자동 커밋/푸시는 워크트리 격리를 전제로 설계됐습니다. 워크트리 밖에서 배경 에이전트를 돌리면 예상치 못한 브랜치에 커밋될 수 있어서, 반드시 git worktree add로 격리된 디렉토리를 사용해야 합니다.

Q. agent_needs_input 훅은 어떤 상황에 트리거되나요?
에이전트가 진행 중 사람의 결정을 요구할 때 — 파괴적 명령 승인, 애매한 요구사항 해석 등 — 트리거됩니다. 텔레그램/슬랙 알림으로 붙여두면 원격에서도 승인 가능한 워크플로가 됩니다.