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 は、多くの環境でそのまま読み込めると報告されています。
移行でつまずきやすいポイントと対処
実際に移行した人の報告から、つまずきやすい箇所を切り分け表にまとめました。エラーが出たときは、この観点から順に確認すると原因を特定しやすくなります。
| 症状 | 主な原因 | 対処の方向性 |
|---|---|---|
| 設定を引き継げない | 旧Gemini CLIを先にアンインストールした | バックアップした ~/.gemini/ を戻してからインポートを実行 |
agy コマンドが見つからない |
PATHが通っていない／ターミナル未再起動 | ターミナルを開き直し、インストール先がPATHに含まれるか確認 |
| 認証が通らない | 別のGoogleアカウントでログイン済み | 個人向け対象のアカウントで再認証する |
| 拡張機能が動かない | 旧Extensions形式のまま | プラグイン形式へインポート・再登録する |
| 組織アカウントで挙動が違う | Standard/Enterpriseライセンス配下 | 管理者にライセンス種別と移行方針を確認 |
特に多いのが1行目の「先にアンインストールしてしまう」ケースです。移行は「インポート→動作確認→旧CLI削除」の順を守ると失敗が減ります。
【一次情報・2026年9月6日 公式CLIドキュメント確認】インストーラが実際に置くもの（OS別コマンドとバイナリの配置先）
移行でつまずく相談で多いのが「インストールは終わったはずなのに agy が見つからない」というPATHの問題です。手順を書いた解説は増えましたが、公式が示しているコマンドと、バイナリがどこに置かれるかまで載せているものは多くありません。2026年9月6日にAntigravityの公式CLIドキュメントを直接確認し、次のとおり整理しました。
| 環境 | 公式に記載されたインストールコマンド | agy バイナリの配置先 |
|---|---|---|
| macOS / Linux | curl -fsSL https://antigravity.google/cli/install.sh | bash |
~/.local/bin/agy |
| Windows（PowerShell） | irm https://antigravity.google/cli/install.ps1 | iex |
C:\Users\<username>\AppData\Local\agy\bin |
| Windows（コマンドプロンプト） | curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd |
同上 |
この表から読み取れる実務上のポイントは2つあります。ひとつは、macOS/Linuxの配置先が ~/.local/bin だという点です。このディレクトリはシェルの設定によってはPATHに入っていないため、インストール直後に agy が command not found になるなら、まず echo $PATH で ~/.local/bin が含まれているかを見るのが最短の切り分けになります。もうひとつは、Windowsの配置先が AppData\Local 配下、つまりユーザー単位のディレクトリだという点です。管理者権限で別ユーザーとしてインストールすると、普段使っているシェルからは見えないままになります。
あわせて公式ブログでは、移行時に引き継げる資産として Agent Skills・Hooks・Subagents・Extensions（Antigravity側ではプラグインとして扱われる） が名指しで挙げられています。裏を返すと、この4つ以外は引き継ぎ対象として明言されていないため、自作のシェルエイリアスやCIの呼び出しは自分で置き換える前提で見積もっておくほうが安全です。なお組織で Gemini Code Assist の Standard / Enterprise ライセンスを使っている場合は「アクセスは変わらない（remains unchanged）」と明記されており、6月18日の停止対象からは外れます。出典: Google Antigravity Docs「CLI Getting Started」（公式） ／ Google Developers Blog（公式発表）
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
公式ドキュメントで確認した「無料枠の実際」【2026年8月21日時点】
「無料でどこまで使えるのか」は、加入しているGoogle AIプランによってクォータの回復間隔そのものが変わります。ここが分かっていないと「昨日は使えたのに今日は止まる」という状態になります。公式のPlansドキュメントを2026年8月21日に取得して整理しました。
| 加入プラン | クォータの量 | 回復の間隔 | サードパーティ製モデル |
|---|---|---|---|
| AI Pro／Ultraなし（無料で使う場合） | 実用的な量（meaningful quota） | 週次で回復 | 利用不可 |
| Google AI Pro | 多めのクォータ（週上限に達するまで） | 5時間ごとに回復 | 利用不可 |
| Google AI Ultra | 最も多いクォータ・週上限も最大 | 5時間ごとに回復 | 利用可能 |
プランに関係なく共通の基本枠として、Gemini 3.1 Pro・Gemini 3.5 Flashなどのコアモデルの利用、Tab補完（無制限）、スケジュールタスクやCLIを含む全機能へのアクセスが含まれます。つまり「無料だとCLIが使えない」ということはなく、差が出るのは主に使える量と回復の速さです。
もうひとつ注意したいのが、クォータがプロンプト数ではなくエージェントの作業量に連動すると明記されている点です。単純な依頼なら同じ枠でも多く回せますが、大きな改修を丸ごと任せると一気に消費します。無料の週次回復で運用するなら、タスクを小さく割って投げるほうが結果的に多く進みます。
上限を超えた分は、AI Pro／Ultraの利用者のみ購入済みのAIクレジットで継続でき、AI Credit Overages設定を「Never（回復を待つ）」か「Always（自動でクレジットを使う）」から選べます。意図しない消費を避けたいならNeverのままにしておくのが安全です。なお公式には、追加のレート上限を得るためのBYOK（自前APIキー持ち込み）や独自エンドポイントは現時点で非対応と明記されています。出典: Google Antigravity Docs「Plans」（公式）
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連携や上位の使い方へ広げていくとよいでしょう。正確なコマンドや料金の最新条件は、必ず公式ドキュメントで確認してから進めてください。
