Gemini CLIを使い始める：インストール、3つのログイン方式、GEMINI.md、最初の10分、無料枠の公式の記載を、公式ドキュメントで確かめる

この記事は、公式のドキュメント、GitHub、ブログを2026年10月24日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。運営者はGeminiを入れていますが、使い心地はこの記事には書いていません。コマンド、設定名、画面の項目名は、公式の記載を写したもので、動作確認はしていません。公式のページは要約の形で取得したため、引用は最小限にして、ほとんどは言い換えています。読めなかったページと、読んだ範囲では見つからなかったことは、そのつど書きました。

先に結論

• 最初に確かめること。 自分が使えるログイン方式が、いま本当に使えるかどうかです。公式の資料を読むかぎり、個人のGoogleアカウント（無料のCode Assist for individuals、Google AI Pro、Google AI Ultra）でのログインは、2026年6月18日に提供が止まったと書かれています。この記事を読んだあとも、始める前に最新の告知を見てください。
• 続けて使えると公式が書いている道。 ブログには、有料のGemini APIキーなどで使い続けられること、Code AssistのStandardとEnterpriseは変更なし、と書かれています。Code Assistのライセンスを持つ組織や、有料のAPIキーを持つ人が対象です。無料のAPIキーとVertex AIについては、告知に名指しがなく、読んだ範囲では確認できていません。
• 入れ方。 公式のインストールページは、npm install -g @google/gemini-cli を挙げています。Node.js 20.0.0以上が必要です。入れたら、プロジェクトのフォルダで gemini と打ちます。
• 覚えさせる。 GEMINI.md を作ると、毎回の指示を省けます。「必ず守らせる」仕組みではなく、プロンプトと一緒に送られる資料です。
• 安全。 公式のTrusted foldersのページは、フォルダを信頼するかどうかを聞く機能（Trusted Folders）を標準ではオフと書いています。ただし設定リファレンスは security.folderTrust.enabled の既定値を true と書いていて、公式どうしが食い違っています。確認なしで実行するモード（YOLO）は、設定ファイルでは指定できず、起動のときのフラグだけだと書かれています。

今日どの方式で始めるか：3行の早見表

下の表は、公式の記載（ブログ、Code Assistのページ、認証ページ）を僕らが並べ直したものです。どの行も、始める前に最新の告知を確かめてください。

前提：用語をそろえる

• Gemini CLI：Googleが出している、ターミナルで動くオープンソース（Apache License 2.0）のAIエージェントです。
• Antigravity CLI：公式の告知が、Gemini CLIの行き先として挙げているツールです。コマンド名は agy と移行ガイドにあります。
• ログイン方式（認証）：どの窓口を通してモデルを呼ぶかの選び方です。方式によって、上限、料金、規約、プライバシーの扱いが変わる、と認証ページにあります。
• APIキー：Google AI Studioで作る、Gemini APIを呼ぶための文字列です。パスワードと同じに扱います。
• Vertex AI：Google Cloud上のAIの窓口です。Google Cloudのプロジェクトが要ります。
• GEMINI.md：Gemini CLIが毎回読み込む、指示を書いたMarkdownのファイルです。
• 承認モード：コマンド実行やファイル編集の前に、人に確認するかどうかの基準です。
• 環境変数：設定を渡すための、名前つきの値です。GEMINI_API_KEY のように使います。

まず確かめる：2026年6月18日の告知

ここは、この記事の中でいちばん大事な所です。公式の資料の中で、書かれていることが場所によって違います。読めたものを順に並べます。

読めた告知

「Googleアカウントでのログイン」について、公式の資料は割れています。geminicli.comの認証ページ（2026年9月18日更新）は、個人のGoogleアカウント（無料のCode Assist for individualsと、有料のAI Pro、Ultra）も「Sign in with Google」を選べる、と書いています。一方、Code Assistの公式ページ（2026年10月9日更新）は、「Login with Google」はGemini CLIでも使えない、と書いています。合っていない理由は、読んだ範囲では分かりません。

僕らの見立てです。日付が新しく具体的に「使えない」と書くCode Assistのページと、5月のブログを先に信じるのが安全です。認証ページの表には、告知より前の書き方が残っている可能性があります。ただし、公式がそう書いているわけではありません。個人のGoogleアカウントで始めたい人は、実際にログインの画面で通るかどうかを確かめる必要があります。

「無料枠（unpaid tier）」は何を指すのか

告知の先頭文は、対象を「unpaid tier and Google One users」としています。この「unpaid tier」が、Googleアカウントの無料枠だけを指すのか、無料のAPIキーも含むのか。読んだ範囲では、説明が見つかりませんでした。ブログは、Gemini CLIが続けて使えるものとして「有料のAPIキー」を挙げていて、無料のAPIキーには触れていません。認証ページと料金ページは、無料のAPIキーを方式として書き続けています。

つまり、無料のAPIキーでこれから始められるかどうかは、僕らには決められていません。

Antigravity CLIに移る場合の、読めた範囲

ブログには、Antigravity CLIは2026年5月19日から誰でもダウンロードできる、と書かれています（antigravity.google/download）。移行ガイドで読めたのは、次の点です。

• 初めて agy を動かして、昔の設定が見つかると、対話型のチェックリストが始まる。
• GEMINI.md は、そのまま使える。プロジェクトの GEMINI.md と AGENTS.md、全体の ~/.gemini/GEMINI.md を読む、と書かれている。
• 拡張機能は agy plugin import gemini で変換できる。
• スキルの置き場所は、全体が ~/.gemini/antigravity-cli/skills/、プロジェクトが .agents/skills/ に変わる。プロジェクトのスキルは、手で移す必要がある。
• MCPの設定は、~/.gemini/config/mcp_config.json（全体）と .agents/mcp_config.json（プロジェクト）に分かれる。

Antigravity CLIのインストールとログインの手順、料金や上限は、移行ガイドには書かれておらず、読めていません。この記事は、Gemini CLIの入口に絞ります。

インストール：入れる前の条件と、方法

条件（公式のInstallationページ）

Cloud ShellとCloud Workstationsには、Gemini CLIが最初から入っている、と書かれています。トラブルシューティングのページにも、Node.jsは20以上と書かれていて、2か所で合っています。地域の一覧は、読めていません。

入れ方（READMEとInstallationページ）

Anacondaの場合の、公式の例は次のとおりです。

conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
npm install -g @google/gemini-cli

動かすときは、gemini と打ちます。入れずに試すときは npx @google/gemini-cli です。Installationのページには、GitHubのmainブランチから直接動かす npx https://github.com/google-gemini/gemini-cli も載っています。これは、公開されたばかりの未検証の版を動かすことになるので、初心者には向きません（僕らの見立てです）。

3つのリリースの種類

READMEには、リリースが3種類あると書かれています。

初めての人は、安定版（@latest または、何も付けないとき）がいちばん安全です。これは、公式が安定版を標準としていることからの僕らの整理です。

更新とアンインストール

• 更新。 公式のチートシートに、gemini update（最新版に更新）が載っています。FAQのページには、npmで全体に入れた場合は npm install -g @google/gemini-cli@latest を実行する、と書かれています。どちらも公式の記載です。HomebrewやMacPortsでの更新方法は、読んだ範囲では見つかりませんでした。
• アンインストール。 公式のUninstallのページによると、次のとおりです。

npxのキャッシュを消すコマンドは、ほかのnpxで動かしたパッケージのキャッシュも消える、と公式が書いています。設定フォルダの ~/.gemini を消す方法は、このページには書かれていませんでした。

ログイン方式：3つの道を比べる

公式の認証ページ（geminicli.com、2026年9月18日更新）が示している選び方の表です。

認証ページでは、個人のアカウントに、無料のGemini Code Assist for individualsと、有料のGoogle AI Pro、Ultraを含めています。組織のアカウントは、会社・学校・Workspaceを通した有料のライセンスで、Google AI Ultra for Businessも含まれる、と書かれています。

方式1：Googleでログイン

公式の手順は、gemini を動かし、「Sign in with Google」を選び、ブラウザで入る、です。認証情報は、パソコンの中に保存され、次回から使われます。ブラウザは、ターミナルと同じパソコンから届く場所で動く必要がある、と書かれています。

Google Cloudのプロジェクトが要る場合は、次のとおりです。

• 会社・学校・Workspaceのアカウントを使う。
• Google Developer Program経由のGemini Code Assistのライセンスを持っている。
• Gemini Code Assistの購読で、ライセンスを持っている。

その場合の手順は、プロジェクトのIDを調べ、「Gemini for Cloud API」を有効にし、必要なIAMの権限を設定し、環境変数を設定する、です。公式の例は次のとおりです。

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

PowerShellでは $env:GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID" です。GOOGLE_CLOUD_PROJECT_ID という名前も使えると書かれていますが、CLIはまず GOOGLE_CLOUD_PROJECT を見ます。ページの中で2つの名前が混ざっているので、GOOGLE_CLOUD_PROJECT に揃えるのが無難です（これは僕らの見立てです）。権限の具体的な名前（IAMのロール）は、読めていません。

方式2：Gemini APIキー（Google AI Studio）

公式の手順は次のとおりです。

1. Google AI Studio（aistudio.google.com/app/apikey）でキーを作る。READMEには、aistudio.google.com/apikey とも書かれています。
2. 環境変数に入れる。macOS・Linuxは export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"。PowerShellは $env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"。
3. gemini を動かして、「Use Gemini API key」を選ぶ。

公式は、キーを機密の認証情報として扱い、無断で使われないよう守るように、と注意しています。ブログの記載では、続けて使えるのは「有料のGemini APIキー」です。無料のキーの扱いは、前の節のとおり、確認できていません。

方式3：Vertex AI

どの手順でも、次の2つの環境変数が要ります。

• GOOGLE_CLOUD_PROJECT：Vertex AI APIを有効にしたプロジェクトのID。
• GOOGLE_CLOUD_LOCATION：Vertex AIのリソースの場所。公式の例は us-central1。

そのうえで、3通りの認証があります。いずれも、設定したあと gemini を動かして「Vertex AI」を選びます。

Cのキーを使うと「API keys are not supported by this API...」のようなエラーが出る場合は、組織がAPIキーを制限している可能性があるので、AかBを使う、と書かれています。READMEの例では、Vertex AIのキーの場合は、GOOGLE_API_KEY に加えて GOOGLE_GENAI_USE_VERTEXAI=true を設定する書き方でした。認証ページの手順には、この変数は出ていません。2つのページで書き方が違うので、どちらが今の標準かは、読んだ範囲では決められていません。

環境変数を、毎回打たなくて済むようにする

公式が挙げている方法は2つです。

.env は、1行に1つ 名前=値 を書くファイルです。たとえば、ホームの ~/.gemini/.env に次の1行を書きます（形は僕らの例で、公式のページにそのままのコード例があったわけではありません）。

GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

プロジェクトの .env にキーを書くと、Gitで共有したときにキーも出てしまうおそれがあります。置くなら、ホームの ~/.gemini/.env のほうが安全です（僕らの見立てです）。

Google Cloudの上で動かす場合、ヘッドレスの場合

• Cloud Shellでは、通常、Cloud Shellの認証情報で自動的に認証される。
• Compute Engineでは、メタデータサーバーからのADC（Application Default Credentials）が使われる。
• 自動で通らないときは、上の対話型の方式を使う。
• ヘッドレス（人が画面の前にいない実行）は、保存された認証情報があればそれを使い、なければ、環境変数でGemini APIキーかVertex AIを設定する。

どの方式で、どの規約が適用されるか

公式の利用規約のページ（2026年4月10日更新）は、方式ごとに適用される規約を分けています。個人のGoogleアカウントはGoogleの利用規約とCode Assist for individualsのプライバシー通知（AI Pro、UltraはGoogle One追加利用規約も）。Code AssistのStandard、EnterpriseとVertex AIのキーはGoogle Cloudの規約とプライバシー通知。Gemini APIキーは、無料なら「Unpaid Services」、有料なら「Paid Services」の部分です。このページは、学習に使われるかどうかを方式ごとには書いていません。それぞれの規約を読む必要があります。利用統計は、設定で止められると書かれています（プライバシーポリシーとの関係は読めていません）。また、第三者のソフトを通してGemini CLIのOAuthでサービスに入ると、規約違反でアカウントの停止につながりうる、とあります。無料のAPIキーの入出力が改善に使われうる点は、前のガイド（03）に書いたとおりです。

無料枠の公式の記載：場所ごとの数字を並べる

ここは、公式の資料のどれを見るかで、数字が変わります。取得できた範囲を、日付つきで並べます。

注意点です。

• APIキーの無料枠の数字が、2か所で違います。 料金のページは1日250件でFlashのみ、READMEは1日1,000件（FlashとProの混合）です。前のガイド（04）にも同じ食い違いを書きました。どちらが新しいかは確認できていません。
• Googleアカウントの無料枠は、告知と合いません。 料金のページの更新日は告知と同じ2026年6月18日なのに、Googleアカウントの1日1,000件を書き続け、同じページの先頭は無料枠の利用者は置き換えられたと書いています。「いま使える無料枠」とは読まないほうが安全です（僕らの見立てです）。
• 有料の固定料金の枠。 個人向けはGoogle AI Proが1日1,500件、Google AI Ultraが1日2,000件。組織向けはCode Assist Standardが1日1,500件、Enterpriseが1日2,000件、Workspace AI Ultraが1日2,000件です。「Google AI Plus」などは対象外と書かれています。ただし、個人のAI Pro・Ultraのログインが止まったという告知とは合っていません。
• 従量課金。 Gemini APIキーはトークンや呼び出しごとの支払いで、上限は料金の階層で変わります。Vertex AI（通常のモード）は共有の割り当てか、事前に買った処理能力で、費用はモデルとトークンの量で決まります。
• Workspaceのプランは別。 Gemini for Workspaceのプランは、Gemini CLIを動かすAPIの利用には当てはまらない、と書かれています。
• 分単位の上限と使用量。 要求はユーザーごとに1分あたりでも制限され、需要が高いときは提供が保証されません。分単位の数字は書かれていませんでした。使った量は、CLIの中で /stats model で見ます。

APIの料金や無料の上限のモデルごとの数字は、前のガイド（03）にまとめました。ここでは、読めた数字だけを載せ、確かめられない数字は書いていません。

GEMINI.md：毎回の説明を省く

前のガイド（04）に、GEMINI.mdの仕組みの概要は書きました。ここでは、実際に作って使う手順に進みます。公式のgemini-mdのページと、メモリ管理のチュートリアルによると、次のとおりです。

どこに置くか、どう読まれるか

見つかったファイルは、すべてつなげて、毎回のプロンプトと一緒に送られます。CLIの画面の下には、読み込まれたコンテキストファイルの数が出る、と書かれています。チュートリアルの例では、プロジェクトのルートの ./GEMINI.md と、サブフォルダの ./src/GEMINI.md が挙がっています。

作る

1. プロジェクトのルートに、GEMINI.md という名前のファイルを作る。
2. Markdownで指示を書く。チュートリアルの例は「スタイルはTailwind CSSを使い、独自のCSSは書かない」という趣旨の1行です。
3. 新しいセッションを始めると、自動で読み込まれる。

下書きを作らせるには、/init です。コマンド一覧に、現在のフォルダから、プロジェクト用の GEMINI.md を作る、と書かれています。

公式のgemini-mdのページにあるサンプルは、次のとおりです（TypeScriptのライブラリ向け。コピーして、自分のプロジェクトに合わせて書き換えられます）。

# Project: My TypeScript Library

## General Instructions

- When you generate new TypeScript code, follow the existing coding style.
- Ensure all new functions and classes have JSDoc comments.
- Prefer functional programming paradigms where appropriate.

## Coding Style

- Use 2 spaces for indentation.
- Prefix interface names with `I` (for example, `IUserService`).
- Always use strict equality (`===` and `!==`).

一般的な指示（既存のコードスタイルに従う、JSDocを付ける、適切なら関数型を好む）と、コードスタイル（2スペース、インターフェース名の頭に I、=== と !==）に分けて書いています。「具体的に書くほど守られやすい」といった書き方のコツは、読んだ公式ページには見つかりませんでした。

確かめる、読み直す、分ける

• /memory show：モデルに送られる、つなげた指示の全体を表示する。無視されるルールがあるときの点検に使う、と書かれている。
• /memory reload：実行中のセッションで GEMINI.md を編集したあとに、読み直す。
• @ での取り込み：大きなファイルは、@./components/instructions.md や @../shared/style-guide.md のように、相対パスでも絶対パスでも取り込める。
• 別の名前にする：settings.json の context.fileName に、1つの名前か、名前のリストを書ける。公式の例は ["AGENTS.md", "CONTEXT.md", "GEMINI.md"]。

「覚えて」と頼む方法もあります。チュートリアルによると、設定ファイルなしに、チャットで「constをletより優先して使うのが好み、と覚えて」のように頼むと、エージェントが適切なメモリのMarkdownファイルを書き換え、次のセッションから読み込まれます。このメモリファイルの正確な場所は、このページには書かれていませんでした。

コマンドの書き方に、公式のページ同士で違いがあります。コマンドリファレンスのページは /memory list|refresh|show と書いていて、reload は載っていません。チートシートとチュートリアル、gemini-mdのページは /memory reload と書いています。どちらが今の動作と合うのかは、この記事では動作を確かめていないので、決められていません。動かなかったら、もう一方を試すことになります。

書かれていないこと

• 信頼されていないフォルダでは、Trusted foldersのページに「Automatic memory loading is disabled」とあり、ローカルの設定で指定したフォルダからの自動の読み込みが止まります。このページは、その節でGEMINI.mdという名前を挙げていません。プロジェクトのGEMINI.mdが読まれない場合は、フォルダを信頼したかどうかも確認してください（僕らの整理です）。
• 「GEMINI.mdに書けば必ず守られる」という保証は、読んだ範囲では書かれていません。毎回送られる指示、という説明です。必ず止めたいことは、承認モードやポリシーエンジンの役目です（前のガイド04）。
• 「秘密を書かない」という注意は、読んだページには見つかりませんでした。毎回モデルへ送られる内容なので、パスワードやAPIキーは書かないほうが安全です（僕らの見立てです）。

最初の10分でやること

公式に書かれている手順を、僕らが並べ直したものです。順番や「練習用のフォルダで」という進め方は、僕らの整理です。根拠は括弧に書きました。

0分：どの道で始めるかを決める。 有料のGemini APIキー、Google Cloudのプロジェクト、組織のCode Assistのライセンスのどれかがあれば、この記事の方式で進めます。個人のGoogleアカウントしかない場合は、ログインが通らない可能性が高いので（上の告知）、手順4で確かめます。通らなければ、ブログのAntigravity CLIの案内を読みます。

1分：環境を確かめる。 node -v でNode.jsが20.0.0以上か見ます。Code Assistが使える地域かも、公式の一覧で確かめます（Installation）。

2分：入れる。 npm install -g @google/gemini-cli（Quickstart）。試すだけなら npx @google/gemini-cli。gemini -v で版が出れば成功です（FAQ）。「command not found」はPATHの問題の可能性がある、と公式にあります（Troubleshooting）。

3分：練習用のフォルダを作って入る。 大事なファイルがない新しいフォルダにします。Gemini CLIは、ファイルを書き、コマンドも動かせるからです（僕らの整理）。

4分：ログインする。 - APIキー：export GEMINI_API_KEY="..." を設定して gemini を動かし、「Use Gemini API key」を選びます（Authentication）。 - Googleアカウント：gemini を動かし、「How would you like to authenticate for this project?」で「1. Sign in with Google」を選び、アカウントを選んで「Sign in」を押します（Quickstart）。会社・学校のアカウントは、プロジェクトの設定が要ることがあります。 - あとで方式を変えるときは、/auth のダイアログを使います（コマンド一覧）。

5分：確認を読みながら1つ頼む。 承認モードの標準は default です（Configuration）。--yolo（-y）はチートシートで非推奨とされ、--approval-mode=yolo が示されています。最初は使いません（僕らの見立て）。Quickstartの例は、ファイル名の変更、リポジトリを読んで説明、CSVの結合、テストを書く、などです。実行の前に許可を求められ、「Allow once」を選べる、とあります。例は可能性の紹介で、結果はモデルや環境で変わる、と公式が断っています。

6分：@ でファイルを見せる。 @<パス> で中身をプロンプトに入れられます。Gitで無視されるファイルは、標準で除外されます（コマンド一覧）。

7〜8分：/init で GEMINI.md を作る。 できた内容を読んで直し、/memory show で読み込まれた内容を確かめます。

9分：使用量を見て終わる。 /stats model で使用量と上限を見ます（Quickstart）。/quit で終わります（--delete を付けると、そのセッションの履歴と一時ファイルも消える、とコマンド一覧にあります）。

この手順を、動かして確かめたものではありません。

最初に覚えるコマンド

公式のチートシートとコマンド一覧から、始めに役立つものを選びました。

モデルの別名は、チートシートに auto（gemini-2.5-pro または gemini-3-pro-preview）、flash（gemini-2.5-flash）などと書かれていました。このページの更新日は2026年5月1日で、モデル名は変わりやすいので、いま使える名前は公式の表示で確かめてください。

安全のための最初の3つ

前のガイド（04）で、承認モードやポリシーエンジンの全体像を書きました。ここでは、始める前に押さえたい3つに絞ります。

1. Trusted Folders（フォルダを信頼するか）

公式のページ（2026年4月23日更新）によると、これは、プロジェクトのフォルダを承認してから、そのプロジェクト固有の設定を読み込む安全機能です。Trusted foldersのページは「標準ではオフ」とし、ユーザーの settings.json に次のように書くと有効になる、と説明しています。一方、設定リファレンスは既定値を true としていて、どちらが今の動作かは、読んだ範囲では決められていません。次の1行を自分で書いて有効にしておくのが確実です。

{ "security": { "folderTrust": { "enabled": true } } }

有効にすると、「Trust folder」（このフォルダを信頼）、「Trust parent folder」（親と、その下すべてを信頼）、「Don't trust」（制限された安全モード）から選びます。選ぶ前に、そのフォルダにあるコマンド、MCPサーバー、フック、スキル、設定の上書きの一覧と警告が出ます。

信頼しないフォルダでは、プロジェクトの .gemini/settings.json と .env が読み込まれず、拡張機能の導入・更新・削除ができず、ツールの自動承認が無効になり（必ず確認が出る）、MCPサーバーはつながらず、独自の .toml コマンドも読み込まれません。結果は ~/.gemini/trustedFolders.json に保存され、現在のフォルダの信頼は /permissions で変えられます。人が答えられないヘッドレスやCIで信頼されていないフォルダを開くと、FatalUntrustedWorkspaceError で終了します。避けるには --skip-trust か、環境変数 GEMINI_CLI_TRUST_WORKSPACE=true で、そのセッションだけ信頼します。

他人が作ったプロジェクトを開くときは、確認を読んで、迷ったら信頼しないのが安全です（僕らの見立てです）。

2. 承認モード

チートシートでは、--approval-mode は default、auto_edit、yolo、plan の4つです。設定ファイルの general.defaultApprovalMode は、標準が "default" で、"default"、"auto_edit"、"plan" を受け付け、YOLOはコマンドラインからしか有効にできない、と書かれています。同じ設定リファレンスには、security.disableYoloMode（標準は false）という設定があり、「YOLOモードを、フラグで有効にされても無効にする」という趣旨の説明です。共有の環境でYOLOを使わせたくないときの手がかりになります（使い方の例は読めていません）。前のガイド（04）は、承認モードを autoEdit と書きました。Policy Engineのページがそう書いていたためです。今回読んだチートシートと設定のページは auto_edit です。新しい書き方に合わせて、04の書き方は、こちらを優先してください。

3. サンドボックス

公式のページ（2026年7月17日更新）によると、有効にする方法は、フラグ -s または --sandbox、環境変数 GEMINI_SANDBOX=true（または docker、podman、sandbox-exec、runsc、lxc）、settings.json の tools の下の "sandbox": true です。優先順位はこの順です。なお設定リファレンスは、tools.sandbox を「Legacy full-process sandbox execution environment」（古い、プロセス全体のサンドボックス）と説明し、値は真偽値、サンドボックスのプロファイルのパス、明示的なコマンドのどれか、標準は未設定（undefined）と書いています。標準の状態は明記されておらず、「次の方法で有効にする」という書き方から、標準ではオフと読めます（僕らの読みです）。方法には、macOSのSeatbelt、Docker・podman（既定のイメージは ghcr.io/google/gemini-cli:latest）、gVisor（Linux）、LXC（Linuxで実験的）などがあります。公式は、サンドボックスは「リスクを減らすが、すべてを防ぐわけではない」という趣旨で、GUIのアプリは動かないことがある、とも書いています。

つまずいたとき（公式のTroubleshootingより）

プロキシの設定手順と、429（上限超過）の対処は、このページには見つかりませんでした。ページの先頭にも「無料枠とGoogle OneはAntigravity CLIに置き換えられた」という告知があり、ログインで失敗したときは、まずこれを確認します。

気をつけること

• この記事は、実際に使って確かめた記録ではありません。運営者はGeminiを入れていますが、使い心地はこの記事には書いていません。コマンド、設定名、画面の文言は、公式の記載を写したものです。
• 公式のページは要約の形で取得しました。「書かれていなかった」は、「読んだ範囲では見つからなかった」という意味です。
• 公式の資料どうしが食い違っています。個人のGoogleアカウントでのログイン、無料APIキーの上限、Vertex AIの環境変数、/memory のサブコマンド、承認モードの名前（auto_edit と autoEdit）、Trusted Foldersの既定値（オフと true）です。決めつけず、並べて書きました。
• ドキュメントサイトの先頭に、2026年6月18日の置き換えの告知があります。通る方法があとで変わることは十分ありえます。始める前に、公式のブログとCode Assistの廃止のページを見てください。
• 価格、上限、プラン名、モデル名、日付は変わりやすいものです。ここの数字は、公式の表示のまま、確認日2026年10月24日までに読めたものです。日本での提供や価格は確認できていません。
• GitHubのドキュメント（authentication.md、installation.md）は取得に失敗したため、同じ内容のgeminicli.comのページを根拠にしています。GitHubのファイルとの差は確かめていません。
• 読めていないもの：Antigravity CLIの入れ方、ログイン、料金、上限。Code Assistの対応地域の一覧。IAMのロール名。HomebrewとMacPortsの更新方法。security.auth.selectedType の値の一覧。Windows用サンドボックスの手順。「Gemini 3 on Gemini CLI」のページ。
• 無料のAPIキーの入出力は、Googleの製品改善に使われうる、と前のガイド（03）に書きました。仕事の資料や個人の情報を入れる前に、規約を確かめてください。
• この記事は、法律や個人情報、セキュリティの助言ではありません。規約の解釈は専門家に確認してください。

出典

• Gemini CLI（GitHubのREADME、google-gemini、確認日2026-10-24）
• Gemini CLI Releases（GitHub、google-gemini、確認日2026-10-24）
• Gemini CLI docs 概要と目次（Gemini CLI Docs、Google、確認日2026-10-24）
• Quickstart（Gemini CLI Docs、Google、確認日2026-10-24）
• Installation（Gemini CLI Docs、Google、確認日2026-10-24）
• Authentication（Gemini CLI Docs、Google、2026年9月18日更新、確認日2026-10-24）
• CLI cheatsheet（Gemini CLI Docs、Google、2026年5月1日更新、確認日2026-10-24）
• Command reference（Gemini CLI Docs、Google、確認日2026-10-24）
• Configuration reference（Gemini CLI Docs、Google、確認日2026-10-24）
• Quota and pricing（Gemini CLI Docs、Google、2026年6月18日更新、確認日2026-10-24）
• Terms and privacy（Gemini CLI Docs、Google、2026年4月10日更新、確認日2026-10-24）
• Project context GEMINI.md（GitHub、google-gemini、確認日2026-10-24）
• Manage context and memory（Gemini CLI Docs、Google、確認日2026-10-24）
• Trusted folders（Gemini CLI Docs、Google、2026年4月23日更新、確認日2026-10-24）
• Sandboxing（Gemini CLI Docs、Google、2026年7月17日更新、確認日2026-10-24）
• Headless mode（Gemini CLI Docs、Google、確認日2026-10-24）
• Troubleshooting（Gemini CLI Docs、Google、確認日2026-10-24）
• FAQ（Gemini CLI Docs、Google、確認日2026-10-24）
• Uninstall（Gemini CLI Docs、Google、確認日2026-10-24）
• An important update: Transitioning Gemini CLI to Antigravity CLI（Google Developers Blog、Google、2026年5月19日、確認日2026-10-24）
• Gemini Code Assist consumer accounts（Google for Developers、Google、2026年10月9日更新、確認日2026-10-24）
• Antigravity CLI：Gemini CLI migration guide（Antigravity Docs、Google、確認日2026-10-24）