Gemini CLI

Connect Google’s Gemini CLI to ShuYou and call Gemini models through ShuYou’s Google-compatible endpoint.

Prerequisites

Install Node.js LTS (v20+).
Create a ShuYou API key in the console.

ShuYou Gemini / Vertex-compatible base URL: https://api.shuyou.ai

Gemini CLI requires patching the installed @google/genai package to change the default Google endpoint. Back up files before editing, or prefer Claude Code or Codex CLI for simpler setup.

Step 1: Install Gemini CLI

npm install -g @google/gemini-cli
gemini --version

Step 2: Point API to ShuYou

Find the global npm modules path:

npm root -g

In {npm_root}/@google/gemini-cli/node_modules/@google/genai/dist/node/, edit index.mjs and index.cjs. Locate the default base URL assignment:

// Before
initHttpOptions.baseUrl = `https://generativelanguage.googleapis.com/`;

// After
initHttpOptions.baseUrl = `https://api.shuyou.ai/`;

Set your API key:

macOS / Linux
Windows

export GEMINI_API_KEY="YOUR_SHUYOU_API_KEY"

$env:GEMINI_API_KEY = "YOUR_SHUYOU_API_KEY"

Step 3: Verify

gemini "Who are you?"

In interactive mode, use /model to switch models. Pick slugs supported on ShuYou models for the Google / Vertex protocol.

FAQ

401 / 403: Verify GEMINI_API_KEY and that both index.mjs and index.cjs were updated. Updates break config: Re-apply the base URL patch after upgrading @google/gemini-cli.

Run Gemini CLI in a dedicated project folder only.

​Gemini CLI

​Prerequisites

​Step 1: Install Gemini CLI

​Step 2: Point API to ShuYou

​Step 3: Verify

​FAQ

Gemini CLI

Prerequisites

Step 1: Install Gemini CLI

Step 2: Point API to ShuYou

Step 3: Verify

FAQ