KozeKoze
← 블로그로 돌아가기
지도 시간2026年3月23日·管理员

Gemini CLI 구성 튜토리얼

Gemini CLI 구성 튜토리얼

📋 준비 단계

시작하기 전에 다음 사항을 확인하세요.

  • Koze 계정을 등록하고 로그인했는지 확인하세요.
  • API 관리 페이지에서 API 키를 생성했는지 확인하세요.
  • Gemini CLI를 설치했는지 확인하세요. (npm install -g @anthropic-ai/gemini-cli 또는 공식 저장소를 참조하세요.

🚀 방법 1: Gemini API를 통한 접근 (권장)

터미널에서 다음 환경 변수를 설정하세요.

# Koze Gemini 프록시 주소 설정 export GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# Koze API 키 설정
export GEMINI_API_KEY='API 키'

# 사용할 모델 지정
export GEMINI_MODEL='gemini-2.5-pro'

인증 방법:시작 시 Gemini API 키 사용을 선택하세요. API 키를 입력하라는 메시지가 표시되면 Enter 키를 누르고 비워 두세요.

💡 시작 시 Google 로그인 페이지로 자동 리디렉션되는 경우 ~/.gemini/settings.json 파일을 삭제하고 다시 시작하세요.

🔧 두 번째 방법: 코드 지원 API를 통한 액세스

특수한 시나리오에 적합한 또 다른 액세스 방법입니다.

# 코드 지원 엔드포인트 설정

export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini'

# 액세스 토큰 설정 (Koze API 키 사용)

export GOOGLE_CLOUD_ACCESS_TOKEN='API 키'

# GCA 모드 활성화

export GOOGLE_GENAI_USE_GCA='true'

# 모델 지정

export GEMINI_MODEL='gemini-2.5-pro'

인증 방법:시작 시 다음으로 로그인을 선택하세요.

⚠️ 참고: Gemini CLI 콘솔에 "사용자 정보를 가져오는 데 실패했습니다: 401 권한 없음" 오류가 표시될 수 있습니다. 이는 정상적인 현상이며 사용에는 영향을 미치지 않습니다.

🎯 3단계: Gemini CLI 실행

설정 후 터미널에서 Gemini CLI를 실행합니다.

gemini

📌 환경 변수 저장

환경 변수를 셸 설정 파일(예: 방법 1)에 저장하는 것이 좋습니다.

# Zsh 사용자

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY= key

export GEMINI_MODEL=

EOF source ~/.zshrc

📌 사용 가능한 모델

모델명 설명
gemini-2.5-pro Gemini 2.5 Pro, 최신 고성능 모델
gemini-2.5-flash Gemini 2.5 Flash, 더 빠르고 강력함 비용 효율적
gemini-2.0-flash Gemini 2.0 플래시

⚠️ 자주 묻는 질문(FAQ) 사용에 영향을 미치지 않으므로 무시하십시오.
문제 해결 방법
시작 후 Google 로그인 페이지로 자동 리디렉션 ~/.gemini/settings.json 파일을 삭제하고 다시 시도하세요
401 권한 없음 오류 메시지 정상적인 메시지입니다
모델을 이용할 수 없습니다. Koze 모델 로비에서 현재 플랜에 Gemini 모델이 포함되어 있는지 확인하십시오.

Gemini CLI 구성 튜토리얼 | Koze AI