> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> Gemini CLI を EvoLink.AI に接続する

## 概要

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-2.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=164ba3d3b5cdc5deaff461189e96ba50" alt="Gemini CLI Interface" width="1711" height="578" data-path="images/integration-guide/image-2.png" />

Gemini CLI は、ターミナルで Gemini モデルと対話するための Google 公式コマンドラインツールです。
Gemini CLI を **EvoLink API** と統合することで、公式モデルの制限を超え、**Gemini、GPT、Claude** シリーズモデルを含む EvoLink の幅広いモデルセットに、一つのエントリーポイントからアクセスできます。

## 前提条件

設定を始める前に、以下を準備してください：

### 1. Node.js と npm のインストール

**なぜ必要？** Node.js は CLI ツールのランタイム環境です（スマホで WeChat を使うためにアプリをインストールするように、CLI ツールを実行するにはパソコンに Node.js をインストールする必要があります）。

**既にインストール済みの場合：** `node -v` と `npm -v` を実行してバージョンを確認してください。v20 以上であれば、このステップはスキップできます。

**初めてインストールする場合：**

* [Node.js 公式サイト](https://nodejs.org/)からダウンロードしてインストール（LTS バージョン推奨）
* インストール手順に不慣れな場合は、[Runoob - Node.js インストールガイド](https://www.runoob.com/nodejs/nodejs-install-setup.html)を参照してください
* 推奨：**Node.js v20 以上**
* インストールの確認：

```bash theme={null}
node -v
npm -v
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/claude-node-npm-verify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=13be4f60f117fca3024b2b2c1d0fd208" alt="Node.js and npm version verification" width="1730" height="923" data-path="images/integration-guide/claude-node-npm-verify.png" />

### 2. EvoLink API Key の取得

* [EvoLink Dashboard](https://evolink.ai/dashboard) にログイン
* ダッシュボードで API Keys を見つけ、「新しいキーを作成」ボタンをクリックし、生成されたキーをコピー
* API Key は通常 `sk-` で始まります

## ステップ 1：Gemini CLI のインストール

<Note>
  **ヒント：** コマンドラインターミナルの開き方がわからない場合は、[FAQ - コマンドラインターミナルの開き方](#13-コマンドラインターミナルの開き方)を参照してください
</Note>

### 1. インストールコマンド

```bash theme={null}
npm install -g @google/gemini-cli
```

**期待される結果：** ダウンロード情報がスクロール表示され、最後に `added XX packages` と表示されます（1〜3分かかります）。

**エラーが発生した場合：** `permission denied` の場合、Windows では「管理者として実行」した PowerShell が必要です。macOS/Linux ではコマンドの前に `sudo` を追加してください。

### 2. インストールの確認

```bash theme={null}
gemini --version
```

**成功の目安：** バージョン番号が表示されます（例：`1.x.x`）。

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-version.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=3fd01705c8f519f6d81ba1fb78d25cb2" alt="Gemini CLI Version" width="1730" height="923" data-path="images/integration-guide/gemini-version.png" />

## ステップ 2：EvoLink API の設定

**⚠️ 重要：** Gemini CLI の設定は他のツールより**やや複雑**で、インストールファイルの修正が必要です。プログラミング初心者の方は、まず **Claude CLI** や **Codex CLI**（設定がより簡単）の使用を検討してください。

### 1. インストールディレクトリの確認

```bash theme={null}
npm root -g
```

**以下のようなパスが表示されます：**

* Windows: `C:\Users\YourUsername\AppData\Roaming\npm\node_modules`
* macOS: `/usr/local/lib/node_modules`
* Linux: `/usr/lib/node_modules`

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-find-install-dir.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=b532f9ef42e03905f6b23a216debb194" alt="Find Gemini CLI installation directory" width="1730" height="923" data-path="images/integration-guide/gemini-find-install-dir.png" />

### 2. API エンドポイントの修正

2つのファイルを修正します：

<img src="https://mintcdn.com/muyutechnology/ImpSKD1BzFmyJCJ-/images/integration-guide/gemini-modify-api.png?fit=max&auto=format&n=ImpSKD1BzFmyJCJ-&q=85&s=02aaff8284dabd21e029e42b85310dd5" alt="File location" width="1028" height="236" data-path="images/integration-guide/gemini-modify-api.png" />

**ファイル 1：** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.mjs`

**約11222行目**を見つけてください：

```javascript theme={null}
// 変更前
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// 変更後
initHttpOptions.baseUrl = `https://direct.evolink.ai/`;
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-mjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=5ba761a74f73a50df86f72a2303c2087" alt="Modify mjs file" width="1302" height="896" data-path="images/integration-guide/gemini-mjs-modify.png" />

**ファイル 2：** `{install_dir}\@google\gemini-cli\node_modules\@google\genai\dist\node\index.cjs`

**約11244行目**を見つけ、同じ変更を行います。

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-cjs-modify.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=84ee7886704faaebddad7b44a565e285" alt="Modify cjs file" width="1301" height="865" data-path="images/integration-guide/gemini-cjs-modify.png" />

### 3. API Key の設定

<Tabs>
  <Tab title="Windows PowerShell">
    **一時的（現在のセッションのみ）**

    ```powershell theme={null}
    $env:GEMINI_API_KEY = "your-evolink-api-key"
    ```

    **永続的**

    ```powershell theme={null}
    [Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your-evolink-api-key", "User")
    ```

    変更を反映するにはターミナルを再起動してください。

    **設定の確認**

    ```powershell theme={null}
    echo $env:GEMINI_API_KEY
    ```

    API Key が出力されれば、設定は成功です。

    <img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-check-env.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=588d9271f5c882ec0fbdd463f12877e1" alt="Check environment variable" width="1730" height="923" data-path="images/integration-guide/gemini-check-env.png" />
  </Tab>

  <Tab title="macOS / Linux">
    **一時的（現在のセッションのみ）**

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    **永続的**
    `~/.bashrc` または `~/.zshrc` を編集し、以下を追加：

    ```bash theme={null}
    export GEMINI_API_KEY="your-evolink-api-key"
    ```

    その後 `source ~/.bashrc` または `source ~/.zshrc` を実行して反映するか、ターミナルを再起動してください。

    **設定の確認**

    ```bash theme={null}
    echo $GEMINI_API_KEY
    ```

    API Key が出力されれば、設定は成功です。
  </Tab>
</Tabs>

## ステップ 3：Gemini CLI を使い始める

### 1. 作業ディレクトリに移動

```shell theme={null}
cd your-working-directory
```

**注意：** `your-working-directory` を実際のパスに置き換えてください

### 2. 単発クエリモード

```shell theme={null}
gemini "Who are you"
```

### 3. 対話モード

```shell theme={null}
gemini
```

<img src="https://mintcdn.com/muyutechnology/aVl9y2uT7NNwpwBy/images/integration-guide/gemini-interface.png?fit=max&auto=format&n=aVl9y2uT7NNwpwBy&q=85&s=390483a8f111f322165b81ff8bbe0626" alt="Gemini CLI Interface" width="1730" height="923" data-path="images/integration-guide/gemini-interface.png" />

**成功の目安：**

* AI の応答テキストが表示される（数行）
* `401`、`403`、`API Key invalid` などのエラーが**表示されない**

**エラーが表示された場合：**

* `401 Unauthorized`：API Key が未設定または無効 → 環境変数を確認してください
* `403 Forbidden`：API Key の権限が不足 → API エンドポイントの修正を確認してください
* `Network error`：ネットワークの問題 → 接続を確認してください

## よくある質問

### 1. Gemini CLI とは何ですか？何に使えますか？

Gemini CLI は、ターミナルで Gemini モデルと対話するための Google 公式コマンドラインツールです。EvoLink の設定を行うことで、GPT、Claude などの他のモデルにもアクセスできます。

### 2. 初回使用時にインストールと設定を確認するには？

以下のコマンドを順番に実行してください：

* `node -v` と `npm -v`：Node.js と npm がインストールされていることを確認
* `gemini --version`：Gemini CLI がインストールされていることを確認
* `gemini "Who are you"`：API 設定が正しいことを確認

### 3. 対話モードと単発コマンドモードの違いは？

* **対話モード**：`gemini` を実行して連続会話に入り、複数回のやり取りが可能
* **単発コマンドモード**：`gemini "質問"` を実行して単一の応答を取得し終了

### 4. Gemini CLI はローカルファイルやコードを自動的に読み取りまたはアップロードしますか？

いいえ。Gemini CLI は、明示的に参照または許可した場合にのみファイル内容を読み取ります。専用のプロジェクトフォルダで使用することを推奨します。

### 5. Gemini CLI でローカルファイルの内容を分析するには？

対話モードで、以下の方法でファイルを参照できます：

* ファイルパスを入力して Gemini に読み取らせる
* ファイルをターミナルウィンドウにドラッグ＆ドロップする

### 6. Gemini CLI は日本語の入出力に対応していますか？

はい、完全に対応しています。

### 7. 実行後に何も出力されない場合、原因は？

よくある原因：

* ネットワーク接続の問題
* API Key が無効、または残高不足
* API エンドポイントの設定が正しくない
* ファイアウォールまたはプロキシがリクエストをブロックしている

### 8. API エンドポイントや環境変数の変更が反映されないのはなぜ？

* ターミナルまたはコマンドラインウィンドウを再起動してください
* `GEMINI_API_KEY` 環境変数が正しく設定されていることを確認してください
* API エンドポイントファイルが正しく修正されていることを確認してください（node\_modules 内の .mjs と .cjs ファイルの修正が必要）

### 9. 401/403 エラーの原因は？

* **401 エラー**：`GEMINI_API_KEY` が未設定または無効
* **403 エラー**：権限不足またはキーの有効期限切れ
* API エンドポイントが `https://direct.evolink.ai/` であることを確認してください

### 10. Gemini CLI はどのようなシーンに適していますか？

**適しているシーン：**

* コードの作成、デバッグ、リファクタリング
* コマンドライン環境での素早い Q\&A
* ファイル内容の分析
* 自動化スクリプトとの統合

**適していないシーン：**

* 複雑な GUI 操作
* リアルタイム共同編集
* 大規模なバッチファイル処理

### 11. モデルを切り替えるには？

対話モードで `/model` と入力してください。

<img src="https://mintcdn.com/muyutechnology/ogYegfyiYikRHauR/images/integration-guide/image-3.png?fit=max&auto=format&n=ogYegfyiYikRHauR&q=85&s=9fd12b04bfc76875a9652b480a44b786" alt="Gemini CLI Switch Model" width="1280" height="570" data-path="images/integration-guide/image-3.png" />

利用可能なモデル：

* `gemini-2.5-pro`
* `gemini-2.5-flash`
* `gemini-3-pro-preview`
* `gemini-3-flash-preview`

### 12. 画像をアップロードするには？

* 方法 1：画像のパスを参照する
* 方法 2：画像をターミナルにドラッグ＆ドロップする

いずれの方法もユーザーの操作が必要です。Gemini CLI がローカル画像を自動的に読み取りまたはアップロードすることはありません。

### 13. コマンドラインターミナルの開き方

<Tabs>
  <Tab title="Windows">
    * 方法 1：`Win + R` を押し、`cmd` または `powershell` と入力して Enter を押す
    * 方法 2：スタートメニューで「コマンド プロンプト」または「PowerShell」を検索する
    * 方法 3：フォルダ内で Shift を押しながら右クリックし、「PowerShell ウィンドウをここで開く」を選択する
  </Tab>

  <Tab title="macOS">
    * 方法 1：`Command + Space` を押して Spotlight を開き、`Terminal` と入力して Enter を押す
    * 方法 2：「アプリケーション」→「ユーティリティ」→「ターミナル」を開く
  </Tab>

  <Tab title="Linux">
    * 方法 1：`Ctrl + Alt + T` ショートカットを押す
    * 方法 2：アプリケーションメニューで「Terminal」を検索する
  </Tab>
</Tabs>

## 注意事項

<Warning>
  Gemini CLI は専用のプロジェクトフォルダで実行してください。機密性の高いディレクトリ（システムフォルダや認証情報を含むディレクトリなど）での実行は避けてください。Gemini CLI は現在の作業ディレクトリを起点として動作します。
</Warning>