🚀 Gemini CLI: 구글이 만든 오픈소스 AI 에이전트를 터미널에서 써봤습니다

며칠 전에 구글이 새로운 개발자 도구를 하나 공개했더라고요.
Gemini CLI라고 하는데, 말 그대로 터미널에서 직접 AI랑
대화하면서 개발 작업을 할 수 있는 툴입니다.

Copilot도 터미널용이 나왔지만,
이건 좀 더 “AI 에이전트스럽다”는 느낌이에요.

그래서 저도 설치해보고 뭐가 가능한지 간단히 정리해봤어요.
CLI 툴 좋아하시는 분들이나, AI 도구 관심 있는 분들한테는 꽤 재밌는 도구일 것 같아요.

---

1️⃣ Gemini CLI가 뭐냐면요

• 🧠 오픈소스 AI 에이전트입니다. Apache 2.0 라이선스로 GitHub에 공개돼 있어요.
• 💡 Gemini 2.5 Pro 모델을 기반으로 돌아갑니다. 100만 토큰까지 문맥 기억된다는 게 포인트.
• 🖥 터미널에서 바로 실행해요. 코드 생성, 디버깅, 파일 입출력, 구글 검색,이미지·영상 생성까지 이 안에서 가능.

🔗 GitHub: https://github.com/google-gemini/gemini-cli
🔗 공식 블로그: https://blog.google/technology/developers/introducing-gemini-cli-open-source-ai-agent/

---

2️⃣ 핵심 기능 요약 (2025.06.25 기준)

기능	설명
💬 자연어 프롬프트	코드 생성, 요약, 질문 등 자유롭게 가능
🐞 디버깅 지원	오류 지적 + 수정 방향 제안
📁 파일 입출력	--input, --output 옵션으로 파일 다루기
🌍 구글 검색 연동	실시간 검색 결과 받아오기
🛠 시스템 명령 실행	Shell 명령 실행까지 터미널에서 직접
🧩 MCP 연동	외부 도구/클라우드 연동 가능
🖼 미디어 생성	Imagen, Veo로 이미지/영상도 만들 수 있음

---

3️⃣ 설치는 이렇게 했습니다

✅ Node.js 먼저 설치

Gemini CLI는 Node.js 기반이라 먼저 Node.js가 필요해요.

• Node.js 공식 다운로드 링크
• LTS 최신 버전(v22.17.0 기준)으로 설치 추천드려요.
  

설치가 완료되면 터미널에서 이렇게 확인하면 됩니다:

node -v
# → v22.17.0 이런 식으로 나오면 OK

• 저는 기존 설치된 LTS(v22.14.0) 버전으로 진행했어요.
  

---

✅ Gemini CLI 설치 방법 2가지

▶️ 1. 일회성 실행 (npx)

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

▶️ 2. 전역 설치 (추천)

npm install -g @google/gemini-cli
gemini # 설치 후엔 그냥 이 명령어로 실행 가능

---

🔐 로그인 관련

• 처음 실행하면 Google 계정으로 로그인하라고 나와요.
• 로그인하면 무료 코드 어시스트 라이선스가 자동 발급됩니다.
• 더 고급 기능을 쓰거나 호출량을 늘리고 싶으면 나중에 API Key 등록도 가능해요.
  (이건 추후 따로 정리해볼게요!)

---

4️⃣ 실전으로 써보기

실제로 써보면 진짜 신기해요.
몇 줄 말하면 알아서 코드 짜주고, 설명도 곁들여줍니다.

▶️ 새 디렉토리에서 시작할 때

cd new-project/
gemini
> 내가 제공할 FAQ.md 파일을 활용해서 질문에 답하는 Discord 봇을 만들어줘

▶️ 기존 레포에 붙여서 쓸 때

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> 어제 반영된 모든 변경 사항을 요약해줘

---

5️⃣ 더 다양하게 써보자! (활용 예시)

🔍 코드 분석

> 이 프로젝트의 전체 구조랑 핵심 컴포넌트 설명해줘

> 보안 쪽에서 어떤 방식이 적용되어 있는지 알려줘

---

🧑‍💻 협업 자동화

> GitHub 이슈 #123에 맞춰 첫 번째 구현 초안을 작성해줘

> 이 코드베이스를 최신 Java 버전으로 마이그레이션하는 계획을 세워줘

---

⚙️ 워크플로우 자동화

> 지난 7일간의 Git 커밋을 팀원별로 정리해서 슬라이드 만들어줘

> 인기 있는 GitHub 이슈들을 시각화한 웹앱을 만들어줘

---

🖥️ 로컬 파일 작업

> 이 폴더에 있는 모든 JPG 이미지를 PNG로 변환하고, EXIF 날짜 기준으로 이름 정리해줘

> 내 PDF 청구서들을 월별로 분류해서 정리해줘

---

▶️ 간단한 바이브코딩 예시 (Context.md)

• 제가 직접 해 본 간단한 바이브코딩 예시 컨텍스트입니다.

> # 🎮 Q-Words: 6글자 단어 추측 게임 컨텍스트

당신은 MVC 아키텍처 기반의 Wordle 스타일 게임을 개발 중입니다.

---

## 📌 게임 규칙

- 플레이어는 **6글자 단어**를 추측해야 합니다.
- 총 **5번의 시도 기회**가 주어집니다.
- 각 시도마다 다음과 같은 **피드백**이 제공됩니다:
  - `'+'` : 글자와 위치가 모두 정확할 때
  - `'?'` : 글자는 포함되어 있지만 위치는 다를 때
  - `'x'` : 해당 글자가 단어에 없을 때
- 모든 추측 단어는 **사전에 등록된 유효한 6글자 단어**여야 합니다.

---

## 🧱 아키텍처: MVC 패턴

### 🔹 Model (모델)
- 유효한 단어 목록(사전)을 관리합니다.
- 정답 단어와 현재 시도 수를 추적합니다.
- 피드백 생성 로직(+, ?, x)을 담당합니다.

### 🔹 View (뷰)
- 사용자가 입력한 단어를 시각적으로 보여줍니다.
- 피드백 결과를 시각적으로 표현합니다.
- 게임 종료(정답/실패)를 표시합니다.

### 🔹 Controller (컨트롤러)
- 사용자 입력을 받아 모델로 전달합니다.
- 모델의 판단 결과를 받아 뷰로 전달합니다.
- 게임의 전체 흐름(진행, 종료, 재시작 등)을 제어합니다.

---

## 🧠 설명 가이드라인

- **게임 메커니즘**(추측 → 피드백 → 다음 시도)과 코드 흐름을 연결지어 설명하세요.
- 각 구성요소가 **서로 어떻게 연결되는지** 강조하세요.
- **주니어 개발자도 이해할 수 있는 쉬운 언어**로 설명하세요.
- 예시 코드, 흐름도, 비유 등을 활용하면 더 좋습니다.

---

> 💡 이 프롬프트는 코드 리뷰, 문서 작성, 구조 설계 설명 등에 활용할 수 있으며,
> 필요한 경우 특정 컴포넌트(Model만, View만 등)에 초점을 맞춰 요청해도 됩니다.

• 갑자기 지멋대로 파이썬으로 서버 구동시켜서, 노드로 변경해주었습니다.

• 사실 코딩은 여기서 부터 시작입니다. 디버깅을 해야 하거든요. 😊
  자연어로 점점 디버깅 단계를 밟으면서 완성시키면 됩니다.

• 컨텍스트가 명확하고 자세할수록 원하는 결과물에 가까워 지는 것 같습니다.
  이래서 다들 대AI 시대에는 기획, 설계 능력이 중요하다고 하는 것 이겠죠?

---

이번 주말에는 바빠서 기획만 하던

풀스택 토이 프로젝트를 GeminiCLI로 구현해봐야겠어요. 😀

---

✅ 마무리: 써보니까 이런 느낌

일단 설치나 실행은 생각보다 금방 됐어요.
Google 계정으로 로그인만 하면 바로 써볼 수 있었고, 터미널 기반이라 복잡한 설정도 거의 없었습니다.

저는 개인적으로 “Shell 명령도 실행하고, 코드도 짜주고, 검색도 해주는”
그 올인원 느낌이 꽤 마음에 들었어요.

아이디어가 떠오를 때? 대신 실험을 해 줄 조수 하나 둔 느낌?

다만 한번에 혼자서 완벽한 코드를 뽑아주는 게 아니라서,
같이 개발 해 줄 어시스턴트로 써보는 게 맞는 듯 합니다.

가까운 미래엔 자연어로 모든 걸 개발 해 줄 어시스턴트가 되겠죠?

---

개인적으로 VScode나 Cursor 내에서 터미널로

이렇게 GeminiCLI를 띄워 각자 특화된 여러 AI툴들을

사용하는 환경을 만들 수 있어서 마음에 듭니다. 😎

---

다음 포스팅에서는 최근 같이 뜨고 있는
ClaudeCode (for VSCode) 도구도 함께 써보고 비교해볼 예정이에요.
이런 AI 기반 CLI나 IDE 도구들 관심 있다면, 다음 글도 기대해주세요!

---

🔗 참고링크 모음

• 📦 GitHub: https://github.com/google-gemini/gemini-cli
• 📄 공식 소개 블로그: https://blog.google/technology/developers/introducing-gemini-cli-open-source-ai-agent/
• 💬 명령어 모음: https://github.com/google-gemini/gemini-cli#commands
• 🛠 Troubleshooting: https://github.com/google-gemini/gemini-cli/issues