Gemini CLI (재미나이 CLI)

Table of Contents

Gemini CLI는 터미널 환경에서 직접 Gemini 모델과 상호작용할 수 있도록 만들어진 오픈소스 AI 에이전트입니다. 단순한 질문과 답변을 넘어, 다음과 같은 복잡한 작업 수행이 가능합니다.

Gemini CLI는 Gemini 2.5 Pro 모델을 기반으로 작동하며, 무려 100만 토큰에 달하는 방대한 컨텍스트 창을 지원하여 긴 문서나 복잡한 코드 구조도 깊이 있게 이해하고 처리할 수 있습니다.

Gemini CLI를 사용하기 위해 필요한 것은 매우 간단합니다.

개인 Google 계정으로 로그인할 경우, 분당 60회, 하루 1,000회의 모델 요청이라는 넉넉한 무료 사용량을 제공받아 대부분의 사용자는 부담 없이 강력한 AI 기능을 활용할 수 있습니다.

Gemini CLI 설치는 터미널에서 단 한 줄의 명령어로 완료됩니다.

터미널을 열고 다음 명령어 중 하나를 실행하세요.

옵션 1: npx를 이용한 임시 실행 및 설치 (가장 간편한 방법)

Bash

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

옵션 2: npm을 이용한 글로벌 설치 (시스템에 영구적으로 설치)

Bash

npm install -g @google/gemini-cli

글로벌 설치 후에는 터미널 어디에서든 gemini 명령어로 실행할 수 있습니다.

설치 후 gemini를 처음 실행하면, 인증 절차를 안내합니다.

이제 터미널에서 Gemini를 사용할 준비가 모두 끝났습니다.

인증이 완료되면 터미널에 프롬프트가 나타나며, 바로 Gemini와 대화를 시작할 수 있습니다.

기본적인 대화:

> 파이썬으로 현재 폴더의 파일 목록을 보여주는 스크립트 만들어줘

파일 참조하기: 프롬프트에 @ 문자를 입력하면 파일 선택기가 나타납니다. 이를 통해 특정 파일을 현재 대화의 컨텍스트에 포함시킬 수 있습니다.

> @(my_code.py) 이 코드의 잠재적인 버그를 찾아주고 개선 방안을 제안해줘.

특별 명령어 사용하기: Gemini CLI에는 슬래시(/)로 시작하는 유용한 내장 명령어들이 있습니다. 프롬프트에서 /를 입력하면 사용 가능한 명령어 목록을 볼 수 있습니다.

더 높은 사용량 한도가 필요하거나 특정 Google Cloud 프로젝트와 연동해야 하는 전문 개발자의 경우, Google AI Studio에서 발급받은 API 키를 사용할 수 있습니다.

API 키 발급: Google AI Studio에 방문하여 API 키를 생성합니다.
환경 변수 설정: 발급받은 키를 터미널 환경 변수로 설정합니다.
- macOS/Linux:Bashexport GEMINI_API_KEY="YOUR_API_KEY"
- Windows (Command Prompt):Bashset GEMINI_API_KEY="YOUR_API_KEY" (터미널 세션이 종료되면 초기화되므로, 영구적으로 설정하려면 시스템 환경 변수에 등록해야 합니다.)
CLI에서 인증 전환: gemini CLI 내에서 /auth 명령어를 실행하고 API 키를 사용하는 옵션으로 전환할 수 있습니다.