Skip to main content
Gemini CLI is Google’s powerful coding assistant with advanced reasoning capabilities.
If your Allowed Headers are already set to *, you can skip this note. If not and you face issues integrating Bifrost with Gemini CLI, try switching to * or adding the specific headers required by your client. By default, Bifrost whitelists: Content-Type, Authorization, X-Requested-With, X-Stainless-Timeout, and X-Api-Key.

​
To install Gemini CLI

npm install -g @google/gemini-cli

​
Configuring Gemini CLI to work with Bifrost

Gemini CLI supports multiple authentication methods. Choose the one that matches your account type.

​
Google account (OAuth)

Log in with your Google account for free-tier access (60 requests/min, 1,000 requests/day).
  1. Set the Bifrost base URL 
    export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
  2. Run Gemini CLI and sign in 
    gemini
    Select Login with Google and authenticate via your browser. All traffic automatically routes through Bifrost.

​
API key based usage

For users with a Gemini API key (obtain one from Google AI Studio):
  1. Configure environment variables 
    export GEMINI_API_KEY=your-api-key  # Gemini API key or Bifrost virtual key
export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
  2. Run Gemini CLI 
    gemini
    Select Use Gemini API Key in the CLI prompt for authentication.
Gemini CLI authentication

​
Google Cloud / Vertex AI

For enterprise users with Vertex AI access: 
export GOOGLE_API_KEY=your-api-key  # Google API key or Bifrost virtual key
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_GEMINI_BASE_URL=http://localhost:8080/genai
gemini
For paid Code Assist License users, set your Google Cloud project: export GOOGLE_CLOUD_PROJECT="your-project-id"
Now all Gemini CLI traffic flows through Bifrost, giving you access to any provider/model configured in your Bifrost setup, plus observability and governance.

​
Model Configuration

Use the -m flag to start Gemini CLI with a specific model: 
gemini -m gemini-2.5-flash
gemini -m gemini-2.5-pro

​
Using Non-Google Models with Gemini CLI

Bifrost automatically translates GenAI API requests to other providers, so you can use Gemini CLI with models from OpenAI, Anthropic, Mistral, and more. Use the provider/model-name format to specify any Bifrost-configured model. 
# Start with an OpenAI model
gemini -m openai/gpt-5

# Start with an Anthropic model
gemini -m anthropic/claude-sonnet-4-5-20250929

# Start with a Groq model
gemini -m groq/llama-3.3-70b-versatile

​
Supported Providers

Bifrost supports the following providers with the provider/model-name format: openai, azure, gemini, vertex, bedrock, mistral, groq, cerebras, cohere, perplexity, xai, ollama, openrouter, huggingface, nebius, parasail, replicate, vllm, sgl
Non-Google models must support tool use for Gemini CLI to work properly. Gemini CLI relies on tool calling for file operations, terminal commands, and code editing. Models without tool use support will fail on most operations.