Gemini CLIの設定チュートリアル

Gemini CLI設定チュートリアル

Gemini CLI は Google 公式のコマンドラインツールで、開発者に強力な AI 支援コーディング体験を提供します。インテリジェントなコード生成、コード解析、デバッグ支援などの機能に対応しています。

:rocket: 主な機能

• インテリジェントなコード生成 - 高品質なコードをすばやく生成
• コード解析 - コード構造を深く理解して分析
• デバッグ支援 - コード上の問題を賢く見つけて修正
• ドキュメント生成 - コードドキュメントを自動生成
• コマンドライン統合 - 開発フローにシームレスに統合

:star: Gemini CLI で使用できるモデル

本サイトの Gemini モデルはすべて Gemini CLI で使用できます

:package: インストール手順

1. Gemini CLI のインストール

npm install -g @google/gemini-cli  # macOS/Linux需sudo权限

2. Mac & Liunx の設定方法

Terminal での設定方法

Terminal で以下のコマンドを実行します：

export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"
export GEMINI_API_KEY="你的API密钥"
export GEMINI_MODEL="gemini-3-pro"

永続設定方法

シェル設定ファイルに追記します：

zsh の場合（デフォルト）

echo 'export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"' >> ~/.zshrc
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.zshrc
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.zshrc
source ~/.zshrc

bash の場合

echo 'export GOOGLE_GEMINI_BASE_URL="https://api.4allapi.com"' >> ~/.bash_profile
echo 'export GEMINI_API_KEY="你的API密钥"' >> ~/.bash_profile
echo 'export GEMINI_MODEL="gemini-2.5-pro"' >> ~/.bash_profile
source ~/.bash_profile

Gemini CLI の環境変数を確認

Terminal で確認します：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

3. Windows の設定方法

PowerShell での設定方法

PowerShell で以下のコマンドを実行します：

$env:GOOGLE_GEMINI_BASE_URL = "https://api.4allapi.com"
$env:GEMINI_API_KEY = "你的API密钥"
$env:GEMINI_MODEL = "gemini-3-pro"

PowerShell の永続設定（ユーザー単位）

PowerShell で以下のコマンドを実行します：

# ユーザー単位の環境変数を設定（永続的に有効）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.4allapi.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

:bulb: 設定後は、反映するために PowerShell ウィンドウを開き直してください。

Gemini CLI の環境変数を確認

PowerShell で確認します：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

コアコマンドの詳細

基本操作

gemini  # 进入交互模式
gemini -p "解释这段代码" @./src/utils.js  # ファイル分析
gemini --media wireframe.png "转换为React组件"  # 多模态処理

セッション管理

# コマンドヘルプを表示
/quit  # 終了してセッション統計を表示
/chat save feature_dev  # 現在のセッションを保存
/chat resume feature_dev  # セッションを復元

ツール統合

!ls -la  # システムコマンドを実行
/tools  # 利用可能なツールを表示
gemini review --staged-files --format=checklist  # Git連携

コードベース操作

gemini -p "@./ 总结项目架构"  # 全ディレクトリ分析
gemini -p "@src/components/Button.jsx 生成单元测试"  # 指定ファイル
gemini "迁移Django项目到Python3.12"  # 複雑なタスクの分解

高度なメモリ管理(/memory コマンド)

コマンド比較

コマンド	機能	使用シーン
/memory add	新しい指示を追加	gemini /memory add “常に中国語で返答する”
/memory show	現在の記憶を表示	AI のコンテキスト確認
/memory refresh	設定ファイルを再読み込み	GEMINI.md 更新後

設定ファイルの実践

1. GEMINI.md を作成してプロジェクトルールを定義します：

# 项目规范
- 使用TypeScript严格模式
- 函数命名：camelCase
- API响应格式：{ data, error }

2. 設定を再読み込みします：

/memory refresh  # すべての設定を再読み込み
/memory show  # 読み込まれた内容を確認

複数階層のディレクトリを自動スキャンでき、企業プロジェクトではチーム共通の標準を定義できます

状態復元(/restore コマンド)

操作手順

# 起動時にチェックポイントを有効化
gemini --checkpointing

# ファイルを変更する可能性のある操作の後
/restore  # 復元可能なポイントを表示

# 指定した状態に戻す
/restore checkpoint_42

適用シーン：

1. コード生成の試行に失敗した後のロールバック
2. ファイル編集ミス時の復元
3. 一括操作前の安全なスナップショット

エラー処理ガイド

よくあるエラーの解決策

エラータイプ	症状	解決策
認証失敗	API key not found	環境変数を確認するか、config.json を再設定
クォータ超過	429 Too Many Requests	他のモデルに切り替えるか、しばらく待つ
コンテキスト超過	明確なエラーコードなし（性能低下）	入力を簡潔にする／分割処理する
ファイル作成失敗	権限不足	管理者権限で実行するか、ディレクトリ権限を確認
ネットワーク異常	接続タイムアウト	1. プロキシを確認 2. curl で API 到達性をテスト

デバッグツール

gemini -d  # 詳細デバッグモードを有効化
/stats  # リソース使用状況を表示

---

4All API フッター

4All API · 一站式AI大模型API聚合平台 | 価格 | お問い合わせ

© 2025 4All API. All rights reserved.