Gemini CLI 통합

개요

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

빠른 설정

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

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

호환성

단계별 설정

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.com

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

3. 3
   Gemini 실행

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

   bash

   gemini

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

추천 모델

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

주의사항

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