GeminiCLI.net

Windows 및 Linux에 Gemini CLI를 설치하는 최종 가이드

blog.postMeta

새롭고 강력한 명령줄 도구를 시작하는 것은 특히 환경 설정과 관련하여 때때로 부담스러울 수 있습니다. 이 가이드는 Windows 또는 Linux 컴퓨터에서 공식 Gemini CLI를 원활하게 실행하기 위한 명확하고 따라하기 쉬운 지침을 제공합니다.

전제 조건: Node.js 및 npm

Gemini CLI는 Node.js 패키지로 배포되므로 먼저 시스템에 Node.js와 해당 패키지 관리자인 npm이 설치되어 있어야 합니다.

  • 설치 여부 확인: 터미널(명령 프롬프트, PowerShell 또는 Linux 터미널)을 열고 node -v 및 npm -v를 실행합니다. 버전 번호가 표시되면 준비가 된 것입니다!
  • 설치 방법: 설치되어 있지 않은 경우 공식 Node.js 웹사이트를 방문하여 운영 체제에 맞는 LTS(장기 지원) 버전을 다운로드하는 것이 좋습니다. 설치 프로그램이 모든 것을 처리해 줍니다.

1단계: Gemini CLI 패키지 설치

Node.js와 npm이 준비되면 Gemini CLI 설치는 단일 명령으로 가능합니다. -g 플래그는 패키지를 시스템에 "전역적으로" 설치하여 모든 디렉터리에서 gemini 명령에 액세스할 수 있도록 하므로 중요합니다.

터미널을 열고 다음 명령을 실행합니다:

npm install -g @google/generative-ai

이 명령은 npm 레지스트리에서 패키지를 다운로드하여 시스템에 설정합니다.

대안: 설치 없이 빠른 시작(npx)

패키지를 전역적으로 설치하고 싶지 않거나 빠르게 사용해보고 싶다면 npx를 사용할 수 있습니다. npm과 함께 제공되는 이 명령은 시스템에 영구적으로 설치하지 않고 패키지를 일시적으로 다운로드하여 실행합니다.

gemini 명령 앞에 npx @google/generative-ai를 붙이면 됩니다:

npx @google/generative-ai "지금까지 발견된 가장 먼 은하는 무엇이며, 얼마나 멀리 있습니까?"

이것은 즉시 시작할 수 있는 환상적인 방법입니다. 이 가이드의 나머지 부분에서는 전역 설치를 수행했다고 가정합니다.

2단계: Google AI API 키 받기

CLI를 사용하려면 Google AI API 키로 인증해야 합니다. 이 키는 누가 요청하는지 Google에 알려줍니다. 아직 키가 없는 경우, 전체 과정을 안내하는 "3가지 간단한 단계로 Google Gemini API 키 받는 방법(2025년 가이드)" 튜토리얼이 있습니다.

키를 받으면 클립보드에 복사하고 다음 단계로 진행합니다.

3단계: API 키 구성

gemini 명령이 API 키에 액세스할 수 있도록 해야 합니다. 이를 위한 가장 안전하고 권장되는 방법은 환경 변수를 설정하는 것입니다.

Linux 및 macOS용

  1. 셸의 구성 파일을 엽니다. 이것은 보통 ~/.bashrc, ~/.zshrc(macOS를 포함한 대부분의 최신 시스템) 또는 ~/.profile입니다.

  2. 파일 끝에 다음 줄을 추가합니다. YOUR_API_KEY를 복사한 실제 키로 바꾸십시오.

    export GOOGLE_API_KEY="YOUR_API_KEY"

  3. 파일을 저장하고 터미널을 다시 시작하거나 source ~/.zshrc(또는 해당 파일)를 실행하여 변경 사항을 즉시 적용합니다.

Windows용

  1. 시작 메뉴에서 "환경 변수"를 검색하고 "시스템 환경 변수 편집"을 선택합니다.
  2. 시스템 속성 창에서 "환경 변수..." 버튼을 클릭합니다.
  3. 상단의 "사용자 변수" 섹션에서 "새로 만들기..."를 클릭합니다.
  4. "변수 이름"에 GOOGLE_API_KEY를 입력합니다.
  5. "변수 값"에 이전에 복사한 API 키를 붙여넣습니다.
  6. 모든 창에서 확인을 클릭하여 저장합니다.

비디오 안내

시각적 가이드를 위해 이 짧은 비디오들이 과정의 주요 단계를 다룹니다.

1. 전역 NPM 패키지 설치 방법:

Video Tutorial: npm 패키지를 전역적으로 설치하기

2. Windows에서 환경 변수 설정 방법:

Video Tutorial: Windows 11에서 환경 변수 설정하는 방법

4단계: 설치 확인

모두 설정되었습니다! 모든 것이 올바르게 작동하는지 확인하려면 터미널에서 간단한 테스트 명령을 실행합니다:

gemini "지금까지 발견된 가장 먼 은하는 무엇이며, 얼마나 멀리 있습니까?"

설치가 성공적이었다면 Gemini 모델로부터 상세한 답변을 받아야 합니다. 축하합니다, Gemini CLI를 성공적으로 설치하고 구성했습니다!

문제 해결 팁

  • command not found: gemini: 이것은 보통 전역 npm 설치 디렉터리가 시스템의 PATH에 없다는 것을 의미합니다. Node.js 설치 프로그램이 이를 처리해야 하지만, 그렇지 않은 경우 수동으로 추가해야 할 수 있습니다.
  • 인증 오류: 인증에 대한 오류가 발생하면 GOOGLE_API_KEY 환경 변수가 올바르게 설정되었는지, 오타가 없는지 다시 확인하십시오. 설정 후 터미널을 다시 시작했는지 확인하십시오.

이제 명령줄에서 AI의 모든 힘을 탐색할 준비가 되었습니다. 다른 튜토리얼과 사용 사례를 확인하여 무엇을 만들 수 있는지 확인하세요!

SocialShare.shareArticle