macOS 및 Windows 환경에서 Gemini CLI 설정하는 방법

핵심 요약: 본 문서는 Google의 명령줄 AI 도구인 Gemini CLI의 설치부터 기본 실행까지의 전 과정을 단계별로 설명한다. 이 가이드를 통해 사용자는 터미널 환경에서 Gemini AI 모델을 활용하는 기본적인 사용법을 습득할 수 있다.

Gemini CLI는 터미널 환경에서 Gemini의 강력한 AI 모델을 직접 활용하여 코드베이스 쿼리, 애플리케이션 생성, 워크플로우 자동화 등 다양한 작업을 수행할 수 있도록 지원하는 도구이다. 본 문서는 이러한 초기 진입 장벽을 낮추고, 명확한 절차를 제공하여 사용자가 원활하게 기술을 도입할 수 있도록 돕는 것을 목표로 한다.

0. 시작 전 준비 사항

본 튜토리얼을 진행하기에 앞서, 아래의 개발 환경이 구축되어 있는지 확인해야 한다.

• Node.js: v18.0 이상 (node -v 명령어로 버전 확인)
• Google 계정: 모델 요청 및 인증을 위한 개인 Google 계정
• 터미널: 명령어 실행을 위한 기본 터미널 또는 선호하는 터미널 애플리케이션

모든 요구사항이 충족되었다면, 프로젝트를 진행할 디렉터리를 생성하거나 기존 프로젝트 디렉터리로 이동한다.

1단계: Gemini CLI 실행 및 인증

Gemini CLI는 별도의 복잡한 설치 과정 없이, `npx` 명령어를 통해 직접 실행할 수 있다. 다음 명령어를 터미널에 입력한다.

npx https://github.com/google-gemini/gemini-cli

최초 실행 시, Gemini 사용을 위해 Google 계정 인증 절차가 진행된다. 웹 브라우저가 자동으로 열리며, 안내에 따라 로그인을 완료하면 터미널에서 Gemini CLI를 사용할 수 있는 상태가 된다.

📌 권장 사항 (전역 설치)
Gemini CLI를 자주 사용할 경우, `npm`을 통해 전역으로 설치하면 `gemini`라는 짧은 명령어로 즉시 실행할 수 있다.
npm install -g @google/gemini-cli
설치 후에는 터미널에서 `gemini` 명령어만 입력하면 된다.

2단계: 기본 사용법 및 예시

인증이 완료되면 터미널에 `gemini>` 프롬프트가 나타나며, 이 프롬프트에 직접 자연어 질문이나 명령을 입력하여 AI와 상호작용할 수 있다.

예시 1: 새로운 프로젝트 아이디어 구상

새로운 디렉터리에서 Gemini CLI를 실행하고, 만들고 싶은 애플리케이션에 대한 아이디어를 요청할 수 있다.

cd new-project/
npx https://github.com/google-gemini/gemini-cli

gemini> Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide

예시 2: 기존 코드베이스 분석

기존에 존재하는 Git 저장소를 클론하고, 해당 프로젝트의 구조나 변경사항에 대해 요약을 요청할 수 있다.

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini> Give me a summary of all of the changes that went in yesterday

3단계: 고급 사용 (API 키 설정)

기본 인증 방식은 분당 60회, 일일 1,000회의 요청 제한이 있다. 더 높은 한도가 필요하거나 특정 모델을 사용해야 하는 경우, Google AI Studio에서 API 키를 발급받아 사용할 수 있다.

발급받은 API 키는 아래와 같이 환경 변수로 설정한다. `YOUR_API_KEY` 부분을 자신의 키로 대체해야 한다.

export GEMINI_API_KEY="YOUR_API_KEY"

🧐 오류 해결 (Troubleshooting)
만약 `command not found` 오류가 발생한다면, 전역 설치가 제대로 이루어지지 않았거나 환경 변수의 `PATH` 설정에 문제가 있을 수 있다. 이 경우 `npx`를 이용한 직접 실행 방식을 권장한다. Node.js 버전이 18 미만일 경우에도 오류가 발생할 수 있으니, `node -v` 명령어로 버전을 반드시 확인해야 한다.

결론

이상으로 Gemini CLI의 기본적인 설치 및 실행, 그리고 인증 과정을 검토하였다. 본 튜토리얼에서 다룬 내용을 바탕으로 터미널 환경에서 AI의 능력을 활용하여 개발 생산성을 크게 향상시킬 수 있다.

이미지 생성, 복잡한 Git 이력 분석 등 더 많은 활용 사례와 명령어는 공식 문서를 통해 확인할 수 있다. 추가적인 문의 사항이 있을 경우, 댓글을 통해 질문할 수 있다.