CometAPI와 함께 Gemini CLI 사용하기

이 가이드를 사용해 API 엔드포인트로 CometAPI를 설정하여 Gemini CLI를 실행하세요. 공식 참고 자료:

모델 제공 여부는 시간이 지남에 따라 변경될 수 있습니다. 사용 가능한 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"

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

유효하지 않은 API Key 오류

GEMINI_API_KEY가 올바르게 설정되었는지 확인하세요. 확인하려면 echo $GEMINI_API_KEY를 실행하세요.

fetch failed

네트워크 제한으로 인해 연결이 차단될 수 있습니다. 시스템 전체 프록시를 사용해 보세요.

잘못된 Node.js 버전

Gemini CLI는 Node.js 22+가 필요합니다. 확인하려면 node --version을 실행하세요.

Gemini CLI 제거

npm uninstall -g @google/gemini-cli를 실행하세요.