Gemini CLI 設定

Gemini CLI は Google の AI コーディングアシスタントで、大きなコンテキストを扱うコード作業に便利です。

先に「環境設定」の章を完了し、Node.js と npm がインストールされていることを確認してください。

Linux / macOS

ステップ 1: Gemini CLI をインストール

npm i -g @google/gemini-cli

ステップ 2: 環境変数を設定

~/.bashrc または ~/.zshrc に追加します:

# Relay base URL: domain only, do not append /v1beta
export GOOGLE_GEMINI_BASE_URL="https://api.icodeeasy.cc"

# Use your I Code Easy API Key
export GEMINI_API_KEY="your API Key"

# Recommended fast model. You can also use stronger models such as gemini-3.1-pro-preview
export GEMINI_MODEL="gemini-3.5-flash"

# Explicitly use Gemini API v1beta
export GOOGLE_GENAI_API_VERSION="v1beta"

ファイルを保存し、source ~/.bashrc または source ~/.zshrc を実行します。

注意: GOOGLE_GEMINI_BASE_URL を https://api.icodeeasy.cc/v1beta にしないでください。Gemini CLI が /v1beta/v1beta/models/... のようなパスを作ってしまいます。 利用中のネットワークで api.icodeeasy.cc が遅い場合は、GOOGLE_GEMINI_BASE_URL を https://jp.icodeeasy.cc に変更してください。この場合も /v1beta は付けません。

ステップ 3: Gemini を起動

cd your-project-folder
gemini

Windows

ステップ 1: Gemini CLI をインストール

npm i -g @google/gemini-cli

ステップ 2: 環境変数を設定 in PowerShell

# Relay base URL: domain only, do not append /v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.icodeeasy.cc", "User")

# Use your I Code Easy API Key
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "your API Key", "User")

# Recommended fast model. You can also use stronger models such as gemini-3.1-pro-preview
[Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3.5-flash", "User")

# Explicitly use Gemini API v1beta
[Environment]::SetEnvironmentVariable("GOOGLE_GENAI_API_VERSION", "v1beta", "User")

環境変数を設定した後、新しい PowerShell ウィンドウを開いてください。

利用中のネットワークで api.icodeeasy.cc が遅い場合は、GOOGLE_GEMINI_BASE_URL を https://jp.icodeeasy.cc に変更してください。この場合も /v1beta は付けません。

ステップ 3: Gemini を起動

新しい PowerShell ウィンドウを開き、プロジェクトディレクトリに移動して起動します:

cd your-project-folder
gemini

モデル選択

よく使うモデル:

Gemini CLI 内蔵の flash オプションは、古い gemini-3-flash-preview に解決される場合があります。クライアントやプラグインが gemini-3-flash を送信した場合、このサービスは自動的に gemini-3-flash-preview にマッピングします。

Raw API テスト例

CLI を使わずにネイティブ Gemini API を直接テストする場合:

curl "https://api.icodeeasy.cc/v1beta/models/gemini-3.5-flash:streamGenerateContent?alt=sse" \
  -H "x-goog-api-key: your API Key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [{"text": "Hello, briefly introduce yourself"}]
      }
    ]
  }'

非ストリーミングのエンドポイントパス:

/v1beta/models/{model}:generateContent

ストリーミングのエンドポイントパス:

/v1beta/models/{model}:streamGenerateContent?alt=sse

よくある質問