ターミナルを開いたまま、コマンド一行でAIに話しかけられたら——そう思ったことはないでしょうか。ブラウザのタブを切り替え、ログインして、プロンプトを貼り付ける。その手間が積み重なると、開発のリズムが乱れます。Gemini CLIは、その問題をターミナル上で解決するGoogleのオープンソースAIエージェントです。
ai-jitan-hub.com（2026年9月時点）によると、Googleアカウントがあれば1日1,000リクエストまで無料で使え、コードレビューからシェルスクリプトへの組み込みまで幅広く対応します。この記事では、インストールから実践的な活用法まで、順を追って解説します。
この記事のポイント
- genai-ai.co.jp（2026年8月時点）によると、Gemini CLIはGoogleが2025年6月にリリースしたオープンソースのターミナル用AIエージェントで、ai-jitan-hub.com（2026年9月時点）によるとGoogleアカウントで1日1,000リクエストまで無料で利用できます
- Node.js v20以上があればnpx一行で即起動。APIキー取得またはGoogleアカウント認証の2経路で使い始められます
- GEMINI.mdでプロジェクト単位の指示を設定でき、シェルスクリプトへの組み込みや非対話モードでの自動化にも対応しています
Gemini CLI とは何か？
Gemini CLIは、ターミナル上でGeminiモデルを直接操作できるAIエージェントです。ブラウザ版のGeminiとは異なり、ローカルファイルの読み書き・シェルコマンドの実行・コードベース全体の参照といった操作をコマンドラインから一貫して行えます。
Gemini CLI の概要と位置づけ
genai-ai.co.jp（2026年8月時点）によると、Gemini CLIはGoogleが2025年6月にリリースしたオープンソース（Apache 2.0ライセンス）のCLIツールです。TypeScriptで実装されており、aquallc.jpの調査時点でGitHubリポジトリでは約95,900スターを獲得しています（随時変動します）。
公式のREADME（2026年9月時点）によると、Gemini 3 のモデルなどを使えて、最大100万トークンのコンテキストウィンドウを持ちます。コード生成・レビュー・バグ修正・ドキュメント生成・タスク管理まで、幅広い用途に対応しています。汎用のローカルユーティリティとして設計されたツールです。
CLI（Command Line Interface）とは、マウスを使わずテキストのコマンド入力でコンピュータを操作するインターフェースのことです。開発者にとっては自動化しやすく、既存のワークフローに自然に組み込める点が強みです。
ブラウザ版・API版との違い
Gemini CLIとブラウザ版・API版では、操作の起点と連携できる対象が大きく異なります。以下の比較表で整理します。
| 項目 | ブラウザ版（gemini.google.com） | API版（直接呼び出し） | Gemini CLI |
|---|---|---|---|
| 操作インターフェース | Webブラウザ | コード（Python/JS等） | ターミナル |
| ローカルファイル操作 | 手動でコピー貼り付け | コードで実装が必要 | @記法で直接参照 |
| シェルコマンド連携 | 不可 | 別途実装が必要 | !記法で直接実行 |
| 無料枠（Googleアカウント） | プランによる | 250リクエスト/日（Flash）※1 | 1,000リクエスト/日※2 |
| スクリプト自動化 | 不可 | 可（コード実装要） | パイプ・引数で容易 |
※1 Gemini API無料枠はin-site.jp（2025年7月時点）によると250リクエスト/日（Flashのみ）・毎分10リクエストですが、情報源によって数値が異なる場合があります。最新値はGoogle公式ドキュメントでご確認ください。
※2 ai-jitan-hub.com（2026年9月時点）による。
ターミナルから使いたい場合は、API直接呼び出しよりもGemini CLIの方が無料枠の上限が大きくなります（各出典時点の情報。最新情報は公式ドキュメントでご確認ください）。
Gemini CLI の使い方：インストールと初期設定の手順
Gemini CLIのセットアップは、Node.jsさえ入っていれば数分で完了します。インストール方法は複数ありますが、まずは環境を確認してから進めましょう。
Node.js の確認と Gemini CLI のインストール
ai-jitan-hub.com（2026年9月版）によると、Gemini CLIの動作に必要なNode.jsのバージョンはv20以上です（なお、一部古い記事ではv18以上と記載されているものもあります。最新要件は公式GitHubリポジトリのREADMEでご確認ください）。
対応OSはmacOS 15以上・Windows 11 24H2以上・Ubuntu 20.04以上。メモリは短いセッションなら4GB以上、大きなコードベースを扱う場合は16GB以上が推奨されています。
まずターミナルで以下を実行してNode.jsのバージョンを確認します。
node --versionv20.x.x以上が表示されればOKです。インストール方法は主に3つあります。
- npx（インストール不要・試したいとき）：
npx @google/gemini-cli - npm グローバルインストール（常用するとき）：
npm install -g @google/gemini-cli - Homebrew（macOSユーザー向け）：
brew install gemini-cli
初めて試す場合はnpxが手軽です。常用するならグローバルインストールしてgeminiコマンドだけで起動できる状態にしておくと、作業の流れが止まりません。インストール後はgemini --versionでバージョンが表示されれば成功です。
なお、ai-jitan-hub.com（2026年9月時点）によると、2026年9月15日公開の最新安定版はv0.60.0で、安定版は毎週火曜20:00 UTCに更新されます。
APIキーの取得と認証設定
Zennのインストールガイドによると、初回起動時はテーマ選択→認証方法選択の順に進みます。認証方法は3つあります。
- Googleアカウントでサインイン（最も手軽）：「Login with Google」を選ぶとブラウザが開き、Googleアカウントで認証するだけで完了。ai-jitan-hub.com（2026年9月時点）によると無料枠（1日1,000リクエスト・毎分60リクエスト）がすぐに使えます
- Gemini APIキー：Google AI StudioでAPIキーを発行し、環境変数
GEMINI_API_KEYに設定します。Mac/Linuxならexport GEMINI_API_KEY="取得したキー"をシェルの設定ファイル（~/.zshrcなど）に追記して永続化します - Vertex AI：企業向け。ai-jitan-hub.com（2026年9月時点）によるとExpress Modeは90日間課金設定不要で試せます
⚠ データ利用に関する注意
無料プラン（GoogleアカウントまたはGemini API無料枠）を利用した場合、プロンプト・回答・コードがGoogleのAIトレーニングに利用される可能性があります（in-site.jp、2025年7月時点）。機密情報や業務上の重要なコードを扱う場合は、有料プランへの切り替えを検討してください。
最新のプライバシーポリシーはGoogle公式ドキュメントでご確認ください。
また、APIキーはコードに直接書かず、環境変数（GEMINI_API_KEY）で管理し、.gitignoreに追加しておくことを強くお勧めします。
Gemini CLI の使い方：対話モードとコマンド実行
起動方法とコマンドの基本を押さえると、Gemini CLIは一気に使いやすくなります。対話モードと非対話モードを使い分けるのがポイントです。
対話モード（インタラクティブモード）の起動と操作
プロジェクトのディレクトリに移動してからgeminiと入力するだけで対話モードが起動します。>プロンプトが表示されたら、日本語で自然に話しかけられます。
cd /path/to/your/project
gemini対話を終了するには/quitまたは/exitと入力します。Zennのチュートリアルによると、--yoloオプションを付けて起動するとYOLOモードになり、ファイル作成・削除・ライブラリインストールなどの操作を確認なしで自動実行します。自律的に進めてほしいときに便利ですが、意図しない変更が起きるリスクもあるため、慣れてから使うのが安全です。
非対話モード（ワンショット実行）では、コマンドに直接プロンプトを渡せます。
gemini -p "このコードのバグを教えて"シェルスクリプトへの組み込みや、パイプで他のコマンドと連携するときはこちらを使います。
よく使うコマンドと引数の一覧
Gemini CLIには、対話モード中に使えるスラッシュコマンドと、起動時に指定するコマンドライン引数の2種類があります。ZennのチュートリアルおよびZennのインストールガイドを参考にまとめました。
| コマンド/引数 | 種別 | 用途 |
|---|---|---|
/quit / /exit |
スラッシュコマンド | 対話モードの終了 |
/help |
スラッシュコマンド | 使えるコマンドの一覧表示 |
/clear |
スラッシュコマンド | 会話履歴のリセット |
@ファイルパス |
@記法 | ファイル・ディレクトリをコンテキストに追加 |
!コマンド |
!記法 | シェルコマンドを直接実行 |
-p "プロンプト" |
起動引数 | 非対話モード（ワンショット実行） |
--yolo |
起動引数 | 確認なしの自律実行モード |
--model |
起動引数 | 使用モデルの指定 |
スラッシュコマンドは対話モード中にいつでも入力できます。/helpを打てば現在使えるコマンドの一覧が表示されるので、迷ったときはまずここを確認するのが早道です。
ファイルやディレクトリを渡して処理させる方法
Gemini CLIで特に便利なのが、ローカルファイルをそのままコンテキストに渡せる@記法です。ブラウザ版のようにコードをコピー&ペーストする手間がなくなります。
# 特定ファイルを渡す
> @src/utils/date.ts このコードを簡素化して
# ディレクトリ全体を渡す
> @src/ このディレクトリのアーキテクチャを説明して
# パイプで標準入力から渡す
cat error.log | gemini -p "このエラーの原因を教えて"Zennのチュートリアルによると、@記法はローカルファイルだけでなくディレクトリ全体も参照できます。100万トークンのコンテキストウィンドウを活かして、大きなコードベースごと渡して質問するといった使い方も可能です。パイプを使えば、たとえばエラーログ500行をそのままAIに投げて原因を絞り込むといった使い方が、コマンド一行でできます。
Gemini CLI の使い方：活用シーン別の活用例
Gemini CLIは汎用ツールですが、特に効果を発揮するシーンがあります。コードレビューとワークフロー自動化の2つを具体的に見ていきます。
コードのレビュー・修正依頼
コードレビューは、Gemini CLIがもっとも得意とする用途の一つです。ファイルを@記法で渡しながら、自然言語で指示を出すだけで動きます。
# コードレビューの依頼
> @src/api/user.ts このコードの問題点を指摘して
# バグ修正の依頼
> @src/api/user.ts 型エラーが出ているので修正して
# リファクタリングの依頼
> @src/ 重複しているロジックをまとめてリファクタリング案を出してブラウザ版との違いが際立つのは、修正後のコードをそのままファイルに書き戻せる点です。通常モードでは変更前に確認が入るため、意図しない書き換えを防げます。Zennチュートリアルによると、既存のコードベースに対して「GitHub Issue #123を実装する初稿を作って」「最新バージョンのライブラリに移行する計画を立てて」といった指示も通ります。
コードレビューを依頼するときは、プロジェクトのルートディレクトリで起動しておくと、関連ファイルを横断した回答が得やすくなります。
シェルスクリプトやワークフローへの組み込み
非対話モード（-p引数）を使うと、Gemini CLIをシェルスクリプトの一部として組み込めます。定型的なテキスト処理やログ解析を自動化したいときに役立ちます。
#!/bin/bash
# エラーログを要約してSlackに通知するスクリプトの例
SUMMARY=$(cat /var/log/app/error.log | gemini -p "このエラーログを3行で要約して")
echo "$SUMMARY" | curl -X POST -H 'Content-type: application/json' \
--data "{\"text\":\"$SUMMARY\"}" $SLACK_WEBHOOK_URLai-jitan-hub.com（2026年9月版）によると、--output-format jsonオプションで出力をJSON形式にできるため、後続のコマンドでjqを使ってパースするといった連携も可能です。「直近7日間のgit履歴を機能と担当者でグループ分けしてスライド資料を作成して」のような複合タスクも、対話モードで一度試してから非対話モードに落とし込む流れが実践的です。
設定ファイルとカスタマイズ：GEMINI.md と settings.json でできること
Gemini CLIはそのまま使っても便利ですが、設定ファイルを活用するとプロジェクトに最適化した動作にカスタマイズできます。ここでは2つの主要な設定方法を紹介します。
GEMINI.md によるプロジェクト単位の指示設定
GEMINI.mdは、プロジェクトルートに置くMarkdownファイルで、Gemini CLIが起動時に自動で読み込む「プロジェクトへの指示書」です。
Qiitaの解説記事によると、GEMINI.mdに書いた内容はセッションをまたいで常に参照されるため、「このプロジェクトはTypeScriptを使っている」「コメントは日本語で書く」「テストはJestで書く」といったルールを一度書いておけば、毎回説明する手間がなくなります。
# GEMINI.md の記述例
## プロジェクト概要
これはNext.js + TypeScriptで構築したECサイトです。
## コーディングルール
- TypeScriptの型は必ず明示する
- コメントは日本語で書く
- テストはJestで書く
- コミットメッセージはConventional Commitsに従う
## 禁止事項
- anyの使用
- console.logの本番コードへの混入aquallc.jpの完全ガイドによると、GEMINI.mdは3階層の構造（グローバル・ユーザー・プロジェクト）で管理でき、プロジェクト単位の設定が最も優先されます。チームで共有するリポジトリにGEMINI.mdを含めておくと、メンバー全員が同じルールでAIを使えるようになります。
モデルの切り替えと出力フォーマットの変更
Gemini CLIでは、用途に応じてモデルを切り替えられます。たとえば速度重視ならgemini-2.5-flashのような軽いモデル、精度重視なら上位のモデルを選ぶのが基本的な考え方です（モデル名は入れ替わるので、いま使えるモデルは公式のドキュメントで確かめてください。2026年9月時点のREADMEでは Gemini 3 のモデルが案内されています）。
# 起動時にモデルを指定
gemini --model gemini-2.5-flash
# 非対話モードでモデルを指定
gemini --model gemini-2.5-pro -p "このコードを詳しくレビューして"settings.json（~/.gemini/settings.json）に"model": "gemini-2.5-flash"を書いておけば、毎回指定しなくても済みます。出力フォーマットはデフォルトのMarkdown形式に加え、スクリプト連携用のJSON形式も選択できます。プロジェクトの性質や作業の種類によって使い分けると、レスポンス速度とコスト（有料プラン利用時）のバランスを取りやすくなります。
Gemini CLI の使い方でよく詰まるポイント：よくある質問
Q. Gemini CLI は完全無料で使えますか？
A. Googleアカウントでサインインする方法なら、ai-jitan-hub.com（2026年9月時点）によると1日1,000リクエスト・毎分60リクエストまで無料で使えます。ただし無料プランでは、入力したプロンプトや回答がGoogleのAIトレーニングに利用される可能性があります（in-site.jp、2025年7月時点）。
機密情報を扱う業務では有料プランを検討してください。最新の料金・制限はGoogle公式ドキュメントでご確認ください。
Q. Node.js のバージョンはいくつが必要ですか？
A. ai-jitan-hub.com（2026年9月版）およびaquallc.jpの情報ではNode.js v20以上が推奨されています。古い記事ではv18以上と記載されているものもありますが、公式の最新要件はGitHubリポジトリのREADMEでご確認ください。node --versionでバージョンを確認してから進めるのが確実です。
Q. Gemini CLI と Claude Code はどちらを選べばいいですか？
A. 無料で始めたい個人開発者にはGemini CLIが向いています。ai-jitan-hub.com（2026年9月時点）によると、Googleアカウントだけで1日1,000リクエストまで無料で使えます。
一方、genai-ai.co.jp（2026年8月時点）の比較によると、業務全体をAIエージェントに委任するような自律実行の用途では、Claude Codeの方が実用性が高いとされています。まずGemini CLIで試して、物足りなさを感じたら有料ツールを検討するという順序が合理的です。
Q. GEMINI.md はどこに置けばいいですか？
A. プロジェクトのルートディレクトリに置くのが基本です。Gemini CLIは起動時にカレントディレクトリのGEMINI.mdを自動で読み込みます。チームで使う場合はGEMINI.mdをGitリポジトリに含めておくと、全員が同じルールでAIを利用できます。
グローバル設定（~/.gemini/GEMINI.md）も使えるため、全プロジェクト共通のルールと、プロジェクト固有のルールを分けて管理できます。
Q. 企業の業務で使うときに気をつけることは？
A. 無料プラン（GoogleアカウントまたはGemini API無料枠）では、入力データがAIトレーニングに利用される可能性があります（in-site.jp、2025年7月時点）。社外秘のコードや個人情報を含むデータを扱う場合は、データ利用のないVertex AIや有料プランを選択してください。
また、APIキーはコードに直接書かず、環境変数（GEMINI_API_KEY）で管理し、.gitignoreに追加しておくことを強くお勧めします。最新のプライバシーポリシーはGoogle公式ドキュメントでご確認ください。
Gemini CLI の使い方を最短で始めるまとめ
Gemini CLIは、ターミナルを作業の中心に置いているエンジニアにとって、コンテキストスイッチを減らしながらAIを活用できる実用的なツールです。ai-jitan-hub.com（2026年9月時点）によると、Googleアカウントだけで1日1,000リクエストまで無料という入口の低さも、まず試してみる理由になります。
使い始めるときの最短ルートは、npx @google/gemini-cliを実行してGoogleアカウントで認証するだけです。その後、プロジェクトルートにGEMINI.mdを置いてコーディングルールを書いておくと、セッションをまたいで一貫した回答が得られるようになります。
個人開発や学習目的であれば十分な機能と無料枠が揃っており、まずnpxで動かしてみることを強くお勧めします。ブラウザとは異なるAIとの向き合い方が、ターミナルの中に広がっています。
今日から試せる3ステップ
npx @google/gemini-cliを実行してGoogleアカウントで認証する- プロジェクトのルートで
geminiを起動し、@ファイル名でコードを渡してみる - GEMINI.mdにプロジェクトのルールを書いて、次回起動から自動で読み込ませる
集中して手を動かせる環境があると、新しいツールの習得も進みやすくなります。もし静かな作業環境をお探しであれば、管理人が運営するアイデスク新宿自習室（新宿西口駅徒歩3分・24時間営業）も選択肢の一つです。半個室ブース18席、私語厳禁、Wi-Fi完備。コードを書くことだけに集中できる環境です。
※本記事の情報は2026年9月時点のものです。料金・制限・プライバシーポリシーは変更される可能性があります。最新情報は各公式サイトでご確認ください。
最終更新: 2026年9月29日
参考サイト
- Gemini CLI | Gemini for Google Cloud | Google Cloud Documentation
- google-gemini/gemini-cli – GitHub（公式リポジトリ・README）
- Gemini CLI 完全ガイド【2026年最新】｜無料で使えるGoogle製AIコーディングエージェント
- Gemini CLI料金プラン全6種を比較【無料版のデータ利用に注意】
- Gemini CLI 使い方【2026年9月】──インストール・ログイン3方式・1日の上限・モデル選択・非対話モード
- Gemini CLI の簡単チュートリアル – Zenn
- Gemini CLI のインストール方法と基本的な使い方
- 【2026年8月最新】Gemini CLIとは？使い方・料金・Claude Codeとの違いを徹底比較
- ターミナルからAIを操る！Google製「Gemini CLI」の使い方を徹底解説
- 【完全ガイド】Gemini CLIとは？できること・使い方・料金・競合比較
