Gemini CLI 시작하기 — 무료로 시작하는 AI 터미널 코딩

"AI 코딩 에이전트를 써보고 싶은데, 매달 20달러씩 내는 구독료가 부담스럽다." 그렇다면 정답은 정해져 있다. Google 계정만 있으면 무료로 1M 토큰의 컨텍스트를 사용할 수 있는 Gemini CLI다.

왜 첫 도구로 Gemini CLI를 추천하는가?

1편에서 살펴보았듯, CLI 코딩 에이전트는 터미널에서 스스로 코드를 읽고, 고치고, 실행하는 강력한 도구다. 시장에는 여러 도구가 있지만, 입문자나 개인 개발자에게 Gemini CLI를 가장 먼저 추천하는 이유는 압도적인 '가성비'와 '컨텍스트 윈도우' 때문이다.

완전 무료: 별도의 API 결제나 구독 없이, 개인 Google 계정만 있으면 넉넉한 무료 할당량(예: 하루 수백 회 요청)으로 사용할 수 있다.
100만(1M) 토큰 컨텍스트: 소형 프로젝트뿐 아니라, 파일 수십~수백 개짜리 거대한 프로젝트 전체를 한 번에 읽어들이고 맥락을 파악한다.
Google Search Grounding: 코딩하다 막히는 최신 라이브러리 문서를 실시간으로 검색해서 답을 찾는다.

이제 본격적으로 내 터미널에 Gemini를 설치해 보자.

1. 1분 만에 끝나는 설치와 인증

Gemini CLI는 Node.js 환경에서 돌아간다. npm이 설치되어 있다면 한 줄이면 끝난다. (macOS 사용자는 Homebrew도 지원한다.)

설치하기

# npm을 통한 글로벌 설치 (권장)
npm install -g @google/gemini-cli

# macOS 사용자의 경우 Homebrew 사용 가능
brew install gemini-cli

Google 계정 인증

설치가 끝났다면, 터미널에 gemini라고 입력해 보자.

gemini

첫 실행 시 브라우저 창이 열리며 Google 계정 로그인을 요구한다. 평소 사용하는 계정으로 로그인하고 권한을 승인하면 끝이다. 이제 터미널은 당신만의 AI 비서와 연결되었다.

[!TIP] 엔터프라이즈 환경이라면? 브라우저 인증이 불가능한 CI/CD 환경이나 GCP(Google Cloud Platform) 환경에서는 환경 변수 GOOGLE_API_KEY를 설정하거나, 서비스 계정(GOOGLE_APPLICATION_CREDENTIALS)을 통해 인증할 수 있다.

2. 첫 대화와 기본 명령어

인증 후 gemini 명령어를 입력하면, 대화형(Interactive) 프롬프트가 시작된다.

╭───────────────────────────────────────────────╮
│  Gemini CLI에 오신 것을 환영합니다!           │
╰───────────────────────────────────────────────╯
> _

여기서 자연어로 명령을 내리면 된다.

"현재 디렉토리의 파일 구조를 설명해 줘."
"src/utils.js 파일에서 중복된 함수를 찾아서 리팩토링해 줘."

반드시 알아야 할 단축 명령어 (Slash Commands)

대화 중에 사용할 수 있는 유용한 명령어들이다.

/help : 사용 가능한 전체 명령어 확인
/clear : 현재 대화 컨텍스트 초기화 (토큰이 꽉 찼거나 새 주제로 넘어갈 때 필수)
/exit : Gemini CLI 종료 (또는 Ctrl + C)
/plan [목표] : 코드를 바로 수정하지 않고, 어떻게 수정할지 계획(Plan Mode)만 먼저 세우도록 지시

3. 에이전트 길들이기: GEMINI.md의 마법

Gemini CLI를 진짜 "내 프로젝트 전담 직원"으로 만들려면 GEMINI.md 파일이 필요하다. 이 파일은 프로젝트의 아키텍처, 코딩 컨벤션, 주의사항 등을 담아두는 지시서(System Prompt) 역할을 한다.

왜 GEMINI.md가 필요한가?

매번 대화할 때마다 "우리는 TypeScript를 쓰고, 들여쓰기는 2칸이고, 스타일링은 TailwindCSS를 써..."라고 말할 수는 없다. 프로젝트 루트에 GEMINI.md를 만들어두면, Gemini CLI가 실행될 때마다 이 파일을 자동으로 읽고 규칙을 숙지한 상태에서 작업을 시작한다.

/init 으로 자동 생성하기

프로젝트 폴더에서 CLI를 켜고 /init을 입력해보자.

> /init

Gemini가 현재 폴더의 소스 코드를 싹 훑어보고, 사용 중인 언어와 프레임워크를 분석하여 초안 GEMINI.md를 알아서 만들어 준다.

실전 GEMINI.md 작성 예시

자동 생성된 파일을 내 입맛에 맞게 다듬어보자.

# 프로젝트 규칙 (GEMINI.md)

## 기술 스택
- 프론트엔드: React 18, Next.js 14 (App Router)
- 스타일링: TailwindCSS
- 언어: TypeScript (Strict 모드 켜져 있음)

## 코딩 컨벤션
- 컴포넌트는 함수형으로 작성하고, 화살표 함수를 사용한다.
- `any` 타입은 절대 사용하지 않는다. 명확한 인터페이스를 정의할 것.
- 모든 API 호출은 `src/lib/api.ts`에 정의된 래퍼 함수를 통과해야 한다.

## ⚠️ 주의사항
- `public/` 폴더 내의 정적 에셋은 임의로 삭제하지 말 것.
- 데이터베이스 스키마(Prisma)를 변경하는 코드는 작성 전 반드시 나에게 먼저 물어볼 것.

이렇게 세팅해두면, 이후 코드 수정을 요청할 때 Gemini가 TypeScript 룰을 어기거나 any를 남발하는 헛발질을 원천 차단할 수 있다.

📝 정리

[x] 초보자 최적화: 구독료 걱정 없이 구글 계정만으로 1M 토큰의 강력한 에이전트를 쓸 수 있다.
[x] 초간단 설치: npm install -g @google/gemini-cli 후 gemini 명령어로 로그인.
[x] 맞춤형 에이전트: 프로젝트 루트에 GEMINI.md를 작성하여 팀의 코딩 컨벤션을 강제할 수 있다.

Gemini CLI가 내 터미널에 성공적으로 정착했다. 다음 3편에서는 이 1M 토큰의 넓은 시야를 활용하여, 남이 짠 거대한 레거시 코드를 단숨에 분석하고, 봇을 자동화하는 실전 테크닉을 알아본다.