Gemini CLI 공식 안내: 무료 티어 및 Google One 사용자는 2026년 6월 18일부터 Antigravity CLI로 전환됩니다. API 키를 사용하고 Base URL을 직접 설정하는 방식에는 영향이 없습니다.
빠른 설정 가이드:
1️⃣ 전역 npm 패키지 설치
터미널에서 실행하세요2️⃣ 환경 변수 구성
Aihubmix API 키와 전달 주소를 시스템 환경 변수에 추가하세요. Aihubmix 「키」 페이지에서 API 키를 생성할 수 있습니다. 예를 들어, ~/.zshrc에 추가하세요:3️⃣ 구성 적용
구성을 추가한 후, 터미널에서source ~/.zshrc를 실행하고 Enter 키를 누르세요.
4️⃣ 터미널 실행
터미널에 입력하세요:초기화 설정
연결 방법 선택

Trust folder를 선택하면 자동으로 다시 시작됩니다. 다시 시작한 뒤 Get started 인증 화면이 표시되며, GEMINI_API_KEY가 설정되어 있으면 Use Gemini API Key가 기본으로 선택되어 있습니다. Enter 키를 눌러 확인하세요.
Enter Gemini API Key 입력 창이 나타나며, GEMINI_API_KEY 값이 미리 입력되어 있습니다. 값을 확인한 뒤 Enter 키를 눌러 제출하세요.
이후 인증 방법을 전환하려면
/auth를 입력해 인증 화면을 다시 열 수 있습니다.대화형 선택 건너뛰기 (선택 사항)
~/.gemini/settings.json에 다음 설정을 추가하면 실행할 때 대화형 선택을 건너뛸 수 있습니다:
실행 성공
위의 초기화를 완료하면 정상적으로 사용할 수 있습니다.