Antigravity CLIの使い方｜Gemini CLIからの移行手順

Antigravity CLIは、2026年6月18日に個人向けの提供を終了したGemini CLIの後継として登場した、Google公式のターミナル型AI開発ツールです。この記事では、Gemini CLIからAntigravity CLIへの移行手順と使い方を、実際のつまずきやすいポイントを切り分けながら整理します。「コマンドが変わって戸惑う」「設定を引き継げるのか不安」という方が、最短で新しい環境に慣れられるようにまとめました。

先に結論をまとめると、移行の要点は次の3つです。(1) 旧Gemini CLIをアンインストールする前に設定データを引き継ぐこと、(2) 起動コマンドと一部の用語が変わること、(3) 個人利用の基本機能は引き続き無料で使えること。順番に見ていきましょう。

Antigravity CLIとは｜Gemini CLIから何が変わったのか

まずは背景の整理です。なぜGemini CLIが終了し、Antigravity CLIへ移行する必要があるのかを理解しておくと、設定の引き継ぎで迷いにくくなります。

Gemini CLIが2026年6月18日に個人向け終了した経緯

Googleは2026年5月19日、Gemini CLIをAntigravity CLIへ移行する方針を公式に発表しました。公式ブログによると、Gemini CLIとGemini Code AssistのIDE拡張は2026年6月18日にリクエストの受け付けを停止しています。対象となるのは無料ユーザー、Google AI Pro/Ultraの契約者、個人向けGemini Code Assistの利用者です。一方で、Gemini Code AssistのStandard/Enterpriseライセンスを利用している組織や、Google Cloud経由のアクセスは影響を受けません。つまり「個人で無料または個人向け有料プランを使っていた人」が移行対象になります。出典: Google Developers Blog（Transitioning Gemini CLI to Antigravity CLI）

Antigravity CLIの特徴（Go実装・マルチエージェント）

Antigravity CLIは、Googleが掲げる「エージェント優先の開発プラットフォーム」の一部として設計されています。Go言語で実装されており起動が速く、複数のサブエージェントを並行して動かせるのが従来との大きな違いです。大規模なリファクタリングや複数テーマの調査を、ターミナルをロックせずにバックグラウンドで進められます。デスクトップ版のAntigravityと同じ設計思想を共有しており、Agent Skills・Hooks・Subagents・Extensions（新しくは「プラグイン」と呼びます）といった機能を引き継いでいます。

Gemini CLIからAntigravity CLIへの移行手順

ここが本題です。移行そのものは難しくありませんが、順番を間違えると設定を引き継げずに一からやり直しになることがあります。手順を追って進めましょう。

移行前に確認すること（データのバックアップ）

最初に確認したいのは、旧Gemini CLIの設定ディレクトリ（ホーム配下の ~/.gemini/）が残っているかどうかです。移行ツールはこの旧データを参照して設定を変換するため、旧CLIをアンインストールする前に引き継ぎを済ませるのが鉄則です。カスタムのプロンプト設定やAPIキーの登録内容、拡張機能の一覧を使っている場合は、念のためディレクトリごとコピーしてバックアップを取っておくと安全です。

インストールと設定の引き継ぎ

Antigravity CLIは公式サイトから配布されるインストーラーで導入します。導入後は起動コマンドが agy に変わり、初回はGoogleアカウントでの認証だけで使い始められます。旧環境からの引き継ぎには、プラグイン（旧Extensions）のインポート機能が用意されており、実行すると ~/.gemini/ 配下の設定が新しい形式へ変換されます。正確なインストールコマンドとインポート手順はバージョンによって更新されるため、必ず公式の技術ドキュメントを確認してから実行してください。プロジェクトルールを記述する GEMINI.md や AGENTS.md は、多くの環境でそのまま読み込めると報告されています。

移行でつまずきやすいポイントと対処

実際に移行した人の報告から、つまずきやすい箇所を切り分け表にまとめました。エラーが出たときは、この観点から順に確認すると原因を特定しやすくなります。

特に多いのが1行目の「先にアンインストールしてしまう」ケースです。移行は「インポート→動作確認→旧CLI削除」の順を守ると失敗が減ります。

Antigravity CLIの基本的な使い方

移行が終わったら、新しい環境の使い方を押さえましょう。基本の流れはGemini CLIと大きくは変わりませんが、マルチエージェントの扱いが加わっています。

初回セットアップと認証

初回は agy で起動し、ブラウザが開いてGoogleアカウントの認証を求められます。認証が完了すれば、すぐに対話形式でタスクを依頼できます。プロジェクト単位でルールを持たせたい場合は、作業ディレクトリに AGENTS.md を置いておくと、起動時に自動で読み込まれます。日常的に使うスキルはグローバルに登録しておくと、プロジェクトをまたいで自動で有効になります。

マルチエージェントを活用した実タスク例

Antigravity CLIの持ち味は、複数の作業を同時に進められる点です。たとえば「既存コードのリファクタリング」と「関連ライブラリの調査」を別々のエージェントに割り当て、片方の完了を待たずにもう片方を進める、といった使い方ができます。ビジネス寄りの用途では、次のような分担が現実的です。

• 調査系: 複数の技術記事や仕様を並行して要約させ、比較表のたたき台を作る
• 実装系: 定型的な修正やテストコードの雛形生成をバックグラウンドで走らせる
• ドキュメント系: コードの変更内容から手順書や更新履歴の下書きを作る

一度に多くのエージェントを走らせるほど便利ですが、依頼が曖昧だと出力の精度が落ちます。タスクは「何を・どの範囲で・どんな形式で」まで具体的に指示するのがコツです。

料金と無料でできる範囲

費用対効果を重視する方向けに、無料でどこまで使えるのかを整理します。

個人利用の無料枠

Antigravity CLIは、基本的なCLI機能と個人利用は無料で使えます。Gemini CLIからの移行対象だった個人ユーザーが、追加費用なしで移れるように設計されています。まずは無料の範囲で操作に慣れ、必要になった段階で上位の使い方を検討するのが無理のない進め方です。

有料／API課金が発生するケース

一方で、Vertex AIなどのAPIを本格的に使う構成では、利用量に応じた課金が発生する場合があります。また、組織で使う場合はGemini Code AssistのStandard/EnterpriseライセンスやGoogle Cloud経由のアクセスが前提となり、個人向けとは料金体系が異なります。どこから課金対象になるかは公式の料金ページで最新の条件を確認してください。出典: Google Developers Blog

Antigravity CLIとほかのAIコーディングツールの使い分け

Antigravity CLIが自分に合うかは、ほかのツールと比べると判断しやすくなります。ここでは代表的な選択肢との違いを整理します。

Claude Codeとの違い

同じターミナル型のエージェントとしてはClaude Codeが代表的です。どちらもコマンドラインからAIに作業を任せられますが、Antigravity CLIはGoogleアカウントと連携し、無料の個人枠から始めやすいのが特徴です。すでにGoogleのエコシステム（Gemini、Google Cloud）を使っているなら移行の相性が良く、Claude系のモデルを主に使いたいならClaude Codeという整理になります。両者の性格の違いはAIコーディングツールの比較記事もあわせて読むと立体的に把握できます。

Cursorなどエディタ一体型との違い

ターミナル型に対して、エディタとAIが一体化したタイプもあります。コードを目で追いながら少しずつ直したい人には、Cursorのようなエディタ一体型が向きます。逆に、複数の作業をまとめて背後で進めたい・ターミナル中心で開発したい人にはAntigravity CLIのマルチエージェントが向きます。Gemini自体の基本的な使い方から確認したい場合はGoogle Geminiの使い方も参考になります。

まとめ｜移行は「引き継ぎ→確認→削除」の順で

Antigravity CLIへの移行は、旧Gemini CLIの設定を引き継いでから動作確認し、最後に旧CLIを削除する、という順番さえ守れば大きくつまずくことはありません。起動コマンドは agy に変わり、複数エージェントを並行して動かせる点が新しい強みです。個人利用の基本機能は無料で使えるため、まずは無料の範囲で操作に慣れ、必要に応じてAPI連携や上位の使い方へ広げていくとよいでしょう。正確なコマンドや料金の最新条件は、必ず公式ドキュメントで確認してから進めてください。