Gemini CLIとは｜無料枠終了後の使い方とClaude Codeとの違い

Gemini CLIとは｜ターミナルで動くGoogle製のAIエージェント

結論から言うと、Gemini CLIはターミナルに常駐してコードを読み書きするAIエージェントです。エディタの拡張機能ではなく、シェルから起動するコマンドライン製品である点が出発点になります。

公式リポジトリの説明では、Gemini CLIは「Google CloudのエンタープライズなGemini Code Assistワークフロー向けに維持されているオープンソースのターミナルエージェント」と位置づけられています（google-gemini/gemini-cli）。ここは重要な変化です。登場当初に語られていた「誰でも無料で使えるGoogleのCLI」という説明は、執筆時点では当てはまりません。

Gemini CLIでできること

リポジトリに挙がっている主な機能は次のとおりです。

• 大規模なコードベースの照会と編集（ファイルの読み取り・書き換え）

• PDFや画像を入力にしたアプリケーション生成

• シェルコマンドの実行と、実行結果を踏まえた修正

• MCP（Model Context Protocol、AIツールを外部データ源につなぐ共通規格）サーバーとの接続

• GEMINI.mdによるプロジェクト固有のルール読み込み

• 非対話モードでの実行（スクリプトやCIへの組み込み）

• サンドボックス実行と信頼済みフォルダによる実行範囲の制限

このうち実務で効くのは、MCP連携と非対話モードです。チケット管理やドキュメントとつないだり、シェルスクリプトの一部としてエージェントを呼んだりできます。

CLI型とIDE統合型は役割が違う

AIコーディングツールは、大きく3タイプに分かれます。エディタに組み込むIDE統合型、ターミナルで自走させるCLI型（自律エージェント型）、VS Code拡張としてエージェントを動かす型です。Gemini CLIは2つめに属します。

タイプ別の整理はAIコーディングエージェント比較｜Cursor・Claude Code・Clineの選び方で扱っているので、そもそもどのタイプを選ぶかから迷っている場合はそちらが先です。

ミニFAQ

Gemini CLIとGemini APIは別物ですか。

別物です。Gemini APIはモデルを呼ぶためのインターフェースで、Gemini CLIはそのAPIを使ってコードを読み書きするエージェント本体にあたります。APIを直接叩く方法はGemini APIの使い方｜料金・無料枠・モデル選定とOpenAI APIとの違いで解説しています。

ブラウザ版のGeminiと何が違うのですか。

ファイルとシェルに触れるかどうかが決定的な違いです。CLIはローカルのリポジトリを直接編集し、テストを走らせ、失敗したら直すところまで一続きで動かせます。

2026年6月18日の変更点｜個人向け無料アクセスはAntigravity CLIへ

2026年6月18日を境に、個人が無料でGemini CLIを使う経路はなくなりました。 Googleの公式告知では、同日からGemini Code Assist for individuals、Google AI Pro、Google AI Ultraの各層がリクエストの受け付けを停止し、Antigravity製品群への移行が案内されています（Gemini Code Assist for individuals の終了に関する公式ページ）。

Gemini CLI側のREADMEにも、個人向けの無料アクセスとGoogle AI Pro／Ultra（Google One）は2026年6月18日にAntigravity CLIへ移ったと明記されています。

終了したもの／残ったものの対比

ここを混同すると判断を誤ります。「Gemini CLIが廃止された」という説明を見かけますが、正確ではありません。

つまり「製品は残っているが、無料の入口だけが閉じた」という状態です。

geminiコマンドが応答しないときの切り分け

参画先で急に動かなくなった、という相談が出やすい時期でもあります。原因の切り分けは次の順番が早いはずです。

1. 認証方式を確認する。Googleアカウントでのログインを使っていたなら、原因はほぼこれで確定

2. 環境変数にAPIキーが設定されているか確認する

3. Code Assistライセンス経由なら、Google Cloudプロジェクトの指定が外れていないか確認する

4. それでも切り分かない場合はバージョンを確認する。公式リポジトリの記載では、執筆時点のStableは毎週火曜のUTC 20:00に更新される運用のため、意図せず新しいバージョンに上がっていることがあります

ミニFAQ

移行しないまま放置していた設定ファイルは消えますか。

ローカルのGEMINI.mdや設定ファイルが削除されるわけではありません。認証が通らないだけなので、ルートを選び直せばそのまま使えます。

今からGemini CLIを使う3つのルート

結論として、選択肢は「Gemini Code Assistライセンス」「Gemini APIキー」「Vertex AI」の3つです。READMEの認証セクションにもこの3方式が挙げられています。個人で無料から始めたい場合だけは、Gemini CLIではなくAntigravity CLIが答えになります。

表の「費用の考え方」は方式の違いを示したもので、金額を保証するものではありません。各ルートの単価と無料枠は改定されるため、数字は必ず公式ページで確認してください。

自分はどのルートか

判断は3問で足ります。

1. 常駐先・発注元がGoogle CloudとGemini Code Assistを契約しているか。していればCode Assistルート

2. していない場合、会社の環境ではなく自分の環境で動かすのか。自分の環境ならAPIキーかAntigravity CLI

3. 業務データを扱う前提か。扱うなら、課金先とログの保存先を発注元と合意できるVertex AIまたはCode Assistへ寄せる

APIキールートを選ぶときは、無料枠の対象モデルやレート上限が随時変わる点に注意してください。公式も、実際の上限はプロジェクトの利用階層によって変わると案内しています（Gemini APIの料金／レート上限）。記事に書かれた数字ではなく、使う直前に自分のプロジェクトのダッシュボードで確認するのが確実です。

インストールと初期設定｜最短10分の手順

インストール自体は数分で終わります。Node.jsが導入済みで、認証に使うキーやライセンスがすでに手元にある場合は、コマンド入力から初回の応答までおおむね10分前後が目安です。前提が揃っていない場合、時間がかかるのは認証の準備のほうです。Google Cloudプロジェクトの払い出しから始めるなら、別途数日かかることもあります。

インストール

リポジトリに記載されている方法は次のとおりです。

• 試すだけなら npx @google/gemini-cli

• グローバルインストールは npm install -g @google/gemini-cli

• macOS／LinuxのHomebrewなら brew install gemini-cli

• MacPortsなら sudo port install gemini-cli

プロジェクトごとにNode.jsのバージョンが違う現場では、グローバルインストールよりnpx実行のほうが事故が少なくなります。グローバルに入れる場合は、Nodeのバージョン管理ツールを切り替えたときに参照先が変わる点を頭に置いておいてください。

APIキーでの認証

個人検証ならこのルートが最短です。Google AI StudioでAPIキーを発行し、環境変数 GEMINI_API_KEY に設定します。シェルの設定ファイルに直書きすると、リポジトリやドットファイルの共有時に漏れる危険があります。シークレット管理ツールか、プロジェクト外の読み取り制限付きファイルに置いてください。

キーを発行したら、課金アラートも同時に設定しておきます。エージェントは自走する分、想定よりトークンを消費することがあります。

GEMINI.mdでプロジェクトの前提を渡す

最初に効く設定がこれです。リポジトリのルートにGEMINI.mdを置くと、セッション開始時にエージェントが読み込みます。書くべきなのは、コーディング規約、使ってよいライブラリ、触ってはいけないディレクトリ、テストの実行コマンドあたりです。

分量は多くしすぎないほうが機能します。常に読み込まれる以上、長文は毎回トークンを消費します。

なお、GEMINI.mdとAGENTS.mdはGemini CLIとAntigravity CLIの両方で同じものが使えます。将来の乗り換えを考えても、この2ファイルに情報を寄せておくのが無難です。

基本的な使い方｜対話モードと非対話実行

使い方は2系統しかありません。ターミナルに常駐させて対話する使い方と、1回きりの指示を投げる非対話実行です。

対話モードは、コードベースの調査や段階的なリファクタに向きます。「このディレクトリの責務を説明して」から始めて、理解が合ったところで編集に進む流れが安全です。

非対話実行は自動化向けです。ログを食わせて異常を要約させる、差分を渡してレビュー観点を出させる、といった使い方ができます。CIに組み込む場合は、書き込み権限を与えない設定から始めてください。

最初の30分でやること

導入直後にここを済ませておくと、後の事故が減ります。

1. 読み取り専用で1つ質問を投げ、挙動を確認する

2. GEMINI.mdに規約と禁止事項を書く

3. サンドボックス設定と信頼済みフォルダを確認し、エージェントが触れる範囲を絞る

4. 小さなブランチを切り、実際にコミット単位の変更をさせてみる

5. 生成された差分を自分でレビューし、どこを間違えるかの癖を把握する

4と5を飛ばして本番ブランチで使い始めるのが、いちばん多い失敗です。

MCPサーバーと拡張機能

MCPサーバーを登録すると、エージェントの手が外部ツールまで伸びます。設計時の注意点は、権限を広げすぎないことに尽きます。読み取りだけで足りるツールに書き込み権限を渡さない、人の承認を挟む箇所を決めておく、といった設計はAIエージェントの権限設計｜最小権限とHuman-in-the-loopの実装で整理しています。

Claude Codeとの違い｜比較表と使い分け

どちらもターミナルで動く自律型エージェントで、できることは重なります。分かれるのは、入口（課金・認証）と、動かせる場所の広さです。

客先のコードを扱うなら、機能差よりこの最終行のほうが先に効きます。送信先と課金主体が自分側になる構成は、合意なしに選ばないでください。

Claude Code側の提供形態と課金方式は公式ドキュメントに、製品としての概要はClaude Codeとは｜使い方・料金プラン・案件動向を解説にまとめてあります。同じCLI型ではCodex CLIとは｜使い方・料金とClaude Codeとの違いも比較対象になります。

使い分けの判断軸

機能の優劣で選ぶより、案件の環境で選ぶほうが外れません。

• 常駐先がGoogle Cloud中心で、Code Assistのライセンスがある → Gemini CLI

• 開発環境がクラウド非依存で、個人の契約で持ち込む → Claude Code、またはCodex CLI

• OSSで自前のモデル接続まで含めて制御したい → Clineとは｜OSSのAIコーディングエージェントの使い方・料金・違いも候補に入ります

• 個人の検証用に無料から始めたい → Antigravity CLI

複数案件を並行している場合、現場ごとに別のツールを使うことになります。これは避けられません。だからこそ、規約をAGENTS.mdに寄せておく意味があります。

ミニFAQ

両方インストールしても競合しませんか。

コマンド名が違うため、同一マシンに共存できます。ただし設定ファイルの管理が煩雑になるので、規約はAGENTS.mdに一本化しておくと移動が楽になります。

Antigravity CLIへの移行手順｜設定の引き継ぎ

個人利用でGemini CLIが使えなくなったなら、公式が案内している移行先はAntigravity CLIです。インストールはシェルスクリプトで、macOS／Linuxは curl -fsSL https://antigravity.google/cli/install.sh | bash、Windows PowerShellは irm https://antigravity.google/cli/install.ps1 | iex が案内されています。起動コマンドは agy です。

この形式のインストールは、ダウンロードしたスクリプトをそのまま実行します。URLが公式ドメインであることを確認し、社給PCや客先環境ではスクリプト実行の可否を情報システム部門に確認してから進めてください。手順をコピーする際も、記事の文字列ではなく公式ページのコマンドを使うほうが安全です。

対話起動は agy、プロンプト付き起動は agy -i、非対話実行は agy -p というかたちで、Gemini CLIに近い操作感になっています。消費量は /usage コマンドで確認できます。

引き継げるもの／手作業が要るもの

移行ガイドによると、初回起動時にレガシー設定を検出して対話的なチェックリストを出す仕組みがあります。手を動かす量は多くありません。

詳細な手順とキー名の対応はGemini CLIからの移行ガイドに載っています。MCPを何本も登録している環境では、ここだけ事前に差分を見ておくと安全です。

客先案件で使う前に確認すること

ここはツールの話ではなく契約の話です。生成AIツールの持ち込み可否は、案件ごとに結論が変わります。 確認せずに使い始めると、情報持ち出しの扱いで揉めます。

参画前または参画初週に、次の5点を発注元と確認してください。

1. 生成AIコーディングツールの使用可否と、使ってよい範囲（自分の検証用か、納品物の生成にも使ってよいか）

2. ソースコードを外部APIへ送信することの可否。これが実質的な論点になります

3. 使用するアカウントと課金主体（自分の契約か、発注元のライセンスか）

4. プロンプトと応答のログがどこに保存され、誰が見られるか

5. 成果物の権利と、AI生成物を含むことの事前開示が必要かどうか

持ち込みPCやセキュリティ要件まわりの実務は客先セキュリティ要件対応｜ISMS・Pマーク・持ち込みPCの実務にまとめています。口頭の了承だけで進めず、メールやチャットなど後から参照できる形で残しておくのが無難です。

Code Assistライセンス経由で使う場合、契約主体が発注元になるため、この確認はおおむね自動的にクリアされます。逆に、自分のAPIキーで動かす場合は、送信先と課金先が自分側になる点を明示して合意を取る必要があります。

フリーランス案件での使いどころと単価への影響

先に率直なところを書くと、特定のCLIツールを使えること自体が単価に直結するわけではありません。募集要件にツール名として「Gemini CLI」が指定される例は、2026年11月時点で公開されている求人を見るかぎり一般的とは言えません（エージェント経由の非公開案件までは確認できないため、公開情報の範囲での話になります）。

評価につながりやすいのは、ツール名ではなく次のような動き方です。

• レビュー前提の生成物を出せること（AIの出力をそのまま投げない）

• エージェントに渡す前提条件を、規約ファイルとして言語化できること

• MCPや権限設計を含めて、チームが安全に使える形に落とせること

• 自動化の範囲と、人が確認する境界を設計できること

このうち3つめと4つめは、AIエージェントそのものを作る案件の要件とも重なります。単価帯の考え方はAIエージェント開発案件の単価相場｜必要スキル・獲得ルートを解説で整理しています。

いま自分がどのくらいの単価を狙えるかの目安は、無料のフリーランスエンジニア単価診断で確認できます。単価を体系的に上げる考え方は【2026年最新版】フリーランスエンジニアの単価相場と単価の上げ方とは？にまとめてあります。

案件を選ぶ段階で何を優先するかは案件の選び方｜フリーランスエンジニアが単価・稼働・スキルで決める優先順位が参考になります。AI関連の募集を見たい場合はAIエンジニアの案件一覧から探せます。

よくある失敗と対策

古い情報のまま「無料で使える」と思い込む

検索上位の解説記事には、個人向け提供が終わる前に書かれたものが残っています。インストール手順だけ真似してログインで止まる、というパターンに陥りやすい状況です。公式リポジトリと終了告知ページを先に見るのが近道です。

APIキーをシェル設定に直書きする

環境変数に入れること自体は正しいのですが、置き場所で事故ります。ドットファイルをGitHubで公開している方は特に危険です。キーが漏れた場合、課金は自分に来ます。

権限を絞らずに本番ブランチで使う

エージェントにシェル実行を許したまま、確認なしで走らせる構成は危険です。最初はサンドボックスと信頼済みフォルダで範囲を絞り、ブランチを分けて挙動を把握してください。

客先での使用可否を確認しないまま使う

先述のとおり、実質的な論点は「ソースコードを外部へ送信してよいか」です。許可が曖昧なまま使い続けると、後から成果物の扱いまで遡って問題になります。

ツールを増やしすぎて設定が散らかる

CursorもClaude CodeもGemini CLIも入れた結果、どこに規約を書いたか分からなくなるケースです。AGENTS.mdに寄せ、ツール固有の設定だけを各ファイルに残す運用に切り替えてください。

実践チェックリスト

導入前

• 自分が使うルート（Code Assist／APIキー／Vertex AI／Antigravity CLI）を1つに決めた

• 客先案件で使う場合、生成AIツールの持ち込み可否を文面で確認した

• ソースコードの外部送信について合意が取れている

• APIキーの保管場所と課金アラートを設定した

導入直後

• 読み取り専用で挙動を確認した

• GEMINI.mdまたはAGENTS.mdに規約と禁止事項を書いた

• サンドボックスと信頼済みフォルダで実行範囲を絞った

• 検証用ブランチで実際の差分を出し、自分でレビューした

運用中

• トークン消費と課金額を定期的に確認している

• バージョン更新で挙動が変わっていないか確認している

• 生成物をそのまま納品せず、必ずレビューを通している

まとめ

Gemini CLIは廃止されていません。無料の入口だけが2026年6月18日に閉じ、個人の利用はAntigravity CLIへ移りました。 今からGemini CLIを使うなら、Gemini Code Assistライセンス・Gemini APIキー・Vertex AIの3ルートから、案件の環境に合うものを選ぶことになります。

要点を整理します。

• 現在のGemini CLIは、Google CloudのGemini Code Assistワークフロー向けに維持されているOSS

• Googleアカウントでのログインは使えない。2026年6月18日以降に急に動かなくなった場合は、まずここを疑う

• 個人で無料から試すならAntigravity CLI（コマンド名 agy）へ。GEMINI.mdとAGENTS.mdはそのまま使える

• Claude Codeとの違いは機能より入口。常駐先のクラウド環境で選ぶと外れにくい

• 客先で使う前に、生成AIツールの持ち込み可否とソースコードの外部送信可否を文面で確認する

• ツール名そのものより、規約の言語化と権限設計ができることが評価につながりやすい

次の一歩としては、まず自分のルートを1つ決めてください。そのうえで検証用ブランチを切り、GEMINI.mdを書いてから小さな変更を1件やらせてみる。ここまでやると、自分の案件で使えるかどうかの判断がつきます。

参照した一次情報

• Gemini CLI 公式リポジトリ（google-gemini/gemini-cli）

• Gemini Code Assist for individuals の終了に関する公式案内

• Antigravity CLI はじめかた

• Gemini CLI からの移行ガイド

• Gemini API の料金

• Claude Code 公式ドキュメント