[Anthropic은 2026년 9월 22일 Claude Opus 5.5를 발표했습니다](https://www.anthropic.com/claude-opus-5-5). 따라서 먼저 현재 모델 목록과 Claude Code Action 문서에서 모델 ID와 지원 여부를 확인한 뒤, 권한이 제한된 GitHub Actions 시험 흐름에 연결하세요. 모델 검토는 테스트나 사람의 병합 승인을 대신하지 않습니다. Xcode 등 Apple 도구가 필요한 작업에만 macOS Runner를 따로 배정하세요.

이 글은 PR 자동 검토와 코드 수정을 설정하는 GitHub Actions 담당자를 위한 안내입니다. 모델 작업과 결정적 CI의 승인 경계를 정하려는 AI 코딩 팀도 대상입니다. iOS·macOS 팀은 어떤 작업에 macOS Runner가 필요한지 확인할 수 있습니다.

*마지막 업데이트: 2026년 9월 25일. 모델 공개 정보는 [공식 모델 목록](https://www.anthropic.com/claude/opus), 작업 설정은 [Claude Code Action 사용 문서](https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md)와 [설정 문서](https://github.com/anthropics/claude-code-action/blob/main/docs/configuration.md), 권한 경계는 [Action 보안 문서](https://github.com/anthropics/claude-code-action/blob/main/docs/security.md)와 [GitHub Actions 보안 안내](https://docs.github.com/en/actions/reference/security/secure-use), 이벤트 처리는 [GitHub의 `pull_request_target` 안전 사용 지침](https://docs.github.com/en/actions/reference/security/securely-using-pull_request_target), 실행 환경은 [호스팅 Runner 문서](https://docs.github.com/en/actions/reference/runners/github-hosted-runners)를 기준으로 확인합니다.*

먼저 작업별 권한 경계를 나누세요

한 워크플로에 검토, 파일 수정, 테스트, 병합 권한을 모두 몰아주지 마세요. 장애가 나면 어떤 단계가 원인이었는지 추적하기 어렵고, 모델이 읽은 외부 입력이 쓰기 권한과 같은 실행 환경에 놓입니다. 토큰 권한은 작업에 필요한 최소 범위로 설정하고, 댓글 작성 권한도 꼭 필요한 경우에만 추가하세요.

**Claude Opus 5.5는 어떻게 설정하나요?** 배포 시점의 Anthropic 모델 목록에서 정확한 모델 ID를 확인한 다음, Action 입력으로 전달하세요. 이름을 추측하거나 과거 예시의 값을 복사하지 마세요. Claude Code Action 설정 문서에서 현재 입력 이름과 형식을 함께 대조해야 합니다.

아래는 권한과 작업 단계를 구분하는 구성 뼈대입니다. Action 버전과 입력 이름은 실제 적용 전에 공식 문서에서 확인하고, 검토를 통과한 커밋으로 고정하세요.

```yaml name: AI review on: pull_request: types: [opened, synchronize, reopened]

permissions: contents: read pull-requests: write

jobs: review: runs-on: ubuntu-latest steps: - name: Review pull request uses: anthropics/claude-code-action@<검토한 커밋> with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: "변경 사항을 검토하고 근거가 있는 문제만 요약하세요." claude_args: "--model ${{ vars.CLAUDE_MODEL_ID }}" ```

이 예시는 구성 방향을 보여주는 뼈대이며, 현재 Action 입력과 일치한다고 보장하지 않습니다. 지원되는 모델, 입력 형식, Action 버전을 확인한 뒤 저장소 규칙에 맞게 수정하세요. 검토 결과는 댓글이나 별도 리포트로 남기고, 성공 상태를 승인으로 취급하지 마세요.

PR 읽기 전용 검토부터 시작하세요

읽기 전용 검토는 변경 내용을 이해하는지, 지적에 파일과 줄 근거가 있는지 확인하는 데 적합합니다. 체크아웃이나 수정 도구가 필요하지 않다면 작업 공간에 쓰기 권한을 주지 마세요. 댓글을 남기려면 `pull-requests: write`가 필요할 수 있지만, 저장소 파일을 바꿀 권한인 `contents: write`와는 분리해야 합니다.

**Claude Code Action으로 Opus 5.5를 실행할 수 있나요?** Action 자체가 있다는 사실만으로 특정 모델 지원이 확인되는 것은 아닙니다. 사용 문서와 설정 문서에서 현재 지원 방식과 모델 전달 입력을 확인하세요. 모델 목록에 표시되는 ID와 Action에서 받아들이는 값이 맞지 않으면 배포를 멈추고, 호환성이 확인될 때까지 기존 검토 절차를 유지하세요.

신뢰된 브랜치의 자동 코딩은 별도 작업으로 분리하세요

파일 수정과 커밋을 허용하면 단순 검토보다 영향 범위가 커집니다. 어떤 경로를 바꿀 수 있는지, 어떤 명령을 실행할 수 있는지, 결과를 누가 확인하는지 작업 설명에 명시하세요. 쓰기 권한은 필요한 저장소와 브랜치에만 제한하고, 사용이 끝난 자격 증명은 폐기하거나 교체할 수 있어야 합니다. Action이 실행된다는 이유만으로 작업 공간이 자동 격리된다고 가정하지 마세요.

다음 조건을 모두 확인하기 전에는 자동 커밋을 켜지 마세요.

- [ ] 모델 ID와 Action 버전이 현재 공식 문서에서 지원되는지 확인합니다. - [ ] 수정 가능한 파일과 실행 가능한 도구를 작업 단위로 제한합니다. - [ ] 트리거 사용자가 신뢰된 대상인지 확인하고, 외부 기여자 입력을 별도 취급합니다. - [ ] 토큰에 부여한 권한이 실제 작업에 필요한 최소 범위인지 검토합니다. - [ ] 변경 사항을 테스트하고 사람이 검토하기 전에는 병합되지 않도록 규칙을 둡니다. - [ ] 실패 시 자격 증명을 철회하고 워크플로를 중단할 담당자를 정합니다.

외부 PR과 댓글을 권한 있는 실행 흐름에서 떼어 놓으세요

PR 제목, 설명, 코드 차이, 댓글은 모두 신뢰할 수 없는 입력으로 다뤄야 합니다. 그 안에 적힌 지시가 에이전트 프롬프트나 실행 명령에 영향을 주지 않는지 시험하세요. 특히 `pull_request_target`은 이벤트의 기본 권한과 코드 체크아웃 방식을 혼동하면 위험해질 수 있습니다. GitHub의 안전한 `pull_request_target` 사용 지침을 검토하고, 외부 PR 코드를 높은 권한으로 실행하지 마세요.

**코드 검토 Agent에는 어떤 권한을 주면 되나요?** 읽기 검토는 대체로 코드 읽기에 필요한 권한부터 시작하고, 댓글을 써야 할 때만 PR 쓰기 권한을 더하세요. 브랜치 변경이나 커밋을 맡기는 작업은 검토용 권한과 분리해야 합니다. GitHub Actions 보안 안내와 Claude Code Action 보안 문서를 확인하고, 외부 입력이 있는 작업에 저장소 쓰기 권한이나 비밀값을 노출하지 마세요.

> 외부 PR이 들어오는 흐름에서는 편의보다 입력 출처와 토큰 범위를 먼저 점검하세요. 권한을 줄일 방법이 없다면 해당 트리거에서 에이전트 실행을 중지하고 사람의 검토로 돌리세요.

일반 CI는 모델 결과와 테스트 결과를 따로 기록하세요

웹·백엔드 저장소의 린트, 단위 테스트, 빌드는 통과와 실패를 판정하는 기준으로 유지하세요. 모델이 제안한 수정과 테스트 결과를 같은 상태 하나로 합치지 말고, 검토 결과와 각 CI 단계의 로그를 따로 남기세요. 모델의 분석이나 워크플로 성공만으로 코드가 옳다고 결론 내릴 수 없습니다. 저장소 규칙과 팀의 승인 절차가 허용하지 않는 한 Agent가 병합을 진행하지 못하게 하세요.

Xcode가 필요할 때만 macOS Runner를 선택하세요

**iOS 작업에 macOS Runner가 필요한 시점은 언제인가요?** Xcode, Apple SDK, 시뮬레이터처럼 macOS 전용 도구를 실제로 실행할 때입니다. 텍스트 기반 검토나 Apple 도구를 호출하지 않는 CI에는 모델을 쓴다는 이유만으로 macOS 환경을 붙일 필요가 없습니다. Runner의 사용 가능 환경은 GitHub 호스팅 Runner 문서에서 확인하세요.

작업을 세 경계로 나누면 권한 혼선을 줄일 수 있습니다. 모델 분석은 코드 검토 권한으로 실행하고, Xcode 빌드와 테스트는 해당 도구가 있는 macOS Runner에서 검증하세요. 서명과 배포는 별도 승인 절차에 두고, 검토나 빌드 성공만으로 인증서 사용과 릴리스를 허용하지 마세요.

Xcode CI 환경이 필요하다면 [Mac 환경 선택 안내](https://macwww.com/ko/gumae.html)에서 구매와 임대의 조건을 비교해 보세요. 여러 실행 환경을 함께 검토할 때는 [Mac 관련 안내](https://macwww.com/ko/dowem.html)도 참고할 수 있습니다.

현재 Linux 기반 CI는 일반 테스트에 적합하지만, Xcode 도구 부재, macOS 전용 재현 환경 확보, 서명 작업 분리라는 제약이 있습니다. 반대로 상시 사용을 위해 Mac을 직접 구매하면 장비 유지와 유휴 시간 관리가 뒤따릅니다. Xcode 빌드를 잠깐 검증하거나 회귀 환경이 필요한 경우에는 MacWww에서 Mac을 임대해 전용 macOS 실행 환경을 마련하는 선택지도 있습니다. 다만 장기간 일정한 부하가 이어지거나 물리 장비와 연결된 주변기기가 필요하다면, 임대보다 상시 보유 환경이 나을 수 있습니다.