보안 소식 · 2026년 10월 20일 · 공식 발표 해설
GitHub AI Scan 정식 출시: PR 취약점 탐지·병합 차단 제한·AI Credits 정리
GitHub의 PR 보안 분석이 확장됐지만, 저장소 전체 검사나 자동 병합 차단 기능은 아닙니다.
GitHub AI Scan GA, CodeQL을 대체하지 않는 이유
GitHub는 2026년 10월 15일 GitHub AI Scan for pull requests의 정식 출시를 발표했다. GitHub AI Scan GA는 PR에 새로 들어오는 코드 변경에서 보안 취약점 신호를 찾아 개발자에게 보여주는 기능이다. 이 기능은 기존 CodeQL 전체를 대체하는 분석기가 아니라, CodeQL이 현재 지원하지 않는 언어와 프레임워크의 보안 분석 공백을 보완한다.
예를 들어 PHP, Shell/Bash, Terraform HCL, Dockerfile, JSP/Java, Blazor/C# 등이 공식 문서의 예시다. 다만 GitHub AI Scan 지원 언어 목록은 향후 업데이트될 수 있으므로 특정 저장소의 모든 파일 형식이 검사된다고 가정하면 안 된다. AI Scan은 저장소 전체를 정기 검사하는 기능도 아니다.
GitHub CodeQL AI Scan 차이를 이해하려면 검사 단위부터 나누는 편이 좋다. CodeQL은 정적 분석을 통해 코드 스캐닝 경고를 제공하고, AI Scan은 적격 PR의 변경 사항에 추가적인 AI 기반 경고를 제공한다. 서로 보완하는 도구이므로 한쪽을 활성화했다고 전체 위험이 사라지는 것은 아니다.
어떤 PR이 검사되고 어떤 PR이 제외되나
적격한 PR에 대한 스캔은 코드 스캐닝이 활성화되어 있고 저장소에 적용되는 AI Scan 설정도 켜진 경우 자동 실행된다. 그러나 AI Scan fork PR과 AI Scan Dependabot PR은 검사 대상이 아니다. GitHub 문서는 포크에서 온 PR, Dependabot이 만든 PR을 명시적으로 제외한다.
따라서 외부 기여자나 자동 의존성 업데이트가 많은 저장소에서는 AI Scan 결과가 없다는 이유만으로 안전을 판단하지 말아야 한다. 이 경우 기존 CodeQL, 의존성 점검, 리뷰 절차를 계속 유지해야 한다. GitHub PR 취약점 탐지는 다양한 검사 조합으로 운영하는 것이 합리적이다.
2026년 9월 변경 공지에 따르면 AI Scan은 CodeQL 기본 설정에 종속되지 않는다. 하지만 코드 스캐닝과 AI Scan 활성화라는 별도 요건은 여전히 중요하다.
탐지 결과는 권고성, 병합 차단은 지원하지 않는다
가장 주의할 부분은 AI Scan 병합 차단이다. GitHub 공식 설명에 따르면 AI Scan 결과는 권고성(advisory)이다. 코드 스캐닝 체크를 실패시키지 않고 ruleset의 필수 조건으로 PR 병합을 차단하는 데 사용할 수 없다. 이를 CodeQL의 별도 병합 차단 설정과 혼동하면 보안 운영 정책에 빈틈이 생긴다.
결과는 PR의 Conversation 및 Files changed 영역에서 CodeQL 결과와 함께 보이며 AI 표시로 구별된다. 발견 내용에는 위험 설명이나 수정 제안이 포함될 수 있지만, 제안이 실제 위험을 완벽하게 재현하거나 패치 정합성을 보장하지는 않는다.
AI Scan 오탐이 발생할 수 있으므로 사람의 리뷰를 거쳐 진단 근거, 악용 가능성, 실제 수정 필요성을 평가해야 한다. 모든 경고를 취약점 확정으로 발표하거나 탐지율을 100%라고 표시해서는 안 된다.
공개·비공개 저장소의 라이선스와 AI Credits
GitHub Advanced Security AI Scan의 접근 조건은 저장소 소유자와 공개 범위에 따라 다르다. 개인 또는 조직 소유 공개 저장소에서 사용할 수 있지만, 조직 소유 비공개·내부 저장소는 GitHub Code Security나 GitHub Advanced Security가 필요하다. 개인 계정 소유 비공개 저장소에는 제공되지 않는다는 공식 문서 예외도 확인해야 한다.
AI Scan 자체에 GitHub Copilot 라이선스가 반드시 필요한 것은 아니다. 하지만 분석 사용량은 GitHub Code Security AI Credits 체계에 기록된다. 사용량은 계정의 포함 크레딧과 설정한 예산, 실제 스캔량에 영향을 받으므로 '무제한 무료'라고 해석할 수 없다.
| 점검 항목 | 확인할 내용 |
|---|---|
| 저장소 소유 | 개인·조직 계정 및 공개 여부 |
| 사용 권한 | Code Security·Advanced Security 필요 여부 |
| 비용 | AI Credits 예산과 계정별 청구 주체 |
| 활성화 정책 | Enterprise·Organization·Repository 설정 |
구체적인 크레딧 단가·무료 잔여량은 계정별 설정과 현재 청구 정책을 확인해야 하며 이 글에서는 임의 수치를 제시하지 않는다.
활성화 방법과 운영 지표·Agentic autofix 구분
AI Scan 활성화 방법을 검토할 때는 먼저 조직 차원의 정책이 허용되는지, 저장소가 적격한지, 코드 스캐닝이 켜져 있는지 확인한다. 조직에서 정책을 켜면 해당 조건에 맞는 저장소에 영향을 줄 수 있으므로 활성화 전에 예상 PR 유입량과 AI Credits 예산을 검토해야 한다. 개인 소유 공개 저장소는 저장소 설정에서 활성화할 수 있다.
- 저장소의 공개 범위와 기능 이용 자격을 확인한다.
- Enterprise와 Organization에서 AI Scan 허용·활성화 정책을 확인한다.
- 코드 스캐닝 및 유효한 저장소 AI Scan 설정을 검증한다.
- 적격 PR에서 AI 표시 경고를 확인하고 오탐을 검토한다.
- AI Credits 사용량과 예산 제한을 정기적으로 확인한다.
- 기존 리뷰·CodeQL·의존성 검사·승인 정책은 별도로 유지한다.
2026년 10월 13일 공개된 AI Scan 지표는 조직별 발생·해결 추이를 보여주는 관리 기능이며, 해당 발표 시점에는 공개 미리보기였다. GitHub Enterprise Server에서 지원되지 않았다는 범위도 구분해야 한다. 또한 Agentic autofix GA는 기본 브랜치 코드 스캐닝 경고에 대한 수정 자동화를 가리키며 PR 자체를 검사하는 AI Scan과 다른 기능이다.
자주 묻는 질문
AI Scan을 사용하면 CodeQL을 꺼도 되나요?
권장하지 않습니다. 두 기능은 탐지 대상이 다르며 AI Scan은 기존 코드 보안 절차를 보완합니다.
AI Scan 결과로 PR을 병합하지 못하게 할 수 있나요?
아니요. 현재 AI Scan 결과는 권고성이며 GitHub ruleset의 병합 차단 조건으로 사용되지 않습니다.
Dependabot PR도 AI Scan이 검사하나요?
아니요. Dependabot이 만든 PR과 포크에서 온 PR은 제외됩니다.
GitHub Copilot 구독이 필수인가요?
AI Scan 기능 이용 자체를 위해 Copilot 구독이 반드시 필요한 것은 아닙니다.
AI Scan은 무료인가요?
Code Security AI Credits 사용량이 발생하며 계정별 포함 크레딧·예산·정책을 확인해야 합니다.
AI Scan 경고는 반드시 실제 취약점인가요?
아닙니다. AI Scan은 오탐 가능성이 있으므로 검토와 재현이 필요합니다.
