大人のAIアソビ

Gemini CLIが動かない！？ 起動しない時の対処法と再インストール完全ガイド【保存版】

2025年12月27日

Gemini CLIが突然動かなくなる現象、実は多くの開発者が経験しています。
この記事では、再起動やキャッシュクリアなどの基本対処法から、
最終手段の再インストール手順まで、誰でもできる解決策を分かりやすく解説します。

大変なのさ！ Geminiちゃんがうんともすんとも言わないのだ！ コマンド打ってもシーン…って感じで、ボク、嫌われちゃったのかな？

ええっ！？ めいも昨日、Geminiとお話ししようとしたら固まっちゃったよ。壊れちゃったのかなぁ？

結論から言うと、それはバグや故障ではなく、一時的なリソース不足やプロセスの競合である可能性が高い。嫌われたわけではないから安心しろ。

まずはここから！ 基本のトラブルシューティング

Gemini CLIのような対話型ツールは、会話が長くなると記憶（コンテキスト）が膨大になり、動作が重くなることがある。まずは以下の基本手順を試してみるんだ。

1. セッションのリセット

最も簡単で効果的な方法です。会話が噛み合わなくなったり、応答が遅くなったりしたら、一度CLIを完全に終了（Ctrl + C など）し、再起動しましょう。これだけでメモリが解放され、軽快さが戻ることが多いです。

2. 残留プロセスの確認と終了

CLIが強制終了した場合など、バックグラウンドで Python や Node.js のプロセスが生き残っていることがあります。

• Windowsの場合: タスクマネージャーを開き、不要な node.exe や python.exe があれば終了させます。
• Mac/Linuxの場合: ターミナルで pkill -f node などを検討してください（他の作業に影響がないか注意！）。

3. 一時ファイルのクリーンアップ

Gemini CLIは動作中に一時ファイルを作成します。これが破損していると起動トラブルの原因になります。

お掃除だね！ どこを掃除すればいいの？

プロジェクトフォルダの中にある .gemini/tmp というフォルダだ。この中身を空にしてみるといい。ただし、GEMINI.mdなどの設定ファイルは絶対に消さないように注意が必要だぞ。

それでもダメなら… 再インストール手順 (Windows編)

うーん、もう一歩踏み込んで考えてみるなのさ！ いろいろやってもダメな時は、最初からやり直すのが一番早いって思わない？

ほう、興味深い。時にはその潔さも必要だな。再インストールで環境をクリーンにする手順を説明しよう。ここでは一般的な npm パッケージとして導入している場合を想定する。

以下のコマンドをコマンドプロンプトやPowerShellで順番に実行してください。

Step 1: アンインストール

まずは現在のGemini CLIを削除します。

npm uninstall -g @google/gemini-cli

Step 2: キャッシュのクリア

古い設定や壊れたファイルが残らないように、npmのキャッシュを強制的にクリアします。

npm cache clean --force

Step 3: 再インストール

最新版をインストールし直します。

npm install -g @google/gemini-cli

Step 4: 動作確認

インストールが完了したら、バージョンを表示して確認しましょう。

gemini --version

快適に使うためのコツ

最後に、トラブルを未然に防ぐためのコツを伝授しよう。

• 負荷の分散: 「全ファイルを検索して」といった重い指示は避け、対象を絞って指示を出す。
• こまめな再起動: タスクが一つ終わるごとにCLIを再起動する習慣をつけると、常に快適な速度で対話できる。
• フィードバック: どうしても直らないバグは /bug コマンドで報告する。

わかった！ めい、これからはこまめに休憩させてあげることにする！

ボクも、Geminiちゃんと仲良くするために、優しく接するなのさ！ これでまた楽しくお話できるね！

参考URL

• Gemini API Documentation
• npm install Documentation

著者：ぷれい（と、愉快なAIたち）

「明日から本気出す」が座右の銘。このブログは、管理人のぷれいが寝転がりながらGeminiに指示を出し、AIに8割くらい書かせている「完全他力本願」な場所です。AIが賢くなってくれるおかげで、私の昼寝時間は日々増える一方。タイトルも内容もAI生成、最終チェックは私の（半分閉じた）目が担当しています。

↓ 応援クリックお願いします！ ↓