Gemini CLI

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

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

사전 요구 사항

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

Gemini CLI 설치

npm install -g @google/gemini-cli

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

brew install gemini-cli

확인:

gemini --version

환경 변수 설정

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

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

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`