# Gemini CLI

出典: https://docs.aicentos.com/ja/clients/gemini-cli

Language: ja

> Gemini CLI で aicentos を使う —— 環境変数によるカスタムゲートウェイの設定

Gemini CLI は Google が公式にリリースしたコマンドラインツールで、環境変数によるカスタムゲートウェイの設定を通じて Codex Proxy サービスに接続でき、ターミナル内で Gemini モデルと対話できます。

## 準備

Gemini CLI は npm でグローバルインストールするため、先に Node.js 18+ と npm 環境を用意する必要があります。

### Node.js のインストール

* Node.js 公式サイトのダウンロードページにアクセスします：[https://nodejs.org/en/download](https://nodejs.org/en/download)
* macOS/Windows：LTS バージョンをダウンロードしてインストール
* Linux：そのページに記載のディストリビューションごとの方法でインストール
* macOS（Homebrew ユーザー）：`brew install node` を実行

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

```bash
node -v
npm -v
```

## Gemini CLI のインストール

npm でグローバルインストールします：

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

インストールの確認：

```bash
gemini --version
```

## 環境変数の設定

Gemini CLI は以下の 3 つの環境変数でカスタムゲートウェイに接続できます：

| 環境変数                     | 説明                                             |
| ------------------------ | ---------------------------------------------- |
| `GOOGLE_GEMINI_BASE_URL` | ゲートウェイサービスのルートアドレス。Google のデフォルトエンドポイントを置き換えます |
| `GEMINI_API_KEY`         | あなたの API Key                                   |
| `GEMINI_MODEL`           | デフォルトで使うモデル                                    |

### 設定例

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"
```

### 注意事項

* `GOOGLE_GEMINI_BASE_URL` にはサービスのルートアドレスを入力し、具体的な API パスは不要です
* 一時的なテスト：現在の shell セッションで上記の export コマンドを直接実行します
* 永続化：export 文を `~/.zshrc` または `~/.bashrc` に追記し、`source ~/.zshrc` を実行して反映させます

## Gemini CLI の起動

設定が完了したら、次のコマンドでそのまま起動します：

```bash
gemini
```

起動後、ターミナル内で Gemini モデルと対話できるようになります。

## 接続の確認

Gemini CLI 内で会話を 1 回開始し、正常に返信が受け取れれば接続成功です。

### よくある問題のトラブルシューティング

* 認証エラーが発生した場合は、`GEMINI_API_KEY` が正しいか確認してください
* `GOOGLE_GEMINI_BASE_URL` が正しいサービスアドレスを向いているか確認してください

## 注意事項

* 現在のサービスは Gemini 互換インターフェースに対応しており、Gemini CLI にそのまま使えます
* 環境変数の設定は、永続化のために shell 設定ファイルに追記することをおすすめします
* Gemini CLI は API パスを自動で連結するため、BASE\_URL に具体的な API パスを追加する必要はありません

## 関連リンク

* 公式ドキュメント：[https://docs.aicentos.com/clients/gemini-cli.html](https://docs.aicentos.com/clients/gemini-cli.html)