Gemini Integration

macOS Configuration¶

Step 1: Install Node.js¶

Gemini CLI requires Node.js to run.

Method 1: Using Homebrew (Recommended)¶

If you have Homebrew installed, use it to install Node.js:

# Update Homebrew
brew update

# Install Node.js
brew install node

Method 2: Official Download¶

1. Visit https://nodejs.org/

2. Download the LTS version for macOS

3. Open the downloaded .pkg file

4. Follow the installer instructions to complete installation

macOS Notes¶

• You may need to use sudo if you encounter permission issues

• First run may require approval in System Preferences

• Terminal or iTerm2 is recommended

Verify Node.js Installation¶

After installation, open Terminal and run:

node --version
npm --version

If version numbers are displayed, installation was successful!

Step 2: Install Gemini CLI¶

Install Gemini CLI globally using npm:

npm install -g @google/gemini-cli

After installation, verify:

gemini --version

Step 3: Configure Gemini CLI Environment Variables¶

Set the following environment variables to connect to the proxy service:

Temporary Setup (Current Session)¶

Run the following commands in terminal:

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

Replace cr_xxxxxxxxxx with your QCode.cc API key. Use the same API key as Claude Code.

Permanent Setup (Shell Configuration)¶

Add the following to your shell configuration file (~/.zshrc):

# Gemini CLI Configuration
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

Then run:

source ~/.zshrc

Verify Gemini CLI Environment Variables¶

Verify in terminal:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Linux / WSL2 Configuration¶

Step 1: Install Node.js¶

Gemini CLI requires Node.js to run.

Method 1: Using nvm (Recommended)¶

nvm makes it easy to manage multiple Node.js versions:

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reload shell configuration
source ~/.bashrc

# Install latest LTS version
nvm install --lts

Method 2: Using Package Manager¶

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm

Linux / WSL2 Notes¶

• WSL2 users should install in Linux subsystem, not Windows

• Using nvm helps avoid permission issues

• Ensure shell configuration file properly loads nvm

Verify Node.js Installation¶

After installation, open terminal and run:

node --version
npm --version

If version numbers are displayed, installation was successful!

Step 2: Install Gemini CLI¶

Install Gemini CLI globally using npm:

npm install -g @google/gemini-cli

After installation, verify:

gemini --version

Step 3: Configure Gemini CLI Environment Variables¶

Set the following environment variables to connect to the proxy service:

Temporary Setup (Current Session)¶

Run the following commands in terminal:

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

Replace cr_xxxxxxxxxx with your QCode.cc API key. Use the same API key as Claude Code.

Permanent Setup (Shell Configuration)¶

Add the following to your shell configuration file (~/.bashrc):

# Gemini CLI Configuration
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

Then run:

source ~/.bashrc

If using Zsh, add to ~/.zshrc and run source ~/.zshrc.

Verify Gemini CLI Environment Variables¶

Verify in terminal:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Windows Configuration¶

Step 1: Install Node.js¶

Gemini CLI requires Node.js to run.

Method 1: Official Download (Recommended)¶

1. Open your browser and visit https://nodejs.org/

2. Click the "LTS" version to download (recommended for stability)

3. Double-click the downloaded .msi file

4. Follow the installation wizard, keeping default settings

Method 2: Using Package Manager¶

If you have Chocolatey or Scoop installed, use command line:

# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs

Windows Notes¶

• PowerShell is recommended over CMD

• Run as Administrator if you encounter permission issues

• Some antivirus software may flag it; add to whitelist if needed

Verify Node.js Installation¶

After installation, open PowerShell or CMD and run:

node --version
npm --version

If version numbers are displayed, installation was successful!

Step 2: Install Gemini CLI¶

Install Gemini CLI globally using npm:

npm install -g @google/gemini-cli

After installation, verify:

gemini --version

Step 3: Configure Gemini CLI Environment Variables¶

Set the following environment variables to connect to the proxy service:

PowerShell Temporary Setup (Current Session)¶

Run the following commands in PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"

Replace cr_xxxxxxxxxx with your QCode.cc API key. Use the same API key as Claude Code.

PowerShell Permanent Setup (User Level)¶

Run the following commands in PowerShell:

# Set user-level environment variables (permanent)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)

You need to reopen PowerShell for changes to take effect.

Verify Gemini CLI Environment Variables¶

Verify in PowerShell:

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

Related Documents