메인 콘텐츠로 건너뛰기
Aihubmix로 Gemini CLI를 구동하여 안정적이고 효율적인 Gemini 모델 서비스를 이용하세요.
Gemini CLI 공식 안내: 무료 티어 및 Google One 사용자는 2026년 6월 18일부터 Antigravity CLI로 전환됩니다. API 키를 사용하고 Base URL을 직접 설정하는 방식에는 영향이 없습니다.

빠른 설정 가이드:

1️⃣ 전역 npm 패키지 설치

터미널에서 실행하세요
Node.js 버전이 20 이상인지 확인하세요. 자세한 정보는 다음을 참조하세요:
  1. 공식 저장소
  2. 상세 구성

2️⃣ 환경 변수 구성

Aihubmix API 키와 전달 주소를 시스템 환경 변수에 추가하세요. Aihubmix 「키」 페이지에서 API 키를 생성할 수 있습니다. 예를 들어, ~/.zshrc에 추가하세요:
Mac 사용자의 경우, 사용자 이름 디렉토리에서 단축키 ⌘ + ⇧ + .를 사용하여 숨겨진 .zshrc 파일을 표시한 다음, 시스템의 “텍스트 편집기” 앱으로 열어 위 내용을 추가할 수 있습니다.
Windows PowerShell 사용자는 다음 명령을 실행하세요(현재 창에서만 적용됩니다):

3️⃣ 구성 적용

구성을 추가한 후, 터미널에서 source ~/.zshrc를 실행하고 Enter 키를 누르세요.

4️⃣ 터미널 실행

터미널에 입력하세요:

초기화 설정

연결 방법 선택

Gemini CLI 인증 화면에서 Use Gemini API Key를 선택한 화면 처음 실행하면 Gemini CLI가 먼저 현재 폴더를 신뢰할지 묻습니다. Trust folder를 선택하면 자동으로 다시 시작됩니다. 다시 시작한 뒤 Get started 인증 화면이 표시되며, GEMINI_API_KEY가 설정되어 있으면 Use Gemini API Key가 기본으로 선택되어 있습니다. Enter 키를 눌러 확인하세요.
이어서 Enter Gemini API Key 입력 창이 나타나며, GEMINI_API_KEY 값이 미리 입력되어 있습니다. 값을 확인한 뒤 Enter 키를 눌러 제출하세요.
이후 인증 방법을 전환하려면 /auth를 입력해 인증 화면을 다시 열 수 있습니다.

대화형 선택 건너뛰기 (선택 사항)

~/.gemini/settings.json에 다음 설정을 추가하면 실행할 때 대화형 선택을 건너뛸 수 있습니다:

실행 성공

위의 초기화를 완료하면 정상적으로 사용할 수 있습니다. Gemini CLI 구성 완료 후 정상적으로 대화하는 화면

즐겁게 사용하세요!

마지막 업데이트: 2026-10-19