Gemini CLI 설치완전 가이드 2025

몇 분 안에 Google의 공식 오픈소스 AI 에이전트를 시작하세요. Gemini CLI는 강력한 코드베이스 분석, 워크플로 자동화 및 멀티모달 AI 기능을 터미널에 직접 제공합니다.

✅ 무료: 하루 1000회 API 호출 (신용카드 불필요)

시스템 요구사항

Gemini CLI를 설치하기 전에 시스템이 이러한 요구사항을 충족하는지 확인하세요.

Node.js

필수

18.0.0 이상

NPM 설치에 필요한 JavaScript 런타임

NPM

필수

8.0.0 이상

패키지 매니저 (Node.js와 함께 제공)

Git

최신

버전 제어 시스템 (선택사항, 소스 빌드용)

Google 계정

필수

활성

API 인증에 필요

설치 방법

설정에 가장 적합한 설치 방법을 선택하세요.

📦

NPM 설치 (권장)

Node Package Manager를 사용하여 전역 설치

쉬움
npm install -g @google/gemini-cli

지원 플랫폼:

WindowsmacOSLinux
NPM에서 보기
⬇️

직접 다운로드

플랫폼용 미리 빌드된 바이너리 다운로드

쉬움
GitHub 릴리스에서 다운로드

지원 플랫폼:

WindowsmacOSLinux
릴리스 다운로드
🔧

소스에서 빌드

고급 사용자를 위한 소스 코드에서 컴파일

고급
git clone && npm run build

지원 플랫폼:

WindowsmacOSLinux
빌드 가이드 보기

단계별 설치

NPM을 사용하여 Gemini CLI를 설치하는 자세한 단계를 따르세요 (권장 방법).

1

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
2

Install Gemini CLI

Use NPM to install Gemini CLI globally on your system.

npm install -g @google/gemini-cli
3

Verify Installation

Check that Gemini CLI is installed correctly and accessible from your terminal.

gemini --version
gemini --help
4

Authenticate with Google

Run Gemini CLI and follow the authentication prompts, or set up your API key.

gemini
Or set API key:
export GEMINI_API_KEY="YOUR_API_KEY"

Test Your Installation

Run your first Gemini CLI command to ensure everything is working.

gemini
# Then in the interactive session:
> 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가 설치되었으니, 설정을 최대한 활용하기 위한 다음 단계를 탐색하세요.

제목

사실 확인됨
[1]🏛️공식 문서검증됨

Gemini CLI - Official GitHub Repository

저자: Google Gemini Team
조직: Google
게시됨: 2024年1月1日
액세스됨: 2025年8月14日
출처 보기
사실 확인됨
[2]🏛️공식 문서검증됨

Node.js Installation Guide

조직: Node.js Foundation
게시됨: 2024年1月1日
액세스됨: 2025年8月14日
출처 보기
사실 확인됨

인용 면책 조항

상표 고지

Google™, Gemini™ Google과 Gemini는 Google LLC의 상표입니다.

NPM® npm은 npm, Inc.의 상표입니다.

Node.js® Node.js는 OpenJS Foundation의 상표입니다.

GitHub® GitHub는 GitHub, Inc.의 상표입니다.

모든 상표는 각각의 소유자의 재산입니다.