Gemini CLI 사용법

Gemini CLI 사용법

https://github.com/google-gemini/gemini-cli

    - 설치 (업데이트)
npm install -g @google/gemini-cli

     - 실행
gemini

 

 

-------------------------------------------------------------------------------
* 새 인증 설정 방법
     - gemini 실행중 /auth 명령 실행

---------------------------------------
* 인증 방법에 따른 차이
1. Login with Google : 무료

무료는 Gemini Pro 모델 사용과 사용량에 제한 있음 

유료로 사용하려면 Gemini Code Assist 유료 결제를 하면 가능

    - 환경변수 설정 필요 : GOOGLE_CLOUD_PROJECT="google cloud 프로젝트"

    참고 :  https://codens.tistory.com/2953

 

2. Gemini API Key (AI Studio)
https://aistudio.google.com/app/apikey
     : 사용해본 결과 현재 유료
     - 설정 방법
GEMINI_API_KEY="API_키"
 
3. Vertex AI : 유료

 

 

-------------------------------------------------------------------------------
'Vertex AI'  인증하는 방법

https://medium.com/@minamimunakata/how-to-set-up-gemini-cli-with-vertex-ai-fcbe26207271

 

* Google Cloud 에 가입하고 프로젝트 생성

https://cloud.google.com/

 

* google cloud CLI (gcloud) 설치하고 인증
https://cloud.google.com/sdk/docs/install?hl=ko
https://codens.tistory.com/2785

     - 인증 실행
gcloud auth application-default login

     - 현재 인증 정보 확인
gcloud config list

---------------------------------------
* 시스템 환경변수 설정
    - 프로젝트의 .env 에 설정해도 됨(프로젝트 한정)
GOOGLE_GENAI_USE_VERTEXAI=true
GOOGLE_CLOUD_PROJECT="생성한 프로젝트"
GOOGLE_CLOUD_LOCATION="region 이름"  <== global 추천

 

* gemini CLI 인증
gemini 실행후 인증방식을 Vertex AI 선택하면 브라우저 인증 실행됨
다른 브라우저로 인증하려면, 실행된 브라우저의 주소줄을 복사해서 원하는 브라우저에 붙여넣고 인증한다.

 

 

-------------------------------------------------------------------------------

-------------------------------------------------------------------------------
gemini-cli 에러 해결 방법

* 에러 메시지

✕ [API Error: API keys are not supported by this API. Expected OAuth2 access token or other authentication credentials that assert a principal. See https://cloud.google.com/docs/authentication (Status: UNAUTHENTICATED)]


* 해결 방법
- google cloud 인증
gcloud auth application-default login

gcloud auth application-default set-quota-project [프로젝트이름]
gcloud config set project nernter-ai2 [프로젝트이름]


- 환경변수 설정
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT=[프로젝트이름]
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_APPLICATION_CREDENTIALS=인증키파일 경로

- 다음 환경변수는 설정하지 않는다
GOOGLE_API_KEY

 

-------------------------------------------------------------------------------
---------------------------------------
* 사용 모델
     - 모델 변경
gemini --model gemini-2.5-pro

     - 주로 Gemini Pro를 사용하고, 현재 사용중인 모델이 하단에 표시됨
     - 그런데 사용 로그를 보면 Flash도 사용되는 걸로 나옴

 

-------------------------------------------------------------------------------
Google Cloud 결제금액 , 사용량 모니터링 방법

결제 - 개요 (결제 예정 금액)
https://console.cloud.google.com/billing

API 및 서비스 - API 사용 현황
https://console.cloud.google.com/apis/dashboard
-> Gemini for Google Cloud, Vertex AI Endpoints, Vertex AI Model Garden 선택

모니터링 – 사용량 모니터링
https://console.cloud.google.com/monitoring/dashboards
-> Gemini for Google Cloud, Vertex AI Endpoints, Vertex AI Model Garden 선택

할당량 및 시스템 한도 – IAM 및 관리자 / 할당량
https://console.cloud.google.com/iam-admin/quotas

-------------------------------------------------------------------------------

---------------------------------------
* 여러줄 입력방법 

Ctrl+Enter : 사용가능 환경 WSL, PowerShell, cmd.exe, git-bash.exe

끝에 '\' 입력후 엔터 : 사용가능 환경 WSL, PowerShell, cmd.exe, git-bash.exe

 

---------------------------------------
* 여러줄 붙여넣기 방법
- WSL에서는 바로 붙여넣기 가능
- Windows 환경(PowerShell, cmd.exe, git-bash.exe)에서는 외부 에디터 실행 키(Ctrl+x) 사용

---------------------------------------
에디터 설정

- notepad
set EDITOR=notepad

- Vim
set EDITOR=vim

- vscode
set EDITOR=code

-------------------------------------------------------------------------------
< 참고 >
VS code Extension : Gemini Code Assist , 사용자 인증 변경 방법

     - 로그아웃
명령 팔레트( Ctrl+Shift+P ) -> sign out 입력 -> Google Cloud SDK에서 모든 계정 로그아웃(Sign out of all accounts in Google Cloud SDK)**을 선택

     - 로그인
맨 좌측 패널의 제미나이 아이콘 클릭 -> Google에 로그인(Log in to Google) 


* 사용 모델 변경 방법
     - 모델 변경 불가, 주로 Gemini-Flash 버전 사용
     - 참고 : GitHub Copilot은 Gemini-Pro 지정 가능


* Gemini Code Assist Standard(유료버전) 사용 신청 방법
https://console.cloud.google.com/gemini-admin
     - 구글 클라이드의 상단 메뉴에서 admin for gemini 타이핑



---------------------------------------
VS code Extension : Google Cloud Code
     - Google Cloud 기반의 개발 및 배포 기능
     - AI 코딩 도우미가 아님
    - Gemini Code Assist 와 관련 없음