第4章 権限と元に戻す — プリセットは4つ、破棄は慎重に
必須 この段階を進めるなら、必ず読んでください。一言まとめ: アプリの権限は4つのプリセット(Request Review・Default・Auto・Turbo)から選びます。最初はRequest ReviewかDefaultで始めましょう。 Reviewウィンドウの破棄は、確認なしですぐに適用されます。ターミナルには
/rewindがありますが、いちばん確実な安全網は、やはりGitの記録です。
権限 は、エージェントが自分の許可なしにやってもいい仕事の範囲です。たとえば「フォルダの中のファイルを直すのは聞かなくていいけど、プログラムのインストールは必ず聞いて」のような約束です。権限がなぜ必要なのかは、Claude Code 第4章でもっと詳しく説明しました(選択)。
このガイドは、まだアプリの画面では実習できていません。自分の画面と違うときは、画面に合わせてください。この章は、個人のGoogleアカウントを前提に書きました。[1]
権限のプリセット4種類
| プリセット | コマンドの実行 | いつ使う |
|---|---|---|
| Request Review | すべてのコマンドで許可を求める | 最初、慎重にしたい仕事 |
| Default | 柵の中では聞かず、外に出るときに聞く | 慣れてから |
| Auto (Preview) | 安全なコマンドは任せ、危険なコマンドだけ聞く | 試験的な機能 |
| Turbo | 制限なしにすべて実行する | ほとんど使わない |
出典: Antigravity公式ドキュメント(一部のみ抜粋)[2]
Turboは、柵なしでパソコン全体を読み書きできます。[3] メモの整理には要りません。
切り替える場所は3か所あります。[4]
- すべてのプロジェクト: Settings → General → Global Permissions → Permission Preset
- プロジェクトひとつ: Settings → Projects
- 今の会話: 入力欄の権限セレクター
プロジェクトは初期設定で全体の設定に従い(Inherit Global)、プロジェクトごとに別々に決めることもできます。[5] 信頼できるプロジェクトは緩く、信頼できないフォルダは厳しくしておける、ということです。[6] 個人アカウントが最初にどのプリセットで始まるのかは、公式ドキュメントには載っていません。アプリを開いたら、まず確認してください。
理解度チェック
Antigravity アプリの権限プリセットのうち、制限なしですべてのコマンドを実行するものはどれでしょうか?
柵と基本のルール
アプリにはターミナルの柵(サンドボックス、Sandbox)があります。エージェントが実行するコマンドが手を出せる範囲を限っておく仕組みです。公式ドキュメントは初期設定でオンだと説明しています。[7]
ただし、プリセットによって違います。[8]
- オン: Default・Auto
- オフ: Request Review・Turbo
柵がオンのとき、コマンドはこのように制限されます。
たとえばDefaultで、エージェントがインターネットから何かをダウンロードするコマンドを使おうとすると、柵の外に出る必要があります。このとき、アプリがそのコマンドを自分で判断します。安全で元に戻せるコマンドは聞かずに進め、危険なコマンドや元に戻せないコマンドは止まって、自分の許可を求めます。[2:1]
プリセットに関係なく、基本のルールもあります。
- プロジェクトフォルダの中のファイルの読み書きは、聞かれません。外のファイルには許可が必要です。[11]
- Webページの読み込みと操作は、初期設定が「聞く」です。[12]
- ルールが重なったときは、ブロック(Deny)> 確認(Ask)> 許可(Allow)の順で決まります。[13] たとえば「Webページの読み込みは許可」と「このサイトはブロック」を両方決めておくと、そのサイトではブロックが勝ちます。今すぐルールを作る必要はありません。
会話の中で許可したことは残ることがあり、エージェントが信頼できる動作を少しずつ覚えていきます。[14] 便利ですが、何を許可したかは覚えておいてください。
ターミナル(agy)の初期設定は違います。 ターミナルは、ファイルの書き込み・コマンド・Webツールの前に聞き[15]、柵は初期設定でオフです。[16] 第6章で扱います。
理解度チェック
アプリの Default プリセットと、ターミナル(agy)で、コマンドの柵(サンドボックス)は初期状態でどうなっているでしょうか?
元に戻す
Reviewウィンドウの破棄には気をつけてください。「Discard unstaged changes」は、まだgit addで記録するリストに載せていない変更を捨てるボタンです。このボタンは確認なしですぐに適用され、一度も記録されていない新しいファイルまで消します。[17]
初期の表示には、自分で直したものも入っています(第2章)。そのため、このボタンを押すと、エージェントが直したものだけでなく、自分で直したものまで消えることがあります。破棄する前に、何が入っているかを必ず見てください。
いちばん確実な元に戻す方法は、Gitの記録 です。この段階でもCodex 第4章と同じ習慣を使います。
- 任せる前: Gitで今の状態を記録しておく。
- 任せる。
- ReviewウィンドウのAgent Editsで、変わったものだけを見る。
- よければまた記録し、そうでなければ元に戻す。
Gitのコマンドを知らなくても大丈夫です。エージェントに「今の状態をGitで記録して」と頼めばOKです(Claude Codeで確認した方法です。Antigravityでは、このガイドはまだ確認できていません)。
ほかにも元に戻す機能はありますが、ファイルまで戻るのかはまだ確認されていません。
詳しく(クリックして開く)
理解度チェック
Review ウィンドウの Discard unstaged changes を押すときに注意が必要なのは、なぜでしょうか?
やってみましょう
- Settings → General → Global Permissionsで、今のプリセットを確認する。初めてなら、Request ReviewかDefaultにしておく。
- 整理ツールのフォルダの今の状態を、Gitで記録する。
- 第2章の議事録に「一番上に『作成日: 今日の日付』を一行追加して」と頼む。
- ReviewウィンドウをAgent Editsで見て、変わった行を確認する。
続きの課題: 第5章では、計画(/plan)、予約(/schedule・Automations)、ブラウザ(/browser)、目標(/goal)を見ていきます。
まとめ
- アプリの権限はプリセット4つ。最初はRequest ReviewかDefault、Turboは使わない。
- アプリの柵は、DefaultとAutoのプリセットでオンになり、インターネットが止まる。ターミナルは初期設定でオフ。
- プロジェクトフォルダの中のファイルは聞かれず、外とWebは聞かれる。
- Reviewウィンドウの破棄は、確認なしですぐに消す。任せる前にGitで記録しておく。
用語まとめ
| 用語 | 読み方 | 一言でいうと |
|---|---|---|
| Permission preset | パーミッション・プリセット | 権限を一度に決めるセット |
| Sandbox | サンドボックス | コマンドが手を出せる範囲を限る柵 |
| Discard | ディスカード | 変わった内容を捨てること |
/rewind | リワインド | ターミナルで会話をひとつ前の状態に戻すコマンド |
この章は読み終わりましたか?
学習の記録はこのブラウザにのみ保存されます。全体の進み具合は 全体目次で確認できます。
次の章: 第5章 計画・予約・ブラウザ・目標
参考資料(20件)
この章は、2026年11月1日に確認したAntigravityの公式ドキュメントをもとに書きました。このガイドは、まだアプリの画面では実習できていません。会社・企業のアカウントでは、権限の画面が違います。[20] ↩︎
Antigravity 公式ドキュメント「Agent settings」。"Request Review (“Every command requires approval.”): The sandbox is off and every terminal command requires approval." / "Default (“Ask before sensitive operations.”): Commands run without prompting inside the Terminal sandbox; running outside the sandbox requires approval." / "When a command needs to run outside the sandbox, Antigravity automatically evaluates it so safe, reversible commands proceed without prompting while risky or irreversible actions still pause for your approval." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Agent settings」。"Turbo (“Run all commands without restrictions.”): All commands run without prompting with no isolation or restrictions, and the agent has full read and write access to your filesystem." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Agent settings」。"For all projects: Open Settings > General > Global Permissions > Permission Preset." / "From the message box (
v2.23.0+): Choose a preset from the permissions picker." / "For a single project: Override the global preset under Settings > Projects. Projects default to Inherit Global, which follows your global preset." antigravity.google (確認日 2026-11-01) ↩︎Antigravity 公式ドキュメント「Agent settings」。"Projects default to Inherit Global, which follows your global preset." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Antigravity features」。"This means you can have a more permissive setting for a trusted project and a more restrictive security setting for an untrusted folder." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Terminal sandbox」。"Antigravity includes a terminal sandbox, enabled by default, that isolates shell commands executed by agents." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Terminal sandbox」。"| Default | On | Allowed in sandbox; ask outside |" / "| Turbo | Off | Allowed without prompting, unrestricted |" antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Agent permissions」。"Default (“Ask before sensitive operations.”): Terminal commands run inside the isolated Terminal sandbox with access restricted to your workspace and temp directories and no network access." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Terminal sandbox」。"Sensitive files such as
~/.sshand.envare blocked, anything not explicitly mounted is invisible inside the sandbox, and network access is limited to domains you’ve approved." antigravity.google (確認日 2026-11-01) ↩︎Antigravity 公式ドキュメント「Agent permissions」。"Workspace files: Reading and writing files inside your active project directory is allowed without prompting, while non-workspace files require approval." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Agent permissions」。"Web browsing defaults to Ask: Actions for
read_urlandexecute_urldefault to Ask." antigravity.google (確認日 2026-11-01) ↩︎Antigravity 公式ドキュメント「Agent permissions」。"Precedence rule: Conflicting rules are strictly evaluated in priority order: Deny > Ask > Allow." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Antigravity features」。"Permissions manually granted during a conversation can persist, allowing the agent to learn trusted actions over time." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Antigravity features」。"The default
request-reviewpermission asks before the agent writes files, runs shell commands, or uses web tools, unless one of your allow rules matches." antigravity.google (確認日 2026-11-01) ↩︎Antigravity 公式ドキュメント「Antigravity features」。"The terminal sandbox is off by default." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Review changes」。"Discard unstaged changes takes effect immediately, without asking you to confirm. It also deletes untracked files from disk." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「CLI best practices」。"Type
/rewind(or/undo) to roll back your conversation thread to a previous stable checkout." antigravity.google (確認日 2026-11-01) ↩︎Antigravity 公式ドキュメント「Changelog」。"The Confirm Undo dialog now offers an option to revert only the conversation." antigravity.google (確認日 2026-11-01) ↩︎
Antigravity 公式ドキュメント「Agent settings」。"Business and enterprise accounts use the following settings instead of the permission presets above." antigravity.google (確認日 2026-11-01) ↩︎