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 & Licensing | Enterprise owner・billing manager |
| Organization 全体・Organization 配下のリポジトリ | Organization の Billing & Licensing | Organization owner・billing manager |
| 個人アカウント全体・配下のリポジトリ | 個人の Settings → Billing | アカウント本人 |
1 アカウントあたりの予算数の上限は 10,000 件なので、数百のリポジトリに個別に予算を張る運用も現実的です。作成後にスコープと対象 SKU は変更できず、別のリポジトリに付け替えたい場合は削除して作り直します。
UI で Repository 予算を作る
Organization 配下のリポジトリにハード予算を張る手順は次のようになります。
- Organization の
Settingsを開き、サイドバーの Access セクションにあるBilling & Licensingをクリックする(Enterprise の場合は画面上部の Billing & Licensing タブ、個人アカウントの場合は https://github.com/settings/billing) Budgets and alerts→New budgetをクリックするBudget TypeでProduct-level budgetを選び、Product にActionsを指定する(高単価ランナーやキャッシュ超過枠だけに上限を張りたい場合はSKU-level budgetでactions_linux_96_coreやactions_cache_storageなどの SKU を選ぶ)Budget scopeでRepositoryを選び、対象リポジトリを 1 つ指定するBudgetに月額の USD 上限を整数で入力するStop usage when budget limit is reachedにチェックを入れる。ここを入れないと、同じ金額を指定してもアラートだけで追加課金は止まらないReceive budget threshold alertsを有効にし、Alert Recipientsに追加通知先(SRE・プラットフォームチームなど)を指定する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"]
}
}
EOFbudget_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 compute | Artifact / Packages 共有枠 | Repository あたり Cache |
|---|---|---|---|
| GitHub Free (Personal) | 12 USD | 500 MiB | 10 GiB |
| GitHub Pro | 18 USD | 1 GiB | 10 GiB |
| GitHub Free for organizations | 12 USD | 500 MiB | 10 GiB |
| GitHub Team | 18 USD | 2 GiB | 10 GiB |
| GitHub Enterprise Cloud | 300 USD | 50 GiB | 10 GiB |
標準 GitHub-hosted ランナーの単価は次のとおりです(Actions runner pricing 参照)。パブリックリポジトリでの標準ランナーと、プライベートリポジトリも含めた self-hosted ランナー自体の GitHub Actions 利用料は無料です。
| ランナー | USD / 分 | 1 ジョブ 6 時間ハング | 20 並列 6 時間ハング |
|---|---|---|---|
| Linux 1 コア(slim) | 0.002 | 0.72 | 14.40 |
| Linux 2 コア x64 | 0.006 | 2.16 | 43.20 |
| Linux 2 コア arm64 | 0.005 | 1.80 | 36.00 |
| Windows 2 コア | 0.010 | 3.60 | 72.00 |
| macOS 3〜4 コア | 0.062 | 22.32 | 446.40 |
Larger runner はさらに単価が上がり、パブリックリポジトリでも課金対象になります。
| Larger runner | USD / 分 | 1 ジョブ 6 時間ハング | 20 並列 6 時間ハング |
|---|---|---|---|
| Linux 32 コア | 0.082 | 29.52 | 590.40 |
| Linux 64 コア | 0.162 | 58.32 | 1,166.40 |
| Linux 96 コア | 0.252 | 90.72 | 1,814.40 |
| Windows 96 コア | 0.552 | 198.72 | 3,974.40 |
| macOS M2 Pro 5 コア | 0.102 | 36.72 | 734.40 |
| Linux GPU 4 コア | 0.052 | 18.72 | 374.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 つの落とし穴
超過防止の手段としてハード予算は強力ですが、これだけに依存すると想定外の超過や開発停止を招きます。
- 作成初月は超過しうる: 新規作成した予算は、作成日より前の課金を集計に含めません。月の途中で慌てて予算を張ったときには、作成前の消費分と作成後の上限分の合計が請求される可能性があります(Budgets and alerts に「you may exceed your budget in the first billing cycle」と明記)。予算は月初または運用開始前に設定します
- 無料枠は Organization で共有される: Included compute usage はリポジトリごとに割り当てられず、Organization 単位で全リポジトリが共有します。Repository A が月初の数日で無料枠を使い切ると、健全な Repository B は月初から有料フェーズに入って Repository B の予算を消費し始めます。無料枠 90% / 100% の Included usage alerts を併用して予兆を掴みます
- in-flight ジョブの扱いが未定義: 公式ドキュメントには「additional usage is blocked」とあるだけで、予算到達時に既に実行中のジョブが即座に強制終了されるのか、完走まで課金が続くのかは明記されていません。多数の並列ジョブが一斉に起動した直後に予算へ到達した場合、完走分の課金は避けられない可能性があります
- Larger runner で 0 USD 予算はジョブが動かない: Larger runners のトラブルシューティングでは、ジョブが実行されない要因として「Spending limit が 0 より大きいこと」と「有効なクレジットカードが登録されていること」が挙げられています。Larger runner を使うリポジトリで 0 USD 予算を張るとジョブが動かなくなるので、1 USD 以上を指定します
- 約 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 | アラート | 目的 |
|---|---|---|---|---|---|
| 1 | Actions(製品)想定月額の 1.5〜2 倍 | Organization | オン | owner・billing manager・SRE | 全社の最終防衛線 |
| 2 | Actions(製品)想定月額の 1.2〜1.5 倍 | 高コスト・高リスクのリポジトリ(macOS ビルド・E2E・fork PR を受けるもの) | オン | リポジトリ担当チーム | 1 リポジトリの暴走を局所停止 |
| 3 | actions_linux_96_core 等の Larger runner SKU | Organization | オン | SRE | 高単価ランナーの個別管理 |
| 4 | Actions(製品)想定月額 | 通常のリポジトリ(任意) | オフ(ソフト) | リポジトリ担当チーム | ブロックせず異常を早期検知 |
| 5 | actions_cache_storage | Organization | オン | SRE | Cache 上限を引き上げている場合のみ |
これに加えて、全ワークフローに timeout-minutes と concurrency を設定し、Larger runner はランナーグループで対象リポジトリを限定し、Artifact の保持期間を短くします。新規リポジトリ作成時には Budget API を叩いてデフォルト予算を自動プロビジョンします。
以上、AI コーディングエージェント時代の GitHub Actions 月額上限をリポジトリ単位で堅めに張る設計を整理した、現場からお送りしました。