Gemini CLI

Gemini CLI에서 게이트웨이 API 키 인증과 기본 v1beta API를 사용합니다.

설치 및 준비

  1. Node.js 20 이상과 아래 공식 Gemini CLI npm 패키지를 설치합니다. gemini --version으로 확인합니다.
  2. routerra.ai API 키에서 키를 만들고 모델에서 기본 Gemini 프로토콜 지원 모델을 선택합니다. 이 연결은 OpenAI Chat Completions 대신 Gemini generateContent/streamGenerateContent를 사용합니다.
npm install -g @google/gemini-cli
gemini --version

기본 Gemini 라우팅 설정

  1. Gemini CLI를 실행하는 터미널에서 아래 변수 세 개를 설정합니다. SDK가 /v1beta/models/...를 추가하므로 GOOGLE_GEMINI_BASE_URL은 /v1이나 /v1beta 없는 https://routerra.ai여야 합니다. 키와 모델 자리표시자를 바꿉니다.
  2. 인증 화면에서 Use Gemini API key를 선택합니다. 최신 빌드는 게이트웨이 인증을 자동 감지할 수 있습니다. 기존 Google 로그인이나 Vertex 세션은 이 경로를 우회할 수 있으므로 /auth로 전환합니다. 영구 저장은 ~/.gemini/.env에 NAME=value 형식으로 기록하고 다시 시작합니다. 파일을 커밋하지 마세요.
export GEMINI_API_KEY="YOUR_API_KEY"
export GOOGLE_GEMINI_BASE_URL="https://routerra.ai"
export GOOGLE_GENAI_API_VERSION="v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

Windows PowerShell 환경：

$env:GEMINI_API_KEY = "YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL = "https://routerra.ai"
$env:GOOGLE_GENAI_API_VERSION = "v1beta"
gemini --model YOUR_GEMINI_MODEL_ID

연결 확인

명시적 --model ID로 짧은 프롬프트를 테스트합니다. Google 로그인 화면은 인증 모드가 잘못됐다는 뜻입니다. /v1/v1beta 또는 /v1beta/v1beta 요청은 기본 URL에 경로가 추가된 경우입니다. 모델이 거부되면 OpenAI ID로 바꾸지 말고 기본 Gemini 지원 여부를 확인합니다. 충돌하는 GOOGLE_GENAI_USE_VERTEXAI나 GOOGLE_GENAI_USE_GCA를 지우고 다시 시작한 뒤 routerra.ai 사용량을 확인합니다.