Antigravityで何ができるか、どう使うと有意義か：プロジェクト、計画の確認、権限と承認、ブラウザ、予約実行までを、公式の資料で確かめる

この記事は、公式の資料を2026年10月23日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はAntigravityを入れていますが、使い心地はこの記事には書いていません。メニュー名、設定名、コマンドは公式の表記を写しています。公式ページは要約の形で取得したため、読み切れていない所は「公式の資料では確認できていない」と書き、長い引用は避けて言い換えています。

先に結論

• Antigravity は、「頼む → 計画を見る → 差分を見る → 承認する」を繰り返すツールとして説明されています。 公式のドキュメントは、エージェントが作る「アーティファクト」（実装計画、差分、録画など）を、人が確認できる場所として説明しています。
• 安全面の初期値は「閉じ気味」です。 公式の機能の一覧（Features）は、「Secure by default」の項で、サンドボックスの外でターミナルのコマンドを実行する前には承認を求め、標準ではプロジェクトのフォルダの中だけを読み書きする、と書いています。
• 使い始めは、小さく。 これは公式が書いている推奨ではなく、僕らの見立てです。まず練習用のフォルダで、「このコードの構成を説明して」のような読むだけの頼みから始め、権限の設定を確かめてから、書き換えを頼む流れが無理がないと考えます。
• 全部を一度に使う必要はありません。 /boost や /teamwork-preview のような大きな機能は、慣れてから足せます。

前提：用語をそろえる

• エージェント：自分で手順を考え、ツール（ファイルの読み書き、ターミナル、ブラウザなど）を使って、頼まれた作業を進めるAIです。
• サンドボックス（sandbox）：コマンドを、パソコンの中の隔離された場所で動かす仕組みです。公式は、OSの機能を使った軽い隔離で、仮想マシンやコンテナではない、と説明しています。
• ワークツリー（Git worktree）：Gitの機能で、同じリポジトリの別の作業場をもうひとつ作るものです。元のフォルダを汚さずに作業できます。
• サブエージェント（subagent）：主となるエージェントが、調べもの、ビルド、検証などを任せるために起動する、別のエージェントです。
• MCP：外部のツールやデータにつなぐための共通の規格です（03で扱います）。
• スキル、ルール、フック：エージェントの動きを、自分の資料や手順で調整する仕組みです（03で扱います）。

たとえ話：頼む相手に、鍵の束をどこまで渡すか

エージェントを、作業を代行してくれる業者にたとえてみます。「Request Review」は、部屋に入るたびに毎回声をかけてもらう頼み方です。「Default」は、作業場の中は自由に使ってよいが、外に出るときは声をかけてもらう頼み方です。「Turbo」は、鍵の束を全部渡して、何も聞かない頼み方にあたります。これは僕らのたとえで、公式の表現ではありません。どれを選ぶかは、頼む内容の大きさと、元に戻せるかどうかで決めるのが無理がない、と僕らは考えます（これも見立てです）。

公式が挙げる主な機能

公式のドキュメント「Features」は、Appの機能を10個挙げています。いずれも、読んだ範囲のページに「Preview」や「beta」の表示はありませんでした（確認日 2026-10-23）。

場面ごとの使い方：公式のどこに書かれているか

以下は、公式のページが説明している場面です。「僕らが試した」ものではなく、「公式にはこう書かれている」ものを並べています。

場面1：複数のフォルダにまたがる作業を、元のフォルダを汚さずに進めたい

• 公式のどこか： ドキュメント「Projects」。
• 書かれていること： プロジェクトは、ひとつのフォルダでも、フロントエンドとバックエンドのように複数のフォルダでも作れます。会話を始めるときに、「Local mode」（手元のフォルダで直接作業。素早い編集向き）か、「New worktree mode」（その会話のために新しいワークツリーを作る。複雑な作業向きで、元のフォルダには触れない）かを選びます。新しいプロジェクトは、全体の設定を引き継ぐ「Inherit Global」から始まります。
• ひとこと： 公式は、ワークツリーのモードが、複数のエージェントが衝突しないようにする助けにもなる、と書いています。公式のFAQも、ワークツリーに対応しているか、という問いに、Appで対応している、と答えています。

場面2：いきなり書かせずに、まず計画を見たい

• 公式のどこか： ドキュメント「Artifacts」と、CLIの「Features」のコマンド一覧。
• 書かれていること： アーティファクトは、エージェントが作業を進めて、進み具合を伝えるために作る、構造のある成果物です。Markdownの実装計画、コードの差分、構成の図、画像、ブラウザの録画が挙げられています。主に「Planning mode」で作られ、Appでは、計画を操作しながら見られるサイドバー、差分を見る画面、ブラウザ録画の再生があります。CLIでは、キーボードで操作する確認画面があり、ファイルを書き換える前に承認が要るときは、ターミナルの状態表示に通知が出ます。設定によっては、エージェントが節目で止まって確認を待ち、文字のコメントで方向を変えられる、とあります。
• コマンド： CLIの機能一覧には、/plan [task]（見直せる実装計画を作る）、/grill-me [task]（作業を始める前に、1回に1つずつ質問をする）が載っています。Appの変更履歴にも、v2.17.0で /plan が加わったと書かれています。
• ひとこと： 公式のクイックスタートでは、CLIの最初の手順の中で、提案された変更を「Artifact Review」の画面（Ctrl + R）で確認し、Y で承認する流れが説明されています。

場面3：画面の動作を、ブラウザで確かめさせたい

• 公式のどこか： ドキュメント「Browser」（IDE）と「Features」。
• 書かれていること： Antigravity は、手元のChromeを開いて、読んで、操作できます。例として、開発中のウェブサイトの確認、ドキュメントを読む、ブラウザの作業の自動化が書かれています。専用のサブエージェントが、必要に応じてタブを操作し、画面の写真（スクリーンショット）と、操作の録画を残します。録画は、操作できるアーティファクトとして保存されます。
• 安全面： URLへのアクセスは、拒否のリスト（denylist）と許可のリスト（allowlist）の2段で決まります。エージェントは、普段使っているブラウザとは別の、隔離された Chrome のプロファイルで動く、と書かれています。ユーザー設定の「Browser Tools」のスイッチで、ブラウザのツールをすべて止められます。

場面4：決まった時刻に、自動で確認や整理をさせたい

• 公式のどこか： コマンド「/schedule」のページ。
• 書かれていること： /schedule は、1回だけのタイマーや、定期的な（cron形式の）予定を設定して、エージェントを指示つきで呼び起こします。App、CLI、IDEで使えます。予定は、その会話の中のバックグラウンドの作業として動き、会話に属します。これとは別に、会話が閉じていても続けたい仕事（毎日のレポートや夜間の整理など）向けに「Automations」があり、実行のたびに新しい会話が始まる、と書かれています。
• 確認できていない点： パソコンを起こしておく必要があるか、アプリを開いておく必要があるかは、読んだ範囲では書かれていませんでした。なお、公式のFAQは、エージェントが動いている間は、パソコンがスリープしないようにする、と書いています。

場面5：大きな作業を、複数のエージェントで分担させたい

• 公式のどこか： ドキュメント「Subagents」と「Teamwork」、CLIの「Features」。
• 書かれていること（サブエージェント）： 主となるエージェントが invoke_subagent で、背景で動くサブエージェントを起動します。内蔵は research（コードの調査）、browser（ブラウザのテスト）、self（呼び出した本人の分身）の3つです。サブエージェントは、親の会話の履歴を持たない、まっさらな状態で始まります。親が許可した範囲（コマンド、フォルダの範囲、サンドボックスの設定）は引き継がれ、承認が必要なときは、親の画面に依頼が上がってきます。入れ子は10段までです。
• 書かれていること（/teamwork-preview）： 数日かかる大きなソフトウェアの作業、シミュレーション、深い調査のために、役割の違うエージェントが集まって進めます。名前のとおりPreviewで、有料のプランが必要、AppとCLIで使える、と書かれています。最初に、目的や受け入れの条件を聞く「scoping interview」があり、依頼文の成果物を承認してから、自動で実行が始まります。実行が始まったあとは、途中で止めずに進むため、公式は、確認の関門（Critic、Challenger、Auditor、Success Auditor）と、「integrity mode」（development、demo、benchmark）で抑える、と説明しています。
• ひとこと： 実行時間や費用、チームの大きさの上限は、このページには書かれていませんでした。

場面6：エディタで、書きながら補完してほしい

• 公式のどこか： 料金ページ、ドキュメント「Agent side panel」。
• 書かれていること： 料金ページは、Tab補完とCommandリクエストが無制限（unlimited）と書いています。IDEの「Agent」サイドパネルには、新しい会話の開始、履歴、@ で資料を指す、/ で手順（ワークフロー）を呼ぶ、画像の添付、エージェントのモードの切り替え、モデルの選択があり、下のツール欄から、生成されたアーティファクト、動いているターミナルの処理、変更の確認「Review Changes」へ行けます。
• ひとこと： IDE拡張機能は、公式の説明では、サイドパネルでの会話、細かい差分の確認、計画の確認、複数手順の作業を、いつものエディタの中でする入口です（03で扱います）。

権限と承認：どこまで勝手にやらせるか

ここがこのツールで一番大事な設定です。公式のドキュメント「Permissions」と「Terminal sandbox」から整理します（確認日 2026-10-23）。

Appの「Permission Preset」

設定の場所は、「Settings」→「General」→「Global Permissions」→「Permission Preset」です。プロジェクトごとには「Settings」→「Projects」で決められ、標準は「Inherit Global」です。v2.23.0以降は、メッセージ欄からも選べる、と書かれています。

• Default は、公式が「Ask before sensitive operations」（重要な操作の前に聞く）と説明するもので、サンドボックス内のコマンドはネットワークにつながりません。ネットワークやパソコン本体の資源が要るコマンドは、許可のルールがなければ確認が出ます。
• Auto (Preview) は、安全で元に戻せるコマンドは、サンドボックスの外でも確認なしで動き、危険なものや元に戻せないものは確認が出る、と書かれています。App v2.23.0以降で、企業・組織のアカウントでは使えません。
• Turbo は、サンドボックスもなく、ファイルシステム全体と、MCP、ウェブがすべて許可される組み合わせです。公式の表のとおり、何も聞かれません。

承認の流れとルール

• 敏感な操作は、action(target) の形の許可の対象として、3つのリスト（Deny、Ask、Allow）で点検されます。優先順位は、Deny、Ask、Allow の順です。
• Ask に当たると、エディタの中にカードが出ます。ファイル、URL、MCPの確認では、許可を広げるために、対象を書き換えられます（例：/project/file.txt を /project に）。ターミナルのコマンドでは、これはできません。
• ルールの動作は、read_file、write_file、read_url、execute_url、command、mcp です。write_file を許可すると、同じ場所の read_file も許可され、read_file を拒否すると write_file も拒否されます。
• $(...) や波括弧の展開のような、実行を隠せる書き方が入ったコマンドは、前方一致の許可が効かず、行全体が一致したときだけ、確認なしで動きます。

CLIの実行モードと設定

• Shift+Tab、--mode、/config で切り替えます。auto（Preview）は、作業フォルダの編集を自動で承認し、サンドボックス内でコマンドを動かします。macOS・Linuxで v1.3.5以降、Windowsで v1.4.4以降です。accept-edits は、作業フォルダの編集と作成を自動で承認し、シェルのコマンドは、toolPermission とルールで点検されます。
• toolPermission の標準は "request-review" です。"proceed-in-sandbox" にすると、サンドボックスの中のコマンドは確認なしで動きます。--dangerously-skip-permissions（always-proceed）は、auto モードよりも優先される、と書かれています。
• CLIのサンドボックス enableTerminalSandbox の標準は false です。

サンドボックスが守るもの、守らないもの

公式の説明は次のとおりです。ファイルは、プロジェクトのフォルダ、一時フォルダ、よくあるビルドのキャッシュには書け、/usr や /etc のようなシステムのフォルダは読めますが、~/.ssh や .env のような敏感なファイルは見えません（macOS・Linuxの場合）。ネットワークは、標準では使えません。サンドボックスでは動かせないコマンドは、承認を経て、パソコン本体で、全権限で動きます。

OSごとの実装は、Linuxはカーネルの名前空間、macOSは sandbox-exec、Windowsは AppContainer と書かれています。Windowsは、Windows 11 24H2の2026年8月の更新以降が必要、とあります。

資料の書き方に差がひとつあります。「Settings」のページは、サンドボックスの対応を macOS と Linux と書き、Windows 10 や古い Windows 11 のようにサンドボックスが使えない環境では、サンドボックスの設定は効かない、とも書いています。一方、サンドボックスのページは Windows にも対応と書き、条件は Windows 11 24H2 の2026年8月の更新以降です。変更履歴（v2.15.1、2026年9月19日）にも Windows 対応が書かれています。Windows で使えるかどうかは OS の版しだいと読めますが、これは僕らの読み取りです。

モデルを選ぶ

公式のドキュメント「Models」によると、モデルの選択は、会話の入力欄の下のメニューで行い、「Low」「Medium」「High」の思考の深さも選べます。深さを下げると速く、上げると難しい設計やデバッグ向き、と書かれています。選んだものは、その会話の以降のメッセージで続きます。エージェントの実行中にモデルを替えても、いまのターンが終わるか中止するまでは前のモデルを使います。モデルの一覧とプランごとの違いは、04で表にしています。

公式が紹介する、そのほかの小さな機能

• /btw <query>： 背景で、ちょっとした質問をする（CLIの機能一覧）。
• /codesearch、/diff、/context： コードの検索、差分、使っている文脈の確認。
• /rewind（別名 /undo）： 会話の巻き戻し。
• 会話の検索： Appの変更履歴に、Cmd/Ctrl+K での内容による会話の検索（v2.21.1）。
• PDFの書き出し： 変更履歴に、Markdownの表示結果をPDFで書き出せる（v2.19.1）。

今日からできること

1. 練習用のフォルダで、プロジェクトを作る（01の手順）。
2. 権限の設定を確かめる。まず「Default」のまま、何が確認されるかを見る。
3. 「このフォルダの主なファイルと、読む順番を教えて」と頼む（読むだけの頼み）。
4. 次に、小さな修正を頼む。その前に /plan で計画を出してもらい、アーティファクトのコメントで直したい点を伝える。
5. 変更は、Appなら「VCS panel」（Git確認画面）で、差分を見てから、コミットするかを決める。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者はAntigravityを入れていますが、使い心地はこの記事には書いていません。公式の資料を読んだ範囲です。
• 「Turbo」は、公式の表によると、サンドボックスもなく、ファイル全体と、MCP、ウェブがすべて許可される組み合わせです。重要なファイルのあるフォルダや、仕事のコードでは、使う前に、何が起こりうるかを公式の説明で確かめてください。これは僕らの見立てです。
• 公式のドキュメントは、機能ごとにApp、CLI、IDEの対応が違います。たとえば、/schedule はApp、CLI、IDEで使える、/teamwork-preview はAppとCLIで使える、サンドボックスはAppとCLIで使える、と書かれています。使う入口で使える機能を、ドキュメントの「Available on」で確かめてください。
• 「Auto (Preview)」「auto モード」「/teamwork-preview」は、公式が「Preview」と書く機能です。動きが変わる可能性があります。
• 画面の名前は変わっています。「Scheduled tasks」は、変更履歴によると、v2.21.1で「Automations」になりました。ドキュメントの中でも、新旧の名前が混ざることがあります。
• この記事は、法律や安全性の保証ではありません。権限の設定の最終的な判断は、ご自分でお願いします。

出典

• Features（Google Antigravity Docs、確認日 2026-10-23）
• Projects（Google Antigravity Docs、確認日 2026-10-23）
• Artifacts（Google Antigravity Docs、確認日 2026-10-23）
• Agent（Google Antigravity Docs、確認日 2026-10-23）
• Agent side panel（Google Antigravity Docs、確認日 2026-10-23）
• Browser overview（Google Antigravity Docs、確認日 2026-10-23）
• Subagents（Google Antigravity Docs、確認日 2026-10-23）
• Teamwork（Google Antigravity Docs、確認日 2026-10-23）
• /schedule（Google Antigravity Docs、確認日 2026-10-23）
• Permissions（Google Antigravity Docs、確認日 2026-10-23）
• Terminal sandbox（Google Antigravity Docs、確認日 2026-10-23）
• Models（Google Antigravity Docs、確認日 2026-10-23）
• CLI features（Google Antigravity Docs、確認日 2026-10-23）
• Getting Started（Google Antigravity Docs、確認日 2026-10-23）
• Settings（Google Antigravity Docs、確認日 2026-10-23）
• FAQ（Google Antigravity Docs、確認日 2026-10-23）
• Changelog（Google Antigravity Docs、確認日 2026-10-23）
• Pricing（Google Antigravity、確認日 2026-10-23）