---
title: Gemini CLI | RunAPI
description: Gemini CLI を RunAPI の Gemini ネイティブ API に接続し、リクエストを確認して元の設定に戻します。
url: https://runapi.ai/ja/docs/resources/tool-integrations/gemini-cli.md
canonical: https://runapi.ai/ja/docs/resources/tool-integrations/gemini-cli
locale: ja
---

> HTML 版: https://runapi.ai/ja/docs/resources/tool-integrations/gemini-cli
> エージェント向けサイトインデックス: https://runapi.ai/llms.txt

# Gemini CLI

## 概要

Gemini CLI はターミナルのエージェントです。このガイドではモデルプロバイダーを RunAPI の Gemini ネイティブ API に変更します。MCP による RunAPI ツールの追加は別の手順です。

## 始める前に

[公式インストールガイド][1]に従ってください。[認証ガイド](https://runapi.ai/ja/docs/guides/authentication.md)で専用の標準 API キーを作成し、[モデルカタログ](https://runapi.ai/ja/models)から Gemini ネイティブモデル ID をコピーします。キーをコミットしないでください。

[1]: https://geminicli.com/docs/get-started/installation/

```shell
npm install -g @google/gemini-cli
```

## RunAPIを設定する

まず現在のシェルにこれらの変数を設定します。ベース URL は `/v1beta` を含まない HTTPS API のルートです。SDK が `POST
/v1beta/models/{model}:streamGenerateContent?alt=sse` を付加します。HTTP が許可されるのは localhost のみです。

```shell
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` に送信されます。

```json
{
  "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 が正常に応答しただけでは、どのエンドポイントに届いたかは証明できません。

```shell
gemini --version
gemini -p "Describe this repository in one sentence."
```

## RunAPI ツールを追加

MCP はツールを追加するもので、モデルプロバイダーではありません。このコマンドはローカルサーバーを登録します。別途必要な認証と確認は [Local MCP](https://runapi.ai/ja/docs/resources/mcp/local.md) を参照してください。

```shell
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 サーバーは、そのツールが不要になった場合のみ削除してください。

```shell
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL
```

## 次のステップ

[LLM API クイックスタート](https://runapi.ai/ja/docs/guides/llm-api/quickstart.md)、[Gemini generateContent](https://runapi.ai/ja/docs/api/gemini/generate-content.md)、[streamGenerateContent](https://runapi.ai/ja/docs/api/gemini/stream-generate-content.md)、[モデルカタログ](https://runapi.ai/ja/models)、[Local MCP](https://runapi.ai/ja/docs/resources/mcp/local.md)をご覧ください。

---

## RunAPI のその他の情報

- [ホーム](https://runapi.ai/ja/.md)
- [モデルカタログ](https://runapi.ai/ja/models.md)
- [料金](https://runapi.ai/ja/pricing.md)
- [プロバイダー](https://runapi.ai/ja/models)
- [ドキュメント](https://runapi.ai/ja/docs/guides)
- [SDK](https://runapi.ai/ja/sdk.md)
- [CLI](https://runapi.ai/ja/cli.md)
- [MCP Server](https://runapi.ai/ja/mcp.md)
- [x402](https://runapi.ai/ja/x402.md)
- [Claude Code と Cursor](https://runapi.ai/ja/claude-code-vs-cursor.md)
- [Cursor API セットアップ](https://runapi.ai/ja/cursor-api-setup.md)
- [RunAPI と OpenRouter の比較](https://runapi.ai/ja/openrouter-alternative.md)
- [エンタープライズ](https://runapi.ai/ja/contact.md)
- [お問い合わせ](https://runapi.ai/ja/contact.md)
- [利用規約](https://runapi.ai/ja/terms.md)
- [プライバシー](https://runapi.ai/ja/privacy.md)
- [エージェント向けサイトインデックス](https://runapi.ai/llms.txt)

お問い合わせ: contact@runapi.ai

## 構造化データ

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ja",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ja/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ja",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/jaicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ja",
    "@type": "TechArticle",
    "headline": "Gemini CLI",
    "description": "Gemini CLI を RunAPI の Gemini ネイティブ API に接続し、リクエストを確認して元の設定に戻します。",
    "url": "https://runapi.ai/ja/docs/resources/tool-integrations/gemini-cli",
    "mainEntityOfPage": "https://runapi.ai/ja/docs/resources/tool-integrations/gemini-cli"
  }
]
```