Google が提供する Gemini CLI は、ターミナルから直接 AI と対話できる強力なツールです。macOS ユーザーにとって、Homebrew を活用した導入方法は最もシンプルで確実な選択肢となります。本記事では、Homebrew を使った Gemini CLI のインストールから、PATH 設定、シェル補完の有効化まで、実践的な手順を詳しく解説していきます。

初めて CLI ツールを導入する方でも安心して進められるよう、各ステップを丁寧に説明しますので、ぜひ最後までお読みください。

背景

Gemini CLI とは何か

Gemini CLI は、Google の生成 AI モデル「Gemini」をコマンドラインから利用できる公式ツールです。ブラウザを開くことなく、ターミナル上で質問や指示を送り、即座に AI からの回答を得ることができます。

開発者にとっては、コーディング中にエディタから離れずに AI を活用できる点が大きな魅力ですね。

macOS における CLI ツール管理の現状

macOS では、CLI ツールの管理に以下のような選択肢があります。

mermaidCopy codeflowchart TB
  user["macOS ユーザー"] --> choice{"CLI ツール<br/>導入方法"}
  choice -->|公式| manual["手動ダウンロード<br/>& インストール"]
  choice -->|推奨| homebrew["Homebrew<br/>パッケージ管理"]
  choice -->|言語別| lang["言語固有<br/>パッケージマネージャ"]

  manual --> path1["PATH 設定が必要"]
  homebrew --> path2["PATH 自動管理"]
  lang --> path3["環境ごとに異なる"]

  path1 --> result["管理負担: 高"]
  path2 --> result2["管理負担: 低"]
  path3 --> result3["管理負担: 中"]

図で理解できる要点:

• Homebrew は PATH を自動管理するため、手動設定の手間が省けます
• 複数の CLI ツールを一元管理できるため、バージョン管理やアップデートが容易です
• 公式パッケージとして提供されているツールは、信頼性と安定性が高くなります

Homebrew の利点

Homebrew は macOS における事実上の標準パッケージマネージャとして、以下のメリットを提供します。

• 自動依存解決: 必要なライブラリを自動でインストール
• 簡単アップデート: brew upgrade コマンド一つでバージョン管理
• クリーンアンインストール: 関連ファイルも含めて完全削除が可能

特に Gemini CLI のような新しいツールでは、Homebrew を通じて最新版を常に入手できる点が重要です。

課題

手動インストールの問題点

Gemini CLI を公式サイトからバイナリをダウンロードして手動インストールする場合、いくつかの課題に直面します。

手動インストールで発生する典型的な問題:

#	課題	影響
1	PATH 設定の複雑さ	コマンドが認識されない
2	バージョン管理の困難	アップデート作業が煩雑
3	アンインストール時の残存ファイル	ストレージの無駄遣い
4	依存ライブラリの手動管理	動作不良の原因

特に PATH 設定は、シェルの種類（bash、zsh など）によって設定ファイルが異なるため、初心者がつまずきやすいポイントとなっています。

シェル補完の未設定による非効率性

CLI ツールを導入しても、シェル補完（タブ補完）が有効になっていないと、コマンドやオプションを毎回手入力する必要があります。

mermaidCopy codeflowchart LR
  user["ユーザー"] -->|補完なし| manual_input["コマンド全文<br/>手入力"]
  user -->|補完あり| tab["タブキー押下"]

  manual_input --> error["入力ミス発生"]
  manual_input --> slow["作業速度低下"]

  tab --> complete["自動補完"]
  complete --> fast["効率的な作業"]

  error --> retry["再入力"]
  retry --> manual_input

図で理解できる要点:

• シェル補完がないと、長いコマンドやオプション名を正確に覚える必要があります
• タイプミスによるエラーが頻発し、作業効率が大幅に低下します
• 補完機能を有効化することで、学習コストを下げ、快適な操作環境を実現できます

環境変数と PATH の理解不足

多くのユーザーが PATH の仕組みを正確に理解していないため、以下のようなトラブルが発生します。

よくある PATH 関連のエラー:

bashCopy codezsh: command not found: gemini

このエラーは、Gemini CLI の実行ファイルが配置されているディレクトリが PATH に含まれていないことを示しています。

解決には、シェル設定ファイル（.zshrc や .bash_profile）への正しい記述が必要ですが、どのファイルをどう編集すればよいか分からず、挫折してしまうケースが少なくありません。

解決策

Homebrew による統合管理

Homebrew を使用することで、Gemini CLI の導入に関わるすべての課題を一括で解決できます。

Homebrew 導入による解決内容:

#	課題	Homebrew による解決
1	PATH 設定	自動で ​/​opt​/​homebrew​/​bin を追加
2	バージョン管理	brew upgrade で一括更新
3	クリーンな削除	brew uninstall で完全削除
4	依存解決	必要なライブラリを自動インストール

Homebrew は macOS のシステム領域を汚さず、​/​opt​/​homebrew（Apple Silicon）または ​/​usr​/​local（Intel Mac）配下で一元管理を行います。

シェル補完の標準化手順

Gemini CLI のシェル補完を有効化することで、コマンド入力の効率が劇的に向上します。

mermaidCopy codesequenceDiagram
  participant User as ユーザー
  participant Shell as シェル
  participant Completion as 補完スクリプト
  participant CLI as Gemini CLI

  User->>Shell: "gemini " + Tab キー
  Shell->>Completion: 補完候補をリクエスト
  Completion->>CLI: 利用可能なコマンド問い合わせ
  CLI-->>Completion: コマンドリスト返却
  Completion-->>Shell: 候補を整形して返却
  Shell-->>User: 候補を表示 or 自動補完

図で理解できる要点:

• タブキーを押すと、シェルが補完スクリプトを呼び出します
• 補完スクリプトが Gemini CLI から利用可能なコマンド一覧を取得します
• ユーザーには候補が表示され、再度タブキーで選択・確定できます

ベストプラクティスのワークフロー

Gemini CLI を macOS に導入する際の推奨手順は以下の通りです。

推奨導入フロー:

1. Homebrew のインストール確認・導入
2. Gemini CLI のインストール
3. PATH の自動設定確認
4. シェル補完の有効化
5. 動作確認とテスト

この順序で進めることで、トラブルを最小限に抑え、最短時間で実用環境を構築できます。

具体例

ステップ 1: Homebrew のインストール確認

まず、Homebrew がすでにインストールされているか確認しましょう。

ターミナルを開き、以下のコマンドを実行してください。

bashCopy codebrew --version

コマンドの説明: このコマンドは、Homebrew のバージョン情報を表示します。正常にインストールされていれば、Homebrew 4.x.x のようなバージョン番号が返されます。

Homebrew が未インストールの場合

command not found と表示された場合は、Homebrew をインストールする必要があります。

以下のコマンドで公式インストールスクリプトを実行します。

bashCopy code/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

コマンドの説明:

• curl コマンドで公式インストールスクリプトをダウンロード
• -fsSL オプションでエラー時の詳細表示と進捗非表示、リダイレクト対応を実施
• ダウンロードしたスクリプトを bash で即座に実行

インストール完了後、画面に表示される指示に従って PATH を追加してください。

Apple Silicon Mac での PATH 設定

Apple Silicon（M1/M2/M3）Mac の場合、以下のコマンドを実行します。

bashCopy codeecho 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

コマンドの説明:

• 1 行目: ~​/​.zprofile に Homebrew の環境変数設定を追記
• 2 行目: 現在のシェルセッションに即座に反映

Intel Mac での PATH 設定

Intel Mac の場合は、パスが異なります。

bashCopy codeecho 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

コマンドの説明: Apple Silicon 版と同様ですが、Homebrew のインストール先が ​/​usr​/​local になっている点が異なります。

ステップ 2: Gemini CLI のインストール

Homebrew が正常に動作していることを確認したら、Gemini CLI をインストールします。

bashCopy codebrew install gemini

コマンドの説明:

• brew install コマンドでパッケージをインストール
• gemini は Homebrew のパッケージ名（Formula 名）
• 依存関係を自動解決し、必要なライブラリも同時にインストール

インストールには数分かかる場合がありますので、完了まで待ちましょう。

インストール完了の確認

インストールが完了したら、以下のコマンドでバージョンを確認します。

bashCopy codegemini --version

コマンドの説明: Gemini CLI が正しくインストールされ、PATH が通っていれば、バージョン情報が表示されます。

正常に表示されれば、Gemini CLI の基本的な導入は完了です。

ステップ 3: PATH 設定の確認

Homebrew 経由でインストールした場合、通常は自動で PATH が設定されますが、念のため確認しておきましょう。

bashCopy codeecho $PATH

コマンドの説明: 現在のシェルに設定されている PATH 環境変数の値を表示します。

出力結果に ​/​opt​/​homebrew​/​bin（Apple Silicon）または ​/​usr​/​local​/​bin（Intel）が含まれていれば問題ありません。

PATH が通っていない場合の対処

もし上記のパスが含まれていない場合、以下の手順で設定を追加します。

zsh を使用している場合（macOS デフォルト）:

bashCopy codeecho 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

コマンドの説明:

• 1 行目: ~​/​.zshrc に PATH 設定を追記（Homebrew のパスを先頭に追加）
• 2 行目: 設定ファイルを再読み込みして即座に反映

bash を使用している場合:

bashCopy codeecho 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

コマンドの説明: zsh の場合と同様ですが、bash では設定ファイルが ~​/​.bash_profile になります。

ステップ 4: シェル補完の有効化

Gemini CLI のシェル補完を有効にすることで、コマンド入力が格段に楽になります。

zsh での補完設定

macOS Catalina 以降のデフォルトシェルは zsh です。

まず、Gemini CLI の補完スクリプトを生成します。

bashCopy codegemini completion zsh > ~/.zsh/completions/_gemini

コマンドの説明:

• gemini completion zsh で zsh 用の補完スクリプトを生成
• > でリダイレクトし、~​/​.zsh​/​completions​/​_gemini に保存

補完ディレクトリが存在しない場合は、事前に作成が必要です。

bashCopy codemkdir -p ~/.zsh/completions

コマンドの説明: -p オプションで、親ディレクトリも含めて必要なディレクトリを作成します。

次に、~​/​.zshrc に補完機能を読み込む設定を追加します。

bashCopy codeecho 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc

コマンドの説明:

• 1 行目: 補完スクリプトの配置ディレクトリを fpath に追加
• 2 行目: zsh の補完機能を初期化

設定を反映させるため、シェルを再起動するか、以下のコマンドを実行します。

bashCopy codesource ~/.zshrc

コマンドの説明: 設定ファイルを再読み込みし、補完機能を即座に有効化します。

bash での補完設定

bash を使用している場合は、以下の手順で設定します。

bashCopy codegemini completion bash > ~/.bash_completion.d/gemini

コマンドの説明: bash 用の補完スクリプトを生成し、専用ディレクトリに保存します。

補完ディレクトリを事前に作成します。

bashCopy codemkdir -p ~/.bash_completion.d

~​/​.bash_profile に補完スクリプトを読み込む設定を追記します。

bashCopy codeecho 'for file in ~/.bash_completion.d/*; do' >> ~/.bash_profile
echo '  [ -r "$file" ] && source "$file"' >> ~/.bash_profile
echo 'done' >> ~/.bash_profile

コマンドの説明:

• ~​/​.bash_completion.d​/​ 内のすべてのファイルをループで読み込む
• -r "$file" で読み取り可能なファイルのみを対象にする
• source で各補完スクリプトを読み込む

設定を反映させます。

bashCopy codesource ~/.bash_profile

コマンドの説明: bash の設定ファイルを再読み込みし、補完を有効化します。

ステップ 5: 動作確認

すべての設定が完了したら、実際に Gemini CLI を使って動作確認を行いましょう。

基本的な動作テスト

まず、ヘルプコマンドを実行します。

bashCopy codegemini --help

コマンドの説明: Gemini CLI の使用可能なコマンドとオプション一覧を表示します。

正常に動作していれば、コマンドの説明が表示されます。

シェル補完のテスト

次に、シェル補完が機能しているか確認します。

ターミナルで以下を入力し、タブキーを 2 回押してください。

bashCopy codegemini [Tab][Tab]

期待される動作: 利用可能なサブコマンドやオプションの候補が表示されます。

例えば、gemini chat、gemini config などのサブコマンドが候補として出てくるはずです。

API キーの設定

Gemini CLI を実際に使用するには、Google AI Studio で取得した API キーの設定が必要です。

bashCopy codegemini config set api_key YOUR_API_KEY_HERE

コマンドの説明:

• gemini config set で設定項目を追加
• api_key に取得した API キーを指定
• YOUR_API_KEY_HERE の部分を実際の API キーに置き換える

API キーは Google AI Studio で無料で取得できます。

実際の使用例

API キーの設定が完了したら、実際に Gemini と対話してみましょう。

bashCopy codegemini chat "Hello, Gemini!"

コマンドの説明:

• gemini chat で対話モードを起動
• クォート内のメッセージを Gemini に送信
• AI からの応答がターミナルに表示される

正常に動作すれば、Gemini からの返答がターミナルに表示されます。

トラブルシューティング

導入中によく遭遇するエラーと解決方法をまとめました。

Error: command not found: gemini

エラーコード: なし（シェルエラー）

エラーメッセージ:

bashCopy codezsh: command not found: gemini

発生条件: PATH が正しく設定されていない、または Gemini CLI がインストールされていない。

解決方法:

1. Gemini CLI がインストールされているか確認

bashCopy codebrew list | grep gemini

2. インストールされていない場合は再インストール

bashCopy codebrew install gemini

3. PATH を確認し、必要に応じて追加

bashCopy codeecho $PATH
# /opt/homebrew/bin が含まれていない場合
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Error: Permission denied

エラーコード: EACCES

エラーメッセージ:

bashCopy codeError: Permission denied @ apply2files

発生条件: Homebrew のインストール先ディレクトリに書き込み権限がない。

解決方法:

bashCopy codesudo chown -R $(whoami) /opt/homebrew

コマンドの説明:

• sudo で管理者権限を取得
• chown -R で再帰的に所有者を変更
• $(whoami) で現在のユーザー名を取得
• ​/​opt​/​homebrew 全体の所有権を変更

補完が機能しない場合

発生条件: 補完スクリプトが正しく配置されていない、または設定ファイルが読み込まれていない。

解決方法:

1. 補完スクリプトが存在するか確認

bashCopy codels -la ~/.zsh/completions/_gemini

2. 存在しない場合は再生成

bashCopy codemkdir -p ~/.zsh/completions
gemini completion zsh > ~/.zsh/completions/_gemini

3. .zshrc の設定を確認

bashCopy codecat ~/.zshrc | grep compinit

4. 設定がない場合は追加

bashCopy codeecho 'fpath=(~/.zsh/completions $fpath)' >> ~/.zshrc
echo 'autoload -Uz compinit && compinit' >> ~/.zshrc
source ~/.zshrc

API キー関連のエラー

エラーコード: 401 Unauthorized

エラーメッセージ:

bashCopy codeError: API key is invalid or missing

発生条件: API キーが正しく設定されていない、または無効な API キーを使用している。

解決方法:

1. 現在の設定を確認

bashCopy codegemini config list

2. API キーを再設定

bashCopy codegemini config set api_key YOUR_NEW_API_KEY

3. API キーが有効か Google AI Studio で確認

Google AI Studio の API キー管理ページにアクセスし、キーの状態を確認してください。

アップデート方法

Gemini CLI のアップデートは非常に簡単です。

bashCopy codebrew upgrade gemini

コマンドの説明: Homebrew が管理するすべてのパッケージの最新版を確認し、Gemini CLI をアップデートします。

アップデート後は、バージョンを確認しましょう。

bashCopy codegemini --version

定期的にアップデートすることで、新機能や不具合修正の恩恵を受けられます。

アンインストール方法

Gemini CLI が不要になった場合、クリーンにアンインストールできます。

bashCopy codebrew uninstall gemini

コマンドの説明: Gemini CLI とその依存関係（他のパッケージが使用していないもの）を削除します。

補完スクリプトも削除する場合は、以下のコマンドを実行します。

bashCopy coderm ~/.zsh/completions/_gemini

または bash の場合:

bashCopy coderm ~/.bash_completion.d/gemini

コマンドの説明: 手動で配置した補完スクリプトファイルを削除します。

まとめ

本記事では、Gemini CLI を macOS に最短で導入するための手順を、Homebrew を中心に解説しました。

重要なポイント:

• Homebrew の活用: 手動インストールの複雑さを回避し、PATH 設定やバージョン管理を自動化
• シェル補完の有効化: タブキーによる補完で、コマンド入力の効率を大幅に向上
• トラブルシューティング: よくあるエラーとその解決方法を理解することで、問題発生時も迅速に対応可能

Homebrew を使った導入方法は、初心者から上級者まで、すべての macOS ユーザーにとって最も信頼性が高く、メンテナンスしやすい選択肢です。

本記事の手順に従うことで、わずか数分で Gemini CLI の実用環境を構築し、ターミナルから AI を活用した効率的な作業を開始できます。ぜひ、日々の開発やタスクに Gemini CLI を取り入れ、生産性を向上させてください。

関連リンク

• Homebrew 公式サイト
• Gemini API 公式ドキュメント
• Google AI Studio（API キー取得）
• zsh 公式ドキュメント
• macOS ターミナル使い方ガイド