Gemini CLI
Gemini CLI を RunAPI の Gemini ネイティブ API に接続し、リクエストを確認して元の設定に戻します。
概要
Gemini CLI はターミナルのエージェントです。このガイドではモデルプロバイダーを RunAPI の Gemini ネイティブ API に変更します。MCP による RunAPI ツールの追加は別の手順です。
始める前に
公式インストールガイドに従ってください。認証ガイドで専用の標準 API キーを作成し、モデルカタログから Gemini ネイティブモデル ID をコピーします。キーをコミットしないでください。
npm install -g @google/gemini-cli
RunAPIを設定する
まず現在のシェルにこれらの変数を設定します。ベース URL は /v1beta を含まない HTTPS API のルートです。SDK が POST
/v1beta/models/{model}:streamGenerateContent?alt=sse を付加します。HTTP が許可されるのは localhost のみです。
export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID
継続して使用する場合は、同じ３つの変数をリポジトリ外の ~/.gemini/.env に保存します。chmod 600
~/.gemini/.env でアクセスを制限してください。Gemini CLI は現在のディレクトリから親ディレクトリへ .env を探し、その後 ~/.gemini/.env と ~/.env を確認します。競合するファイルに注意してください。
他の設定を残したまま、この２つの設定を ~/.gemini/settings.json に統合します。API キー認証には gemini-api-key を使用し、保存済みの Google ログインは再利用しないでください。キーは既定で x-goog-api-key に送信されます。
{
"security": {
"auth": {"selectedType": "gemini-api-key"}
},
"model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}
モデルを選択する
対話セッションで GEMINI_MODEL、--model YOUR_RUNAPI_MODEL_ID、または /model を使用します。auto、pro、flash は避けてください。これらの別名は RunAPI で利用できない Google モデル ID に変換される場合があります。内部の選択、分類、ループ検出でも flash や flash-lite の補助モデルを要求する場合があるため、利用可否を別途確認してください。
検証
信頼するリポジトリで実行してください。対話セッションで /about または /stats を使ってモデルを確認し、RunAPI の利用記録で対応する streamGenerateContent リクエストを確認します。CLI が正常に応答しただけでは、どのエンドポイントに届いたかは証明できません。
gemini --version
gemini -p "Describe this repository in one sentence."
RunAPI ツールを追加
MCP はツールを追加するもので、モデルプロバイダーではありません。このコマンドはローカルサーバーを登録します。別途必要な認証と確認は Local MCP を参照してください。
gemini mcp add runapi npx -y @runapi.ai/mcp
トラブルシューティング
リクエストが引き続き Google に送られる場合は、競合する .env、security.auth.selectedType、保存済みのログイン、Google/Vertex の認証環境変数を確認してください。Invalid auth method
selected が表示されたら、設定で gateway ではなく gemini-api-key を選択して再起動します。
401 の場合はキーと GEMINI_API_KEY_AUTH_MECHANISM の上書きを確認してください。既定では x-goog-api-key を使います。404 の場合はベース URL から /v1beta を除き、対応する Gemini ネイティブモデル ID を再度コピーしてください。補助モデルが利用できない場合は要求された正確な ID を確認します。メインモデルの選択だけではすべての CLI 機能の動作は保証されません。
RunAPI は countTokens と embedContent を提供しません。countTokens が失敗した場合、Gemini CLI はローカルでのトークン推定に切り替えられます。推定値は利用記録と異なる場合があります。localhost 以外では HTTPS を使用し、証明書の検証を無効にしないでください。
RunAPI を削除する
シェルと保存した .env ファイルから３つの変数を削除し、以前の security.auth.selectedType とモデル設定に戻して、RunAPI の専用キーを失効させます。別途追加した MCP サーバーは、そのツールが不要になった場合のみ削除してください。
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL