Google Antigravity のスタートガイド

1. はじめに

この Codelab では、エージェントの時代に開発を支援するために設計されたエージェント型開発プラットフォームである Google Antigravity について学びます。Antigravity 2.0 は AI エージェントの中央コマンド センターとして機能し、アクティビティの起動、モニタリング、オーケストレーションを行う統合プラットフォームを提供します。

2.0 のリリースにより、Antigravity は IDE と統合されたエージェント マネージャーではなくなりました。現在では、エージェント ファーストの時代に向けて設計されたプロダクトの完全なエコシステムとなっています。

  • Antigravity: macOS、Linux、Windows 向けの主力スタンドアロン アプリケーションです。これは、複数のローカル エージェントを並行して管理し、スケジュールされたタスクなどを実行するためのコマンド センターです。前身の Agent Manager とは異なり、Antigravity 2.0 は IDE とは独立して機能するスタンドアロン アプリケーションです。
  • Antigravity IDE: 元のフル機能のエージェント IDE は引き続き利用できます（開発者におすすめです）。エージェント マネージャー、アーティファクト、コードベースの深い理解が付属しています。
  • Antigravity CLI: ターミナルベースのエージェント操作用のコマンドライン インターフェース。このチュートリアルでは、これについては説明しません。
  • Antigravity SDK: デベロッパーが Antigravity を独自のシステムにプログラムで統合するためのツール。このチュートリアルでは、これについては説明しません。

この Codelab では、Antigravity に重点を置き、Antigravity IDE について簡単に説明します。他の 2 つのコンポーネント（Antigravity CLI と Antigravity SDK）は対象外です。

ターミナル ベースのアプリケーションである Antigravity CLI の Codelab に興味がある場合は、Codelab: Antigravity CLI のスタートガイドをご覧ください。

学習内容

  • Antigravity のインストールと構成。
  • エージェントやワークスペースの操作など、Antigravity の主なコンセプトについて説明します。
  • さまざまな設定や好みに合わせて Antigravity をカスタマイズする。

必要なもの

Antigravity はシステムにローカルにインストールする必要があります。この製品は、Mac、Windows、特定の Linux ディストリビューションで利用できます。ご自身のパソコンに加えて、次のものが必要です。

  • Chrome ウェブブラウザ。
  • Gmail アカウント（個人用 Gmail アカウント）。

この Codelab は、あらゆるレベルのユーザーとデベロッパーを対象としています。

レポートに関する問題

この Codelab と Antigravity を使用する際に、問題が発生することがあります。

Codelab 関連の問題（誤字脱字、手順の誤りなど）については、この Codelab の左下にある Report a mistake ボタンをクリックしてバグを報告してください。

e7d8a6055a16a773.png

Antigravity に関連するバグや機能リクエストについては、Antigravity 内で問題を報告してください。Antigravity サービスの左下にある [設定] をクリックして、サービスに関するフィードバックを送信できます。[Provide Feedback] オプションを選択します。

2. インストール

Antigravity をインストールする

Google Antigravity のダウンロード ページにアクセスします。オペレーティング システム（macOS、Linux、Windows）用の Antigravity アプリケーションをダウンロードします。

31e6370c1744fe73.png

インストーラを実行します。次の画面が表示されます。

4783c8ff21fbc6e7.png

Google アカウントでログインします。認証を完了すると、次の内容が表示されます。

12fa8752446a0458.png

[Open Antigravity]（反重力を開く）をクリックします。[安全性とデータの使用] ポリシーが表示されます。[次へ] をクリックします。

8f2fe904767c34b.png

お好みのテーマを選択します。

cc2466b518c241c9.png

Antigravity には、さまざまな Google デベロッパー ツールと連携する一連のプラグインが付属しています。これらのプラグインは、Antigravity が Google のさまざまなデベロッパー ツールと連携するのに役立つ一連のスキルをインストールします。インストールを任意で選択できるプラグインの一覧を次に示します。この Codelab では、これらのプラグインについては説明しません。[Finish] をクリックします。

3919ac5f462a5dfc.png

次のような Antigravity インターフェースが表示されます。

319cf98d41231a82.png

Antigravity IDE をインストールする

必要に応じて、Antigravity IDE をインストールすることもできます。Google Antigravity のダウンロード ページに移動します。Antigravity IDE のダウンロード セクションに移動します。

6d05924ef8098ae.png

Antigravity と Antigravity IDE の両方が正常にインストールされると、ドックに 2 つのアイコン（Antigravity（白い背景）と Antigravity IDE（黒いグリッドの背景））が表示されます。

97b7906262ed8246.png

3. Antigravity インターフェース

準備が整いました。まずは Antigravity の使用に焦点を当てましょう。最初の Antigravity 画面は次のようになります。

4b2ebaf5bbaa6a27.png

このチュートリアルでは、必要に応じて左下の [設定] オプションを使用します。

プロジェクト

まず、Antigravity のプロジェクトのコンセプトについて説明します。これは、右側のペインのインターフェースに「プロジェクトを選択」と明記されているため、重要です。Antigravity はプロジェクト中心のアプローチを採用して、エージェントが適切なファイル、ツール、権限などにアクセスできるようにしています。

プロジェクトは、エージェントの環境とスコープを定義するフォルダの組み合わせです。エージェントを単一のフォルダ内で動作させるのではなく、プロジェクトは 1 つまたは複数のフォルダ（フロントエンドとバックエンドのリポジトリなど）で動作し、エージェントにコードベースに必要なすべてのコンテキストを提供できます。すべてのプロジェクトには独自の分離されたエージェント設定があるため、異なるプロジェクトのセキュリティ設定を個別にカスタマイズできます。

最初のプロジェクトを作成しましょう。ローカルマシンのホーム フォルダに、$HOME/agy2-projects/my-first-project という名前のフォルダを作成します。空のフォルダである必要はありません。

ここでは、プロジェクトを構成するフォルダを定義して、Antigravity で最初のプロジェクトを作成します。最初のケースでは、フォルダは 1 つになります。

下に示すように、[Select Project]（プロジェクトを選択）→ [New Project]（新しいプロジェクト）をクリックします。

8fb15004219d1d6d.png

予想どおり、以下のように [フォルダを選択] が表示されます。

3b194f9234cbf9ca.png

[フォルダを追加] をクリックし、$HOME/agy2-projects/my-first-project などの特定のフォルダを選択します。

f907f3b64cf0d6a0.png

（[Add Folder] を使用して）プロジェクトにフォルダを追加することはできますが、ここでは [Next] ボタンをクリックします。

次のようなダイアログが表示されます。すべてのプロジェクトには独自の分離されたエージェント設定があるため、プロジェクトごとに異なるセキュリティ設定を個別にカスタマイズできます。

45a29e5c40bf3ae7.png

各プロジェクトは、アーティファクトのレビュー、許可されたツール、Model Context Protocol（MCP）サーバー構成に関する権限を、メイン インターフェースの [設定] からアクセスできるグローバル構成から継承します。ただし、これらの権限などをプロジェクトごとに個別に設定できるため、柔軟性が大幅に向上し、特定のプロジェクトのコンテキストとツールをシンプルに保つことができます。

今回は、[デフォルト] オプションを選択します。

次のダイアログでプロジェクトに名前を付けて、[作成] をクリックすることもできます。

529d6c23ef880f5.png

次の画面が表示されます。プロジェクトは、プロジェクト リストとチャット インターフェースに表示されます。モデルを選択したり、+ 記号、@、/ アクションなどで追加のコンテキストを渡したりできることに注意してください。

f2bfdb27bc878643.png

エージェントにメッセージで挨拶すると、エージェントがそれに応じて応答します。

7e4027bd7a9505e3.png

ニュースを取得する別のリクエストがあり、うまく機能しています。

a5b751531e25f2d3.png

会話

プロジェクト（my-first-project）で会話スレッドを開始し、現在、スレッドには一連のメッセージ（ユーザー メッセージとエージェントの回答）が存在します。

左側の会話スレッドがプロジェクトの下にグループ化されていることがわかります。

e650cbd24d8b66ca.png

では、この会話スレッドに名前を付けてみましょう。conv-introduction という名前を付けます。

会話の横にあるその他アイコンをクリックします。3 つのオプションが表示されるので、[名前を変更] を選択します。

244d0bd0fce7a213.png

値として conv-introduction またはわかりやすい名前を指定します。

プロジェクトで完全に新しい会話を開始する場合は、次の図に示すように、プロジェクトの横にある +（プロジェクトで新しい会話を開始）アイコンをクリックします。

7b834450020d8c03.png

これで、まったく新しい会話が始まります。

世界中のスポーツ ニュースをいくつか聞いてみましょう。まだ my-first-project にいることに注意してください。

4b3208b40a03b6d1.png

スポーツ界のニュースが表示されます。同じプロジェクトに 2 つの会話スレッドがあることがわかります。

aaf65af4b2791423.png

この会話の名前を conv-sportsnews に変更しましょう。これまでのすべての会話を確認するには、次の図に示すように、左上の [会話履歴] をクリックします。

3ed91bba75d70871.png

いつでも、上部の [新しい会話] オプションを使用して、現在のプロジェクトまたは新しいプロジェクトで新しい会話を開始できます。

プロジェクトの設定

それでは、先ほど説明したプロジェクト設定に戻りましょう。Antigravity でプロジェクトを作成すると、デフォルトの権限が継承されます。必要に応じて、この権限を明示的にオーバーライドできます。

特定のプロジェクトのプロジェクト設定にアクセスするには、左側のナビゲーション バーで各プロジェクトの横にある設定の歯車アイコンをクリックします。

7f7158d07780eba9.png

これにより、次の図に示すように、特定のプロジェクト（my-first-project など）の設定が表示されます。

d73f96c9f4f8f61b.png

左側の [プロジェクト] で、[my-first-project] が選択されていることを確認します。プロジェクトが複数ある場合は、このリストの下に表示されます。プロジェクトを簡単に選択して、必要に応じて設定を調整できます。

次に、右側の my-first-project のプロジェクト設定に注目します。このプロジェクトに追加した単一のフォルダが表示されます。ここからフォルダを追加することもできます。

まず、リスト全体を確認して、プロジェクトのカスタマイズ要件に応じて多数の設定を変更するのに役立つ柔軟性を確認することをおすすめします。

たとえば、次のようなものが挙げられます。

  • セキュリティ プリセット: エージェントがアクションを実行する前に、すべてのターミナル コマンドとファイル アクセスを審査するかどうかを指定します。
  • エージェントの動作: エージェントが実装計画をレビューなしで実行するかどうかを決定します。
  • さまざまなローカル権限: エージェントで許可またはブロックされるファイルパス、URL など。
  • このプロジェクトで許可される特定の MCP ツールを構成することもできます。これは、このプロジェクトのエージェントでグローバルに構成されたすべての MCP サーバーを使用できないようにする場合に非常に便利です。

注: Antigravity インターフェースのメイン設定オプションから、Antigravity の設定やプロジェクトの設定にいつでもアクセスできます。

9632f5815b5f00c5.png

4. スラッシュ コマンド

Antigravity には、興味深いスラッシュ / コマンドがいくつかあります。会話チャット インターフェースで「/」と入力すると、次のようにコマンドが表示されます。

a6b3198f2b693d8d.png

/browser コマンドについて考えてみましょう。これは、ブラウザを起動して何かを実行するように指示する明示的なコマンドです。デバッグ セッションを開始するには、Google Chrome と Google Chrome での権限が必要です。

1a23771f8cc1f7d2.png

これにより、Chrome でデバッグ セッションを開始しようとするブラウザ サブエージェントが生成され、最初に権限を求められます。

1380710b74477b94.png

許可すると、必要に応じて権限をリクエストし、詳細を取得します。

8620b739bc192f7.png

6d592e977d54337b.png

/schedule コマンドは、エージェントが一定の間隔またはスケジュール（月曜日と水曜日の午前 9 時など）で実行する定期的なタスクまたは 1 回限りのタスクを設定する場合に便利です。

同時に、ユーザー インターフェースを使用してこれを行うための同じ機能が提供されます。これについては、次のステップのコマンドのスケジュール設定セクションで説明します。

5. コマンドのスケジュール設定

メイン インターフェースの [スケジュール] オプションを使用すると、定期的なタスクを自動化したり、特定のプロジェクトで 1 回限りのリマインダーを設定したりできます。

4749901a164cd1ad.png

毎日午後 6 時の会議を知らせる毎日のタスクを作成しましょう。[新規] をクリックし、以下のように詳細を入力します。

41865ad9a5242407.png

[Add Scheduled Task] をクリックすると、以下のように、スケジュール設定されたタスクのリストにタスクが追加されます。

a4cecc4896c59893.png

20 分ごとに休憩を促すリマインダーを追加してみましょう。

e3b75ee01010eb9.png

次のように、スケジュール設定されたタスクが 2 つになりました。

6d122472143e48f3.png

タスクは無効にしたり削除したりできます。ここでは基本的なプロンプトを使用しましたが、要件に応じて、プロンプトを詳細にしたり、ツールを呼び出したり（外部システムと通信したり）、定期的にバックグラウンドで多くの処理を実行したりすることもできます。

6. Model Context Protocol（MCP）サーバー

Model Context Protocol（MCP）は、エージェントを外部システムに接続するための標準として登場しました。エージェントがデータと統合の点でグラウンディングを維持するうえで、重要な役割を果たします。

Antigravity は、ローカルとリモートの両方の MCP サーバーをサポートしています。また、Google Cloud サービスと連携する複数の MCP サーバーとの統合も提供されており、数個の構成データでワンクリックでインストールできます。

まず、事前構成済みの MCP サーバー オプションのリストを見てみましょう。[Settings → Customizations] に移動し、[Add MCP+] ボタンをクリックして新しいサーバーを追加します。ダイアログが表示され、サーバーの完全なリストが表示されます。

dbde58f6f5f99df9.png

[+Add] ボタンをクリックして、MCP サーバーを追加します。MCP サーバーに応じて、プロジェクト ID やデータベースの詳細など、提供する必要がある情報がいくつかあります。

既存の MCP サーバーを追加する

バックグラウンドでは、MCP サーバーは $HOME/.gemini/config/mcp_config.json ファイルで構成されます。既存のリモート MCP サーバーを使用している場合は、このファイルに詳細を追加するだけです。カスタム MCP サーバーの構成については、こちらをご覧ください。

リモート MCP サーバーを追加してファイルを保存したら、次のように Antigravity の MCP サーバー セクションに移動できます。

  1. Antigravity のメイン インターフェースで、[Settings] をクリックします。
  2. [カスタマイズ] に移動します。MCP サーバーがまだ表示されない場合は、[更新] をクリックします。

7d004eba523578fd.png

  1. [切り替え] ボタンを使用して、必要に応じて MCP サーバーを無効にできます。また、MCP サーバーのいずれかをクリックして、サーバーが公開しているツールを確認することもできます。

構成した MCP サーバーを使用するには、MCP サーバーを必要とする質問を Antigravity にします。たとえば、cloudrun-mcp サーバーを有効にして、Antigravity に「Build and deploy a Cloud Run service」と質問できます。これにより、Antigravity は cloudrun-mcp サーバーを探して使用し、Cloud Run サービスを構成してデプロイします。

7. アーティファクト

Antigravity は、作業を伝達して人間のユーザーからフィードバックを得る方法として、作業を計画して実行する際にアーティファクトを作成します。リッチ マークダウン ファイル、アーキテクチャ図、画像、ブラウザの録画、コードの差分などがあります。

アーティファクトは信頼のギャップを解消します。以前は、エージェントがバグを修正したと主張した場合、デベロッパーはコードを読んで確認する必要がありました。Antigravity では、エージェントがアーティファクトを生成して証明します。

Antigravity によって生成される主なアーティファクトは次のとおりです。

  • Task Lists: エージェントは、コードを記述する前に構造化された計画を生成します。通常、このプランを編集する必要はありませんが、確認することはできます。必要に応じて、コメントを追加して変更することもできます。
  • Implementation Plan: コードベース内の変更を設計してタスクを完了するために使用されます。これらのプランには、必要な修正に関する技術的な詳細が含まれており、アーティファクトの審査ポリシーが [常に続行] に設定されていない限り、ユーザーが確認することを想定しています。
  • Walkthrough: エージェントがタスクの実装を完了すると、変更の概要とテスト方法がまとめられたものが作成されます。
  • Code diffs: 厳密にはアーティファクトではありませんが、Antigravity はコードの差分も生成します。この差分を確認してコメントを追加できます。
  • Screenshots: エージェントは、変更前後の UI の状態をキャプチャします。

アーティファクトをより深く理解するには、次のプロンプトを使用して、新しいプロジェクトまたは既存のプロジェクトで会話を作成します。

Write a node application that I can run from the command line to get me the latest news from Google.

エージェントが飛び立ち、最初の成果物である実装計画を持って戻ってきます。

37333333a7794098.png

Antigravity によって生成されたアーティファクトは、右上隅に表示されている [補助ペイン] を切り替えることで確認できます。

94738a4b59d84fd7.png

[補助ペイン] を切り替えると、次の出力が表示されます。この出力には、1 つのアーティファクト（実装計画）が生成されたことが示されています。

3ad614ce81650142.png

[Implementation Plan] をクリックすると、次のように詳細が表示されます。

90e8ccae66dba76b.png

ここでは、プランに問題がないため、[続行] ボタンをクリックして次に進みます。

次に、このアーティファクトが処理されると、別のアーティファクト（タスクプラン）とその他のファイルが作成されます。以下に示すように、補助ペインでこれらすべてを確認できます。

5e7c8edfff5390ee.png

[タスク] アーティファクトをクリックすると、特定した目標を達成するためのステップごとのタスクリストが表示されます。また、どのステップが完了し、どのステップがまだ完了していないかも確認できます。

a18a60fc2a5c136f.png

最後に、エージェントがすべてを完了、テスト、確認すると、タスクが完了したことを示すメッセージが表示されます。チュートリアルという別のアーティファクトの準備が整いました。最終的なリストは次のようになります。

125f41b0a983f57a.png

注意すべき点がいくつかあります。アーティファクト（タスク、チュートリアル、実装計画）だけでなく、ソースファイル（package.json、index.js）もあります。

生成されたファイルを表示するために、本格的なエディタや IDE は必要ない場合があります。package.json ファイルまたは index.js ファイルをクリックすると、内容が表示され、コメントを追加できます。

8. Antigravity IDE

IDE を使用する場合は、この Codelab の前半でインストールした Antigravity IDE を使用することもできます。メインの Antigravity インターフェースで補助パネルを切り替えるときに、[IDE を開く] オプションが表示されます。

94738a4b59d84fd7.png

それをクリックして、Antigravity IDE を開きます。Antigravity IDE の起動時に、次のような警告が表示されることがあります。

d5919244c996af7f.png

これは正常な動作です。[はい] をクリックします。これにより、Antigravity IDE が表示されます。IDE を使用したことがある方にはおなじみの画面でしょう。生成されたすべてのフォルダとファイル、エディタ、エージェント パネルがあります。エージェントとコードについてチャットできます（説明、生成、修正など）。

f6af75f8e99cbbc6.png

9. スキル

Antigravity の基盤となるモデルは強力な汎用モデルですが、特定のプロジェクトのコンテキストやチームの標準を把握しているわけではありません。すべてのルールやツールをエージェントのコンテキスト ウィンドウに読み込むと、ツールが肥大化し、コストが増加し、レイテンシが発生し、混乱が生じます。

スキルは、プログレッシブ開示によってこの問題を解決します。スキルは、必要になるまで休眠状態にある専門知識のパッケージです。特定のリクエストがスキルの説明と一致した場合にのみ、エージェントのコンテキストに読み込まれます。

構造とスコープ

スキルはディレクトリ ベースのパッケージです。必要に応じて、次の 2 つのスコープで定義できます。

  • グローバル スコープ（~/.gemini/config/skills/）: すべての Antigravity プロダクト（Antigravity、Antigravity IDE、Antigravity CLI）とプロジェクトで使用できます。
  • プロジェクト/ワークスペースのスコープ（<project-root>/.agents/skills/）: スキルを特定のプロジェクト内でのみ利用できるようにします。

スキルの構造

一般的なスキル ディレクトリは次のようになります。

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

スキルを追加してみましょう。

コードレビュー スキル

これは指示のみのスキルです。つまり、メタデータとスキルの指示を含む SKILL.md ファイルを作成するだけで済みます。バグ、スタイルの問題、ベスト プラクティスについてコードの変更をレビューする詳細をエージェントに提供するスキルを作成しましょう。

特定のプロジェクト フォルダ（$HOME/agy2-projects/my-skills-project) など）にいると仮定すると、最初のステップは、スキルを格納するディレクトリをプロジェクト フォルダに作成することです。

mkdir -p .agents/skills/code-review

プロジェクト フォルダ（例: 先ほど作成した .agents/skills/code-review）に、次の内容の SKILL.md ファイルを作成します。

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

上記の SKILL.md ファイルには、上部にメタデータ（名前と説明）があり、その後に手順が記載されています。エージェントが読み込まれると、スキルのメタデータのみが読み取られ、スキルの手順全体は必要な場合にのみ読み込まれます。

コードレビューのスキルを検証しましょう。選択した特定のプロジェクトの Antigravity で会話を開き、次のプロンプトを入力します。

732820afe6db3ce0.png

code-review スキルが表示されます。

試してみる

$HOME/agy2-projects/my-skills-project に、次の内容のファイルを demo_bad_code.py という名前で新規に作成します。

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

Antigravity の特定のプロジェクトで新しい会話を開き、次のプロンプトを入力します。review the @demo_bad_code.py file

エージェントは code-review スキルを特定し、詳細を読み込んでから、code-review/SKILL.md ファイルに記載されている手順に沿ってアクションを実行する必要があります。

出力例を以下に示します。

a6e2b1b775feda28.png

10. まとめ

おめでとうございます！これで、Antigravity のインストール、環境の構成、エージェントの制御方法を学習できました。

Kaggle 5-Day AI Agents バッジを獲得する

Kaggle の 5-Day AI Agents: Intensive Vibe Coding Course with Google の一環としてこのラボを完了しましたか？修了バッジを受け取る: 5 日間 AI エージェント バッジを取得します。

次のステップAntigravity を使用して実際のアプリケーションを構築する様子を確認するには、次の Codelab をご覧ください。

リファレンス ドキュメント