GitHub AI Scan을 최대 20개 저장소에 한 번에 시작할 수 있게 됐습니다. 선택 목록과 저장소별 완료·경고 검토 결과는 나누어 확인해 주세요. 20개는 이번 일괄 시작의 상한이며, 무료 검사 수나 모든 작업의 동시 완료를 보장하는 숫자가 아닙니다.
GitHub는 2026년 11월 16일 이 변경을 공개 미리보기로 발표했습니다. 17일 공지와 현재 개념·실행 문서를 확인했어요. 이 글은 여러 조직 저장소의 기본 브랜치 검사를 준비하는 담당자를 위한 안내입니다. 실제 저장소의 검사를 시작하거나 크레딧·취약점 발견률을 측정한 사례는 아닙니다.
새로 추가된 것은 여러 저장소의 검사 시작 경로예요
공지에 따르면 조직 수준 설정을 켜는 과정에서 선택한 저장소의 검사를 시작하거나, 조직의 code scanning 경고 페이지에서 여러 저장소를 선택해 시작할 수 있습니다. 한 저장소의 경고 페이지에서 개별 검사를 시작하는 경로도 남아 있어요. 새 기능의 핵심은 시작할 대상을 한 번에 고를 수 있다는 점입니다.
AI Scan은 저장소의 기본 브랜치를 검사합니다. 기본 브랜치는 그 저장소가 기본으로 지정한 코드 흐름이며, 모든 저장소에서 이름이 같다고 가정하면 안 돼요. 당장 검토하고 싶은 수정 사항이 다른 브랜치에 있다면 이번 검사가 그 코드를 대상으로 했다는 근거부터 확인해야 합니다.
CodeQL과는 독립적으로 실행되고, CodeQL이 지원하지 않는 언어의 범위를 넓히거나 이미 분석하는 언어에서 추가 문제를 찾는 용도로 설명됩니다. 그렇다고 저장소 전체의 모든 파일을 빠짐없이 읽는다는 뜻은 아니에요. 현재 문서는 에이전트가 시간 예산 안에서 살펴볼 코드와 함수를 선택한다고 명시합니다.
이번 일괄 시작도 공개 미리보기여서 조건이 바뀔 수 있습니다. 공지의 제공 범위는 github.com과 데이터 레지던시가 있는 GitHub Enterprise Cloud입니다. 이 글은 다른 서버 배포 방식이나 모든 조직에서 같은 화면을 사용할 수 있다고 확인하지 않았습니다.
따라서 먼저 적을 것은 대상 제품과 조직, 기본 브랜치, 확인한 날짜예요. 기능이 표시되는지와 실제로 어떤 저장소를 시작했는지도 다음 단계에서 구분해 두면 됩니다. 아래 순서는 도입 준비를 위한 읽기 안내이며 실제 계정 화면을 조작한 기록은 아닙니다.
허용 설정과 실행할 저장소 목록을 따로 만들어요
AI Scan 사용을 허용하는 설정과 지금 한 번 검사를 시작하는 행동은 다릅니다. 현재 문서는 조직에서 기능을 켠 뒤 최대 20개 저장소의 일회성 검사를 시작할 수 있다고 설명해요. 설정을 켰다는 사실만으로 모든 저장소의 검사가 자동 완료됐다고 적을 수는 없습니다.
조직 소유 공개 저장소는 active-committer 라이선스 없이 사용할 수 있고, 비공개·내부 저장소는 GitHub Code Security 또는 GitHub Advanced Security가 필요한 조건이 있습니다. 실제 저장소의 소유 형태와 공개 범위를 확인해야 해요. 개인 계정 저장소의 별도 제공 조건을 조직 일괄 작업의 권한으로 바꿔 읽지 않는 편이 좋습니다.
기업 정책도 영향을 줍니다. Enterprise 소유자는 조직이 AI Scan을 켜도록 허용하거나 막을 수 있으며, 현재 문서는 이 정책이 기본적으로 Not allowed라고 설명합니다. 기업에서 허용했다는 사실과 조직에서 기능을 실제 활성화했다는 확인도 별개예요. 막힌 정책을 우회하거나 권한을 늘리는 절차는 이 글에 없습니다.
조직 설정은 조직 소유자와 보안 관리자가 다루고, 개별 저장소의 수동 검사는 쓰기 권한이 있는 사용자가 시작한다고 문서가 안내합니다. 일괄 화면에서 가능한 행동은 실제 계정 권한과 제공 UI를 확인해 주세요. 특정 권한 하나만 있으면 조직의 모든 관리 행동이 가능하다고 일반화하지 않겠습니다.
가상의 도입 메모에는 먼저 검사할 저장소 이름, 소유 조직, 공개 범위, 기본 브랜치, 기능 사용 가능 여부와 담당자를 적을 수 있습니다. 최대치를 채우려고 한 번에 20개를 모두 고를 필요는 없어요. 결과를 확인할 책임자가 있는 범위에서 대상을 정하는 것은 이 글의 운영 제안입니다.
Copilot 라이선스 불필요와 비용 없음을 구분하세요
발표는 GitHub Copilot 라이선스가 필요하지 않다고 설명합니다. 하지만 현재 개념 문서는 각 검사가 Code Security AI 크레딧을 소비하며, 이 사용량은 active-committer 라이선스와 별도라고 안내해요. 시작 자격과 과금 단위를 같은 질문으로 보면 비용을 놓칠 수 있습니다.
조직 작업에서는 조직의 청구를 책임지는 계정이 사용량 청구 대상입니다. 그 계정이 Copilot 자격을 통해 포함된 AI 크레딧을 받는 경우에는 먼저 그 크레딧을 사용하고, 없거나 소진되면 적용되는 예산에 따라 사용량이 계측됩니다. 이 글은 독자의 잔여량이나 실제 청구 계정을 조회하지 않았습니다.
문서는 하드 예산 때문에 Code Security AI 크레딧을 사용할 수 없으면 결과를 만들 수 없다고 설명합니다. 관리자가 제한 예산을 높이거나 새 청구 주기가 시작되면 검사가 다시 가능해지는 조건도 있어요. 다만 예산 변경은 담당자의 승인과 비용 판단이 필요한 일이며 이 글이 자동 증액을 권하는 것은 아닙니다.
현재 문서에는 탐지 단계의 30분·150,000 AI 크레딧 제한도 나옵니다. 이를 모든 검사 작업의 벽시계 시간 보장이나 실제 청구액, 일괄 실행 20개 전체에 적용되는 하나의 총액으로 바꾸어 계산하지 말아 주세요. 단위와 적용 단계를 그대로 읽어야 합니다.
실행을 준비할 때는 대상 수와 함께 청구 주체, 포함 크레딧의 실제 확인 여부, 예산의 제한 조건과 중단 시 담당자를 기록할 수 있어요. ‘공개 저장소 사용 가능’이나 ‘Copilot 불필요’라는 한 문장으로 무료 완료를 약속하지 않는 것이 목적입니다. 가격 비교나 절감률을 측정한 글은 아닙니다.
선택·시작·완료는 저장소별로 확인해요
이번 공지의 최대 20개는 한 번에 시작할 저장소 선택 범위입니다. 이 숫자가 계정 전체의 동시 실행 한도나 매일 무료 할당량이라는 설명은 없습니다. 20개를 골랐더라도 각 저장소에서 무엇을 관찰했는지 따로 남기는 것이 좋아요.
가령 승인된 여섯 저장소를 먼저 점검하는 가상 상황을 생각해 보세요. 목록에는 여섯 이름이 있지만, 실제 시작 확인과 완료 확인이 어디까지 이뤄졌는지는 다른 정보입니다. 한 저장소의 결과만 보고 나머지 다섯 개에도 같은 상태를 복사하면 미확인이 성공으로 바뀔 수 있어요.
| 확인할 단계 | 메모할 근거 |
| 선택 | 대상 저장소·기본 브랜치·담당자 |
| 시작 | 실제로 시작한 작업과 관찰 시각 |
| 완료·검토 | 저장소별 완료와 경고 검토 범위 |
이 표는 제품이 제공하는 상태 이름을 새로 정의한 것이 아니라 담당자가 기록할 질문을 나눈 예시입니다. 실제 UI나 로그가 보여 준 값을 그대로 남겨 주세요. 시작 응답이 불명확한데도 같은 작업을 바로 반복 제출하기보다 이미 시작한 작업과 대상부터 조회해 대조하는 편이 좋습니다.
일괄 시작에서 일부 대상이 처리되지 않을 때 전체가 어떤 방식으로 취소되거나 재시도되는지는 이번에 읽은 발표만으로 단정하지 않습니다. 설정 REST API의 실패 규칙을 일괄 실행 작업 전체의 원자성으로 가져오지도 않겠습니다. 실제 작업 응답과 현재 UI에서 확인한 결과를 기준으로 판단할 문제예요.
개별 저장소에서는 Security and quality의 Code scanning에서 AI Scan을 시작하고 완료를 기다리는 흐름이 안내돼 있습니다. 조직 화면의 새 일괄 기능을 이 개별 경로의 버튼 설명만으로 대신하지는 마세요. 적용 시점의 실제 조직 화면과 승인된 목록을 대조하고, 확인하지 못한 대상은 미완료 또는 미확인으로 남겨야 합니다.
경고가 보이는 순간부터 사람의 검토가 이어져요
검사가 끝나면 결과는 기존 code scanning 경고 목록에 CodeQL 경고와 함께 표시됩니다. AI Scan 도구로 필터링해 해당 결과를 보고, 기존 심각도 필터와 경고 평가 절차를 사용할 수 있어요. 결과가 한 목록에 모인다는 사실과 서로 같은 검사라는 뜻은 구분해야 합니다.
기존 CodeQL 경고와 일치하는 결과를 줄이는 처리가 있지만 중복 억제는 최선의 노력 방식이며 중복 경고가 생길 수 있다고 문서가 설명합니다. AI Scan이 CodeQL을 완전히 대체한다거나 이미 있던 경고와 전혀 겹치지 않는다고 보장하지 않는 이유예요.
AI가 만든 경고는 부정확할 수 있으므로 각각 검토해야 합니다. 저장소 담당자가 관련 코드와 영향을 확인한 뒤 우선순위와 대응을 정하는 절차가 남습니다. 실제 취약점인지 확인하지 않은 제안을 해결 완료로 적거나, 경고가 없다는 사실을 저장소 전체의 안전 인증으로 표현하면 안 됩니다.
수정 후의 확인도 별도입니다. 현재 공개 미리보기에서는 잠재적 수정을 기본 브랜치에 병합해도 새 AI Scan이 자동으로 시작되지 않습니다. 다시 수동으로 검사를 시작해 해결 여부를 확인해야 해요. 병합 상태와 재검사 상태를 나누어 기록할 부분입니다.
경고 자동 종료에도 조건이 있습니다. 새 검사 뒤에 수정이 경고를 유발한 정확한 코드 줄을 바꾼 경우에만 자동으로 닫히고, 그렇지 않으면 수동 종료가 필요할 수 있다고 실행 문서가 설명합니다. 실제 수정 내용을 검토하기 전에 경고를 없애기 위한 임의 종료를 권하는 안내는 아닙니다.
일괄 작업의 결과 보고에는 미확인을 남겨 두세요
마지막 보고에는 선택한 저장소 수뿐 아니라 실제 시작·완료·경고 검토·수정 후 재검사를 어디까지 확인했는지 적을 수 있습니다. 각 단계의 실제 저장소와 담당자, 관찰 시각을 연결해 주세요. 숫자를 보기 좋게 맞추는 것보다 남은 확인을 정확히 전달하는 것이 중요합니다.
현재 문서는 기본 브랜치만 분석하고, self-hosted runner를 지원하지 않으며, 예약 검사와 push 시 자동 검사를 지원하지 않는다고 명시합니다. 새 일괄 시작을 설정했다는 이유로 지속적인 자동 검사가 생겼다고 보고하지 마세요. 실행 방식의 한계는 작업 계획에도 남겨야 합니다.
지원 언어 범위가 넓다는 설명도 모든 파일과 모든 취약점의 검사를 보장하지 않습니다. 에이전트가 살펴볼 코드를 고르는 시간 예산이 있고, 결과에는 사람의 판단이 필요해요. 검사 성공이라는 한 칸 대신 어떤 코드 기준과 검토 범위를 확인했는지를 설명하는 이유입니다.
자주 묻는 질문도 정리해 볼게요. 20개를 골랐다면 모두 끝난 건가요? 실제 완료는 각각 확인해야 합니다. Copilot 라이선스가 없으면 무료인가요? 라이선스 조건과 AI 크레딧 사용은 다릅니다. 수정을 병합하면 재검사도 되나요? 현재 문서는 수동 재검사를 안내합니다.
일괄 시작은 반복되는 시작 작업을 묶을 선택지를 제공합니다. 그 편리함을 활용하면서도 저장소별 책임과 증거를 남겨 보세요. 허용 설정, 실행, 결과 검토, 수정 검증을 구분한 기록이 있어야 다음 담당자도 어느 부분을 믿고 무엇을 이어서 확인할지 판단할 수 있습니다.
자료 확인일은 2026년 11월 17일입니다. 공식 발표와 현재 문서로 확인한 범위이며, 실제 계정 설정 변경·명령 실행·성능 시험은 하지 않았어요. 적용 시점의 계정·버전·환경과 승인 범위는 담당자가 다시 확인해 주세요.
함께 읽어 볼 글: Actions 로그의 시크릿 탐지와 보안 경고를 구분해 읽는 글.

'소프트웨어개발' 카테고리의 다른 글
| Cloudflare 비콘 트래픽 탐지 추가: 악성 판정 전에 확인할 조건 (0) | 2026.11.18 |
|---|---|
| Artifacts 로컬 개발이 열렸어요: remote 설정과 저장소를 먼저 구분하세요 (0) | 2026.11.18 |
| RealtimeKit 참가 토큰 시간 설정: 갱신과 회수를 나눠 보세요 (0) | 2026.11.17 |