Gemini CLI Setup

Gemini CLI is Google's AI coding assistant, powered by Gemini 2.5 Pro. Use it through Clauddy without a Google AI Studio account.

Prerequisites

• Clauddy API token (create one)
• Node.js 18+ (environment check)

Install

macOS / Linux

npm install -g @google/gemini-cli

Windows (Run as Admin)

npm install -g @google/gemini-cli

Verify: gemini --version

Configuration

macOS / Linux

# Create config directory and files
mkdir -p ~/.gemini

# Create .env file
cat > ~/.gemini/.env << 'EOF'
GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token
EOF

# Create settings.json file
cat > ~/.gemini/settings.json << 'EOF'
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
EOF

Windows

# Create config directory
mkdir "$HOME\.gemini" -Force

# Write .env
@"
GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token
"@ > "$HOME\.gemini\.env"

# Write settings.json
@"
{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
"@ > "$HOME\.gemini\settings.json"

Manual setup on Windows

If you prefer a GUI workflow, you can also create these two files manually:

%USERPROFILE%\.gemini\.env

GOOGLE_GEMINI_BASE_URL=https://clauddy.com
GEMINI_API_KEY=sk-your-clauddy-token

%USERPROFILE%\.gemini\settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

Config Reference

.env file:

Variable	Description
GOOGLE_GEMINI_BASE_URL	Clauddy API base URL: https://clauddy.com
GEMINI_API_KEY	Your Clauddy API token

settings.json file:

Sets auth to API Key mode, bypassing Google OAuth login.

Config File Paths

OS	Path
macOS / Linux	~/.gemini/.env and ~/.gemini/settings.json
Windows	%USERPROFILE%\.gemini\.env and %USERPROFILE%\.gemini\settings.json

Launch

On first launch, Gemini CLI will read the config files from ~/.gemini/ on macOS / Linux, or %USERPROFILE%\.gemini\ on Windows.

gemini

Troubleshooting

See Gemini FAQ.