【Antigravity】プロジェクト管理・設定変更・エラー修正のコツ

Antigravityの会話履歴管理や複数プロジェクト運用、基本設定（Settings）を解説。さらにブラウザのデベロッパーツールを活用し、エラー発生時にAIへ修正依頼を出して解決する手順まで網羅します。

はじめに
手順1：会話履歴（Conversation History）の管理と新規チャットの開始
手順2：基本設定（Settings）
手順3：新規プロジェクトを追加
手順4：エラーや不具合発生時のデバッグと修正依頼
会話（Conversation）の削除
プロジェクト（Project）の削除
関連コンテンツ

はじめに

Antigravityは単一のアプリ作成だけでなく、複数の開発案件の並行管理やエラー自動修復に対応しています。

管理・対応項目	使用するメニュー・機能	主な役割・用途
会話履歴管理	Conversation History	過去の指示ログや設計計画の復元・再開
モデル設定	Model Selector / Settings	Flash（高速・軽量）とPro（高度推論）の使い分け
複数プロジェクト	Projects 欄（＋ボタン）	フォルダごとに独立した新規アプリ開発・切り替え
バグ・エラー修正	F12 Console ログ連携	発生したJavaScriptエラーをAIに渡して即座に修復

Antigravityを開発ツールとして使いこなすには、複数のプロジェクト管理や会話履歴の切り替え、AIモデルの使い分けが欠かせません。今回は、それらの操作方法とアプリ開発で必ず直面する「動かない」「エラーが出る」といった不具合を、ブラウザのデベロッパーツールと連携してAIに的確に修正させるトラブルシューティング手順を徹底解説します。

なお、前回までの記事で作成したブラウザアプリを例に、今回は具体例を紹介します。

【Antigravity】プロンプト指示だけで最初のアプリを自動生成する手順

Google Antigravityの基本画面の見方と操作手順を解説します。中央の入力欄に日本語プロンプトを入力し、コードを書かずにミニアプリを自動生成・実行するまでの流れを初心者向けにわかりやすく紹介します。

【Antigravity】機能追加・IDE直接編集・@メンションや/スラッシュコマンドを活用した指示のコツ

Antigravityで生成したWebアプリをさらに発展させる方法を解説。チャットからの機能追加指示、内蔵エディタ（Open IDE）でのコード直接編集、@メンションや/スラッシュコマンドを活用した効率的な開発手順を詳しく紹介します。

手順1：会話履歴（Conversation History）の管理と新規チャットの開始

作業内容ごとにチャット履歴が自動保存されます。過去の作業を振り返ったり、同じプロジェクト内で別の機能開発をまっさらな状態から始めたりする手順です。

画面左側のサイドバー上部にある [Conversation History] をクリックします。

会話履歴（Conversation-History）の管理と新規チャットの開始5.png

これまでにやり取りしたスレッド（会話履歴）が一覧で表示されます。過去のスレッドをクリックすると、その時点のチャット履歴、生成されたコードのログ、実装計画などをいつでも再確認・再開できます。

同じプロジェクト内で別の機能（例：ストップウォッチ機能の追加など）を新しい会話で始めたい場合は、左サイドバー上部の [+ New Conversation] をクリックします。

入力欄がリセットされた新しいチャット画面が開きます。作業フォルダの設定は維持されたまま、前回の会話コンテキストをリセットして新たな指示を入力できます。

手順2：基本設定（Settings）

作業内容や利用目的に応じて、使用するモデルの切り替えやエージェントの動作権限、外観などを調整します。

画面左下の最下部にある [Settings（歯車アイコン）] をクリックします。

設定画面が表示されます。左側のメニューから各項目を選択して設定を変更します。設定後は、画面右上の [×] ボタンをクリックしてメイン画面に戻ります。設定画面で、よく使う主要な項目を簡単に紹介します。

General

エージェントの自律的な動作範囲やセキュリティを制御する設定ができます。

主な項目	用途	設定方法・内容
Queued Messages（Execution）	エージェントの応答中に連続してメッセージを送った場合の挙動を決めます。	順番待ちさせる場合は Queue、即時割り込みで送る場合は Send Immediately を選択します。
Security Preset / File Access Rules	ターミナルコマンドの自動実行やファイルアクセスの範囲を制限します。	基本は Default を維持し、特定のディレクトリへの読み書きを制限・許可する場合は File Access Rules の [Open] からパスを設定します。
Terminal Commands / MCP Tools（画面下部）	自動実行を許可するコマンドリストや、外部ツール連携プロトコル（MCP: Model Context Protocol）の管理を行います。	画面下部の各項目にある [Open] から許可コマンドや外部ツールの連携設定を行います。

Appearance

画面の見た目（UI・表示設定）を調整します。

主な項目	用途	設定方法・内容
Verbose Agent Chat	エージェントの思考プロセス（思考ステップ）をチャット上に常時表示するかどうかを切り替えます。	思考過程を詳細に確認したい場合はON、チャット表示を簡潔に保ちたい場合はOFFにします。
Theme / Conversation Width	UIテーマやチャット画面の横幅を調整します。	Themeでシステム連動・ライト・ダークを切り替え、Conversation Widthで Default / Narrow / Wide から選択します。

Models & Usage

プラン確認・変更、クレジットの超過設定、モデルの残り利用枠の確認などができます。

主な項目	用途	設定方法・内容
Plan → Your Plan: Google AI Pro	現在契約中のプランを確認・変更します。	[Upgrade] をクリックして、よりレート制限が緩和される上位プラン（Google AI Ultra）へのアップグレード手続きを行います。
Model Credits → Enable AI Credit Overages	プランのモデルクォータを使い切った際、追加クレジットを自動消費して利用を継続するかを設定します。	スイッチをONにするとクォータ超過時にクレジットが自動消費され、OFFにすると追加課金を防止します（常にクォータ枠が優先消費されます）。
Gemini Models → Weekly Limit Remaining	Geminiモデルの週間利用制限の残量を確認します。	残り利用枠の割合（%）および全枠リフレッシュまでの残り時間が表示されます。
Gemini Models → Five Hour Limit Remaining	Geminiモデルの5時間単位の利用制限の残量を確認します。	直近5時間の残り利用枠の割合（%）およびリフレッシュまでの残り時間が表示されます。
Claude and GPT models → Weekly Limit Remaining	外部連携モデル（Claude / GPT）の週間利用制限の残量を確認します。	残り利用枠の割合（%）および全枠リフレッシュまでの残り時間が表示されます。
Claude and GPT models → Five Hour Limit Remaining	外部連携モデル（Claude / GPT）の5時間単位の利用制限の残量を確認します。	直近5時間の残り利用枠の割合（%）およびリフレッシュまでの残り時間が表示されます。

Antigravityのモデル残量画面では、Gemini系とClaude/GPT系の2つの枠が独立して管理されています。各グループには、1週間単位の上限である「Weekly Limit」と、短時間の集中利用を抑える5時間単位の上限である「Five Hour Limit」の2種類の制限が設定されています。

片方のモデルの残量が低下または枯渇した場合は、もう一方のモデルグループへ切り替えることで作業を中断せずに継続できます。5時間制限は数時間待つことで回復しますが、週間制限は画面に表示されたリフレッシュ日まで回復しません。そのため、週間制限の残量が少ない場合は、リセット日まで別グループのモデルを主軸として使用します。

利用枠の急激な消費を防ぐためには、作業の区切りごとに新しいチャットを開く運用が有効です。会話履歴が長くなるほど、1回の送信で消費されるトークン量が増加します。また、AIへの指示はプロジェクト全体ではなく、対象のファイル名や関数名を具体的に指定することで、不要なコード走査を減らして消費を抑えられます。

Customizations

エージェントに追加の能力（Skills）やルールセットを組み込む設定です。

項目	用途	設定方法・内容
Skills	エージェントが自動利用する拡張スキルやルールの適用状態を管理します。	一覧から各スキルの詳細を確認し、トークン消費量や利用可否を管理します。

Browser

ブラウザ自律操作機能の設定ができます。

項目	用途	設定方法・内容
Browser Javascript Execution Policy / Actuation Rules	ブラウザ自律操作時のスクリプト実行や操作対象URLを制御します。	実行確認レベル（Request Review等）の選択や、Editから操作を許可・拒否するURLを設定します。

Application

アプリの常駐設定などを行います。

項目	用途	設定方法・内容
Prevent Sleep / Keep In Menu Bar	バックグラウンド実行時のスリープ防止やアプリの常駐を設定します。	長時間タスクでPCのスリープを防ぐ場合は Prevent Sleep、ウィンドウを閉じても常駐させる場合は Keep In Menu Bar をONにします。

プロジェクト個別設定

左メニューの「Projects」欄にあるプロジェクト名（test）を選択すると、そのプロジェクト名の個別設定ができます。

項目	用途	設定方法・内容
Folders (test/)	対象プロジェクトに紐づけるローカルフォルダを管理します。	[＋ Add Folder] をクリックして作業ディレクトリを追加したり、フォルダ右端の [×] で解除します。
Security Preset	プロジェクト内でのコマンド実行やファイルアクセスの安全ポリシーを設定します。	デフォルトは Inherit General（全体設定を継承）となっており、ドロップダウンからプロジェクト専用のポリシーに変更できます。
Artifact Review Policy	生成ドキュメント（Artifact）に対する確認要求の頻度を設定します。	デフォルトは Inherit General（全体設定を継承）となっており、ドロップダウンからプロジェクト個別の確認ルールに変更できます。
File Access Rules	プロジェクト固有のファイル読み書き許可・拒否パスを設定します。	[Open] をクリックし、全体設定（Global settings）に加えてこのプロジェクト限定で適用するパスルールを編集します。

手順3：新規プロジェクトを追加

タイマーアプリとは別に新しいWebアプリ（例：ToDoリストやメモ帳アプリなど）を作成したい場合に、プロジェクトフォルダを追加して切り替える手順です。

画面左側サイドバーの「Projects」欄の右横にある フォルダアイコン（＋） をクリックします。表示されたメニューから [New Project] を選択します。

フォルダ選択ダイアログが表示されるので、新しく作成したいアプリ用のフォルダ（例：test2 など）を選択し、[フォルダーの選択] をクリックします。

左側サイドバーの「Projects」欄に新プロジェクトが追加され、作業ディレクトリが切り替わったことを確認します。

プロンプト入力欄に新しいアプリの作成指示を入力して送信することで、前回のタイマーアプリとファイルを混同することなく、独立した新規開発をスタートできます。過去のプロジェクトに戻りたい場合は、サイドバーのプロジェクト名をクリックするだけでいつでも切り替え可能です。

手順4：エラーや不具合発生時のデバッグと修正依頼

Webアプリの動作中にボタンが反応しない場合や処理が停止した際に、ブラウザのデベロッパーツールを使ってAIに修正を依頼する手順です。

アプリ実行中に不具合が発生した場合、キーボードの F12 キー（Macは Cmd + Option + I）を押してデベロッパーツールを開き、[Console] タブを選択します。

赤文字で表示されたエラーログ（Uncaught ReferenceError など）の上で右クリックし、[Copy console] を選択してエラー内容をコピーします。

Antigravityのプロンプト入力欄に、指示文とともにコピーしたエラーログを貼り付けて送信します。

ブラウザで実行すると以下のエラーが出たので、原因と解決案を教えて

app.js:576 Uncaught ReferenceError: timerState is not defined
displayTimerTime @ app.js:576
updateFromInputs @ app.js:420
init @ app.js:140