Gemini CLIの使い方｜導入から安全な自動化まで

Gemini CLIの使い方で重要なのは、コマンドを暗記することではありません。作業フォルダを限定し、プロジェクトの指示を渡し、変更内容を承認して検証する手順です。

Gemini CLIは、ターミナルからGeminiモデルを利用できるオープンソースのAIエージェントです。ファイルの読解、コード変更、コマンド実行、調査を対話から進められるため、一般的なチャット以上に権限管理が欠かせません。本記事では、導入と認証からGEMINI.md、安全設定、ヘッドレス実行までを公式情報に沿って解説します。

Gemini CLIとは何ができるツールか

Gemini CLIは、作業ディレクトリを文脈として扱い、許可されたツールでファイルやコマンドを操作します。主な用途は次のとおりです。

• リポジトリの構成と主要処理を説明する
• ログと関連コードから原因候補を整理する
• 修正案と差分を作成する
• テストや静的解析を実行して結果をまとめる
• 複数ファイルを調査し、JSONやMarkdownで出力する

ソースコードはGitHubで公開されています。通常業務では、3種類のリリースチャネルのうちstableが適しています。

Gemini CLIの概要、料金、提供形態を確認する

ブラウザのチャットとの違い

ブラウザのチャットは会話と添付ファイルが中心です。Gemini CLIは起動フォルダとGEMINI.mdも文脈にし、承認後は編集やコマンド実行まで進めます。自動化しやすい一方、誤編集や誤コマンドのリスクがあるため、読み取り、計画、変更、検証の順序を守ります。

対話モードとヘッドレスモード

対話モードは、要件を確認しながら調査や修正を進める用途に向きます。ヘッドレスモードは、ログ要約や定型チェックのように入出力を決めやすい処理向けです。

# 対話モードgemini# 1回だけ実行gemini -p "主要ディレクトリと役割をJSONで整理してください"

対話モードで入力、権限、出力を確認してから定型化してください。

Gemini CLIをインストールして認証する

導入は、環境確認、stable版のインストール、認証方法の選択という3段階です。

動作要件を確認する

2026年5月14日更新の公式ページでは、Node.js 20.0.0以上が必要です。

項目	公式の推奨内容
OS	macOS 15以上、Windows 11 24H2以上、Ubuntu 20.04以上
メモリ	一般作業は4GB以上、長いセッションや大規模コードは16GB以上
Runtime	Node.js 20.0.0以上
Shell	Bash、Zsh、PowerShell
通信	インターネット接続が必要

要件は更新されるため、導入時に公式インストールガイドを確認してください。

node --versionnpm --version

Node.jsが20未満なら、組織で認められた方法で更新します。

npmまたはHomebrewでインストールする

npmでは公式パッケージをグローバルインストールします。

npm install -g @google/gemini-cli

macOSやLinuxでHomebrewを使う場合は次の方法があります。

brew install gemini-cli

恒久的にインストールせず試す場合は、npxで起動できます。

npx @google/gemini-cli

導入後はバージョンとヘルプを確認します。

gemini --versiongemini --help

更新にはgemini updateを使います。業務環境はstableを基本とします。

利用状況に合う認証方法を選ぶ

初回起動時に認証方法を選びます。公式は、ローカルで使う多くの利用者にGoogleアカウントでのログインを推奨しています。

gemini

利用場面	主な認証方法	Google Cloudプロジェクト
個人のローカル利用	Sign in with Google	多くの場合不要
組織アカウント	Sign in with Google	必要な場合がある
Gemini API利用	Gemini API Key	不要
Vertex AI利用	Vertex AI	必要
CIなどブラウザを使えない環境	API KeyまたはVertex AI	方法により異なる

利用枠、データの扱い、請求先は認証方法と契約で異なります。公式認証ガイドと自社契約を照合してください。APIキーはソースコード、GEMINI.md、共有設定へ書かず、CIのシークレットや組織の認証基盤で管理します。

Gemini CLIの基本的な使い方

最初は既存ファイルを変更しない質問から始め、Gemini CLIが何を読み、どのツール実行を提案するか確認します。

作業フォルダから起動する

対象プロジェクトへ移動してから起動します。

cd /path/to/projectgemini

ホームディレクトリや複数案件を含む上位フォルダでは起動せず、Git管理された検証用プロジェクトから始めます。

最初の依頼では、対象、禁止事項、出力形式、未確認情報の扱いを指定します。

このプロジェクトを変更せずに調査してください。README.mdとpackage.jsonを読み、目的、起動コマンド、テストコマンドを表で整理してください。不明な点は推測せず「未確認」と記載してください。

プロンプトの書き方と10の原則を確認する

ファイルを参照して質問する

対話中の@は、ファイルやディレクトリを文脈へ含める記法です。

@package.json 利用できるnpm scriptsを用途別に整理してください。

必要なファイルから段階的に範囲を広げます。!はシェルコマンドの実行に使えます。削除、上書き、外部送信、パッケージ更新は、変更内容と通信先を確認してから承認します。

変更前に計画と差分を確認する

編集は調査と実行に分けます。まず変更を禁止した状態で、原因と修正案を確認します。

エラーの原因を調査してください。まだ変更しないでください。原因候補、根拠となるファイルと行、最小の修正案、必要なテストを示してください。

計画を確認したら対象を限定します。

src/parser.tsだけを変更してください。設定ファイルと依存パッケージは変更しないでください。変更後に既存テストを実行し、差分と結果を報告してください。

原因の説明と変更を分けると、修正の必要性と影響をレビューしやすくなります。

セッションを確認、再開、圧縮する

-rで保存済みセッションを再開できます。

gemini -r latestgemini -r latest "型エラーが残っていないか確認してください"

コマンド	用途
/help	コマンド一覧を表示
/compress	会話文脈を要約して圧縮
/memory show	読み込まれた指示文脈を表示
/memory reload	GEMINI.mdなどを再読み込み
/restore	チェックポイントを復元
/quit	セッションを終了

最新の一覧は/helpか公式コマンド一覧で確認してください。

GEMINI.mdでプロジェクトの指示を固定する

GEMINI.mdにはプロジェクトの規約を記録できます。Gemini CLIは複数階層のGEMINI.mdを読み込み、各プロンプトの文脈としてモデルへ渡します。

グローバルとプロジェクトの役割を分ける

階層	代表的な場所	書く内容
グローバル	~/.gemini/GEMINI.md	全案件に共通する言語や基本方針
ワークスペース	プロジェクト内のGEMINI.md	技術構成、コマンド、変更ルール
JIT文脈	操作対象付近のGEMINI.md	特定コンポーネントの規約

グローバルには全案件共通の方針だけを書き、顧客名、秘密情報、案件固有のコマンドは置きません。プロジェクト側には技術構成、禁止事項、検証方法を書きます。

最小テンプレートを作る

# Project instructions## Purposeこのリポジトリは社内向け申請管理APIです。## CommandsInstall: npm ciTest: npm testLint: npm run lintBuild: npm run build## Coding rulesTypeScriptのstrict設定を維持する依存関係を追加する前に理由を説明する公開仕様を変える前に影響範囲を報告する## Safety.envと認証情報を読み込まない本番デプロイを実行しないファイル削除は提案だけにする## Completion変更ファイル、テスト結果、未確認事項を報告する

規程は実行時に判断できる行動へ変換します。最初は短いGEMINI.mdを一つ作ってください。

読み込まれた内容を確認する

作成後は実際の文脈を確認します。

/memory show

変更したら再読み込みします。

/memory reload

フッターには読み込まれた文脈ファイル数が表示されます。想定外の上位フォルダにあるGEMINI.mdが含まれていないかも確認してください。

Gemini CLIの導入ルール、GEMINI.md、権限設計を自社環境に合わせて整理したい場合は、株式会社NexaのAI顧問へご相談ください。

AI顧問の詳細と無料相談はこちら

settings.jsonとサンドボックスで安全に運用する

GEMINI.mdは作業方針を伝える文書です。settings.jsonはGemini CLI自体の挙動を制御します。指示文だけに安全性を任せず、技術的な制限を組み合わせます。

設定レイヤーの優先順位を理解する

設定は既定値からコマンドライン引数まで順に適用され、後の設定が前を上書きします。主に使う場所は次の2つです。

• ~/.gemini/settings.jsonは利用者共通の設定
• .gemini/settings.jsonはプロジェクト固有の設定

共有する設定はプロジェクト側、表示など個人向けの設定はユーザー側へ置きます。設定項目は更新されるため、公式設定ガイドとスキーマを確認し、必要なキーだけ追加してください。

承認モードを使い分ける

モード	考え方	適する場面
plan	計画を中心にして変更を避ける	初回調査、設計レビュー
default	ツール実行を都度判断する	通常の開発、業務利用
auto_edit	編集承認を一部省力化する	Git差分を管理できる検証環境
yolo	操作を自動承認する	隔離した使い捨て環境に限定

--yoloは非推奨で、公式は--approval-mode=yoloへの移行を案内しています。通常の社内端末や本番データへ接続できる環境では自動承認を避けてください。

サンドボックスとチェックポイントを使う

サンドボックスはシェルコマンドやファイル変更をホスト環境から隔離します。

gemini --sandbox

macOSではSeatbelt、複数OSではDockerやPodmanを利用できます。隔離後も差分レビューとテストは必要です。

チェックポイントを有効にすると、AIツールによる変更前のプロジェクト状態と会話をローカルへ保存できます。

{  "general": {    "checkpointing": {      "enabled": true    }  }}

/restoreで保存済み状態を選び、復元できます。チェックポイントは別のshadow Git repositoryへ保存されますが、通常のGitコミットやバックアップの代替ではありません。

秘密情報と外部通信を管理する

少なくとも次のルールを設けます。

1. APIキー、秘密鍵、個人情報を作業フォルダへ置かない
2. .gitignoreだけを保護策にしない
3. 外部送信やパッケージ取得は実行前に確認する
4. MCPサーバーや拡張の提供元、権限、通信先を確認する
5. 本番認証情報を持つ環境から検証環境を分離する

MCPは外部ツールやデータソースへの接続方式です。接続先が増えるほど権限とデータ経路も増えます。Gemini CLIのMCP設定と安全運用を確認する

ヘッドレス実行で定型業務を自動化する

対話モードで再現できる処理は、-pまたは--promptで単発実行できます。公式のヘッドレスモードはテキスト、JSON、stream-jsonを出力できます。

-pで単発実行する

cat app.log | gemini -p "エラーを分類し、原因候補と確認手順をMarkdownで出力してください"

最初はログ分類や差分要約など、ファイルを変更しない処理を選びます。会計、契約、権限変更などの重要な判断を無確認で確定させてはいけません。

JSONとstream-jsonを処理する

後続プログラムで扱う場合は出力形式を指定します。

gemini -p "技術的負債を分類してください" \  --output-format json > result.json

jsonは最終回答と利用統計を一つのオブジェクトで返します。stream-jsonは処理内容をJSONLイベントとして順次返します。

gemini -p "テスト失敗の原因を調査してください" \  --output-format stream-json > events.jsonl

公式ガイドが示す終了コードは、成功が0、一般エラーやAPI失敗が1、入力エラーが42、ターン上限超過が53です。文章だけでなく終了コードも確認します。

if gemini -p "README.mdを要約してください" --output-format json > result.json; then  echo "success"else  code=$?  echo "failed: exit code $code" >&2  exit "$code"fi

CIやcronへ組み込む前に確認する

無人実行の前に、次の条件を満たしてください。

• 入力元と対象ファイルが固定されている
• 書き込み先が限定され、既存データを上書きしない
• 認証情報をシークレットとして管理している
• タイムアウト、再試行、終了コード、ログ保存を設計している
• 出力を機械的に検証できる
• 公開、送信、削除の前に人が承認する

Gemini CLIには下書き、分類、候補抽出を任せ、外部公開や不可逆な変更の直前に人が確認する構成が安全です。

Gemini CLIで失敗しやすい場面と対処法

問題が起きたら、インストール、認証、文脈、権限、出力のどこで止まったか切り分けます。

症状	主な確認点	対処
geminiが見つからない	npmのglobal bin、PATH	npm config get prefixとバージョンを確認する
認証できない	アカウント、Cloudプロジェクト、ブラウザ	/authで方法を選び直す
関係ないファイルを参照する	起動場所、GEMINI.md	プロジェクト直下から起動し、/memory showを確認する
変更範囲が広い	指示、承認モード、依存更新	planで調査し、変更対象と禁止事項を示す
長い会話で精度が落ちる	文脈量、古い指示	/compressを使うか新しいセッションへ分ける
コマンド実行が不安	副作用、通信先、復元方法	default承認、サンドボックス、Gitを併用する
自動処理が不安定	出力形式、終了コード	JSONの検証と失敗時停止を追加する

不具合報告には/aboutのバージョン情報を添えます。previewやnightlyで問題が起きた場合はstableでも再現するか確認してください。企業利用では契約、管理機能、データ保護の範囲も確認が必要です。Gemini Code Assistの料金、使い方、導入法を確認する

Gemini CLIの使い方に関するよくある質問

Q. Gemini CLIは無料で使えますか？

個人のGoogleアカウントで利用できる無料枠がありますが、利用枠と機能は認証方法や契約で異なります。Google AIの有料プラン、組織ライセンス、API、Vertex AIでは条件が変わるため、導入時の公式Plansページと認証ガイドを確認してください。

Q. Windowsでも使えますか？

公式インストールガイドはWindows 11 24H2以上を推奨し、PowerShellを対応Shellとして挙げています。組織端末ではNode.js、実行ポリシー、プロキシ、証明書、ブラウザ認証の制限も確認します。

Q. ファイルを読み込ませるにはどうしますか？

対話中に@ファイル名を使うと対象を明示できます。作業フォルダも文脈になるため、機密情報を含む上位フォルダでは起動せず、対象プロジェクトへ移動してください。

Q. モデルは選べますか？

--modelまたは-mでモデルやエイリアスを指定できます。選択肢は更新されるため、gemini --helpと公式CLI早見表を確認してください。通常は既定のautoから始めます。

Q. 社内で安全に使うには何が必要ですか？

利用可能なデータ、起動場所、承認モード、外部通信、MCPや拡張、ログ、復元方法、最終承認者を決めます。アクセス権、サンドボックス、チェックポイント、Git、CIの保護ルールを組み合わせてください。

まとめ

Gemini CLIは次の順序で使うと安全です。

1. 対象プロジェクトへ移動し、読み取りだけの質問から始める
2. GEMINI.mdへコマンド、規約、禁止事項、完了条件を書く
3. planまたはdefaultで計画と差分を確認する
4. サンドボックス、Git、チェックポイントで復元可能にする
5. 対話モードで安定した処理だけをヘッドレス実行へ移す

最初は、検証用フォルダでREADME.mdを要約し、参照ファイルと未確認事項を報告させるだけでも十分です。文脈と権限を確認してから、編集、テスト、定型処理へ広げてください。

公式情報

• Gemini CLI公式ドキュメント
• インストール、実行、リリース
• 認証設定
• CLI早見表
• GEMINI.md
• サンドボックス
• ヘッドレスモード
• GitHubリポジトリ

Gemini CLIを自社業務へ安全に導入したい方へ

株式会社NexaのAI顧問では、対象業務の選定、GEMINI.mdや権限ルールの整備、検証手順、自動化設計を支援しています。現場で継続して改善できる運用を設計します。

AI顧問の詳細と無料相談はこちら