문서 검색...

문서를 검색하려면 입력을 시작하세요

Gemini
Gemini CLI

Gemini CLI 통합

UnoRouter을 Gemini CLI 및 Google GenAI 호환 클라이언트와 함께 사용하세요. Claude, GPT와 함께 Gemini 모델에 접근하세요.

개요

Gemini CLI는 터미널에서 바로 파일을 편집하고 명령을 실행하는 Google의 오픈소스 코딩 에이전트입니다. UnoRouter을 베이스 URL로 설정하면, Google 전용 계정 대신 OpenAI 호환 키 하나로 Gemini, Claude, GPT를 비롯한 모든 모델에 도달할 수 있습니다.

빠른 설정

이 값들을 클라이언트에 입력하세요. 로그인한 상태에서는 키가 자동으로 채워집니다.

text
기본 URL: https://api.unorouter.ai
API 키: YOUR_API_KEY

API 키를 자동 입력하려면 로그인하세요

호환성

Chat Completions스트리밍도구 호출이미지 입력

단계별 설정

  1. 1
    Gemini CLI 설치

    npm으로 Gemini CLI를 전역 설치하세요. Windows에서는 WSL 안에서 실행하세요.

    bash
    npm install -g @google/gemini-cli

    API 키를 자동 입력하려면 로그인하세요

  2. 2
    환경 변수 설정

    UnoRouter API 키가 담긴 `~/.gemini/.env`를 만들고 `GOOGLE_GEMINI_BASE_URL`을 UnoRouter의 베어 기본 URL로 설정하세요. Gemini SDK가 자체 경로를 덧붙이므로 `/v1`을 추가하지 마세요.

    bash
    # ~/.gemini/.env
GEMINI_API_KEY=YOUR_API_KEY
GOOGLE_GEMINI_BASE_URL=https://api.unorouter.ai

    API 키를 자동 입력하려면 로그인하세요

  3. 3
    Gemini 실행

    프로젝트 디렉터리에서 `gemini`를 실행하여 세션을 시작하세요.

powershell
$env:GEMINI_API_KEY="YOUR_API_KEY"
$env:GOOGLE_GEMINI_BASE_URL="https://api.unorouter.ai"

gemini

API 키를 자동 입력하려면 로그인하세요

추천 모델

여기서 잘 작동하는 무료 모델입니다. 원하는 모델 ID를 클라이언트에 붙여넣으세요.

mistral-mediummistral-7b-instruct-v0.3codestral-2508qwen3-next-80b-a3b-instructdeepseek-v3.1

주의사항

  • 요청이 404가 나면 기본 URL에 경로를 추가한 것입니다. `GOOGLE_GEMINI_BASE_URL`은 `/v1` 접미사가 없는 베어 호스트여야 하며, 나머지는 SDK가 덧붙입니다.
  • 인증이 실패하면 `~/.gemini/.env`의 `GEMINI_API_KEY`가 UnoRouter 키인지, 셸 세션이 해당 파일을 읽는지 확인하세요.
API 키 생성모델