# Gemini CLIからAntigravity CLIへの移行ガイド > agyのインストール、設定・プラグイン・環境変数の移行、確認方法、よくあるエラー、地域制限。 Source: https://ailoot.ai/blog/ja/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/ja/gemini-cli-to-antigravity-cli-migration/ Language: ja Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-505bf523996aeb45eb5db7220f61420dcfcf2bf693818fbae72715c199915fa3 2026年5月19日、GoogleはFree、Pro、Ultraのすべてのプランで、旧Gemini CLIを6月18日に終了すると発表しました。このガイドの公開から2週間後には、`gemini`コマンドはリクエストを処理しなくなります。Googleのツールを使い続けるには、`agy`コマンドを使ってGemini CLIからAntigravity CLIへ移行するしかありません。`agy`はGoで作られており、起動は数十倍速くなっています。 CIスクリプト、夜間のcronジョブ、Gemini Code Assist IDE拡張機能など、Gemini CLI上で動いているものがあれば、このガイドでは何も壊さずに一晩で移行する方法を説明します。
モデルの接続方法とAPIの利用方法については、[Ailootのドキュメント](https://ailoot.ai/docs/)で解説しています。
## 2026年6月18日に、具体的に何が使えなくなるのか？
重要なポイント 2026年6月18日、Gemini CLIとVS Code向けGemini Code Assist拡張機能は、Free、Google AI Pro、Google AI Ultraの3種類のユーザーに対するリクエスト処理を停止します。GitHubでのGemini Code Assistの新規インストールも利用できなくなり、既存のものも「数週間以内に」無効化されます。Gemini Enterprise Agent Platform経由の有料APIアクセスとCode Assist Standard/Enterpriseライセンスは、変更なく引き続き利用できます。
これは「プロジェクトの完全終了」ではなく、最も人気のある3つのプランを打ち切るものです。影響を受けるプランは次のとおりです。 | プラン | 提供内容 | 2026年6月18日に起きること | |----|----|----| | Free tier | 制限付きのGemini Code AssistとCLIへのアクセス | 完全に無効化 | | Google AI Pro（月額約\$19.99） | CLIとCode Assistの上限引き上げ | 完全に無効化 | | Google AI Ultra（I/O 2026以降、月額\$100から） | 最も高い上限 | 完全に無効化 | | Gemini Code Assist for GitHub | リポジトリ内でのGoogleによる自動PRレビュー | 新規インストール不可。既存のものも数週間以内に無効化 | | Gemini Code Assist Standard / Enterprise（法人ライセンス） | 法人のGoogle Workspaceアカウント経由 | 変更なく継続 | | Google Cloud経由の有料API（有料Gemini APIキー） | プロジェクトに請求されるリクエスト | 変更なく継続 | Google Developers Blogの公式発表より：

2026年6月18日、Gemini CLIとGemini Code Assist IDE拡張機能は、Google AI Pro、Ultra、Free tierのユーザーに対するリクエスト処理を停止します。

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
ほとんどの個人開発者と同じようにFreeプランを使っていて、「でも有料アカウントを持っている」と考えているなら、APIキーの請求方法を正確に確認してください。AI ProはCloud請求ではなく、個人向けGoogle AIサブスクリプションであり、こちらは無効化されます。有料プロジェクトを使ったCloud請求は無効化されません。 ## GoogleはなぜGemini CLIを終了するのか？
重要なポイント Gemini CLIは、GoogleのGitHubリポジトリにある独立したTypeScript/Node.jsの実験的プロジェクトでした。GoogleはすべてのエージェントツールをGoogle Antigravityという単一のプラットフォームに統合することを決めました。インターフェースは4つあります。Antigravity 2.0（デスクトップアプリケーション）、Antigravity CLI（ターミナル）、Antigravity SDK（Pythonラッパー）、Antigravity IDE（VS Codeのフォーク）です。Antigravity CLIはNode.jsからGoに書き換えられ、数百ミリ秒ではなく数ミリ秒で起動し、数百メガバイトではなく数十メガバイトのメモリを使用します。
旧版の`gemini`は、Node.jsの起動待ちが必要なため「数百ミリ秒」で起動していました。新しい`agy`は単一の静的Goバイナリとして構築され、「数ミリ秒」で起動します。1回の実行でCLIを何百回も呼び出すCIやスクリプトでは、この差は大きな意味を持ちます。 速度とその理由について、Googleは次のように説明しています。

Antigravity CLIはGoで構築され、より高速に動作し、非同期のバックグラウンドワークフローをサポートします。

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
Gemini CLIの主な機能はすべて移行されています。 - **Agent Skills** — `.gemini/skills/`フォルダーは`.agents/skills/`に移りました。 - **Hooks** — 同じイベント（`PreToolUse`、`PostToolUse`など）に対応し、構文もほとんど変わっていません。 - **Subagents** — 以前と同じように動作し、設定も自動で移行されます。 - **Extensions** — Antigravityプラグインに名称が変わり、1つのコマンドでインポートできます。 シームレスに移行できなかったものは、MCPサーバーと、`.gemini/config.json`に直接アクセスする古いスクリプトです。GitHubのディスカッションによると、MCP設定が壊れ、手作業で書き直す必要があると報告しているユーザーもいます。これについては後述の専用セクションで説明します。 GoogleはGemini CLIのオープンソースプロジェクトを終了しません。

リポジトリはApache 2.0ライセンスのもとでGitHubに引き続き公開され、オープンソースプロジェクトとしての開発も続けます。

— Google Developers Blog (Discussion #27274)
つまり、フォークして自分のGemini APIキーで使い続けることはできます。ただし、これはCloud請求を使う有料の構成になります。無料のCode Assistの利用形態は終了します。 ## Antigravity CLIのインストール方法：macOS、Linux、Windows向けコマンド
重要なポイント GoogleのインストーラーはOSとアーキテクチャを自動検出し、バイナリをダウンロードして、`~/.local/bin`（Linux/macOS）または`C:\Users\[your_name]\AppData\Local\agy\bin`（Windows）に配置します。OSによってコマンドが異なります。macOSとLinuxでは`curl`を使う1行コマンド、WindowsではPowerShellの`irm`かCMDの方法を使います。インストール後、インストーラーが設定していなければパスを`PATH`に追加し、新しいターミナルを開いて`agy doctor`を実行します。これはバイナリが見つかるか、Googleに接続できるかを確認します。
始める前に簡単に確認してください。どのプランを利用していますか？6月18日の期限がない有料Cloudプロジェクトを使っているなら、移行は役立ちますが急ぐ必要はありません。Free/Pro/Ultraを利用していてCLI上で動いているものがあれば、各プランがまだ有効なうちに切り替えて、同じタスクで動作を比較しましょう。 ### macOSとLinux `curl`を使う1行コマンド： ```bash curl -fsSL https://antigravity.google/cli/install.sh | bash ``` スクリプトはプラットフォームを検出し、`agy`バイナリをダウンロードしてチェックサムを確認し、`~/.local/bin`に配置します。このフォルダーが`PATH`にない場合は、追加してください。 ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` バイナリが見つかることを確認します。 ```bash which agy agy --version ``` ### Windows（PowerShell） ```powershell irm https://antigravity.google/cli/install.ps1 | iex ``` バイナリは`C:\Users\[your_name]\AppData\Local\agy\bin`にインストールされます。インストーラーがPATHを自動更新しますが、変数を再読み込みするため、新しいPowerShellウィンドウを開いてください。 ### Windows（CMD） 企業のポリシーでPowerShellがブロックされている場合： ```cmd curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd ``` ### インストールを確認する どのOSでも、インストール後に次を実行します。 ```bash agy doctor ``` このコマンドは、バイナリのバージョン、設定ファイルの有無、認証、`antigravity.google`へのネットワークアクセスを確認します。Googleに接続できない場合、問題は地域またはプロキシにあります。 ### 認証 引数なしで初めて`agy`を実行すると、セットアップウィザードが起動します。 1. インターフェースのテーマを選択します。 2. 認証方法を選択します。個人アカウント用のGoogle OAuth、またはAPIキーです。 3. 必要に応じて、`.gemini/`の設定をその場でインポートします。 OAuthを選択するとブラウザーが開き、`accounts.google.com`にリダイレクトされます。データ共有への同意が必要です。その後、CLIを使えるようになります。 ## .geminiから.agentsへ設定とプラグインを移行する方法
重要なポイント Antigravity CLIは、プロジェクト内の`.agents/`と、グローバルな`~/.agents/`から設定を読み込みます。Gemini CLIが`.gemini/`から設定を読み込むのと同じです。移行には`agy plugin import gemini`という1つのコマンドを使います。このコマンドは`.gemini/extensions/`を確認してAntigravityプラグインとして移行し、設定形式を更新します。skillsフォルダーは手動で移動します。`mv .gemini/skills/ .agents/skills/`を実行してください。その後、`agy doctor`と`agy inspect`を使うと、認識されたもの、されなかったもの、重複箇所を確認できます。
手順は次のとおりです。 1. ### agy plugin import gemini このコマンドはどのフォルダーからでも実行できます。グローバルプラグインを`~/.gemini/`から`~/.agents/`へ移行します。ワークスペースのプラグイン（プロジェクト内にあるもの）を移行するには、プロジェクトフォルダー内でコマンドを実行してください。 2. ### mv .gemini/skills/ .agents/skills/ フォルダー名を手動で変更してskillsを移動します。内部のファイル形式は同じなので、Markdownを書き直す必要はありません。 3. ### agy inspect 有効なプラグイン、skills、hooks、subagentsを表示します。Gemini CLIで使っていた一覧と比較し、漏れがないことを確認してください。 4. ### agy config --edit 既定のエディター（`$EDITOR`）で設定を開きます。自動で取り込まれなかったものがあれば、手動で編集してください。 5. ### agy doctor 最終確認では、バイナリ、認証、プラグイン、ネットワークを確認します。4項目すべてが緑色なら、設定の移行は完了です。 見落としがあった場合に備えて、古い`.gemini/`フォルダーは1か月ほどバックアップとして残しておくとよいでしょう。Antigravityを1週間使い、すべて揃っていることを確認したら、削除できます。 [AGENTS.mdをすべてのAIツールで使える共通設定として利用している](https://ailoot.ai/blog/ja/agents-md-guide-template/)場合は、変更する必要はありません。Antigravity CLIはClaude CodeやCodexと同じフォルダーから`AGENTS.md`を読み込みます。 ## 変更が必要な環境変数は？
重要なポイント CI/CDスクリプト、GitHub Actions、ローカルの`.env`ファイル、dotfilesで`GEMINI_API_KEY`などの変数を渡している場合は、変数名を変更する必要があります。`GEMINI_`という接頭辞は`AV_`（Antigravityの略）に変わりました。Antigravity CLIは古い変数を読み込みません。
置き換え一覧： | 古い変数（Gemini CLI） | 新しい変数（Antigravity CLI） | 既定値 | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Google公式エンドポイント | シークレットを渡しているGitHub Actionsがある場合は、`Settings -> Secrets -> Actions`を開き、キー名を変更してください。値そのものは変わりません（移行中にGoogle APIキーは変更されていません）。 `GEMINI_`を含む可能性のある場所をすべて確認します。 ```bash # プロジェクト全体の記述を検索 grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null # dotfiles内 grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null ``` 置き換え後、ターミナルを再起動し、秘密情報を表示せずに変数の有無を確認します。シェルのトレースを有効にせず、値をログへコピーしないでください。変数があるだけでは認証の証明にならないため、`agy doctor`で別途調べます。 ```bash if [ -n "${AV_API_KEY:-}" ]; then printf 'AV_API_KEY is set\n' else printf 'AV_API_KEY is missing or empty\n' fi agy doctor # should show “authorized” ``` ## 移行時によく起こる問題とその解決方法
重要なポイント GitHubのディスカッションによると、最もよくある問題は、`~/.gemini/config.json`で定義したMCPサーバーが自動的に引き継がれず、設定をAntigravity形式に書き直す必要があることです。古い環境変数を使うカスタムhooksはエラーを表示せずに失敗するため、テストが明確なエラーなしで失敗します。CLI経由ではなく`.gemini/`に直接アクセスするスクリプトは、`.agents/`を使うように変更する必要があります。ファイルをコンテキストに読み込む`@[file]`コマンドには、Antigravity CLIの初期ビルドでバグがありました。最近のビルドでは修正されていますが、古いバージョンを使っている場合は更新してください。
初期に起こる問題のチェックリスト： 1. **MCPサーバー。** `.gemini/config.json`で`mcp_servers`を使っていた場合、`agy plugin import gemini`の後に引き継がれていない可能性があります。`agy inspect`で確認してください。`mcp`セクションが空、またはエラーが表示される場合は、`agy config --edit`で手動で書き直します。形式についてはAntigravityの公式ドキュメントにあるMCPセクションを参照してください。 2. **カスタムhooks。** `.gemini/hooks/`に`$GEMINI_API_KEY`を読み込むbashスクリプトがあった場合、動作しなくなります。次のコマンドで該当箇所を探します。bash ``` grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null ``` 変数を置き換えてください。 3. **CI/CD。** GitHub ActionsやGitLab CIで`gemini`コマンドを使っている手順を`agy`に変更します。インストーラーでのバイナリ名が異なる場合があるため、`$CLI_CMD`変数を使った抽象化を作成してください。 4. **IDE拡張機能。** VS Code用Gemini Code Assist拡張機能はCLIとともに無効化されます。代替は[Antigravity IDE](https://antigravity.google)（別のVS Codeフォーク）、または他のAIエディターで使うAGENTS.mdです。 5. **`@[file]`の読み込み。** 初期のAntigravity CLIビルドでは、`@src/file.ts`コマンドでファイルをコンテキストに読み込む際にバグがありました。最新版の`agy update`に更新してください。 重大な問題が起こり、1時間以内に解決できない場合、Freeプラン向けの一時的な方法として、6月18日までGemini CLIを使い続けながら、別のリポジトリブランチで移行を準備できます。期限は14日です。 ## 6月18日以降もGoogleのツールを使う価値はあるか？
重要なポイント Antigravity CLIはより速く起動し、Gemini 3.5 Flashに対応し、`agy --background`で並列エージェントと非同期のバックグラウンドタスクをサポートします。ただし、地域によるアクセス制限と、成熟途上のエコシステム（Claude CodeよりプラグインやMCPサーバーが少ない）という2つの懸念があります。Antigravityを主なツールとして使うことは勧めません。バックグラウンドで並列タスクを実行するための予備の経路として使い、主な開発作業はClaude Codeで続けるのがよいでしょう。FreeプランでGemini CLIを使っていたなら、6月18日はツール一式を見直すよい機会です。
Antigravity 2.0は、主要ツール（Claude CodeまたはCodex）が適さない場合の予備として検討できます。得意なことと苦手なことの詳しい説明は、[Google Antigravity 2.0のガイド](https://ailoot.ai/blog/ja/google-antigravity/)を参照してください。 状況ごとの対応を簡単にまとめます。 | 状況 | 6月18日までにすること | |----|----| | FreeのGemini CLIを実験に使っていた | サービスにアクセスできるアカウントでAntigravity CLIへ移行するか、予算に応じてClaude/Codexに切り替える | | IDEでGemini Code Assistを使っていた | Antigravity IDEに切り替えるか、VS Code + Claude Codeに戻る | | FreeプランのGemini APIで夜間cronジョブを動かしていた | 無効化されない有料Cloud API向けに急いで書き換えるか、Claude APIに移行する | | 法人Cloud（Standard/Enterprise）経由で利用している | 対応不要。今回の終了の影響はありません | | 「無料だから」という理由だけでGemini CLIを試そうと考えていた | 始めずに、[Claude Code](https://ailoot.ai/blog/ja/claude-code/)または[Codex](https://ailoot.ai/blog/ja/codex-vs-claude-code-choice/)を使いましょう | ## 15分でできる移行チェックリスト
重要なポイント ガイド全体を読まずに最短で移行したい場合は、次の手順を実行してください。Geminiのスクリプトが動いていない新しいターミナルから始めれば、移行全体にかかる時間は10〜20分です。
1. ### Antigravity CLIをインストールする `curl -fsSL https://antigravity.google/cli/install.sh | bash`（macOS/Linux）、または`irm https://antigravity.google/cli/install.ps1 | iex`（Windows PowerShell）。 2. ### agyを起動して認証する 引数なしで`agy`を実行します。OAuthまたはAPIキーを選択します。 3. ### .geminiからプラグインをインポートする `agy plugin import gemini`を実行すると、拡張機能がグローバルに移行されます。ワークスペースのプラグインを移行するには、プロジェクトフォルダー内でもう一度実行してください。 4. ### skillsを移動する `mv .gemini/skills/ .agents/skills/`を実行します。ファイルの内容はそのままです。 5. ### 環境変数を置き換える `~/.zshrc`/`~/.bashrc`と`.env`ファイル内で、`GEMINI_API_KEY → AV_API_KEY`、`GEMINI_PROJECT_ID → AV_PROJECT_ID`、`GEMINI_REGION → AV_REGION`に置き換えます。ターミナルを再起動してください。 6. ### インストールを確認する `agy doctor`を実行します。4項目（バイナリ、認証、プラグイン、ネットワーク）がすべて緑色になっていることを確認してください。 7. ### テストタスクを実行する `agy "write a README for the project in the current folder"`を実行し、Gemini CLIで生成した結果と同じような内容になるか確認します。 8. ### GitHub Actions / GitLab CIを更新する コマンド名とシークレットを`GEMINI_*`から`AV_*`に変更します。 9. ### .gemini/をバックアップとして残す すべて動くことを確認してから1〜2週間後に削除できます。 最後に、6月18日は「すべてのプロジェクトが停止する」という意味ではありません。無効化されるのは無料での利用経路です。有料Cloud APIアクセスは引き続き利用でき、Gemini CLIのリポジトリも残り、フォークも可能です。Freeプランを使っていた場合は6月18日までに決める必要があります。そうしなければ、次に`gemini "something"`を実行した際に認証エラーが返されます。
### 出典 - [Google Developers Blog - 重要なお知らせ：Gemini CLIからAntigravity CLIへの移行](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - はじめに](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - GitHubリポジトリ](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Google I/O 2026の開発者向けハイライト](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
[Ailoot](https://ailoot.ai/)でAIを使った作業を続けましょう。
## Gemini CLIからAntigravity CLIへの移行ガイド：よくある質問 ### 名前を変えたAPIキー変数を、値を出さずに確認するには？ `${AV_API_KEY:-}`が空でないかを調べ、設定済みか未設定かだけを表示します。キーをechoしたり、シェルのトレースを有効にして実行したりしないでください。認証状態は`agy doctor`で別に確認します。 ### 設定のインポートが成功すれば移行は完了ですか？ いいえ。有効なプラグイン、スキル、フック、サブエージェントを旧設定と比較し、MCP設定を確認して小さなタスクを実行します。意図した流れと成果を検証するまで、旧`.gemini/`設定を残してください。 ## Ailoot · 企業とそのプロジェクト群 Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。 企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。 Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。