Gemini CLI - CometAPI Documentation

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

모델 제공 여부는 시간이 지나며 변경될 수 있습니다. 사용 가능한 Gemini 모델은 CometAPI Models page에서 확인하세요.

사전 요구 사항

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

Install Gemini CLI

npm install -g @google/gemini-cli

또는 Homebrew를 통해 설치할 수 있습니다(macOS / Linux):

brew install gemini-cli

확인:

gemini --version

Set environment variables

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

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

Start 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` error	`GEMINI_API_KEY`가 올바르게 설정되었는지 확인하세요. `echo $GEMINI_API_KEY`를 실행해 점검할 수 있습니다
`fetch failed`	네트워크 제한으로 연결이 차단될 수 있습니다. 시스템 전체 프록시를 시도해 보세요
잘못된 Node.js 버전	Gemini CLI는 Node.js 22+가 필요합니다. `node --version`을 실행해 확인하세요
제거	`npm uninstall -g @google/gemini-cli`