시스템 요구사항
Gemini CLI를 설치하기 전에 시스템이 이러한 요구사항을 충족하는지 확인하세요.
Node.js
필수18.0.0 이상
NPM 설치에 필요한 JavaScript 런타임
NPM
필수8.0.0 이상
패키지 매니저 (Node.js와 함께 제공)
Git
최신
버전 제어 시스템 (선택사항, 소스 빌드용)
Google 계정
필수활성
API 인증에 필요
설치 방법
설정에 가장 적합한 설치 방법을 선택하세요.
단계별 설치
NPM을 사용하여 Gemini CLI를 설치하는 자세한 단계를 따르세요 (권장 방법).
Install Node.js and NPM
Download and install Node.js from the official website. NPM comes bundled with Node.js.
# Check if Node.js is installed
node --version
npm --version
Install Gemini CLI
Use NPM to install Gemini CLI globally on your system.
npm install -g @google/gemini-cli
Verify Installation
Check that Gemini CLI is installed correctly and accessible from your terminal.
gemini --version
gemini --help
Authenticate with Google
Run Gemini CLI and follow the authentication prompts, or set up your API key.
gemini
export GEMINI_API_KEY="YOUR_API_KEY"
Test Your Installation
Run your first Gemini CLI command to ensure everything is working.
gemini
> Hello, world!
Troubleshooting Common Issues
Having trouble with installation? Here are solutions to the most common problems.
권한 거부 오류
macOS/Linux에서 sudo로 실행하거나 Windows에서 관리자로 실행
sudo npm install -g @google/gemini-cli
설치 후 명령을 찾을 수 없음
NPM 전역 bin 디렉토리를 PATH에 추가
echo $PATH | grep npm
인증 실패
Gemini CLI를 실행하거나 API 키를 설정하여 인증 설정
export GEMINI_API_KEY="YOUR_API_KEY"
설치 중 네트워크 시간 초과
다른 NPM 레지스트리를 사용하거나 방화벽 설정 확인
npm config set registry https://registry.npmjs.org/
설치 완료! 다음은 무엇인가요?
이제 Gemini CLI가 설치되었으니, 설정을 최대한 활용하기 위한 다음 단계를 탐색하세요.
제목
Gemini CLI - Official GitHub Repository
인용 면책 조항