Blog

ブログ

  1. Home
  2. Blog
  3. AI
  4. Antigravity 2.30.0の設定について

Antigravity 2.30.0の設定について

更新日：2026年11月10日｜公開日：2026年11月10日

1. 設定の基本概要とアクセス方法

Antigravityをインストールして結構時間が経ちましたが、バージョン2.30.0時点でのSettingsのマニュアルをAntigravityを使ってまとめたいと思います。バージョン2.30.0ではAIエージェントの自律行動レベル、実行環境の安全性（サンドボックス）、システムリソースの利用可否などを細かくコントロールできます。では行ってみます。

設定画面へのアクセス方法

操作方法手順 / ショートカット対象環境
ショートカットCtrl + , (Windows/Linux) / Cmd + , (macOS)デスクトップアプリ / IDE
サイドバー画面左側のサイドバー最下部にある 「Settings（歯車アイコン）」 をクリックデスクトップアプリ / IDE
プロジェクト設定プロジェクト一覧内の各プロジェクト横にある歯車アイコンをクリックデスクトップアプリ
対話型権限マネージャーチャットまたはTUIで /permissions と入力して実行CLI / デスクトップアプリ

2. 設定の階層構造（グローバル vs プロジェクト）

Antigravity の設定は、「グローバル設定」 と 「プロジェクト設定」 の2層構造になっています。

グローバル設定（Global Settings）

PC全体、すべての会話およびワークスペースに共通して適用される既定値です。

プロジェクト設定（Project-Level Settings）

個別のリポジトリやディレクトリに特化した設定です。プロジェクト設定が定義されている項目は、グローバル設定よりも優先して適用されます。

3. エージェント権限・実行セキュリティ（Agent Settings & Permissions）

Antigravity の中核となるセキュリティ機能です。エージェントがコマンドを実行したり、ファイルを書き換えたりする際の自律性を決定します。

実行プリセット（Execution Presets）

エージェントのツール実行ポリシー（Tool Execution Policy）は、以下のプリセットから選択できます。

プリセット名動作内容推奨用途
Default（既定）サンドボックス内の安全・可逆的な操作は自動実行し、外部影響のあるコマンドや危険な操作のみユーザーに確認（承認）を求める。通常の開発作業（推奨）
Request Review（厳格）コマンド実行やファイル作成・変更の前に、必ずユーザーの明示的な承認を要求する。初めて触るリポジトリ、本番環境、厳格な監査が必要な場合
Autoサンドボックス環境での安全なコマンド実行を自律的に判断し、不要な確認プロンプトを最小限にして素早く処理を進める。テスト自動修正、リファクタリング等の連続反復タスク
Turboすべてのツール・コマンドを承認なしで全自動実行する。信頼された使い捨て環境、CI/CD的な一括処理（上級者向け）

ターミナルサンドボックス（Terminal Sandbox）

エージェントが実行するシェルコマンドを、ホストOSから隔離された仮想・サンドボックス環境で動作させる設定です。

ファイルアクセス制御（Workspace & Non-Workspace File Access）

エージェントがアクセス可能なファイル範囲を制限します。

ネットワーク・インターネット制御（Internet Access Policy）

エージェントが外部Webサイトへのアクセス、API呼び出し、Web検索を行えるかを制御します。

ブラウザ制御ルール（Browser Actuation Rules）

ブラウザ操作サブエージェント（Webブラウジング機能）がアクセス可能なドメインを管理します。

権限判定エンジンと構文（Permission Engine）

設定やルール内で直接権限を記述する場合、action(target) 構文を使用します。

allow: run(git *)
ask: run(npm publish)
deny: read(/etc/shadow)

権限の競合ルール（Precedence）: 複数のルールが合致した場合、deny（拒否） > ask（確認） > allow（許可） の順で最も安全側のルールが優先されます。

成果物レビュー（Artifact Review Mode）

エージェントが設計計画書やリサーチ結果などのアーティファクト（.md ドキュメント等）を生成した際のレビュー動作を設定します。

4. AIモデル設定（Model & Intelligence Settings）

エージェントの思考・コード生成を担う基盤モデルの切り替えを行います。

Model Selection

Progressive Disclosure（段階的情報開示）

5. アプリケーション・システム動作（Application & General Settings）

Antigravity 2.30.0 の稼働環境を安定させるためのシステム設定です。

設定項目選択肢 / 設定値説明
Prevent SleepOn / Off長時間のバックグラウンドタスク（大規模ビルド、テスト、/goal など）の実行中にPCがスリープに入るのを防止します。
Keep In Menu Bar / Run in BackgroundOn / Offメインウィンドウを閉じてもタスクを中断せず、タスクトレイ / メニューバー常駐でバックグラウンド実行を継続します。
Update Modeauto / manual / noneアプリケーションの自動アップデート方針。開発環境の安定性を重視する場合は manual に設定します。
NotificationsOn / Off長時間のタスクが完了した際や、ユーザーの入力・承認が必要になった際にOS通知（デスクトップ通知）を発行します。

6. 表示・UIカスタマイズ（Appearance & Display Settings）

7. 設定ファイルによる高度な管理（settings.json）

GUIからだけでなく、JSON設定ファイルを直接記述してバージョン管理や一括配布が可能です。

ファイルの配置場所

settings.json 設定例

{
  "model": "gemini-3.8-flash",
  "executionPolicy": "default",
  "sandbox": {
    "enabled": true,
    "network": "restricted"
  },
  "fileAccess": {
    "nonWorkspace": "ask"
  },
  "permissions": {
    "allow": [
      "run(git status)",
      "run(git diff)",
      "run(npm test)",
      "read(package.json)"
    ],
    "ask": [
      "run(git push *)",
      "run(npm install *)"
    ],
    "deny": [
      "read(**/.env*)",
      "run(rm -rf /*)"
    ]
  },
  "application": {
    "preventSleep": true,
    "runInBackground": true,
    "updateMode": "manual"
  },
  "appearance": {
    "theme": "dark",
    "conversationWidth": "wide"
  }
}

8. ユースケース別推奨プリセット

日常的な開発作業（標準バランス）

メリット

安全性を保ちつつ、無駄な確認を減らしてテンポよく開発可能。

夜間の自律タスク / バッチ処理（/goal など）

メリット

スリープによる停止を防ぎ、完了時に通知を受け取れる。

機密性の高いプロジェクト / セキュリティ重視

メリット

すべての変更・通信が可視化され、意図しない外部流出や破損を防止。

9. 参考文献

丁寧な比較的最新の設定の記事や自動承認のTurboの設定に関する記事も参考になります。

ユージック

WEBサイトのUI/UXやSEO対策・AIO対策といったWEB関連を専門にして20年。現在は大阪のWEB制作会社でプランナー・ディレクターとして活動中。趣味はバンドでギター、ベース、ドラム。キャンプや登山も好きでよく行ってます。

関連記事:

Menu

Blog Category

Blog Archive