Gemini CLI のインストールと GEMINI.md の書き方:Google アカウントで無料で始める

Gemini CLI は Google が公開しているオープンソースのターミナル向けコーディングエージェントです。最大の特徴は、個人の Google アカウントでログインするだけで、上限付きながら無料で使い始められることです。

この記事では、インストールからログイン、最初のタスクまでの手順と、プロジェクトのルールを伝えるための GEMINI.md の書き方をまとめます。

前提条件

項目	内容
Node.js	20 以上
OS	macOS、Linux、Windows
アカウント	個人の Google アカウント(無料枠)、Gemini API キー、または Google Cloud(Vertex AI)

インストール

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

# または Homebrew (macOS / Linux)
brew install gemini-cli

# または MacPorts (macOS)
sudo port install gemini-cli

# インストールせずに試す
npx @google/gemini-cli

公式の README は npm・Homebrew・MacPorts・Anaconda の 4 通りを挙げています。Homebrew は macOS だけでなく Linux も対象です。

gemini --version

ログイン

プロジェクトのディレクトリで gemini を起動すると、初回に認証方法を選ぶ画面が出ます。

cd path/to/project
gemini

認証方法	特徴
Google アカウントでログイン	ブラウザで認証。個人アカウントなら無料枠で利用できる
Gemini API キー	Google AI Studio で発行。環境変数 GEMINI_API_KEY に設定
Vertex AI	Google Cloud プロジェクト経由。企業利用向け

# API キーを使う場合
export GEMINI_API_KEY="your-key"

無料枠の上限やデータの扱いは Gemini CLI の無料枠と制限 で詳しく説明しています。

最初のタスク

このリポジトリの構成を説明して。テストの実行方法も教えて

Gemini CLI はファイルを読み、必要ならコマンドを実行します。ファイルの変更やコマンド実行の前には確認が入ります。「常に許可」を選ぶと、そのセッション中は同種の操作が自動で通ります。

対話中の主なコマンド:

コマンド	内容
/help	コマンド一覧
/memory show	読み込まれた GEMINI.md の内容を表示
/memory refresh	GEMINI.md を再読み込み
/tools	使えるツールの一覧
/mcp	MCP サーバーの状態
/stats	トークン使用量
/clear	画面と履歴をクリア

GEMINI.md の役割と配置

Gemini CLI は起動時に GEMINI.md を探して読み込み、プロジェクトの前提として扱います。Claude Code の CLAUDE.md、Codex の AGENTS.md と同じ役割です。

配置場所	用途
~/.gemini/GEMINI.md	全プロジェクト共通の個人的な好み
リポジトリのルート GEMINI.md	チームで共有するプロジェクトのルール
サブディレクトリの GEMINI.md	そのディレクトリ配下で作業するときに追加で読み込まれる

読み込まれた内容は結合され、/memory show で確認できます。

GEMINI.md のテンプレート

# プロジェクト概要
Django + React の社内ツール。バックエンドは `backend/`、フロントは `frontend/`。

## コマンド
- バックエンドのテスト: `cd backend && pytest`
- フロントのテスト: `cd frontend && npm test`
- Lint: `cd backend && ruff check .` / `cd frontend && npm run lint`
- 開発サーバー: `docker compose up`

## 規約
- Python は型ヒント必須。`Any` は使わない
- React は関数コンポーネントのみ。状態管理は既存の Zustand ストアを使う
- API のスキーマは `backend/api/schemas/` に置き、フロントの型は生成コマンドで更新する

## 変更禁止
- `backend/migrations/` の既存ファイル
- `frontend/src/generated/`

## 作業の進め方
- 変更前に関連テストを読む
- 複数ファイルにまたがる変更は方針を先に提示する
- 完了報告には実行したコマンドと結果を含める

/init を実行すると、Gemini CLI がプロジェクトを調べて雛形を生成します。README で分かる内容は削り、「見ただけでは分からない約束事」だけを残すのは、他のツールと同じ考え方です(CLAUDE.md の書き方 の方針がそのまま使えます)。

会話中に記憶させる

/memory add <内容> を実行すると、その内容がユーザーの GEMINI.md に追記されます。繰り返し伝えている好みは、このコマンドで書き込んでおくと次回以降も反映されます。

まとめ

• npm install -g @google/gemini-cli で入れ、gemini を起動して Google アカウントでログインする
• GEMINI.md は ~/.gemini/、リポジトリのルート、サブディレクトリの 3 階層で結合される
• /memory show で読み込み状況を確認し、/memory refresh で再読み込みする
• /init で雛形を作り、コマンド・規約・変更禁止・進め方の 4 種類に絞る

Path not in workspace: Attempted path "/home/you/node_modules" resolves outside
the allowed workspace directories

gemini --include-directories ../lib,../docs

export GEMINI_SANDBOX=podman
export SANDBOX_FLAGS="--userns=keep-id"
gemini --sandbox

export SANDBOX_FLAGS="--userns=keep-id --security-opt label=disable"