Gemini CLI

Gemini CLI は、Googleが提供するオープンソースのターミナルエージェントで、ターミナルでの承認後にプロジェクトを理解し、ファイルを分析し、コマンドやツールを使用できます。 Gemini API アドレス、API Key、およびモデルIDを設定することで、Gemini CLI は AGTCloud の Gemini Generate Content 互換エンドポイントを使用できます。

このチュートリアルでは、Gemini CLI の基本的な接続とセキュリティ検証プロセスのみを紹介します。ファイル変更、シェル コマンド、関数呼び出し、およびその他のエージェント機能は、対象モデルと、Gemini パ​​ーツ、関数呼び出しなどのプロトコル構造に対する対応するモデルの実際のサポートによって異なります。

事前準備

開始前に、次の項目を確認してください。

• Node.js 20 以降をインストールします。
• Bash、Zsh、または PowerShell ターミナルを準備します。
• API Keys ページに AGTCloud API Keyを作成します。
• モデルマーケットプレイスから、現在の API Key で利用でき、Gemini Generate Content に対応するモデル ID をコピーします。
• 機密コードや運用認証情報が含まれないテストディレクトリを準備します。

MODEL_ID は、実際のモデル名ではなく、置き換える必要があるプレースホルダーです。現在のAPI Keyで利用可能で、Gemini コンテンツの生成をサポートするモデルIDを使用してください。

Gemini CLIをインストールする

現在の安定バージョンをインストールすることをお勧めします。異なるインストール方法でも同じ gemini コマンドを取得します。

npm install -g @google/gemini-cli

インストールが完了したら、バージョンを確認します。

gemini --version

コマンドが見つからないというメッセージが表示された場合は、ターミナルを再度開き、npm グローバル コマンド ディレクトリが追加されていることを確認してください PATH。

AGTCloudを設定する

Gemini CLI 4 つの環境変数が必要です: API Key、モデルID、カスタム Gemini API アドレス、およびベアラー認証方法。

export GEMINI_API_KEY="your-api-key"
export GEMINI_MODEL="MODEL_ID"
export GOOGLE_GEMINI_BASE_URL="https://api.agtcloud.cn"
export GEMINI_API_KEY_AUTH_MECHANISM="bearer"

設定項目の説明

このチュートリアルでは GOOGLE_GENAI_API_VERSION を設定せず、Gemini CLI で Gemini API デフォルトの v1beta を使用します。また、完全な generateContent リクエストパスを Base URL に書き込まないでください。

ユーザー設定を保存する

一時設定が機能することを確認した後、Gemini CLI のユーザーレベルの .env ファイルに変数を書き込むことができます。このファイルには実際の API Key が含まれている可能性があります。コードリポジトリへコミットしないでください。

~/.gemini/.env

GEMINI_API_KEY=your-api-key
GEMINI_MODEL=MODEL_ID
GOOGLE_GEMINI_BASE_URL=https://api.agtcloud.cn
GEMINI_API_KEY_AUTH_MECHANISM=bearer

Gemini CLI 環境ファイルは、現在の作業ディレクトリと親ディレクトリで検索されます。プロジェクト内のより新しい .env または .gemini/.env がユーザーレベルの設定より優先される場合があります。設定が有効になっていないことがわかった場合は、まずこれらのファイルを確認してください。

API Key認証方式を固定する

Gemini CLI 複数の Google 認証方法をサポートします。 AGTCloud 経由で使用する場合は、Google サインインまたは Vertex AI の代わりに Gemini API Keyを選択する必要があります。

ファイル内の既存のテーマ、権限、その他の設定を上書きせずに、次の設定をユーザーレベル settings.json にマージします。

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

設定ファイルの場所:

保存後、Gemini CLI を完全に終了してから再起動してください。selectedType と GEMINI_API_KEY_AUTH_MECHANISM=bearer は、それぞれ API Key 認証フローの選択と、AGTCloud が必要とする Bearer ヘッダーの生成を担います。両者は相互に置き換えられません。

モデルを選ぶ

デフォルトのモデルは GEMINI_MODEL によって決定されます。単一セッションのモデルを一時的に指定する必要がある場合は、次を実行できます。

gemini --model MODEL_ID

対話型セッションでは /model もモデルの選択に使用できますが、その一覧に、現在の AGTCloud API Key で利用できるすべてのモデルが自動表示されるとは限りません。モデルが見つからない、または一覧に表示されない場合は、モデルマーケットプレイスから完全なモデル ID をコピーし、GEMINI_MODEL または --model で指定してください。

接続を確認する

gemini -p "以下にのみ返信してください。AGTCloud 接続は成功しました。" --output-format json

gemini -p "@README.md プロジェクトの目的を 3 点にまとめてください。ファイルは一切変更しないでください。" --output-format json

gemini

よくある質問

特定できない問題が発生した場合は、リクエスト時間、Base URL、モデルID、Gemini CLI バージョン、HTTP ステータス、および機密情報を除いたエラー情報を記録し、エラーとトラブルシューティング を確認してください。認証情報を含む完全なAPI Key または .env ファイルを送信しないでください。

セキュリティ上の推奨事項

• 実際の API Keyをリポジトリ、共有スクリプト、スクリーンショット、ログ、またはチャット ログに書き込まないでください。
• 最初に一時環境変数を使用して検証し、成功したらユーザーレベルの設定を保存することをお勧めします。
• .env ファイルに適切なローカル アクセス許可を設定し、パブリック クラウド ドライブとの同期を避けます。
• ツールの機能を初めて使用するときは手動による承認を維持し、非実稼働プロジェクトで検証します。
• トラブルシューティング情報を共有する前に、完全なキー、ユーザー名、ローカル パス、およびビジネス ソースコードを削除してください。

次のステップ

• API Key、Base URL および認証
• Gemini Generate Content API Reference
• Gemini Stream Generate Content API Reference
• プロトコルの選択
• エラーとトラブルシューティング