Gemini CLI 설치 방법무료 사용 조건 확인터미널에서 AI 실행법
Gemini CLI 설치 전 준비사항
Gemini CLI를 사용하려면 먼저 Node.js가 설치되어 있어야 합니다.
터미널을 열고 node –version 명령어를 입력해 설치 여부를 확인하세요.
버전이 출력되면 다음 단계로 넘어갈 수 있습니다.
운영체제는 Windows, macOS, Linux 모두 지원합니다.
각 OS별로 설치 경로와 권한 설정이 다를 수 있으니, 본인 환경에 맞는 설치 방법을 미리 확인하는 것이 좋습니다.
터미널 접근 권한도 필요합니다.
관리자 권한으로 실행해야 하는 경우가 있으므로, 미리 확인해 두세요.
터미널에서 Gemini CLI 설치하기
설치 명령어는 npm install -g @google/gemini-cli 입니다.
이 명령어를 입력하면 전역으로 Gemini CLI가 설치됩니다.
설치가 완료되면 gemini –version으로 버전을 확인할 수 있습니다.
설치 중 오류가 발생하면 npm cache clean –force를 실행한 후 다시 시도하세요.
네트워크 문제로 설치가 안 될 때는 VPN이나 프록시 설정을 확인해야 합니다.
설치가 끝난 후 gemini 명령어가 인식되지 않으면 터미널을 재시작하거나, 시스템 PATH를 다시 로드하세요.
설치 후 바로 gemini –help를 입력하면 사용 가능한 모든 옵션을 확인할 수 있습니다.
이 명령어로 기본 사용법을 빠르게 파악하세요.
API 키 발급과 설정 방법
Gemini CLI를 사용하려면 Google AI Studio에서 API 키를 발급받아야 합니다.
키 발급 후에는 환경 변수로 등록하는 방식이 가장 안정적입니다.
Windows에서는 setx GEMINI_API_KEY “발급받은키” 명령어로, macOS와 Linux에서는 export GEMINI_API_KEY=”발급받은키”로 등록합니다.
등록 후 터미널을 재시작하면 적용됩니다.
API 키가 제대로 설정되었는지 확인하려면 gemini auth status 명령어를 사용하세요.
인증 상태가 출력되면 정상적으로 등록된 것입니다.
기본 사용법과 주요 명령어
가장 기본적인 사용법은 gemini “질문 내용”입니다.
이 명령어를 입력하면 Gemini가 터미널에서 바로 답변을 생성합니다.
긴 질문은 따옴표로 감싸서 입력하세요.
파일 내용을 분석하려면 gemini –file 파일경로 명령어를 사용합니다.
코드 리뷰, 문서 요약, 로그 분석 등 다양한 작업에 활용할 수 있습니다.
대화형 모드로 사용하려면 gemini chat을 입력하세요.
이 모드에서는 연속적인 질문을 주고받을 수 있어 복잡한 작업에 유리합니다.
자주 사용하는 명령어는 별칭으로 등록해 두면 편리합니다.
bashrc나 zshrc에 alias g=’gemini’를 추가하면 gemini 대신 g만 입력해도 됩니다.
자주 발생하는 문제 해결하기
API 키 오류가 발생하면 키가 올바르게 등록되었는지, 환경 변수가 제대로 로드되었는지 확인하세요.
gemini auth status로 상태를 점검할 수 있습니다.
네트워크 연결 문제는 방화벽이나 프록시 설정 때문일 수 있습니다.
회사 네트워크에서는 IT 관리자에게 Gemini API 도메인 접근 권한을 요청해야 합니다.
응답이 느리거나 타임아웃이 발생하면 모델 선택이나 요청 길이를 조정해 보세요.
gemini config 명령어로 현재 설정을 확인하고 필요에 따라 변경할 수 있습니다.
무료 사용 한도와 관리 팁
Gemini CLI의 무료 사용 한도는 Google 정책에 따라 변동될 수 있습니다.
정확한 한도는 Google AI Studio 대시보드에서 직접 확인하세요.
사용량이 많아지면 응답 속도가 느려지거나 일시적으로 제한될 수 있습니다.
중요한 작업은 미리 여유를 두고 진행하는 것이 안전합니다.
API 키는 정기적으로 교체하는 것이 좋습니다.
키가 노출된 것으로 의심되면 즉시 Google AI Studio에서 새 키를 발급받고 기존 키를 폐기하세요.
자주 묻는 질문
npm install -g로 설치했다면 전역 경로에 추가되었는지 확인해야 합니다.
발급된 키는 환경 변수로 등록해야 Gemini CLI에서 사용할 수 있습니다.
정확한 한도는 Google AI Studio 대시보드에서 본인 계정의 사용량을 확인하세요.
Windows는 setx, macOS와 Linux는 export를 사용하세요.
환경 변수에 등록된 키도 새 값으로 업데이트해야 합니다.
