2026年11月13日、GitHub が code scanning の AI Scan for repositories を REST API でオンまたはオフに切り替えられるようにしたと発表しました。GitHub の AI Scan を使うかどうかの設定を、画面で一つずつ変えるのではなくスクリプトや infrastructure as code(構成をコードで書いて管理するやり方)から扱えます。GitHub Copilot などで書いたコードを自分のリポジトリで点検したい人に向けて、設定の流れと対象になる範囲を整理します。
要点
- GitHub Changelog(2026年11月13日)で、AI Scan for repositories を REST API から organization と repository の両方のレベルでオン・オフできるようになったと公開された
- public preview(公開プレビュー)として、既存の AI Scan enablement endpoints に repository_scan という設定が追加された
- 使うのは GET と PATCH の /orgs/{org}/code-scanning/ai-scan と /repos/{owner}/{repo}/code-scanning/ai-scan
- 値は enabled か disabled で、pr_scan と repository_scan は同じリクエストでまとめて更新できる
- オンにしただけではスキャンは始まらず、write 権限のある利用者がその都度実行し、各スキャンは GitHub Code Security AI credits を消費する
何が発表されたか
code scanning は、リポジトリの code scanning alerts(コード点検の警告)を REST API で取得・更新できる仕組みです。今回の変更は、その AI Scan の有効・無効をコードから扱えるようにするものです。
追加された設定とエンドポイント
今回の内容は public preview として提供され、既存の AI Scan enablement endpoints に repository_scan という設定を足すものです。設定先は organization 向けの GET と PATCH /orgs/{org}/code-scanning/ai-scan、repository 向けの GET と PATCH /repos/{owner}/{repo}/code-scanning/ai-scan の二組で、repository_scan に enabled か disabled を指定します。GitHub Docs の例では、組織の設定を読み出すと "repository_scan": "enabled" のような値が応答に含まれます。更新は PATCH で行い、pr_scan と repository_scan は同じリクエストで一緒に変えられます。ただしどちらかの変更が阻まれた場合は 422 エラーが返り、どちらの設定も変わりません。GitHub Docs の curl の例では X-GitHub-Api-Version: 2026-03-10 というバージョンヘッダーを付けています。
GitHub Changelog は、一つの organization やリポジトリを一件ずつ変更する代わりに、スクリプトや infrastructure as code で AI Scan for repositories を展開できると説明しています。
組織とリポジトリの関係
organization が AI Scan for repositories を無効にしていると、その配下のリポジトリは有効にできません。organization が有効にすると、配下のリポジトリは設定を受け継ぎ、個別に外れること(opt out)ができます。この挙動は、pull request 向けの既存の設定である pr_scan と同じ仕組みです。enterprise policy が AI Scan を許可していない場合、有効化のリクエストは 422 エラーを返します。
誰が設定できるか
organization の設定を管理できるのは organization owners と security managers です。個別のリポジトリを対象から外せるのは repository administrators です。GitHub Docs によると、組織の AI Scan 設定のエンドポイントでは、認証したユーザーが組織の owner または security manager である必要があり、OAuth app tokens と personal access tokens (classic) では admin:org・repo・write:org のいずれかのスコープが必要です。fine-grained personal access tokens などでは「Administration」の organization 権限を設定し、読み出しは read、更新は write が求められます。
対象になるリポジトリ
AI Scan for repositories が使えるのは、organizations が所有する public リポジトリと、GitHub Code Security または GitHub Advanced Security がある private または internal リポジトリです。enterprise owners が先に enterprise policy で AI Scan を許可しておく必要があります。GitHub Enterprise Server は対象外です。
オンにしても自動では走らない
設定を有効にすること自体は、スキャンの開始ではありません。 write 権限を持つ利用者がその都度スキャンを実行し、各スキャンは GitHub Code Security AI credits を消費します。1 回ごとに消費がある前提で、どのリポジトリをいつ点検するかを決めるのが現実的です。
個人の仕事や学びにどう使えるか
副業や個人開発でコードを置いている Web エンジニアなら、まず自分のリポジトリが対象の条件に当てはまるかを確かめるのが出発点です。organizations が所有する public リポジトリか、GitHub Code Security または GitHub Advanced Security がある private・internal リポジトリかという条件があるため、手元のリポジトリがどれに当たるかで話が変わります。当てはまる場合は、GET /repos/{owner}/{repo}/code-scanning/ai-scan で今の repository_scan の値を読み、必要なら PATCH で切り替えるという順番になります。
社内ツールを抱える情シスやシステム運用の担当者であれば、複数リポジトリの設定をそろえる作業がスクリプトで書けるのが効きます。GitHub Changelog が挙げているとおり、一件ずつ画面を開く代わりに infrastructure as code として管理でき、設定内容を履歴に残せます。
学び直し中の人には、REST API の読み書きの練習題材としても扱いやすい題材です。GET で現在値を確かめ、PATCH で enabled と disabled を切り替え、422 が返る条件を読むという流れは、API の権限設計とエラー設計を具体的に理解する手がかりになります。
会社・チームで使うときのポイント
organization の設定が配下のリポジトリに波及し、enterprise policy がさらにその上に立つという三段の関係があるため、どの層で誰が決めるかを先に決めておくと混乱が減ります。pr_scan と repository_scan を同じリクエストで変える場合、片方が阻まれると両方とも変わらないので、適用後に GET で値を読み返す運用が安全です。スキャンは自動では走らず、実行ごとに GitHub Code Security AI credits を消費する点も、社内への案内に入れておきたいところです。法人でのAI活用の導入や研修を考えている場合は、株式会社デジライズに相談できます。デジライズは法人向けAIリスキリングサービスで導入社数No.1(東京商工リサーチ・2026年3月末時点)で、累計600社超・5万人以上のAI活用を支援しています。
使う前の注意点
今回の機能は public preview として提供されています。有効化できるのは、organizations が所有する public リポジトリと、GitHub Code Security または GitHub Advanced Security がある private または internal リポジトリで、enterprise policy による許可が前提です。GitHub Enterprise Server は対象外です。enterprise policy が許可していない状態で有効化しようとすると 422 エラーになり、GitHub Docs は 422 の説明として「Validation failed, or the endpoint has been spammed.」と記しています。
権限も確認が必要です。organization の設定は organization owners と security managers、個別リポジトリの除外は repository administrators という分担で、トークン側にも admin:org・repo・write:org のいずれか、または「Administration」の organization 権限が必要です。自分のアカウントや契約で実際にどこまで操作できるか、料金や提供の範囲については、使う前に GitHub の公式ヘルプで最新の条件を確かめてください。
まとめ
AI Scan for repositories の設定が REST API から扱えるようになり、組織とリポジトリの両レベルで repository_scan をコードから切り替えられます。有効化はスキャンの開始ではなく、実行は write 権限のある利用者が都度行い、各スキャンは GitHub Code Security AI credits を消費するという前提を押さえておくと、導入の計画が立てやすくなります。開発や運用でのAI活用を体系的に学ぶなら、デジライズAIスクールのコース一覧に「システム運用・情シス業務のAI実務(職種別|IT・デジタル)」などの講座があります。デジライズAIスクールは個人向けのオンラインAIスクールで、動画は990本以上です。
出典
- Manage AI Scan for repositories using the REST API - GitHub Changelog
- REST API endpoints for code scanning - GitHub Docs
この記事は、各社の公式の発表をもとに AI で下書きし、出典の本文との照合とGoogle 検索による事実確認(ファクトチェック)を通ったものだけを公開しています。
