Googleの次世代コーディング環境「Antigravity 2.0」を活用していると、避けて通れないのが利用枠（クオータ制限）の管理です。
自律的にコードを調査・修正してくれるエージェント機能は非常に強力ですが、利用量を意識せずに使い続けると、クオータ制限に達して作業を継続できなくなる場合があります。
[!NOTE]
この記事で分かること
- Antigravity 2.0のクオータ制限の仕組み（プラン別の更新周期）
- 週間上限や5時間単位のクオータ残量の確認方法（GUI /
/usage//quota）- クオータ超過時の挙動と「AIクレジット」によるオーバーエイジ利用
- なぜエージェント型AIでは利用量が膨らみやすいのか？
GEMINI.mdを活用した036Factory独自のエージェントリソース管理術
この記事では、2026年8月現在の最新公式仕様に基づいたクオータの仕組みと確認方法を整理した上で、036Factoryの現場で実際に導入している**「GEMINI.mdを活用したエージェントのリソース管理術」**を詳しく解説します。
1. Antigravity 2.0におけるクオータ制限の基本仕様
まずは、Google公式に定められている利用制限の仕組みを正確に把握しておきましょう。
プランによって異なる更新周期と上限
Antigravity 2.0には、主に「5時間単位で更新されるクオータ」と「週間上限」があり、適用される更新周期や上限は契約プランによって異なります。
- Ultraプラン: クオータは5時間ごとに更新される設計。
- Proプラン: 5時間ごとに更新されるクオータに加え、週間上限も設定されている。
- Free / AI Plusプラン: 週間ベースのクオータが中心。
クオータ消費は「エージェントの仕事量」と「推論モデル」で決まる
Google公式ドキュメントにおいて、Antigravityのレート制限は単純なプロンプト（チャット送信）の回数ではなく、**「エージェントが実際に行う仕事量（amount of work done by the agent）」**に応じて変動すると説明されています。
同じ1回の指示であっても、タスクが単純であればより多く利用でき、複雑なタスクでは利用可能量が少なくなる場合があります。また、選択する推論モデルによってもレート制限が異なります。
クオータ残量の確認方法
現在の利用状況や残量は、GUIおよびCLIから手軽に確認できます。
- GUI（設定画面）での確認:
- 画面左下の歯車アイコン（Settings） →
Modelsを開く。 - 利用可能なモデル一覧とともに、クオータの使用状況バーが表示されます。
- 画面左下の歯車アイコン（Settings） →
- CLI（コマンドライン）での確認:
- チャットまたはターミナル上で
/usageまたは/quotaコマンドを実行することで、現在の残量やモデルごとの利用状況を確認できます。
- チャットまたはターミナル上で
AIクレジットによるオーバーエイジ利用（Google AI Pro / Ultra）
Google AI ProまたはUltraプランを利用している場合、ベースラインのクオータを超過した際、事前購入した「AIクレジット」を使って作業を継続できます。
設定画面の AI Credit Overages で「Never（追加消費しない）」または「Always（自動継続）」を選択することが可能です。
2. なぜエージェント型AIでは利用量が膨らみやすいのか？
通常の対話型AIと異なり、自律エージェント型のAntigravityでは、なぜ利用枠の消費ペースが速くなりやすいのでしょうか。実際の開発現場から考えられる主な要因は以下の通りです。
- 大規模なコードベースや長いログの読み込み:
プロジェクト全体のファイル構造や詳細なエラーログを精査するタスクでは、単純なテキスト生成よりも多くの処理が必要になります。 - サブエージェントによる並行探索:
サブエージェントを利用すると、親エージェントとは別の実行が発生するため、タスク全体の仕事量が増加する可能性があります。 - エラー時の試行錯誤（デバッグループ）:
テストやビルドが通るまでエージェントが自律的に修正を繰り返すことで、1回の指示の裏で多数の実行ステップが発生します。
これらはエージェントが自律的に問題を解決しようとする優れた機能ですが、指示の出し方や設計を工夫しないと、意図せず仕事量が肥大化する原因になります。
3. 【実践】GEMINI.mdを活用したエージェントのリソース管理術
クオータ対策は「モデルを軽くする」だけではない
クオータ対策というと「より軽量なモデルを選ぶ」ことに目が向きがちです。しかし、036Factoryではモデル選択だけを対策の中心にはしていません。
本当に重要なのは、エージェントが必要以上に調査・編集・検証を繰り返さないよう、あらかじめ仕事の境界（スコープ）を決めておくことです。
そのために利用しているのが、Antigravityのカスタムルールファイル GEMINI.md（または .agents/rules）です。
036Factoryが設定している3つの運用方針
036Factoryでは、プロジェクトルートやグローバル設定（~/.gemini/GEMINI.md）にルールを記述し、エージェントの行動指針をコントロールしています。
- 「司令塔」と「実作業」の役割分担:
メインチャットは要件定義や方針決定の「司令塔」とし、バックグラウンドでのファイル差分編集や定型処理は、タスクの難易度に応じて適切なモデルを優先するようルール化する。 - サブエージェントの利用方針:
ユーザーから明示的なマルチエージェント指示がない限り、不要なサブエージェントの乱立を避け、単一エージェントの直線的なステップで処理を完結させる。 - デバッグの局所化:
エラーが発生した際、すぐに別の高性能モデルへ処理を移して深い思考を繰り返すのではなく、まず現在の実行境界内で問題を整理するようルール化する。
実際に設定している GEMINI.md の記述例
# Antigravity Agent Resource Control Rules
## [CRITICAL CONSTRAINT: MODEL & RESOURCE ENFORCEMENT]
- **Primary Execution Engine:** バックグラウンドでのファイル差分編集や定型作業ループは、タスクの難易度に応じた適切なモデル（Flash系モデル等）を優先して実行すること。
- **Subagent Policy:** ユーザーから明示的なマルチエージェント指示がない限り、不要なサブエージェントの乱立を避け、単一エージェントの直線的なステップで処理を完結させること。
- **Resource Conservation Mode:** 思考プロセスや多段階の推論オーバーヘッドを最小限に抑え、1ステップあたりの処理効率を高めること。
## [WORKFLOW DIRECTIVES]
1. **Planning & Execution:** 実装計画の作成およびコード修正は、指定されたモデル境界の範囲内で効率的に実行する。
2. **Error Recovery:** エラーが発生した場合、無秩序な再試行ループに陥る前に現状の課題を整理し、必要に応じて人間に判断を仰ぐこと。4. 実運用から得られた知見と向き・不向き
私自身、このリソース管理ルールを日々の開発・執筆環境に投入して運用を続けています。
厳密な削減率は出せないが「タスクの暴走」は防げる
開発タスクの内容やコードの規模は毎回異なるため、クオータ消費量そのものを厳密に比較できる環境ではありません。そのため、「〇％削減できた」というような具体的な削減率は提示しません。
一方で、「エージェントが勝手に裏で重い処理を繰り返して仕事量を膨らませる」という予期せぬタスクの暴走や不要な再実行を抑える目的においては、非常に有効に機能しています。
運用の向き・不向き
- 向いているタスク:
- 明確な仕様が決まっているコンポーネント作成やリファクタリング
- ブログ記事の校正、データ変換スクリプトの作成
- フォルダ構造や設定ファイルの定期メンテナンス
- 向いていないタスク:
- ゼロベースからの複雑なアーキテクチャ設計
- 抽象的な要件から高度な推論を丸投げしたい大規模開発
設計段階では高度な推論モデルを選択し、定型作業に入ったら適切なモデルへ切り替えるなど、タスクの性質に応じた使い分けが効果的です。
5. よくある質問（FAQ）
Q1. 週間クオータや5時間制限の残量はどこで確認できますか？
A. 設定画面（Settings）の Models から確認できるほか、チャットやターミナルで /usage または /quota コマンドを実行することで、現在の残量やモデル別の利用状況を即座に確認できます。
Q2. 5時間制限と週間制限のどちらが先に適用されますか？
A. どの制限が先に適用されるかは、契約プランとその時点の利用状況によって異なります。短期間の集中利用と週間トータルの利用状況の両方をこまめに確認することが重要です。
Q3. モデルを変更するとクオータの消費量は変わりますか？
A. はい。選択するモデルによってレート制限が異なります。具体的な利用可能量は、Settingsのモデル別クオータ表示から確認できます。
Q4. サブエージェントの起動はクオータを消費しますか？
A. サブエージェントを利用すると親エージェントとは別の実行が発生するため、タスク全体の仕事量が増加し、クオータ消費に影響を与える可能性があります。
6. まとめ：仕様を理解し、エージェントを「飼いならす」
Antigravity 2.0のクオータ制限に直面したとき、ただ制限解除を待つだけでは生産性は上がりません。
- 公式のクオータ仕様（プラン別の更新周期、仕事量連動、AIクレジット）を正しく理解する
- 残量（
/usage）をこまめに把握しながら作業量をコントロールする GEMINI.mdを活用し、エージェントに無駄な仕事をさせないための境界線をあらかじめ定義する
プラットフォームの仕様を正確に把握した上で、エージェントの行動を適切にマネジメントする。この姿勢こそが、AI時代において快適に開発を続けるための最も確実な自衛策と言えます。