Cmd. /autofix-pr
현재 브랜치 PR의 CI 실패와 리뷰 코멘트를 감시해 자동으로 수정·푸시하는 웹 세션을 띄우는 명령
핵심 요약
- PR 실패·리뷰 코멘트를 고치는 cloud session 실행
- 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
PR 실패·리뷰 코멘트를 고치는 cloud session 실행
/autofix-pr [prompt]사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 조건부 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
gh CLI와 클라우드 세션 접근이 필요하며 현재 체크아웃한 브랜치의 PR을 감시합니다.
사용 예
/autofix-pr only fix lint and type errors# 현재 브랜치의 열린 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 | 현재 세션을 백그라운드로 분리 | 터미널을 비우고 작업을 계속 실행 |
실행 결과와 유지 범위
현재 브랜치의 PR을 감시하는 클라우드 세션을 시작하며, 조건에 맞는 수정사항을 push할 수 있습니다.
/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에게 감시 중단을 지시하면 됩니다.
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 사용을 재고하거나 비활성화하세요.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록