💎 Google Gemini CLI 가이드

1️⃣ Python 버전 확인

python3 --version

Python 3.7 이상이 설치되어 있어야 합니다.

2️⃣ Gemini CLI 설치

pip3 install gemini-cli

💡 설치 진행 상황이 안 보이면: pip3 install gemini-cli --verbose

3️⃣ 설치 확인

gemini --version

1️⃣ Python 버전 확인

python --version

Python이 없다면 python.org에서 다운로드

2️⃣ Gemini CLI 설치

pip install gemini-cli

💡 설치 진행 상황이 안 보이면: pip install gemini-cli --verbose

3️⃣ 설치 확인

gemini --version

Step 1: Google AI Studio 접속

링크: https://aistudio.google.com/app/apikey

위 링크를 클릭하면 Google AI Studio의 API 키 관리 페이지로 이동합니다.

Step 2: Google 계정으로 로그인

• 개인 Gmail 계정 사용 권장
• 회사 Google Workspace 계정도 가능 (관리자 설정에 따라 제한될 수 있음)

Step 3: API 키 생성

1. "Create API Key" 버튼 클릭
2. 프로젝트 선택 (없으면 자동 생성됨)
3. 생성된 API 키가 화면에 표시됩니다

💡 API 키는 AIza...로 시작하는 긴 문자열입니다 (약 39자)

Step 4: API 키 복사

"Copy" 버튼을 클릭하여 API 키를 클립보드에 복사합니다.

⚠️ 주의: API 키는 비밀번호처럼 관리하세요. 다른 사람과 공유하지 마세요!

🪟 Windows PowerShell (복사해서 실행)

Step 1: 설정 폴더 생성

# PowerShell에서 실행
mkdir $env:USERPROFILE\.config -Force

Step 2: 설정 파일 생성 및 편집

# 메모장으로 설정 파일 열기
notepad $env:USERPROFILE\.config\gemini-cli.toml

Step 3: 아래 내용을 복사해서 메모장에 붙여넣기

[default]
token = "your-api-key-here"
model = "gemini-1.5-flash"

[generation_config]
temperature = 0.7
top_p = 0.95
top_k = 40
max_output_tokens = 2048

⚠️ 중요: your-api-key-here를 복사한 API 키로 교체하세요!

예시:

[default]
token = "AIzaSyABC123def456GHI789jkl"
model = "gemini-1.5-flash"

[generation_config]
temperature = 0.7
top_p = 0.95
top_k = 40
max_output_tokens = 2048

Step 4: 저장 후 메모장 닫기

1. 메모장에서 파일 → 저장 (Ctrl+S)
2. 메모장 닫기

🍎 Mac/Linux (복사해서 실행)

Step 1: 설정 폴더 생성

mkdir -p ~/.config

Step 2: 설정 파일 생성

# 아래 명령어를 한 번에 복사해서 실행
# your-api-key-here를 실제 API 키로 교체하세요

cat > ~/.config/gemini-cli.toml << 'EOF'
[default]
token = "your-api-key-here"
model = "gemini-1.5-flash"

[generation_config]
temperature = 0.7
top_p = 0.95
top_k = 40
max_output_tokens = 2048
EOF

Step 3: 설정 파일 확인

cat ~/.config/gemini-cli.toml

🪟 Windows PowerShell (상세 가이드)

Step 1: PowerShell 관리자 권한으로 실행 (권장)

1. 시작 메뉴에서 "PowerShell" 검색
2. 우클릭 → "관리자 권한으로 실행"

Step 2: 환경 변수 설정 명령어 실행

# 아래 명령어를 복사해서 PowerShell에 붙여넣기
# 'your-api-key-here' 부분을 복사한 API 키로 교체하세요

[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'your-api-key-here', 'User')

Step 3: PowerShell 재시작 후 확인

$env:GEMINI_API_KEY

🍎 Mac/Linux

# zsh 사용자 (Mac 기본)
echo 'export GEMINI_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

# bash 사용자
echo 'export GEMINI_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

✅ 최종 테스트

Windows PowerShell

# 대화형 모드 실행
python -m gemini_cli

# 또는 직접 질문
python -m gemini_cli "안녕하세요!"

Mac/Linux

# 대화형 모드 실행
python3 -m gemini_cli

# 또는 직접 질문
python3 -m gemini_cli "안녕하세요!"

💡 성공 시: Gemini가 한국어로 답변하면 모든 설정이 완료된 것입니다!