Skip to main content

Gemini CLI

The Gemini CLI source does not confirm a third-party Base URL. Only the CC Switch route is documented as an implemented compatibility entry.

Before configuring​

  • This page uses placeholders only. Copy the real Key from PopGo API keys and the model from models and pricing.
  • One-click setup is for software that is already installed and has registered its protocol handler. Allow the browser to open the external app when prompted.
  • For manual setup, save one minimal Provider first. Enable streaming, tools, or multi-model routing only after the first request succeeds.

Official source and verification​

This page was verified on 2026-07-13 against the official source for Gemini CLI 0.50.0. Official source. Compatibility is partial; unconfirmed direct environment variables are not presented as official capabilities.

One-click setup​

Sign in to the PopGo API keys page and open the action menu on the target Key row. Public documentation never creates or displays a link containing a Key. Choose CC Switch, then Gemini. After CC Switch imports the Gemini setup, do not look for direct variables that are not documented here.

Manual setup​

There is no officially confirmed manual third-party Base URL setup. This page does not invent environment variables.

  • Confirm that gemini --version runs first. This page records only the CC Switch route and does not publish unverified Base URL variables.
  • After import, start Gemini CLI from a new terminal and confirm the current session uses the imported setup.

Installation and verification​

  1. Check node --version and npm --version, then install Gemini CLI using its official method.
  2. Run gemini --version to confirm that the command is on PATH. Reopen the old terminal if it is missing.
  3. This guide records only the verified CC Switch entry. It does not publish unverified environment variables or fixed model settings.
  4. Start Gemini CLI from a new terminal after import and send a short request with YOUR_MODEL.

Success check​

After CC Switch imports the setup, start Gemini CLI from a new terminal. A request with YOUR_MODEL must complete to count as success.

Common errors and recovery​

  • If CC Switch import fails, follow its recovery guide instead of trying an unverified variable name.
  • For a 401, paste YOUR_API_KEY again and remove surrounding whitespace.
  • For a 404, verify the Base URL level and make sure the client is not appending /v1 twice.