Gemini CLI 설정 가이드
Gemini CLI는 Google의 터미널 AI 도구입니다. 명령줄 환경에서 Gemini를 활용해 Q&A, 코드 분석, 프로젝트 보조 작업을 수행하기에 적합합니다.
공식 정보 다운로드 및 문서는 공식 사이트를 기준으로 합니다.
이 도구의 용도 및 기능
Google Gemini터미널 도구Google 로그인Gemini API Key
먼저 인증 방식을 선택하세요
| 방식 | 대상 사용자 | 설명 |
|---|---|---|
| Google 로그인 | 개인 사용자 및 초보자 | Gemini를 실행하고 안내에 따라 로그인 |
| Gemini API Key | 이미 Google AI Studio Key를 보유한 사용자 | GEMINI_API_KEY에 Key 입력 |
| Vertex AI | 기업 또는 클라우드 프로젝트 사용자 | Google Cloud 프로젝트 및 권한에 맞게 설정 |
API Key 테스트 방법
PowerShell에서 임시 테스트
$env:GEMINI_API_KEY = "YOUR_GEMINI_API_KEY" gemini터미널에서 임시 테스트
GEMINI_API_KEY="YOUR_GEMINI_API_KEY" gemini대화형 로그인
gemini테스트 성공 후 진행 방법
- 먼저 빈 디렉터리에서 Gemini CLI를 실행하세요. 중요한 프로젝트 폴더에서 바로 열지 마세요.
- 모델이 정상적으로 응답하는지 확인하기 위해 짧은 고정 질문 하나만 먼저 테스트하세요.
- 그런 다음 테스트용 파일을 읽게 하고, 파일을 수정하지 않도록 명확하게 요청하세요.
- API Key를 장기적으로 사용하려면 Gemini CLI 공식 문서에 따라 로컬 환경 변수나 설정 파일에 인증 정보를 저장하세요.
- AI 제공업체(중계 사이트)나 CC-Switch 설정을 변경한 경우, 터미널을 다시 열고 다시 테스트하세요.
| 현상 | 우선 확인 사항 | 대처 방법 |
|---|---|---|
| Google 로그인이 계속 요구됨 | 현재 인증 방식이 Google 로그인 절차로 진행되고 있나요? | 먼저 Gemini CLI의 자체 안내에 따라 인증을 완료하세요. API Key 문제 해결과 로그인 절차를 혼동하지 마세요. |
| Key가 유효하지 않음 | GEMINI_API_KEY가 Google AI Studio / Gemini에서 발급받은 것이 맞나요? | Gemini에 OpenAI나 Claude Key를 입력하지 마세요. |
| 모델을 사용할 수 없음 | 모델명이 Gemini 목록에 포함되어 있나요? | Gemini CLI에 OpenAI / Claude 모델명을 입력하지 마세요. |
AI 제공업체(중계 사이트) 설정 시 주의사항
Gemini CLI와 OpenAI 호환 제공업체는 동일한 규격이 아닙니다. 제공업체에서 Gemini CLI, Google Gemini 또는 Vertex AI 전용 설정 방법을 명시적으로 안내하는 경우에만 해당 튜토리얼을 따르세요.
Gemini CLI에 일반 OpenAI Base URL을 입력하지 마세요. OpenAI, Claude, Gemini는 서로 다른 세 가지 프로토콜입니다. 제공업체 콘솔에서 별도의 전용 엔드포인트 주소를 제공한다면 해당 도구에 맞는 주소를 입력해야 합니다.
Gemini CLI 공식 문서 설치 방법, 명령어 및 설정 가이드를 확인하세요.
Gemini CLI 인증 문서 Google 로그인, Gemini API Key 및 Vertex AI 설정을 확인하세요.