WindowsおよびLinuxにGemini CLIをインストールするための究極のガイド
blog.postMeta
新しい強力なコマンドラインツールの使用を開始するのは、特に環境設定に関しては、時に気が引けることがあります。このガイドでは、WindowsまたはLinuxマシンで公式のGemini CLIをスムーズに実行するための、明確で分かりやすい手順を提供します。
前提条件:Node.jsとnpm
Gemini CLIはNode.jsパッケージとして配布されているため、まずシステムにNode.jsとそのパッケージマネージャーであるnpmがインストールされている必要があります。
- インストールされているか確認するには: ターミナル(コマンドプロンプト、PowerShell、またはLinuxターミナル)を開き、
node -v
とnpm -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の場合
-
シェルの設定ファイルを開きます。これは通常、
~/.bashrc
、~/.zshrc
(macOSを含むほとんどの最新システム)、または~/.profile
です。 -
ファイルの末尾に次の行を追加します。
YOUR_API_KEY
をコピーした実際のキーに置き換えることを忘れないでください。export GOOGLE_API_KEY="YOUR_API_KEY"
-
ファイルを保存してターミナルを再起動するか、
source ~/.zshrc
(またはそれぞれのファイル)を実行して変更をすぐに適用します。
Windowsの場合
- スタートメニューで「環境変数」を検索し、「システム環境変数の編集」を選択します。
- 「システムのプロパティ」ウィンドウで、「環境変数...」ボタンをクリックします。
- 上部の「ユーザー環境変数」セクションで、「新規...」をクリックします。
- 「変数名」に
GOOGLE_API_KEY
と入力します。 - 「変数値」に、以前にコピーしたAPIキーを貼り付けます。
- すべてのウィンドウで「OK」をクリックして保存します。
ビデオウォークスルー
視覚的なガイドとして、これらの短いビデオがプロセスの主要なステップをカバーしています。
1. グローバルNPMパッケージのインストール方法:
Video Tutorial: npmパッケージをグローバルにインストールする
2. Windowsで環境変数を設定する方法:
Video Tutorial: Windows 11で環境変数を設定する方法
ステップ4:インストールを確認する
これで準備完了です!すべてが正しく機能していることを確認するために、ターミナルで簡単なテストコマンドを実行します:
gemini "これまでに発見された最も遠い銀河は何ですか、そしてそれはどれくらい遠いですか?"
インストールが成功した場合、Geminiモデルから詳細な回答が返されるはずです。おめでとうございます、Gemini CLIのインストールと設定が正常に完了しました!
トラブルシューティングのヒント
command not found: gemini
:これは通常、グローバルnpmインストールディレクトリがシステムのPATH
に含まれていないことを意味します。Node.jsインストーラーがこれを処理するはずですが、そうでない場合は手動で追加する必要があるかもしれません。- 認証エラー:認証に関するエラーが表示された場合は、
GOOGLE_API_KEY
環境変数が正しく設定されているか、タイプミスがないかを再確認してください。設定後にターミナルを再起動したことを確認してください。
これで、コマンドラインからAIの全能力を探求する準備ができました。他のチュートリアルやユースケースをチェックして、何が構築できるか見てみましょう!