Cmd. /autofix-pr
현재 브랜치 PR의 CI 실패와 리뷰 코멘트를 감시해 자동으로 수정·푸시하는 웹 세션을 띄우는 명령
핵심 요약
/autofix-pr [prompt]는 Claude Code on the web 세션을 띄워, 현재 체크아웃 브랜치의 열린 PR을 감시하고 CI 실패·리뷰 코멘트를 자동으로 수정·푸시합니다.- 열린 PR은
gh pr view로 현재 브랜치에서 자동 감지하므로, 다른 PR을 처리하려면 먼저 그 브랜치로 체크아웃합니다. - Auto-fix는 PR 단위 토글이며, 저장소에 Claude GitHub App이 설치돼 있어야 PR 웹훅을 수신할 수 있습니다.
- Claude는 명확한 수정은 바로 푸시하지만 모호하거나 아키텍처적으로 중요한 코멘트는 행동 전에 먼저 묻습니다.
issue_comment트리거 자동화(Atlantis 등)를 쓰는 저장소에서는 답글이 워크플로를 발동시킬 수 있어 사용을 재고하세요.
명령어 원본 선언
/autofix-pr [prompt][prompt]은 선택 인자입니다. 생략하면 원격 세션이 모든 CI 실패와 리뷰 코멘트를 수정하도록 지시받습니다.- 별칭(alias)은 공식 문서에 명시되어 있지 않습니다.
공식 설명 요약
/autofix-pr는 Claude Code on the web 세션을 띄워, 현재 체크아웃된 브랜치의 열린 PR을 감시하고 CI가 실패하거나 리뷰어가 코멘트를 남기면 수정 사항을 푸시하도록 위임하는 명령입니다.
- 열린 PR은
gh pr view로 현재 체크아웃된 브랜치에서 자동 감지합니다. 다른 PR을 감시하려면 먼저 그 브랜치로 체크아웃하세요. - 인자를 주지 않으면 원격 세션은 모든 CI 실패와 리뷰 코멘트를 고치라고 지시받습니다. 다른 지시를 주려면 prompt를 전달합니다(예:
/autofix-pr only fix lint and type errors). - 터미널에서 이 명령을 실행하면 Claude Code가
gh로 열린 PR을 감지하고, 웹 세션을 띄운 뒤 Auto-fix를 켜는 과정을 한 번에 처리합니다. - 실행에는
ghCLI와 Claude Code on the web 접근 권한이 필요합니다.
Auto-fix는 /autofix-pr 외에도 다음 방법으로 켤 수 있습니다.
- 웹에서 만든 PR: CI 상태 바를 열고 Auto-fix 선택
- 모바일 앱: "이 PR을 감시하면서 CI 실패나 리뷰 코멘트를 고쳐줘"처럼 지시
- 기존 PR 전부: 세션에 PR URL을 붙여 넣고 Auto-fix를 요청
Auto-fix는 PR 단위 토글입니다. 중단하려면 웹 세션의 CI 상태 바에서 Auto-fix 토글을 끄거나 Claude에게 감시 중단을 지시하면 됩니다.
최소 지원 버전
- 공식
Commands문서의 명령어 표에는 버전 컬럼이 없으며, 도입 버전이 별도로 명시되어 있지 않습니다. 다만 기능 자체가 Claude Code on the web에 의존하므로, 해당 기능을 사용할 수 있는 플랜·환경이 사실상의 전제 조건입니다. - Claude Code on the web은 Pro·Max·Team 사용자, 그리고 premium seat 또는 Chat + Claude Code seat을 가진 Enterprise 사용자를 대상으로 한 research preview 단계입니다.
사용법
# 현재 브랜치의 열린 PR을 감지해 모든 CI 실패·리뷰 코멘트를 자동 수정
/autofix-pr# 수정 범위를 prompt로 제한
/autofix-pr only fix lint and type errors좋은 사용 예
- PR이 이미 열려 있고 CI 실패가 명확할 때 자동 수정 루프를 시작
- 리뷰 코멘트가 많지만 범위가 제한적인 경우 prompt로 수정 범위를 좁힘
- 로컬 세션은 설계·검토에 두고 반복 수정은 원격 세션으로 분리
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/autofix-pr | 원격 웹 세션이 PR을 감시·수정 | CI/리뷰 코멘트 자동 처리 |
/web-setup | 웹 세션용 GitHub 연결 설정 | 원격 세션 사용 전 GitHub 연결 |
/review | 현재 세션에서 로컬 리뷰 | 빠른 1차 결함 점검 |
/background | 현재 세션을 백그라운드로 분리 | 터미널을 비우고 작업을 계속 실행 |
활용 사례
- 린트/타입 오류처럼 수정 범위가 좁은 실패 자동 처리
- 리뷰어가 남긴 간단한 copy, test, doc 요청 처리
- 장시간 CI 재시도 중 로컬 세션을 다른 작업에 활용
Claude가 PR 활동에 반응하는 방식
Auto-fix가 켜져 있으면 Claude는 PR의 GitHub 이벤트(새 리뷰 코멘트, CI 체크 실패 등)를 받고, 이벤트마다 조사한 뒤 처리 방식을 결정합니다.
- 명확한 수정: 수정에 확신이 있고 이전 지시와 충돌하지 않으면, 변경을 적용해 푸시하고 세션에서 무엇을 했는지 설명합니다.
- 모호한 요청: 리뷰어 코멘트가 여러 해석이 가능하거나 아키텍처적으로 중요한 사안이면, 행동하기 전에 사용자에게 먼저 묻습니다.
- 중복·무처리 이벤트: 중복이거나 변경이 필요 없는 이벤트는 세션에 기록만 하고 넘어갑니다.
Claude는 리뷰 코멘트 스레드를 해결하면서 GitHub에 답글을 답니다. 이 답글은 사용자의 GitHub 계정으로 게시되어 사용자 이름으로 보이지만, 각 답글에 Claude Code가 작성했다는 표시가 붙어 리뷰어는 사람이 아닌 에이전트가 쓴 글임을 알 수 있습니다.
주의사항
ghCLI와 Claude Code on the web 접근 권한이 필요합니다.- Auto-fix는 저장소에 Claude GitHub App이 설치되어 있어야 합니다. 이 App이 PR 웹훅을 수신하는 데 쓰이며,
/web-setup으로만 연결한 경우에는 별도로 GitHub App을 설치해야 Auto-fix를 쓸 수 있습니다. - 현재 체크아웃된 브랜치 기준으로 PR을 찾으므로(
gh pr view), 다른 PR을 처리하려면 해당 브랜치로 먼저 전환하세요. - 보안/아키텍처 변경처럼 판단이 필요한 코멘트는 prompt로 제외하거나 사람이 직접 검토하세요. Claude도 모호하거나 중요한 사안은 먼저 묻지만, 민감한 변경만큼은 사람이 검토하는 편이 안전합니다.
- 저장소가
issue_comment이벤트로 동작하는 코멘트 트리거 자동화(Atlantis, Terraform Cloud, 커스텀 GitHub Actions 등)를 쓴다면 주의하세요. Claude가 사용자를 대신해 답글을 달면 그런 워크플로가 트리거될 수 있습니다. PR 코멘트만으로 인프라 배포나 권한 작업이 실행되는 저장소에서는 Auto-fix 사용을 재고하거나 비활성화하세요.
출처
- Commands: https://code.claude.com/docs/en/commands
- Use Claude Code on the web (Auto-fix pull requests): https://code.claude.com/docs/en/claude-code-on-the-web#auto-fix-pull-requests