コーディングツール

Gemini CLI

TokenLab APIを使用するためのGoogle Gemini CLIの設定

概要

Gemini CLI 0.60.0 では、APIキー認証のために GOOGLE_GEMINI_BASE_URL が定義されています。gemini_generate_content をサポートする最新のモデルで、TokenLabのGeminiネイティブエンドポイントを使用してください。公式設定リファレンスおよび認証ガイドを参照してください。このセットアップでは、GoogleのサブスクリプションがTokenLabを経由することはありません。

インストール

Gemini CLI 0.60.0にはNode.js 20以降が必要です。

npm install -g @google/gemini-cli@0.60.0
gemini --version

設定

macOS、Linux、WSL、またはWindows PowerShell向けのクイックスタートのターミナル手順を使用して、コマンド履歴にキーを残さずに TOKENLAB_API_KEY を設定してください。Gemini CLIはそのターミナルから起動します。永続的に使用する場合は、ローカルのシークレットマネージャーを使用してください。シェルプロファイルにプレーンテキストのキーを追記しないでください。

現在のGoogleログインと設定はそのまま維持してください。TokenLab用に別途起動する場合は、~/.gemini-tokenlab(PowerShellの場合は $HOME)のような未使用の設定ルートを選択し、その .gemini ディレクトリを作成します。既存の .gemini/settings.json およびセットアップに必要なポリシーファイルを、権限、サンドボックス、および関連のない設定を保持したまま、対応する場所にコピーしてください。そのコピー内でのみ、以下の認証フィールドをマージします(設定ファイルが存在しない場合は作成してください)。OAuthキャッシュをコピーしたり、元の認証情報を消去したりしないでください。管理された認証ポリシーに従い、それを上書きしないでください。

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

使用方法

以下の起動コマンドでは ~/.gemini-tokenlab/.gemini/settings.json を使用します。別のルートを選択した場合はパスを調整してください。Geminiの通常の信頼プロンプトを通じて作業ディレクトリを承認し、既存のツール承認ポリシーを維持してください。モデルはこのセッション用に明示的に選択されます。

GEMINI_CLI_HOME="$HOME/.gemini-tokenlab" GEMINI_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" GOOGLE_GEMINI_BASE_URL=https://api.tokenlab.sh gemini --model gemini-3.8-flash

これらの変数は今回の起動にのみ適用されます。保存されたアカウント、デフォルトモデル、および権限設定はそのまま維持されます。以前のセットアップを使用する場合は、変数を指定せずに通常通り起動してください。シェルプロファイルにこれらの変数を永続化しないでください。

検証

設定の保存やモデルのリスト表示では、キーやリクエストの完了は検証されません。プロンプトを実行するとTokenLabの残高が消費されます。ツールを試す前に、返信内容とそれに対応するリクエスト記録を確認してください。補助的なリクエストも課金対象となる場合があります。

Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.

同じエージェントで画像と動画を生成する

Gemini CLIは、TokenLab MCP serverを使用して画像や短い動画を作成することもできます。各生成は同じTokenLab残高から支払われます。このエントリをTokenLab用の設定ファイル ~/.gemini-tokenlab/.gemini/settings.json にマージしてください。Gemini CLIは起動環境から $TOKENLAB_API_KEY を読み取るため、キーをファイルに書き込む必要はありません。

{
  "mcpServers": {
    "tokenlab": {
      "command": "npx",
      "args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
      "env": {
        "TOKENLAB_MCP_TOOL_PROFILE": "core",
        "TOKENLAB_API_KEY": "$TOKENLAB_API_KEY"
      }
    }
  }
}

上記の起動コマンドでGemini CLIを開始し、/mcp を実行します。tokenlab サーバーが接続済みとして表示される必要があります。表示されない場合は作業フォルダを信頼してください。その後、以下を試してください。

Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.

create_video はタスクIDを返します。エージェントは動画の準備ができるまで get_task_status を呼び出します。その他の設定については、Gemini CLI MCPガイドを参照してください。

このページの内容