Gemini CLI로 시작하고 구축하는 방법 (Gemini 3 Flash 기반)

Source: Dev.to

By Lesly Zerna / @leslysandra

개발자들은 흐름을 끊지 않으면서 작업 효율을 높여줄 도구를 끊임없이 찾고 있습니다. 2025년 6월, 구글은 Gemini CLI를 오픈소스 커뮤니티에 공개하며 큰 반향을 일으켰고, 2025년 12월에는 최신 모델 Gemini 3 Flash로 도구를 업데이트했습니다.

브라우저와 IDE 사이에 코드를 복사·붙여넣는 것이 지겹거나, 터미널에서 진정한 “AI 에이전트”가 어떻게 동작하는지 직접 보고 싶다면 이 가이드를 확인해 보세요 :)

Note: Many of the concepts and examples in this post were inspired by the Gemini CLI course by DeepLearning.AI, which I highly recommend checking out, as well as the official Gemini CLI documentation and the Google for developers blog post.

Source:

Gemini CLI란?

간단히 말하면, Gemini CLI는 터미널 애플리케이션으로, 명령줄에서 직접 Google의 Gemini AI와 대화할 수 있게 해줍니다.

하지만 이것은 단순한 챗봇이 아니라 Gemini 기반의 오픈‑소스 AI 에이전트입니다.

ChatGPT나 Gemini 웹 인터페이스를 사용할 때는 “샌드박스” 안에 있는 것입니다: AI는 파일을 보거나 명령을 실행할 수 없으며, 파일을 업로드해야만 할 수 있습니다. Gemini CLI는 그 장벽을 허뭅니다. 환경 내부에 존재하기 때문에 프로젝트 구조를 이해하고, 코드를 직접 읽으며, 더 빠르게 작업을 진행하도록 도와줍니다.

“Gemini 3 Flash” 업데이트가 중요한 이유는?

Gemini 3 Flash는 속도와 낮은 지연 시간에 최적화되었습니다. 여러 단계가 필요한 AI 에이전트(예: “이 파일을 읽어”, “분석해”, “테스트를 작성해”)를 사용할 때 속도는 매우 중요합니다. Flash는 CLI를 더욱 빠르고 반응성 있게 만들어 줍니다.

왜 CLI를 사용해야 할까요? (브라우저 vs. 터미널)

브라우저에서 작업하는 것은 일반적인 질문에 좋지만, 소프트웨어를 구축할 때는 명령줄 인터페이스(CLI)가 더 우수합니다. 그 이유는 다음과 같습니다:

• 직접적인 파일 시스템 접근 – 복사‑붙여넣기가 필요 없습니다. “utils.py 파일을 리팩터링해줘”라고 말하면 CLI가 파일을 읽고 직접 변경안을 제시합니다.
• 컨텍스트 인식 – CLI는 현재 작업 디렉터리와 그 안에 있는 파일들을 알고 있습니다.
• 자동화 및 스크립팅 – 다른 명령의 출력을 Gemini에 파이프할 수 있습니다. 예: cat logs.txt | gemini "Find the critical error"
• 내장 도구 – Gemini CLI는 배터리 포함(batteries‑included) 도구들을 제공합니다:
  • 파일 시스템 – 파일을 읽고, 쓰고, 목록을 조회합니다.
  • 웹 – URL을 가져오고 Google 검색을 수행해(실시간 정보에 코드를 기반하게) 합니다.
  • 쉘 – 터미널 명령을 안전하게 실행합니다.
  • 맞춤화 및 확장 – 오픈 소스이기 때문에 확장이 가능합니다. **Model Context Protocol (MCP)**를 지원하여 데이터베이스나 내부 API에 연결하는 맞춤형 도구를 구축할 수 있습니다.

실생활 예시와 아이디어 구축

아래는 Gemini CLI를 오늘 바로 사용해 생산성을 높일 수 있는 몇 가지 방법입니다.

1. “스마트” 코드 리뷰어

코드 스타일 문제를 수동으로 확인하는 대신, 푸시하기 전에 Gemini CLI를 사용해 코드를 검토하세요.

명령

gemini "Review @main.py for potential bugs and clean code practices. Output the suggestions as a list."

왜 작동하는가 – CLI가 파일을 직접 읽고 Gemini의 추론을 활용해 놓친 엣지 케이스를 찾아냅니다.

2. 즉시 데이터 분석가

지저분한 CSV나 로그 파일이 있고 빠른 인사이트가 필요하다고 상상해 보세요.

시나리오 – server_logs.csv라는 파일이 있습니다.

명령

gemini "Read @server_logs.csv and tell me which IP address appears the most frequently. Then, use grep to count exactly how many times it appears."

왜 작동하는가 – 에이전트는 CSV를 분석하는 코드를 작성하는 능력과 grep 같은 시스템 도구를 결합해 데이터를 검증합니다.

3. 빠른 프로토타이핑

새 기능을 스캐폴딩해야 하나요?

명령

gemini "Create a new folder called 'blog-app'. Inside it, create an index.html file with a basic responsive layout and a style.css file with a dark mode theme."

결과 – CLI가 폴더를 만들고 파일을 작성해 주므로 바로 코딩을 시작할 수 있습니다.

Source: …

시작하기: 설치

시도해 볼 준비가 되셨나요? Gemini CLI 설치는 간단합니다. Node.js가 머신에 설치되어 있어야 합니다.

자세한 내용: 공식 문서는 geminicli.com을 참고하세요.

단계 1 – 터미널 열기

단계 2 – 설치 명령 실행

npm install -g @google/gemini-cli@latest

단계 3 – 인증

다음과 같이 입력하여 도구를 시작합니다:

gemini

첫 실행 시, CLI가 인증을 요청합니다. 보통 Google 계정으로 바로 로그인할 수 있으며, 이를 통해 관대한 무료 티어를 이용해 실험을 시작할 수 있습니다.

설치가 완료되면 터미널에서 다음과 같이 실행되는 모습을 확인할 수 있습니다:

단계 4 – 최신 기능 활성화 (핵심 단계!)

강력한 Gemini 3 Flash 모델을 사용하려면 미리 보기 기능을 활성화해야 합니다.

1. CLI에서 /settings를 입력합니다.
2. “Preview Features.” 항목을 찾습니다.
3. 이를 True 로 설정합니다.

이렇게 하면 현재 가장 최신이고, 가장 빠르며, 가장 강력한 모델을 사용할 수 있습니다.

내부 동작: Gemini CLI 작동 방식

터미널의 텍스트 박스가 어떻게 코드를 실행할 수 있는지 궁금하실 겁니다.

Gemini CLI는 ReAct Loop(Reason + Act)이라는 개념을 사용합니다. 명령을 입력했을 때 일어나는 일에 대한 간단한 설명은 다음과 같습니다:

• Thought: 질문을 합니다(예: “왜 내 빌드가 실패하나요?”). AI가 요청을 분석합니다.
• Tool Use: AI는 단순히 추측하는 대신 “파일을 읽거나 셸 명령을 실행하는” 도구가 있다는 것을 인식합니다. 그래서 “오류를 확인하기 위해 빌드 명령을 실행해야겠다”라고 판단합니다.
• Observation: CLI가 명령을 실행하고, 출력(오류 메시지)을 캡처하여 AI에 다시 전달합니다.
• Answer: AI가 오류를 읽고 구체적인 해결책을 제공합니다.

이 루프 덕분에 CLI는 단순 텍스트 생성기가 아니라 실제 페어 프로그래머처럼 동작할 수 있습니다.

터미널 탐색: 필수 명령어

Gemini CLI를 설치하면 단순히 공백에 입력하는 것이 아닙니다. 다음 명령어들은 에이전트를 제어하는 데 도움이 됩니다:

• /help – 에이전트가 할 수 있는 일과 상호작용 방법을 보여줍니다.
• /settings – 설정(Assistant 설정, Mode 등)을 탐색하고 수정할 수 있습니다.
• /docs – 고급 기능에 대한 문서를 엽니다.

파일을 참조하는 방법

CLI의 초강력 기능입니다. 코드를 복사‑붙여넣을 필요가 없습니다. 특정 파일에 대해 Gemini에 질문하려면 @ 기호를 사용하면 됩니다.

예시

“@main.py 안의 로직을 설명하고 개선 방안을 제시해 줄 수 있나요?”

에이전트는 해당 파일을 읽고 그 안의 코드를 기반으로 답변을 제공합니다.

Context와 GEMINI.md 이해하기

Context란?

Context는 AI 에이전트가 여러분의 특정 요청을 이해하는 데 사용하는 정보 모음입니다. 반복해서 설명할 필요가 없도록 AI가 필요로 하는 “배경 지식”입니다.

GEMINI.md의 마법

프로젝트에 대해 CLI에게 가르쳐 주는 특별한 파일 GEMINI.md를 만들세요—AI를 위한 “ReadMe”입니다.
폴더에 GEMINI.md 파일이 있으면 CLI가 자동으로 이를 읽어 프로젝트 규칙, 코딩 스타일, 아키텍처 등을 이해합니다.

GEMINI.md를 배치할 수 있는 위치:

• 전역 디렉터리 – 모든 프로젝트에 적용되는 규칙.
• 현재 작업 폴더 – 프로젝트별 규칙.
• 하위 디렉터리 – 해당 모듈에만 적용되는 규칙.

메모리 관리

AI가 현재 “알고 있는” 내용을 확인하거나 메모리에 새로운 정보를 수동으로 추가할 수 있습니다.

컨텍스트 확인

/memory show

현재 에이전트의 컨텍스트에 있는 모든 항목을 나열합니다.

컨텍스트 수동 추가

/memory add "Remember that we are using Python 3.11 for this project"

또는 특정 컨텍스트 파일을 지정할 수도 있습니다:

/memory add path/to/another/gemini.md

결론 (Part 1)

채팅‑인‑브라우저에서 에이전트‑인‑터미널로의 전환은 개발자 생산성에 큰 도약을 가져옵니다. 이제 Gemini 3 Flash가 Gemini CLI를 구동하고, GEMINI.md를 사용해 Context를 맞춤 설정할 수 있게 되면서, 우리의 생각을 따라잡을 만큼 빠르고 복잡한 작업을 처리할 만큼 똑똑한 도구가 생겼습니다.

한 번 사용해 보고, 오픈‑소스 코드를 탐색해 보세요, 그리고 여러분이 만든 것을 알려 주세요!

추가 블로그가 곧 올라옵니다—구독하고 기대해 주세요!

— Lesly