サイト内検索

GitHub Actions の月額上限をリポジトリ単位で設定する — AI エージェント時代の予算と多層防御

重岡 正 · Mon, October 5, 2026

Claude Code や GitHub Copilot coding agent、Codex といった AI コーディングエージェントが広まり、プッシュや PR だけでなくエージェントの判断だけでも GitHub Actions のワークフローが走る状況になりました。以前の「開発者がコミットしたときだけ CI が回る」という前提で予算を組んでいると、エージェントのループや並列ジョブによって、月初の数日のうちに想定を超える課金が発生する可能性があります。AI エージェントに CI を触らせる前に、課金側の上限を設定しておくことをおすすめします。

GitHub Actions の月額予算は、Budgets and alerts で、Enterprise 全体・単一 Organization・単一リポジトリ・コストセンターのどれにでも張れます。本記事では、2026 年 11 月時点の UI と REST API の設定手順、Organization 予算と Repository 予算の重なり方、最新単価、そしてハード予算だけでは塞げない落とし穴と多層防御の設計をまとめます。

Budgets and alerts の設定範囲

GitHub Actions の月額上限は Settings → Billing & Licensing → Budgets and alerts で設定します。設定手順は公式ドキュメントの Setting up budgets にまとまっています。

Budget のスコープは次のとおりです。

スコープ設定できる場所設定できる人
Enterprise 全体・コストセンターEnterprise の Billing & LicensingEnterprise owner・billing manager
Organization 全体・Organization 配下のリポジトリOrganization の Billing & LicensingOrganization owner・billing manager
個人アカウント全体・配下のリポジトリ個人の Settings → Billingアカウント本人

1 アカウントあたりの予算数の上限は 10,000 件なので、数百のリポジトリに個別に予算を張る運用も現実的です。作成後にスコープと対象 SKU は変更できず、別のリポジトリに付け替えたい場合は削除して作り直します。

UI で Repository 予算を作る

Organization 配下のリポジトリにハード予算を張る手順は次のようになります。

  1. Organization の Settings を開き、サイドバーの Access セクションにある Billing & Licensing をクリックする(Enterprise の場合は画面上部の Billing & Licensing タブ、個人アカウントの場合は https://github.com/settings/billing)
  2. Budgets and alerts → New budget をクリックする
  3. Budget Type で Product-level budget を選び、Product に Actions を指定する(高単価ランナーやキャッシュ超過枠だけに上限を張りたい場合は SKU-level budget で actions_linux_96_core や actions_cache_storage などの SKU を選ぶ)
  4. Budget scope で Repository を選び、対象リポジトリを 1 つ指定する
  5. Budget に月額の USD 上限を整数で入力する
  6. Stop usage when budget limit is reached にチェックを入れる。ここを入れないと、同じ金額を指定してもアラートだけで追加課金は止まらない
  7. Receive budget threshold alerts を有効にし、Alert Recipients に追加通知先(SRE・プラットフォームチームなど)を指定する
  8. Create budget を押す

同じ Budgets and alerts 画面内にある Included usage alerts で「無料枠が 90% と 100% に達したときに通知する」もオンにしておくと、プラン付属の無料枠(Included compute usage)が尽きる前に気づけます。無料枠は Organization 単位で全リポジトリに共有される点が、Repository 予算と直接関係する落とし穴なので後述します。

REST API で一括管理する

Budget Management API を使うと、予算の作成・取得・更新・削除を API で管理できます。

Organization 配下のエンドポイントは次のとおりです。

POST   /organizations/{org}/settings/billing/budgets
GET    /organizations/{org}/settings/billing/budgets
GET    /organizations/{org}/settings/billing/budgets/{budget_id}
PATCH  /organizations/{org}/settings/billing/budgets/{budget_id}
DELETE /organizations/{org}/settings/billing/budgets/{budget_id}

fine-grained PAT または GitHub App トークンに Organization の Administration: write を付け、認証ユーザーは Organization owner または billing manager である必要があります。次は、ORG/REPO の GitHub Actions 月額上限を 100 USD に設定し、到達時に追加利用を停止する API 呼び出しの例です。

gh api --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  /organizations/ORG/settings/billing/budgets \
  --input - <<'EOF'
{
  "budget_amount": 100,
  "prevent_further_usage": true,
  "budget_scope": "repository",
  "budget_entity_name": "ORG/REPO",
  "budget_type": "ProductPricing",
  "budget_product_sku": "actions",
  "budget_alerting": {
    "will_alert": true,
    "alert_recipients": ["alice", "bob"]
  }
}
EOF
  • budget_amount は USD の整数(セント単位は指定できない)
  • prevent_further_usage: true がハードキャップを意味する。false だと通知のみのソフト予算になる
  • Organization エンドポイントで作成するときの budget_scope は organization・repository・multi_user_customer・user のいずれか
  • Product 全体に張る場合は budget_type: "ProductPricing" と budget_product_sku: "actions" を、特定 SKU 単体に張る場合は SkuPricing と actions_linux などの SKU 名を組み合わせる

PATCH で変更できるのは budget_amount・prevent_further_usage・budget_alerting の 3 つで、スコープや対象 SKU は変えられません。有効な SKU の一覧は Product and SKU names にまとまっています。

Enterprise 予算を API で管理する場合は /enterprises/{enterprise}/settings/billing/budgets を使います。Enterprise エンドポイントは GitHub App のユーザーアクセストークンまたはインストールアクセストークンに Enterprise の Enterprise billing 権限を付けて呼び出し、fine-grained PAT は対応トークンとして挙げられていません。Organization 側と同じ fine-grained PAT で揃えたい場合は、Organization エンドポイントでリポジトリ単位の予算を作る形に統一する運用が現実的です。

公式 Terraform プロバイダーの integrations/terraform-provider-github には Budgets 対応リソースが未実装で、Enterprise Budgets 用リソースの追加が Issue #3561 で提案されています。IaC で管理したい場合は、新規リポジトリ作成時のプロビジョニングパイプラインや日次のバッチから上記 API を gh api 経由で冪等に呼び出すのが現時点では現実解です。

Organization 予算と Repository 予算の重なり方

ハードキャップは、適用される複数予算のうち「最初に残余枠がゼロになったもの」が勝つルールです。公式ドキュメント(Setting up budgets)には次のように書かれています。

Usage of metered products can count toward multiple applicable budgets at the same time, and if any budget with Stop usage … enabled is exhausted, additional usage is blocked.

具体例として、次の構成を考えます。

flowchart TD
    A[Workflow が GitHub-hosted runner を要求] --> B{Enterprise ハード予算に残あり?}
    B -- No --> X[Enterprise 全体で追加課金ブロック]
    B -- Yes --> C{Organization ハード予算に残あり?}
    C -- No --> Y[Organization 全体で追加課金ブロック]
    C -- Yes --> D{Repository ハード予算に残あり?}
    D -- No --> Z[当該リポジトリのみブロック]
    D -- Yes --> E[Runner が実行され、各予算に加算]
  • Organization 全体のハード予算 500 USD と、Repository A のハード予算 100 USD を設定した場合、A が 100 USD に達すれば A だけが止まり、他のリポジトリは走り続けます
  • Organization 側が先に 500 USD に達すれば、A の予算に余裕があっても Organization 配下のすべてのリポジトリが止まります
  • Repository 予算で「Organization 予算の枠を上書きしてさらに消費する」ことはできません。あくまで下位の予算は上位の予算より厳しい側として働きます

各階層の予算は合算されないので、Organization 予算 200 USD の配下でリポジトリ A と B に 50 USD ずつ張っても、Organization の総額が 300 USD になるわけではありません。GitHub 自身も「avoid creating overlapping budgets」を推奨していますが、意図的な多層防御として重ねる場合は次の役割分担が扱いやすいと感じています。

  • 最上位(Enterprise または Organization): 「会社として絶対に超えたくない総額」の最終防衛線
  • 中間(Repository): 高単価・高並列・fork PR を受けるリポジトリの暴走を局所停止するブレーカー
  • 下位(Workflow 側の timeout や concurrency): 1 ジョブ・1 プッシュあたりの消費を抑える抑止力

Repository 予算の合計を Organization 予算より小さく設計しておくと、通常は個別リポジトリが先に止まり、Organization 全体の CI を巻き込まずに済みます。Product 予算と SKU 予算の組み合わせも同じで、Product-level の actions 予算が尽きれば個別 SKU 予算が残っていても GitHub-hosted runner はすべて止まります。

2026 年の最新単価で超過額を見積もる

適切な上限額を決めるには、現在の単価と無料枠を押さえておく必要があります。無料枠は USD 建ての Included compute usage として表示されます。

プラン月間 Included computeArtifact / Packages 共有枠Repository あたり Cache
GitHub Free (Personal)12 USD500 MiB10 GiB
GitHub Pro18 USD1 GiB10 GiB
GitHub Free for organizations12 USD500 MiB10 GiB
GitHub Team18 USD2 GiB10 GiB
GitHub Enterprise Cloud300 USD50 GiB10 GiB

標準 GitHub-hosted ランナーの単価は次のとおりです(Actions runner pricing 参照)。パブリックリポジトリでの標準ランナーと、プライベートリポジトリも含めた self-hosted ランナー自体の GitHub Actions 利用料は無料です。

ランナーUSD / 分1 ジョブ 6 時間ハング20 並列 6 時間ハング
Linux 1 コア(slim)0.0020.7214.40
Linux 2 コア x640.0062.1643.20
Linux 2 コア arm640.0051.8036.00
Windows 2 コア0.0103.6072.00
macOS 3〜4 コア0.06222.32446.40

Larger runner はさらに単価が上がり、パブリックリポジトリでも課金対象になります。

Larger runnerUSD / 分1 ジョブ 6 時間ハング20 並列 6 時間ハング
Linux 32 コア0.08229.52590.40
Linux 64 コア0.16258.321,166.40
Linux 96 コア0.25290.721,814.40
Windows 96 コア0.552198.723,974.40
macOS M2 Pro 5 コア0.10236.72734.40
Linux GPU 4 コア0.05218.72374.40

ストレージは GiB・月の累積課金で、Artifact と GitHub Packages で枠を共有します。

ストレージUSD / GiB・月
Artifacts + Packages 共有0.25
Actions cache(10 GiB 超過分)0.07
Larger-runner カスタムイメージ0.07

ストレージは 1 時間ごとの GB-Hours で積算され、月途中で削除してもそれまでに積算された分の課金は取り消されません。Artifact の使用量データは公式ドキュメント上 6〜12 時間の反映遅延があると明記されています。

なお、プライベートリポジトリの self-hosted ランナーに対する 0.002 USD/分のプラットフォーム課金は延期されており、2026 年 11 月時点で適用日は示されていません(Update to GitHub Actions pricing)。

ハード予算だけでは塞げない 5 つの落とし穴

超過防止の手段としてハード予算は強力ですが、これだけに依存すると想定外の超過や開発停止を招きます。

  1. 作成初月は超過しうる: 新規作成した予算は、作成日より前の課金を集計に含めません。月の途中で慌てて予算を張ったときには、作成前の消費分と作成後の上限分の合計が請求される可能性があります(Budgets and alerts に「you may exceed your budget in the first billing cycle」と明記)。予算は月初または運用開始前に設定します
  2. 無料枠は Organization で共有される: Included compute usage はリポジトリごとに割り当てられず、Organization 単位で全リポジトリが共有します。Repository A が月初の数日で無料枠を使い切ると、健全な Repository B は月初から有料フェーズに入って Repository B の予算を消費し始めます。無料枠 90% / 100% の Included usage alerts を併用して予兆を掴みます
  3. in-flight ジョブの扱いが未定義: 公式ドキュメントには「additional usage is blocked」とあるだけで、予算到達時に既に実行中のジョブが即座に強制終了されるのか、完走まで課金が続くのかは明記されていません。多数の並列ジョブが一斉に起動した直後に予算へ到達した場合、完走分の課金は避けられない可能性があります
  4. Larger runner で 0 USD 予算はジョブが動かない: Larger runners のトラブルシューティングでは、ジョブが実行されない要因として「Spending limit が 0 より大きいこと」と「有効なクレジットカードが登録されていること」が挙げられています。Larger runner を使うリポジトリで 0 USD 予算を張るとジョブが動かなくなるので、1 USD 以上を指定します
  5. 約 1,000 USD のサポート案件ブロック: 2026 年の GitHub Community には、Actions の課金額が約 1,000 USD に達した時点で CI が止まり、予算の範囲内だった、または予算を引き上げても解除されなかったという報告が複数(#199036・#206941・#207969・#209042)あります。公式見解はなく、Support 対応が必要になった事例です。予算だけを原因として疑わず、Support に連絡できる体制を併せて持ちます

多層防御の設計

ハード予算を「最後の安全網」、timeout と concurrency を「暴走の抑止」、Usage API を「早期警報」として組み合わせます。

対策領域設定・運用抑止するリスク
ジョブのタイムアウトjobs.<job_id>.timeout-minutes を想定時間+余裕分(例: 20 分)に設定する。公式ワークフロー構文の既定は 360 分6 時間のハング、特に macOS や Larger runner での長時間空回し
同時実行制御concurrency: { group: "${{ github.workflow }}-${{ github.ref }}", cancel-in-progress: true } を全 CI に設定。デプロイ系は cancel-in-progress: false連続プッシュや PR 更新による古いコミットへの重複ジョブ
Larger runner の権限分離ランナーグループの Repository access を Selected repositories にし、許可するリポジトリを最小化YAML のミスやテスト目的での高単価ランナー誤使用
Artifact 保持期間Settings → Actions → General の Artifact and log retention を 7〜30 日に短縮。actions/upload-artifact の retention-days で個別指定GB-Hours の積み上げによる徐々に増えるストレージ課金
AI エージェントの実行制御GitHub Agentic Workflows の frontmatter で max-ai-credits を設定して 1 回の実行あたりの AI Credits 消費に上限を設け(Cost management)、Organization レベルの Actions policy で起動できるアクターとイベントを制限エージェントのループや承認なしの高価ジョブ起動

早期警報として、Usage Summary API を日次の定期ワークフローから呼び、Repository・SKU 単位で消費を可視化します。Organization 単位のエンドポイントは次のとおりです。

GET /organizations/{org}/settings/billing/usage/summary

呼び出し例は次のようになります。

curl -sL \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  "https://api.github.com/organizations/$ORG/settings/billing/usage/summary?year=2026&month=11&repository=$ORG/$REPO&product=Actions"

レスポンスには SKU ごとの grossAmount・discountAmount・netAmount が返るので、無料枠適用前の定価ベースと適用後の実質コストを別々に可視化できます。サイボウズの運用事例では、Grafana で両者を表示しつつ「今月の累積 × (月末日数 ÷ 現在日数) × 1.5 倍バッファ」で月末着地予測を算出し、予算に達する前に余裕を持って対応できるようにする仕組みが紹介されています。チームミーティングやデイリースタンドアップでこの予測値を見る習慣を付けておくと、AI エージェントの誤設定で突発的に消費が増えた日も気づけます。

推奨構成の例

Team または Enterprise Cloud の Organization を想定した推奨構成は次のとおりです。金額は各社の利用量に合わせて調整してください。

#予算スコープStop usageアラート目的
1Actions(製品)想定月額の 1.5〜2 倍Organizationオンowner・billing manager・SRE全社の最終防衛線
2Actions(製品)想定月額の 1.2〜1.5 倍高コスト・高リスクのリポジトリ(macOS ビルド・E2E・fork PR を受けるもの)オンリポジトリ担当チーム1 リポジトリの暴走を局所停止
3actions_linux_96_core 等の Larger runner SKUOrganizationオンSRE高単価ランナーの個別管理
4Actions(製品)想定月額通常のリポジトリ(任意)オフ(ソフト)リポジトリ担当チームブロックせず異常を早期検知
5actions_cache_storageOrganizationオンSRECache 上限を引き上げている場合のみ

これに加えて、全ワークフローに timeout-minutes と concurrency を設定し、Larger runner はランナーグループで対象リポジトリを限定し、Artifact の保持期間を短くします。新規リポジトリ作成時には Budget API を叩いてデフォルト予算を自動プロビジョンします。

以上、AI コーディングエージェント時代の GitHub Actions 月額上限をリポジトリ単位で堅めに張る設計を整理した、現場からお送りしました。

参考情報