설치와 인증

Gemini CLI는 설치 하나에 인증 경로가 네 가지야

@google/gemini-cli 패키지를 설치하면 gemini 명령이 생겨. 개인 개발자는 Google 계정 OAuth로 로그인하면 Gemini 2.5 Flash를 분당 60회, 하루 1,000회까지 무료로 쓸 수 있어. 신용카드 없이 실제 모델로 시작할 수 있다는 점이 크지.

Google AI Studio 키는 GEMINI_API_KEY로 넣는 종량제 경로고, 조직의 데이터 거주성과 GCP 정책이 중요하면 GOOGLE_GENAI_USE_VERTEXAI=true와 프로젝트를 설정해 Vertex AI로 보내. Gemini Code Assist는 유료 Workspace 통합과 더 높은 사용량이 필요한 경우에 맞아.

개인 실험은 OAuth로 시작하고 한계에 닿으면 API 키로 옮겨. 기업 요구를 AI Studio 키로 대신하려 하지 마. 인증 방식이 곧 청구와 데이터 경로를 결정해.

패키지는 1개, 인증 경로는 OAuth·API 키·Vertex AI·Code Assist의 4개야. 패키지 자체는 Apache 2.0으로 공개돼 있어.

Code

설치와 네 가지 인증 경로·bash

# Install
npm install -g @google/gemini-cli
gemini --version

# Path A — Google Account OAuth (free tier)
gemini                       # browser flow on first run

# Path B — Google AI Studio API key
echo 'export GEMINI_API_KEY="..."' >> ~/.zshrc
source ~/.zshrc

# Path C — Vertex AI (enterprise)
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_CLOUD_PROJECT=my-gcp-project
export GOOGLE_CLOUD_LOCATION=us-central1
gcloud auth application-default login

# Path D — Gemini Code Assist (Workspace)
gemini auth code-assist

설치 확인·bash

# Health check
gemini auth status
gemini --version

# Smoke test in a real repo
cd ~/myproject
gemini -p "list the files in this repo and describe the project"

# See available models
gemini models list

Gemini CLI는 설치 하나에 인증 경로가 네 가지야

Code

External links

Exercise

Progress

댓글 0