Gemini CLI 使い方｜コマンド一覧・設定・GEMINI.md・無料枠

Gemini CLI は、Google の Gemini をターミナルで動かすオープンソースのコーディングエージェントです。npm install -g @google/gemini-cli で入れ、フォルダで gemini と打つと対話画面が開きます。 指示は GEMINI.md、設定は ~/.gemini/settings.json に書きます。スクリプトからは gemini -p "依頼文" で、対話なしに動かせます。

確認環境：@google/gemini-cli 0.63.0（npm）、Node.js 22.22.2、Linux x86_64。--help とサブコマンドの help、gemini mcp add が書き込む settings.json、対話画面（スラッシュコマンドの一覧・? のショートカット・/memory list・/model・/commands list・/policies list）、認証が無いときの gemini -p の出力と終了コードは、手元で確かめました。モデルとの通信はできない環境のため、回答の中身・無料枠・料金は公式ドキュメント（github.com/google-gemini/gemini-cli の docs）の記載に基づいて書いています（確認日 2026年10月12日）。

Gemini CLI とは：入れる前に知っておくこと

Gemini CLI は、ファイルの読み書き・シェルコマンドの実行・Web 検索などのツールを使いながら、依頼を進めるエージェントです。 ソースは Apache 2.0 で公開されています。

手元では、npm install で入った node_modules は 98MB でした。

$ gemini --version
0.63.0

認証の 3 方式と無料枠

初めて起動すると、フォルダの信頼を聞かれたあと、次の 3 つから認証方法を選ぶ画面が出ました。

? Get started
  How would you like to authenticate for this project?
    1. Sign in with Google
  ● 2. Use Gemini API Key
    3. Vertex AI
  Existing API key detected (GEMINI_API_KEY). Select "Gemini API Key" option to use it.

環境変数 GEMINI_API_KEY があると、「Use Gemini API Key」が最初から選ばれていました。

1日の上限（2026年10月12日に確認したドキュメントの値）

ドキュメントでは、このほかに「1分あたりの上限」と「混雑時の提供状況」の制限があるとされています。Google AI Plus と Workspace AI Standard・Plus は対象外と明記されていました。上限の数値は変わることがあるので、使う前に「Quotas and pricing」のページと、セッション中の /stats model で確かめます。

非対話モード（-p）では、ドキュメントでは API キーか Vertex AI が勧められています。 認証が何も無い状態で -p を実行すると、次のメッセージで終了コード 41 になりました。

$ gemini -p "hi"
Please set an Auth method in your /home/you/.gemini/settings.json or specify one of the following environment variables before running: GEMINI_API_KEY, GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_GENAI_USE_GCA
$ echo $?
41

一度選んだ方式は、~/.gemini/settings.json の security.auth.selectedType に入ります。API キーの場合は "gemini-api-key" で、これを書いておくと起動時の選択画面は出ませんでした。

対話モードの基本：最初の 5 分

フォルダで gemini を起動すると、最初に「このフォルダのファイルを信頼するか」を聞かれます。 信頼しないフォルダでは、プロジェクトの設定・MCP サーバー・カスタムコマンド・フックなどは読み込まれません。

 Do you trust the files in this folder?
 Trusting a folder allows Gemini CLI to load its local configurations, including custom commands, hooks, MCP
 servers, agent skills, and settings. ...
 This folder contains:
   • MCP Servers (1):
     - context7
 ● 1. Trust folder (proj)
   2. Trust parent folder (gemini)
   3. Don't trust

「Trust folder」を選ぶと CLI が自動で再起動し、~/.gemini/trustedFolders.json に "/home/you/proj": "TRUST_FOLDER" が書き込まれました。

画面の下には、今の状態が出ます。

 Shift+Tab to accept edits                                    2 GEMINI.md files · 2 MCP servers
 >   Type your message or @path/to/file
 workspace (/directory)                     sandbox                            /model
 /home/you/proj                    no sandbox                           Auto

/model を開くと、0.63.0 では次の 2 択でした。

 Select Model
 ● 1. Auto
      Let Gemini CLI decide the best model for the task: gemini-3.1-pro-preview, gemini-3.8-flash
   2. Manual
      Manually select a model
 Remember model for future sessions: false (Press Tab to toggle)

スラッシュコマンド一覧（0.63.0 の全41個）

/ を打つと出る一覧を、表示順に全部書き出しました。説明は画面の英語を訳したものです。

キーボードショートカット

入力欄で ? を押すと出た一覧（0.63.0）に、ドキュメントの「Keyboard shortcuts」から主なものを足しました。

キーの割り当ては、ドキュメントでは keybindings.json で変えられるとされています。

承認モードとサンドボックス

Gemini CLI は、ツールを使うたびに確認するかどうかを「承認モード」で決めます。 --help に出る 4 つです。

ドキュメントでは、settings.json の general.defaultApprovalMode に書けるのは default・auto_edit・plan の 3 つで、yolo はコマンドラインからしか有効にできないとされています。security.disableYoloMode を true にすると、フラグを付けても yolo になりません。

サンドボックスは、-s（--sandbox）か環境変数 GEMINI_SANDBOX で有効にします。 ドキュメントにある方式は、macOS の Seatbelt、Docker・Podman のコンテナ、Windows ネイティブ、gVisor（runsc）、LXC です。既定は「サンドボックスなし」で、手元の画面下にも no sandbox と出ていました。

gemini -s -p "コードの構成を分析して"     # その回だけサンドボックス
export GEMINI_SANDBOX=docker             # Docker で動かす

GEMINI.md：置き場所と読み込まれ方

GEMINI.md は、毎回モデルに渡すプロジェクトの決まりごとを書く Markdown です。 3 か所に置いて、/memory list と /memory show で確かめました。

~/.gemini/GEMINI.md     「# Global」
proj/GEMINI.md          「# Project」
proj/sub/GEMINI.md      「# Sub」

/memory show では、次のように区切りつきで連結されていました。

ℹ Current memory content from 2 file(s):
  --- Global ---
  --- Context from: /home/you/.gemini/GEMINI.md ---
  # Global
  - 回答は日本語で書く
  --- End of Context from: /home/you/.gemini/GEMINI.md ---
  --- Project ---
  --- Context from: /home/you/proj/GEMINI.md ---
  # Project
  - テストは ./mvnw test

ドキュメントの説明では、読む順は「全体（~/.gemini/GEMINI.md）→ ワークスペースとその親フォルダ → ツールが触れたフォルダ（JIT：必要になった時点で読む）」です。下位フォルダの GEMINI.md は、そのフォルダのファイルを触ったときに読まれます。@./docs/style.md のように書くと、別のファイルを取り込めます。

AGENTS.md も読ませる

既定では AGENTS.md は読まれませんでした。 settings.json の context.fileName に名前を並べると読まれます。

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

proj に AGENTS.md と GEMINI.md を置いた状態で比べた結果です。

Codex CLI や Claude Code と同じリポジトリで使うなら、指示は AGENTS.md にまとめ、この設定で読ませると内容がずれません。AGENTS.md の書き方は、関連記事「AGENTS.mdの書き方テンプレ｜copilot-instructions比較」で扱っています。

settings.json の雛形

設定は JSON で、上から順に「既定値 → システム既定 → ユーザー → プロジェクト → システム → 環境変数 → コマンドライン」の順に上書きされます（ドキュメントの記載）。

次の雛形は、手元で読み込ませて、警告が出ないことを確かめたものです。$schema を書くと、対応したエディタで補完と検証が効きます。

{
  "$schema": "https://raw.githubusercontent.com/google-gemini/gemini-cli/main/schemas/settings.schema.json",
  "general": {
    "defaultApprovalMode": "default",
    "vimMode": false,
    "checkpointing": { "enabled": true }
  },
  "ui": {
    "hideBanner": true
  },
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  },
  "privacy": {
    "usageStatisticsEnabled": false
  },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

tools.allowed（確認なしで実行するツール）を書くと、0.63.0 では起動時に次の警告が出ました。

⚠  Warning: --allowed-tools cli argument and tools.allowed in settings.json are deprecated and will be removed in 1.0:
   Migrate to Policy Engine: https://geminicli.com/docs/core/policy-engine/

よく使う項目

ポリシー：確認なしで許すコマンド・禁止するコマンド

tools.allowed の代わりは、~/.gemini/policies/ に置く TOML のポリシーファイルです。 次のファイルを置いて /policies list で確かめました。

# ~/.gemini/policies/team.toml
# 読むだけの git コマンドは確認なしで実行
[[rule]]
toolName = "run_shell_command"
commandPrefix = ["git status", "git diff", "git log"]
decision = "allow"
priority = 100

# 危ない削除は常に拒否
[[rule]]
toolName = "run_shell_command"
commandPrefix = "rm -rf"
decision = "deny"
priority = 200

  ### Normal Mode Policies
  1. DENY tool: run_shell_command (args match: \"command\":\"rm\ \-rf(?:[\s"]|\\")) [Priority: 4.2] [Source: User: team.toml]
  2. ALLOW tool: run_shell_command (args match: \"command\":\"git\ status(?:[\s"]|\\")) [Priority: 4.1] [Source: User: team.toml]
  ...
  31. ASK_USER tool: run_shell_command [Priority: 1.01] [Source: Default: write.toml]

ユーザーのルールは「4 + priority ÷ 1000」の優先度になり、既定のルール（1.01 など）より先に効いていました。 決定（decision）は allow・deny・ask_user の 3 つです。ドキュメントでは、プロジェクトの .gemini/policies に置くルールは、今は効かないと注意書きがあります。

MCP サーバーをつなぐ

gemini mcp add は、既定でプロジェクトの .gemini/settings.json に書き込みます。 -s user でユーザーの設定に入ります。

# stdio のサーバー（既定はプロジェクトに保存）
gemini mcp add context7 npx -y @upstash/context7-mcp

# HTTP のサーバーをユーザー設定に
gemini mcp add -s user -t http docs https://example.com/mcp -H "Authorization: Bearer xxx"

MCP server "context7" added to project settings. (stdio)
MCP server "docs" added to user settings. (http)

書き込まれた内容です。

// .gemini/settings.json（プロジェクト）
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

// ~/.gemini/settings.json（ユーザー）
{
  "mcpServers": {
    "docs": {
      "url": "https://example.com/mcp",
      "type": "http",
      "headers": { "Authorization": "Bearer xxx" }
    }
  }
}

信頼していないフォルダでは、ユーザー設定のサーバーも含めて無効になりました。

$ gemini mcp list
Warning: MCP servers are configured but disabled because this folder is untrusted.
User-level servers are also suppressed in untrusted folders to prevent accidental side-effects.

○ docs: https://example.com/mcp (http) - Disabled
○ context7: npx -y @upstash/context7-mcp (stdio) - Disabled

ドキュメントでは、サーバー名に _ を使わないよう注意があります（ツール名が mcp_サーバー名_ツール名 になり、ポリシーの判定がずれるため）。MCP の仕組みは、関連記事「MCPとは？サーバーとクライアントの仕組みと設定例を図解」で扱っています。

カスタムコマンド：よく使う依頼を /コマンドにする

.gemini/commands/ に TOML を置くと、ファイル名がそのままスラッシュコマンドになります。 git/commit.toml なら /git:commit です。

# .gemini/commands/review.toml
description = "未コミットの変更をレビューする"
prompt = """
次の差分をレビューして、問題点を重要度順に挙げてください。
!{git diff}
"""

置いたあと /commands list を実行すると Project Commands に review.toml が出て、/rev と打つと review 未コミットの変更をレビューする が候補に出ました。{{args}} で引数、!{…} でシェルの実行結果を埋め込めます（ドキュメントの記載）。

非対話モード（gemini -p）：スクリプトと CI で使う

-p を付けるか、端末でない環境（パイプなど）で実行すると、非対話モードになります。 標準入力があると、-p の文はその後ろに足されます。

# 1回だけ実行
gemini -p "このリポジトリの構成を要約して"

# 標準入力を渡す
git diff | gemini -p "この差分のレビューコメントを書いて"

# JSON で受け取る
gemini -p "README の要点を3つ" -o json

# JSONL のイベントで受け取る
gemini -p "テストを実行して結果をまとめて" -o stream-json

# 編集を自動承認
gemini -p "lint のエラーを直して" --approval-mode auto_edit

認証が無いときの -o json は、次の形でした。

{
  "session_id": "68ceb97c-eab1-49e3-9df5-315f8310b0ce",
  "error": {
    "type": "Error",
    "message": "Please set an Auth method in your /home/you/.gemini/settings.json or specify one of the following environment variables before running: GEMINI_API_KEY, GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_GENAI_USE_GCA",
    "code": 41
  }
}

非対話モードでは、ポリシーの ask_user（人に聞く）は deny として扱われます（ドキュメントの記載）。 ファイル編集が要る処理は、--approval-mode auto_edit か、ポリシーで allow を決めておきます。

サブコマンドと主なオプション

Claude Code・Codex CLI との対応表

Claude Code 側は公式ドキュメント（code.claude.com）、Codex CLI 側は 0.162.1 の help と画面で確かめた内容です。

Claude Code には、Gemini CLI の設定（指示ファイル・MCP サーバー・コマンドなど）を取り込む /import gemini があります（v2.1.213 以降）。逆向きでは、Gemini CLI の gemini hooks migrate が Claude Code のフックを移します。Codex CLI の使い方は、関連記事「Codex CLI 使い方｜コマンド一覧・config.toml・AGENTS.md」で扱っています。Claude Code 側のコマンドは、関連記事「Claude Code コマンド 一覧｜CLI・スラッシュ・ショートカット早見表」にまとめています。エディタで使う場合の指示ファイルの書き方は、関連記事「Cursor 使い方｜Cursor Rulesの書き方・ショートカット・雛形」で扱っています。

よくある質問

Q. 無料で使えますか。 A. ドキュメントでは、個人の Google アカウントでログインすると Gemini Code Assist（個人向け）の無料枠で 1 日 1,000 リクエスト、Gemini API キーの無料枠では 1 日 250 リクエスト（Flash モデルのみ）とされています（2026年10月12日に確認）。仕事で使うときは、契約やデータの扱いを含めて、会社の決まりと、認証画面に出る「Terms of Services and Privacy Notice for Gemini CLI」のページ（geminicli.com/docs/resources/tos-privacy/）を確かめます。

Q. ネット記事の「1分60回・1日1,000回」と違います。 A. 2026年10月12日のドキュメントでは、1日の上限は認証方法と契約ごとの表になっていて、1分あたりの上限の具体的な数値は書かれていませんでした。数値は変わるので、使っている版のドキュメントと /stats model で確かめます。

Q. 前の会話の続きをしたい。 A. gemini --list-sessions で一覧を出し、gemini -r latest（直近）か gemini -r 番号 で再開します。対話中なら /resume です。

Q. AI が変更したファイルを元に戻せますか。 A. general.checkpointing.enabled を true にすると、ドキュメントの説明では、ツールがファイルを変える前の状態が ~/.gemini/history/<プロジェクトのハッシュ> の別の Git リポジトリに保存され、/restore で戻せます（自分のリポジトリの Git には影響しません）。会話だけを指定したメッセージまで戻すなら /rewind です。上のコマンド一覧は、チェックポイントを有効にする前に取ったもので、/restore は入っていません。

Q. Windows で使えますか。 A. ドキュメントの動作要件は Windows 11 24H2 以降です。API キーは PowerShell なら $env:GEMINI_API_KEY="…" で設定します。

まとめ

• 入れるは npm install -g @google/gemini-cli（Node.js 20 以上）、起動は gemini、対話なしは gemini -p
• 認証は Google ログイン・API キー・Vertex AI の 3 つ。1日の上限は 個人の Google ログインで 1,000、API キーの無料枠で 250（2026年10月12日のドキュメント）
• GEMINI.md は全体 → ワークスペースと親 → 触れたフォルダの順。context.fileName で AGENTS.md も読める
• 確認なしで許すコマンドは、tools.allowed ではなく ~/.gemini/policies/*.toml
• MCP は gemini mcp add。既定はプロジェクトに保存され、信頼していないフォルダでは無効
• -p の失敗は終了コードで見分ける。認証が無いときは 41 だった

参考・出典

確認日はいずれも 2026年10月12日です。

• google-gemini/gemini-cli（GitHub、docs）：https://github.com/google-gemini/gemini-cli
• @google/gemini-cli（npm）：https://www.npmjs.com/package/@google/gemini-cli
• Gemini CLI ドキュメント「Quotas and pricing」：https://github.com/google-gemini/gemini-cli/blob/main/docs/resources/quota-and-pricing.md
• Gemini CLI ドキュメント「Authentication setup」：https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx
• Gemini CLI ドキュメント「Configuration」：https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/configuration.md
• Gemini CLI ドキュメント「Provide context with GEMINI.md files」：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/gemini-md.md
• Gemini CLI ドキュメント「Headless mode reference」：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/headless.md
• Gemini CLI ドキュメント「Policy engine」：https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/policy-engine.md
• Gemini CLI ドキュメント「Keyboard shortcuts」：https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/keyboard-shortcuts.md
• Gemini CLI ドキュメント「Sandboxing」：https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/sandbox.md
• Claude Code ドキュメント「Commands」：https://code.claude.com/docs/en/commands
• Claude Code ドキュメント「How Claude remembers your project」：https://code.claude.com/docs/en/memory

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。