Gemini CLI

CometAPI를 API 엔드포인트로 사용하도록 Gemini CLI를 설정합니다: npm 또는 Homebrew로 설치하고, GEMINI_API_KEY 및 GOOGLE_GEMINI_BASE_URL을 구성한 뒤, 터미널에서 Gemini 모델 사용을 시작하세요.

이 가이드를 사용해 Gemini CLI를 CometAPI를 API 엔드포인트로 설정하여 실행할 수 있습니다.

공식 참고 자료:

• Gemini CLI GitHub
• Gemini CLI Authentication

모델 가용성은 시간에 따라 변경될 수 있습니다. 현재 사용 가능한 Gemini 모델은 CometAPI Models page에서 확인하세요.

​

사전 요구 사항

요구 사항	세부 정보
Node.js	22+ (LTS 권장)
OS	macOS, Linux 또는 Windows
CometAPI key	CometAPI Dashboard에서 확인 ( sk-로 시작)

​

설정

1. Gemini CLI 설치

   npm install -g @google/gemini-cli
   

   또는 Homebrew를 통해 설치(macOS / Linux):

   brew install gemini-cli
   

   확인:

   gemini --version
   
2. 환경 변수 설정

   export GEMINI_API_KEY="sk-your-cometapi-key"
   export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
   

   sk-your-cometapi-key를 실제 CometAPI 키로 바꾸세요.

3. Gemini CLI 시작

   cd your-project
   gemini
   

   처음 실행하면 테마 선택, 안전 공지 확인, 작업 디렉터리 신뢰 여부를 묻는 메시지가 표시됩니다.

​

환경 변수 영구 저장

세션마다 다시 export하지 않으려면 셸 설정 파일에 추가하세요:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

변경 사항을 적용하려면 터미널을 다시 시작하세요.

​

문제 해결

증상	해결 방법
Invalid API Key 오류	GEMINI_API_KEY가 올바르게 설정되었는지 확인하세요. 확인하려면 echo $GEMINI_API_KEY를 실행하세요
fetch failed	네트워크 제한으로 연결이 차단될 수 있습니다. 시스템 전체 프록시를 사용해 보세요
잘못된 Node.js 버전	Gemini CLI는 Node.js 22+가 필요합니다. 확인하려면 node --version을 실행하세요
제거	npm uninstall -g @google/gemini-cli