GeminiCLI.net

WindowsおよびLinuxにGemini CLIをインストールするための究極のガイド

blog.postMeta

新しい強力なコマンドラインツールの使用を開始するのは、特に環境設定に関しては、時に気が引けることがあります。このガイドでは、WindowsまたはLinuxマシンで公式のGemini CLIをスムーズに実行するための、明確で分かりやすい手順を提供します。

前提条件:Node.jsとnpm

Gemini CLIはNode.jsパッケージとして配布されているため、まずシステムにNode.jsとそのパッケージマネージャーであるnpmがインストールされている必要があります。

  • インストールされているか確認するには: ターミナル(コマンドプロンプト、PowerShell、またはLinuxターミナル)を開き、node -vnpm -vを実行します。バージョン番号が表示されれば準備完了です!
  • インストールするには: インストールされていない場合は、公式Node.jsウェブサイトにアクセスし、お使いのオペレーティングシステム用のLTS(長期サポート)バージョンをダウンロードすることを強くお勧めします。インストーラーがすべてを処理してくれます。

ステップ1:Gemini CLIパッケージをインストールする

Node.jsとnpmの準備ができたら、Gemini CLIのインストールは1つのコマンドで完了します。-gフラグは、パッケージをシステムに「グローバルに」インストールするため重要であり、これによりgeminiコマンドがどのディレクトリからでもアクセス可能になります。

ターミナルを開き、次のコマンドを実行します:

npm install -g @google/generative-ai

このコマンドはnpmレジストリからパッケージをダウンロードし、システムにセットアップします。

代替案:インストールなしでのクイックスタート(npx)

パッケージをグローバルにインストールしたくない場合や、単にすぐに試してみたい場合は、npxを使用できます。npmにバンドルされているこのコマンドは、システムに永続的にインストールすることなく、パッケージを一時的にダウンロードして実行します。

geminiコマンドの前にnpx @google/generative-aiを付けるだけです:

npx @google/generative-ai "これまでに発見された最も遠い銀河は何ですか、そしてそれはどれくらい遠いですか?"

これはすぐに始めるための素晴らしい方法です。このガイドの残りでは、グローバルインストールを実行したと仮定します。

ステップ2:Google AI APIキーを取得する

CLIを使用するには、Google AI APIキーで認証する必要があります。このキーは、誰がリクエストを行っているかをGoogleに伝えます。まだ持っていない場合は、「3つの簡単なステップでGoogle Gemini APIキーを取得する方法(2025年ガイド)」という完全なチュートリアルがあり、そのプロセスを案内します。

キーを取得したら、クリップボードにコピーして次のステップに進みます。

ステップ3:APIキーを設定する

geminiコマンドがAPIキーにアクセスできるようにする必要があります。これを行う最も安全で推奨される方法は、環境変数を設定することです。

LinuxおよびmacOSの場合

  1. シェルの設定ファイルを開きます。これは通常、~/.bashrc~/.zshrc(macOSを含むほとんどの最新システム)、または~/.profileです。

  2. ファイルの末尾に次の行を追加します。YOUR_API_KEYをコピーした実際のキーに置き換えることを忘れないでください。

    export GOOGLE_API_KEY="YOUR_API_KEY"
  3. ファイルを保存してターミナルを再起動するか、source ~/.zshrc(またはそれぞれのファイル)を実行して変更をすぐに適用します。

Windowsの場合

  1. スタートメニューで「環境変数」を検索し、「システム環境変数の編集」を選択します。
  2. 「システムのプロパティ」ウィンドウで、「環境変数...」ボタンをクリックします。
  3. 上部の「ユーザー環境変数」セクションで、「新規...」をクリックします。
  4. 「変数名」にGOOGLE_API_KEYと入力します。
  5. 「変数値」に、以前にコピーしたAPIキーを貼り付けます。
  6. すべてのウィンドウで「OK」をクリックして保存します。

ビデオウォークスルー

視覚的なガイドとして、これらの短いビデオがプロセスの主要なステップをカバーしています。

1. グローバルNPMパッケージのインストール方法:

2. Windowsで環境変数を設定する方法:

ステップ4:インストールを確認する

これで準備完了です!すべてが正しく機能していることを確認するために、ターミナルで簡単なテストコマンドを実行します:

gemini "これまでに発見された最も遠い銀河は何ですか、そしてそれはどれくらい遠いですか?"

インストールが成功した場合、Geminiモデルから詳細な回答が返されるはずです。おめでとうございます、Gemini CLIのインストールと設定が正常に完了しました!


トラブルシューティングのヒント

  • command not found: gemini:これは通常、グローバルnpmインストールディレクトリがシステムのPATHに含まれていないことを意味します。Node.jsインストーラーがこれを処理するはずですが、そうでない場合は手動で追加する必要があるかもしれません。
  • 認証エラー:認証に関するエラーが表示された場合は、GOOGLE_API_KEY環境変数が正しく設定されているか、タイプミスがないかを再確認してください。設定後にターミナルを再起動したことを確認してください。

これで、コマンドラインからAIの全能力を探求する準備ができました。他のチュートリアルやユースケースをチェックして、何が構築できるか見てみましょう!

SocialShare.shareArticle