본문 바로가기
Programming | 오류&해결

[ Vertex AI ] Gemini CLI 설정 방법 | gcloud CLI oAuth

by 우루뿡 2026. 4. 20.
반응형
SMALL

claude는 비싸서 못 쓰고 gpt를 구독해서 쓰고 있습니다. 근데 gemini도 써보고 싶은 마음에 찾아보니 vertex ai에서 300달러 크레딧을 제공받아 사용해볼 수 있더라구요.

api 키로 간단히 연동하는 방식이 아닌 'gcloud CLI 인증'을 사용해야 합니다.

 

아래는 gpt한테 물어보면서 이것저것 오류도 해결하면서 결국에 잘 연동된 일련의 과정을 기록해봤습니다.

 

# 가장 중요한 포인트

Vertex AI는 API Key 방식이 아니다

 

1. gemini CLI 설치를 위한 node & npm 설치

 

 

# node 버전은 나오는데 npm 버전이 안나오는 경우

 

 

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

=> 'Y' + 엔터!

 

 

 

2. gemini CLI 설치

 

npm install -g @google/gemini-cli

 

 

3. gCloud CLI 설치

 

빠른 시작: Google Cloud CLI 설치  |  Google Cloud SDK  |  Google Cloud Documentation

 

빠른 시작: Google Cloud CLI 설치  |  Google Cloud SDK  |  Google Cloud Documentation

Google Cloud CLI를 설치하고 몇 가지 핵심 gcloud CLI 명령어를 실행하는 방법을 알아봅니다.

docs.cloud.google.com

 

 

 

 

 

4. Vertex AI API 사용 설정

 

GCP에서 상단 중간에 'vertex ai api' 검색해서 사용 설정!

 

 

 

5. 로그인 & vertex AI에서 생성한 프로젝트 연결

 

'Y' 눌러 로그인

 

 

gcloud~ 뜰 때 아래 명령어 입력

 

gcloud auth application-default login

 

 

 

6. gemini CLI 접속 후 Vertex AI 인증 선택

 

3 누르면 잘 되겠지..? 했는데 안됨

 

 

# 환경변수 세팅이 안되서 안되는 것

 

아래 환경변수들을 세팅해주면 됩니다.

제가 사용했던 명령어도 그대로 올릴테니 참고하세요!

제가 생성한 프로젝트명은 'oai-05-project'

GOOGLE_GENAI_USE_VERTEXAI=true
GOOGLE_CLOUD_PROJECT=<PROJECT_ID>
GOOGLE_CLOUD_LOCATION=us-central1

 

setx GOOGLE_CLOUD_PROJECT "oai-05-project"

setx GOOGLE_CLOUD_LOCATION "us-central1" <- gemini preview 모델 사용 불가

setx GOOGLE_CLOUD_LOCATION "global"

 

 

이제 모든 세팅을 마치고 명령을 하시면 됩니다!

preview 모델은 쓸 수 없다고 하네요.

버텍스 가서 또 권한 뭐시기 해야되나본데 이제 진절머리가 납니다.. ㅠ

그냥 'gemini-2.5-pro'만 사용하기 위해 /model 해서 3.manual로 설정하시면 됩니다.

 

 

이 후 GCP 들어가서 'credits' 검색해서 무료체험 크레딧이 정상적으로 소모되고 있는지 꼭 확인!

 

 

+ 처음엔 vs code에서 extension으로 써보고 싶었는데 아래 오류 뜨면서 결국엔 CLI를 쓰게 됐네요 ㅠ

 

 

구글 클라우드 콘솔에서 권한 주는 거 왜 이렇게 복잡하게 해놓은건지 모르겠어요

다들 버텍스 쌀먹 맛있게 하세용~

 

 

LIST