4장 Gemini (문서)

---
moduleId: m3
toolKey: gemini-cli
title: 3장. GEMINI CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m3
---

# 3장. GEMINI CLI

Gemini CLI의 설치 방법, 업데이트 확인 지점, 코딩 워크플로우에서 중요한 핵심 기능 5가지를 다룹니다.

> 인터랙티브 커리큘럼(TSX): [/projects/ai-coding-tools/hub/curriculum/m3](/projects/ai-coding-tools/hub/curriculum/m3)  
> 벤더 요약: [/ai-coding-tools-files/docs/vendor/gemini-cli/summary.md](/ai-coding-tools-files/docs/vendor/gemini-cli/summary.md)

## 개요

- **부제**: CLI · Google AI
- **섹션**: Gemini CLI Reference View

## 설치 (macOS 요약)

- 1. **Gemini API/CLI 접근 권한 및 계정 준비** — Google AI Studio에서 API 사용 가능 계정과 프로젝트를 먼저 준비합니다.
- 2. **CLI 설치 및 인증 토큰 설정** — CLI 설치 후 GEMINI_API_KEY를 환경 변수로 설정하고 인증 상태를 확인합니다.
- 3. **프로젝트 경로에서 실행 테스트** — 프로젝트 루트에서 gemini --version, gemini --help로 실행 환경을 점검합니다.
- 4. **코드 분석/요약/질의 기본 프롬프트 점검** — Cmd+K 기준으로 분석·요약·질의 프롬프트를 각각 1회씩 실행해 품질을 확인합니다.

## 최근 업데이트

- 2026-04-02 — **Gemma 4 모델 공개**: gemma-4-26b-a4b-it, gemma-4-31b-it 모델이 AI Studio와 Gemini API에서 사용 가능해졌습니다.
- 2026-04-01 — **Flex / Priority Tier**: 비용 최적화(Flex)와 지연시간 최적화(Priority)를 선택할 수 있는 추론 티어가 도입되었습니다.
- 2026-03-31 — **Veo 3.1 Lite Preview**: 비용 효율 비디오 생성 모델이 추가되고 일부 구형 preview 모델이 종료되었습니다.

## 핵심 기능

### CLI Setup + 인증 경로 고정

Gemini CLI 설치 후 인증·실행 경로 빠르게 안정화

- 시나리오: 처음 Gemini CLI를 연결할 때

### 대용량 컨텍스트 요약 탐색

큰 코드베이스도 질문 단위를 잘게 나눠 구조 파악

- 시나리오: 레거시 프로젝트를 처음 인수받았을 때

### 문서·코드 결합 리뷰 루프

요구 문서와 코드를 함께 비교해 누락·불일치 탐지

- 시나리오: 기획과 구현이 어긋났는지 확인해야 할 때

### CLI 질의 + 검증 명령 연계

질의 결과를 검증 명령에 바로 연결해 신뢰도 향상

- 시나리오: 수정 전 영향도와 수정 후 결과를 빠르게 확인할 때

### 실제 사례) 3도구 병렬 역할 분담

Gemini 분석 + Cursor 구현 + Claude 검증 병렬 루프(단순화)

- 시나리오: 짧은 시간에 분석·구현·검증을 나눠 처리해야 할 때

## 공식 링크

- [Gemini API Docs](https://ai.google.dev/gemini-api/docs)
- [Gemini Release Notes](https://ai.google.dev/gemini-api/docs/release-notes)

## 링크 정책

허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.

<hr>
<h2>moduleId: m3
toolKey: gemini-cli
title: 3장. GEMINI CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m3</h2>
<h1>3장. GEMINI CLI</h1>
<p>Gemini CLI의 설치 방법, 업데이트 확인 지점, 코딩 워크플로우에서 중요한 핵심 기능 5가지를 다룹니다.</p>
<blockquote>
<p>인터랙티브 커리큘럼(TSX): <a href="/projects/ai-coding-tools/hub/curriculum/m3">/projects/ai-coding-tools/hub/curriculum/m3</a><br>벤더 요약: <a href="/ai-coding-tools-files/docs/vendor/gemini-cli/summary.md">/ai-coding-tools-files/docs/vendor/gemini-cli/summary.md</a></p>
</blockquote>
<h2>개요</h2>
<ul>
<li><strong>부제</strong>: CLI · Google AI</li>
<li><strong>섹션</strong>: Gemini CLI Reference View</li>
</ul>
<h2>설치 (macOS 요약)</h2>
<ul>
<li><ol>
<li><strong>Gemini API/CLI 접근 권한 및 계정 준비</strong> — Google AI Studio에서 API 사용 가능 계정과 프로젝트를 먼저 준비합니다.</li>
</ol>
</li>
<li><ol start="2">
<li><strong>CLI 설치 및 인증 토큰 설정</strong> — CLI 설치 후 GEMINI_API_KEY를 환경 변수로 설정하고 인증 상태를 확인합니다.</li>
</ol>
</li>
<li><ol start="3">
<li><strong>프로젝트 경로에서 실행 테스트</strong> — 프로젝트 루트에서 gemini --version, gemini --help로 실행 환경을 점검합니다.</li>
</ol>
</li>
<li><ol start="4">
<li><strong>코드 분석/요약/질의 기본 프롬프트 점검</strong> — Cmd+K 기준으로 분석·요약·질의 프롬프트를 각각 1회씩 실행해 품질을 확인합니다.</li>
</ol>
</li>
</ul>
<h2>최근 업데이트</h2>
<ul>
<li>2026-04-02 — <strong>Gemma 4 모델 공개</strong>: gemma-4-26b-a4b-it, gemma-4-31b-it 모델이 AI Studio와 Gemini API에서 사용 가능해졌습니다.</li>
<li>2026-04-01 — <strong>Flex / Priority Tier</strong>: 비용 최적화(Flex)와 지연시간 최적화(Priority)를 선택할 수 있는 추론 티어가 도입되었습니다.</li>
<li>2026-03-31 — <strong>Veo 3.1 Lite Preview</strong>: 비용 효율 비디오 생성 모델이 추가되고 일부 구형 preview 모델이 종료되었습니다.</li>
</ul>
<h2>핵심 기능</h2>
<h3>CLI Setup + 인증 경로 고정</h3>
<p>Gemini CLI 설치 후 인증·실행 경로 빠르게 안정화</p>
<ul>
<li>시나리오: 처음 Gemini CLI를 연결할 때</li>
</ul>
<h3>대용량 컨텍스트 요약 탐색</h3>
<p>큰 코드베이스도 질문 단위를 잘게 나눠 구조 파악</p>
<ul>
<li>시나리오: 레거시 프로젝트를 처음 인수받았을 때</li>
</ul>
<h3>문서·코드 결합 리뷰 루프</h3>
<p>요구 문서와 코드를 함께 비교해 누락·불일치 탐지</p>
<ul>
<li>시나리오: 기획과 구현이 어긋났는지 확인해야 할 때</li>
</ul>
<h3>CLI 질의 + 검증 명령 연계</h3>
<p>질의 결과를 검증 명령에 바로 연결해 신뢰도 향상</p>
<ul>
<li>시나리오: 수정 전 영향도와 수정 후 결과를 빠르게 확인할 때</li>
</ul>
<h3>실제 사례) 3도구 병렬 역할 분담</h3>
<p>Gemini 분석 + Cursor 구현 + Claude 검증 병렬 루프(단순화)</p>
<ul>
<li>시나리오: 짧은 시간에 분석·구현·검증을 나눠 처리해야 할 때</li>
</ul>
<h2>공식 링크</h2>
<ul>
<li><a href="https://ai.google.dev/gemini-api/docs">Gemini API Docs</a></li>
<li><a href="https://ai.google.dev/gemini-api/docs/release-notes">Gemini Release Notes</a></li>
</ul>
<h2>링크 정책</h2>
<p>허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 이 화면의 공식 링크는 참고 자료로 별도 제공합니다.</p>