Gemini CLI終了後の移行ガイド｜アンインストール手順とClaude Code・Codex CLIへの乗り換え方法【2026年版】

AI & Next Tech
スポンサーリンク
スポンサーリンク

はじめに

Gemini CLI は 2026年6月18日をもってサービス終了しました。 現在は新規インストールはもちろん、既存の認証も通らず実質的に利用できません。

「PCに入れたままの gemini コマンドをどう消せばいいのか分からない」「Gemini CLIで組んでいたワークフローを、この機会にどこへ移行すればいいのか」——本記事では、この2つの疑問に一気に答えます。

具体的には、①まず自分の状況を診断してから該当するパターンだけ対応するアンインストール手順と、②Claude Code・Codex CLIへの移行先の選び方・乗り換え手順をセットで解説します。実際には「npmパッケージがまだ残っている人」「本体は消えているのに設定フォルダだけ残っている人」「そもそも別製品（Gemini Code Assist）と混同している人」など状況が人によってかなり異なるため、いきなり手順を実行するのではなく、まず現状を診断することから始めます。

スポンサーリンク

Gemini CLI終了の経緯——いつ・何が起きたか

Gemini CLIはGoogleが2025年に公開したオープンソース（Apache-2.0）のターミナル型AIエージェントで、Googleアカウントのみで無料利用できる点や、デフォルトで100万トークンのコンテキストウィンドウを扱える点が強みでした。

しかし、2026年6月18日にサービス終了が発表・実施され、現在は一切利用できなくなっています。 無料枠の提供に伴う運用コストや、他のGoogle AI製品群との統合方針の見直しが背景にあると見られていますが、Google側から詳細な理由は明確に公表されていません。

当ブログでも以下の記事で終了の事実を追記済みです。Gemini CLIの機能・使い方の詳細な記録として参照したい方はあわせてご覧ください。

サービス終了に伴い、gemini コマンドは起動できても認証エラーで先に進めない状態になっています。ただし、実際に何がPCに残っているかは人によってかなり差があります。いきなり削除コマンドを打つ前に、まず自分の状況を診断しましょう。

スポンサーリンク

まず自分の状況を診断する

「Gemini CLI」と「Gemini Code Assist」は別物

片付けを始める前に押さえておきたい大前提があります。Google製のGemini関連ツールには、名前がよく似た別製品が存在します。

Gemini CLI（本記事の対象）Gemini Code Assist
形態ターミナルで動くAIエージェントVS Code拡張機能（google.geminicodeassist）
インストール方法npm install -g @google/gemini-cli などVS Code拡張機能マーケットプレイスから導入
今回の終了アナウンス対象（2026年6月18日サービス終了）対象外（別製品・別ライフサイクル）

「Gemini CLIを使っていたはずなのに、npmにもPATHにも見当たらない」という場合、実際に使っていたのはGemini Code Assist（VS Code拡張）だった、というケースは珍しくありません。まずはどちらを（あるいは両方）使っていたのかを切り分けましょう。

診断コマンド

以下を実行し、自分がどのパターンに当てはまるか確認してください。

# ① Gemini CLI本体が今もPATH上に存在するか
where gemini          # Windows（コマンドプロンプト。PowerShellでも可）
which gemini          # Mac/Linux

# ② npmのグローバルインストール一覧にあるか
npm list -g --depth=0 | findstr gemini   # Windows
npm list -g --depth=0 | grep gemini      # Mac/Linux

# ③ 設定・認証情報のフォルダが残っているか
dir "%USERPROFILE%\.gemini"    # Windows
ls -la ~/.gemini                # Mac/Linux

# ④ VS Code拡張機能としてGemini Code Assistを導入していないか
code --list-extensions | findstr -i gemini   # Windows
code --list-extensions | grep -i gemini      # Mac/Linux

npm uninstall -g @google/gemini-cli をいきなり実行しても、対象が存在しない場合はup to dateとだけ表示されて何も削除されません。これは「エラー」ではなく「そもそも無かった」というnpmの正常な反応なので、慌てず①〜④の結果で状況を判断してください。

診断結果から該当パターンを選ぶ

①②（CLI本体）③（設定フォルダ）あなたのパターン
見つかる-パターンA：CLI本体がまだ残っている
見つからない見つかるパターンB：本体は消えているが設定だけ残っている
見つからない見つからないパターンC：すでにきれいな状態（対応不要）

④でgoogle.geminicodeassistが見つかった場合は、上記とは別に後述の「Gemini Code Assistを使っていた場合」もあわせて確認してください。

アンインストール手順

パターンA：CLI本体がまだ残っている場合

where gemini や npm list -g で見つかった場合は、以下の手順で本体・設定ファイル双方を削除します。

Step 1: npmパッケージ本体のアンインストール（共通）

# アンインストール実行
npm uninstall -g @google/gemini-cli  # グローバルインストールされたGemini CLI本体を削除

# 削除確認（何も表示されなければ削除完了）
npm list -g @google/gemini-cli

Step 2: 設定ファイル・認証情報の削除（Windows）

npm本体を消しても、設定ファイルや認証キャッシュはホームディレクトリに残り続けます。

# ユーザー単位の設定・認証情報（settings.json、OAuth認証キャッシュなどを含む）
Remove-Item -Recurse -Force "$env:USERPROFILE\.gemini"  # ~/.gemini フォルダを丸ごと削除

# システム全体の初期設定ファイルが残っている場合（管理者権限で導入していたケース）
Remove-Item -Recurse -Force "C:\ProgramData\gemini-cli"  # システム共通設定が入っていた場合のみ削除

Step 3: 設定ファイル・認証情報の削除（Mac / Linux）

# ユーザー単位の設定・認証情報を削除
rm -rf ~/.gemini  # ~/.gemini 配下（settings.json、.env、OAuth認証キャッシュ）を削除

# システム全体の初期設定ファイルが残っている場合（Homebrew等で管理者導入していたケース）
sudo rm -rf "/Library/Application Support/GeminiCli"  # macOSのシステム共通設定を削除

Step 4: 環境変数（APIキー）の削除

GEMINI_API_KEY をシェルプロファイルに直書きしていた場合は、そちらも忘れずに削除します。

# Mac/Linux: ~/.zshrc や ~/.bashrc から該当行を手動削除、またはコメントアウト
# 例: export GEMINI_API_KEY="xxxxx" の行を削除後、設定を再読み込み
source ~/.zshrc  # シェル設定を再読み込みして反映
# Windows: ユーザー環境変数からGEMINI_API_KEYを削除
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", $null, "User")  # 環境変数を削除（$nullを設定すると削除扱いになる）

パターンB：本体は消えているが設定フォルダだけ残っている場合

実はこちらが見落としやすいケースです。npmパッケージ自体は何らかの理由（以前に一度アンインストール済み・npmキャッシュのクリア・Node.js環境の入れ替えなど）ですでに無くなっているのに、~/.geminiフォルダだけがホームディレクトリに残り続けている、という状態です。

このパターンではStep1〜4は不要で、設定フォルダの削除だけで完了します。

# Windows
Remove-Item -Recurse -Force "$env:USERPROFILE\.gemini"
# Mac/Linux
rm -rf ~/.gemini

フォルダ内のoauth_creds.jsonには有効なOAuth認証情報が含まれています。サービス終了後は使い道がないため、セキュリティの観点からも削除しておくことを強くおすすめします。

Gemini Code Assist（VS Code拡張）を使っていた場合

これはGemini CLIとは別製品であり、今回のサービス終了アナウンスの対象ではありません。継続して使いたい場合はそのままで問題ありません。不要であれば、npmのような特殊な手順は不要で、通常のVS Code拡張機能と同じ方法でアンインストールできます。

VS Code → 拡張機能タブ → 「Gemini Code Assist」を検索 → アンインストール

設定・データの退避（必要な場合）

パターンAで完全に削除する前に、以下のデータは移行先で再利用できる可能性があるため、削除前に確認・退避しておくことをおすすめします。なお GEMINI.md は ~/.gemini ではなく各プロジェクトのルートフォルダに置かれているため、上記のアンインストール手順（ホームディレクトリの.gemini削除）では消えません。プロジェクトごとに個別に確認してください。

退避を検討すべきもの:
1. GEMINI.md（プロジェクトルール）
   → CLAUDE.md や AGENTS.md に書き換えて移行先で再利用可能
   → 「すべてのやり取りは日本語で行うこと」等のルールはそのまま流用できる

2. .gemini/commands/ 配下のカスタムスラッシュコマンド定義
   → Claude Codeのカスタムコマンド、Codex CLIのプロンプトテンプレートとして書き直せる

3. .gemini/settings.json 内のMCPサーバー設定
   → Claude Code・Codex CLIともにMCP対応のため、サーバー定義（command / args）はほぼそのまま転用可能

特に GEMINI.md に書いていたプロジェクトルールは、削除前に中身をコピーしておくことを強く推奨します。移行先の設定ファイルに移し替えるだけで、これまで積み上げてきたルールを無駄にせず引き継げます。

移行先の選び方——Claude Code vs Codex CLI

Gemini CLIが担っていた「無料で試せる」「大規模コードベースを一括把握する」というポジションは、残念ながら現在選べる2択のどちらにも完全には存在しません。まずは自分の用途に近い方を選びましょう。

項目Claude CodeCodex CLI
開発元AnthropicOpenAI
月額費用Pro: $20/月〜（定額制）APIキー従量課金、またはChatGPT Plus $20/月〜
得意分野粘り強い自律デバッグ、洗練されたコード品質サンドボックス実行、CI/CD組み込み、ターミナル作業
コンテキストウィンドウ約20万トークン最大100万トークン（gpt-5.3-codex使用時）
サンドボックスなしOSネイティブで完備
IDE統合VS Code + JetBrains（公式）ターミナル中心
音声入力あり（/voice）あり（Realtime Voice V2）
こんな人向け複雑なバグを一発で仕留めたい、コード品質を最優先したいCI/CDに完全自動で組み込みたい、従量課金でも構わない

より詳細な機能比較・ベンチマークスコアは、以下の記事にまとまっています。

簡易診断

Gemini CLIで「無料で気軽に試せる」ことを重視していた
 → 完全な代替はありませんが、Claude CodeのProプラン（$20/月）が最も近い体験です

Gemini CLIで「100万トークンの大規模コンテキスト」を活用していた
 → Codex CLI（gpt-5.3-codex指定時に100万トークン対応）が近い選択肢です

Gemini CLIで「バグ修正・リファクタリングの自律性」を求めていた
 → Claude Codeの粘り強い自律デバッグループが有力候補です

Gemini CLIのワークフローをCI/CDや夜間バッチに組み込んでいた
 → サンドボックス実行に対応するCodex CLIへの移行を検討してください

それぞれへの乗り換え手順

Claude Codeへ移行する場合

Claude Codeは月額定額制のため、まずは無料枠がなくなることを前提に予算を確保した上で導入します。インストールから初回設定までの手順は、以下の記事で30分程度のステップとして詳しく解説しています。

移行時のポイントは、Gemini CLIで使っていた GEMINI.md の内容を CLAUDE.md にコピーし、日本語での対話ルールやコーディング規約をそのまま引き継ぐことです。

# GEMINI.mdの内容を確認しながらCLAUDE.mdを新規作成
# プロジェクトルートに配置すると自動読み込みされる
notepad CLAUDE.md  # Windowsの場合。中身をGEMINI.mdから移植する

Codex CLIへ移行する場合

CI/CDへの組み込みや、サンドボックス環境での完全自動化を重視するならCodex CLIが候補になります。基本機能・料金体系・AGENTS.mdによるプロジェクト設定は以下で解説しています。

Gemini CLIのMCPサーバー設定（.gemini/settings.json の mcpServers）は、Codex CLIの設定ファイルにもほぼ同じ構造で移植できます。command と args の値をそのまま流用できるケースが多いため、退避しておいたJSONを見比べながら移行すると効率的です。

まとめ

Gemini CLIは 2026年6月18日にサービス終了し、現在は利用できません。本記事の要点は以下の通りです。

✅ 「Gemini CLI」と「Gemini Code Assist」は別製品。まずどちらを使っていたか診断する
✅ CLI本体が残っているか（where gemini / npm list -g）、設定フォルダだけ残っているか
   （~/.gemini の有無）で対応するパターンが異なる
✅ 設定・認証情報は ~/.gemini フォルダ（Windowsは %USERPROFILE%\.gemini）に集約されているため
   フォルダごと削除すれば完全にクリーンな状態に戻せる
✅ GEMINI.mdはプロジェクトごとのフォルダに置かれているため、~/.gemini削除では消えない。
   移行先で使う場合はプロジェクトごとに個別に退避する
✅ 移行先は「品質・自律性重視ならClaude Code」「CI/CD・サンドボックス重視ならCodex CLI」で選ぶ

無料で気軽に試せる入口がなくなったのは残念ですが、Claude Code・Codex CLIともに、Gemini CLIとは異なる強みを持つ選択肢です。それぞれのセットアップガイドを参考に、自分のワークフローに合った移行先を選んでみてください。

関連記事：

タグ: #GeminiCLI #Google #サービス終了 #移行ガイド #ClaudeCode #CodexCLI

スポンサーリンク

コメント