VSCode와 함께 써야 꿀조합 GEMINI CLI 그리고 Gemini Code Assist [오늘코드todaycode]

VSCode와 함께 써야 꿀조합 GEMINI CLI 그리고 Gemini Code Assist [오늘코드todaycode]

📘 VSCode와 GEMINI CLI + Gemini Code Assist 활용 가이드

목차

1. 개요
2. 사전 준비
3. Gemini CLI 설치
4. 인증 및 실행
5. VSCode와의 연동
6. Gemini Code Assist 설치 및 활용
7. 주요 기능 정리
8. 고급 설정 (환경변수, 메모리, 설정 파일)
9. 자동화와 보안 기능 (로우 모드, 샌드박스)
10. MCP 서버 연동
11. 실행 절차 요약
12. 참고문헌 및 주석

---

1. 개요

• Gemini CLI는 구글의 AI 모델(Gemini 2.5 Pro 등)을 터미널에서 직접 사용할 수 있는 도구임.
• VSCode와 Gemini Code Assist를 함께 사용하면 GitHub Copilot과 유사한 AI 코딩 지원 기능을 무료 또는 저렴하게 활용 가능.
• 특히 100만 토큰 컨텍스트와 **멀티모달 입력(텍스트, 이미지, PDF)**을 지원하여 대규모 코드 베이스와 문서 작업에 강력함.

---

2. 사전 준비

1. Node.js 설치
   • Node.js 공식 홈페이지에서 운영체제(OS)에 맞는 버전을 다운로드 및 설치
   • 설치 확인:
   •  
     node -v npm -v
2. Google 계정
   • Gemini CLI 인증을 위해 필요
   • 또는 Google AI Studio에서 발급받은 API Key 사용 가능

---

3. Gemini CLI 설치

 

npm install -g @google/gemini-cli

• 설치 확인:

 

gemini --version

• 실행:

 

gemini

→ 처음 실행 시 구글 계정 로그인 팝업이 뜸.
→ 로그인 완료 후 CLI 환경 진입.

---

4. 인증 및 실행

• 구글 로그인 인증 (기본)
• 또는 환경 변수 파일(.env) 생성:

 

GEMINI_API_KEY=your_api_key_here GEMINI_MODEL=gemini-2.5-pro

실행:

 

gemini chat

종료:

 

Ctrl + C

---

5. VSCode와의 연동

• 터미널에서 Gemini CLI 사용 + VSCode 파일 탐색기를 함께 활용하면, 생성된 파일을 곧바로 확인 가능.
• 권장 터미널:
  • Windows: Command Prompt(cmd) (⚠ PowerShell은 권한 문제 발생 가능)
  • MacOS/Linux: 기본 터미널

---

6. Gemini Code Assist 설치 및 활용

1. VSCode Extensions → "Gemini Code Assist" 검색 후 설치
2. Gemini 탭 활성화 → Gemini와 직접 채팅 가능
3. 사용 방법:
   • 코드 드래그 후 "Fix" 요청
   • 프로젝트 맥락을 포함해 코드 수정 지시
   • GitHub Copilot 무료 사용량이 다 소진되면 Gemini Code Assist로 전환 가능

---

7. 주요 기능 정리

• 토큰 용량: 대화당 100만 토큰
• 멀티모달 입력: 이미지, PDF, 텍스트 지원
• 대화 관리:
  • clear: 대화 초기화
  • compress: 대화 압축
  • memory add: 장기 기억 추가
  • stats: 사용량 확인
• 내장 도구:
  • find-file: 파일 검색
  • search-text: 특정 텍스트 검색
  • read-file / write-file: 파일 읽기·쓰기
  • web: 웹 검색 및 크롤링

---

8. 고급 설정

• 설정 파일: settings.json
  • 사용자/프로젝트/시스템 수준 설정 가능
• 프로젝트 메모리 파일: gemini.md
  • 특정 프로젝트별 규칙, 스타일 저장 가능
• 환경 변수(.env):
•  
  GEMINI_MODEL=gemini-2.5-flash GEMINI_API_KEY=your_api_key

---

9. 자동화와 보안 기능

• 로우 모드 (Raw mode)
  • 반복 작업 자동 승인
  • ⚠ 민감한 삭제/덮어쓰기 시 주의
• 샌드박스 모드 (Sandbox)
  • 시스템과 분리된 안전한 환경에서 실행
  • 위험한 코드 실행 시 보안 강화

---

10. MCP 서버 연동

• MCP (Model Context Protocol):
  AI ↔ 외부 데이터 소스/시스템 간의 번역기 역할
• 활용 예:
  • 로컬 파일 시스템 ↔ Gemini
  • 데이터베이스 ↔ Gemini
  • 외부 API ↔ Gemini

---

11. 실행 절차 요약

1. Node.js 설치 (node -v 확인)
2. Gemini CLI 설치 (npm install -g @google/gemini-cli)
3. Google 계정 로그인 or API 키 설정
4. VSCode 설치 및 Gemini Code Assist 확장 추가
5. gemini 명령 실행하여 CLI 진입
6. 필요 시 .env와 gemini.md 구성
7. 내장 도구/메모리/자동화 기능 활용

---

12. 참고문헌 및 주석

• YouTube: VSCode와 함께 써야 꿀조합 GEMINI CLI 그리고 Gemini Code Assist (2025)
  🔗 영상 링크
• Google AI Studio: https://aistudio.google.com
• Node.js 공식 사이트: https://nodejs.org

---

📌 주석

• 토큰(Token): AI가 문장을 이해·처리하는 최소 단위. 한 대화에서 100만 토큰까지 가능.
• 멀티모달(Multimodal): 텍스트뿐 아니라 이미지, PDF 등 다양한 입력 형식을 동시에 처리하는 기능.
• 샌드박스(Sandbox): 시스템에 영향을 주지 않도록 격리된 안전 실행 환경.
• MCP(Model Context Protocol): AI 모델이 외부 시스템과 안전하게 데이터를 교환하기 위한 프로토콜.

---

👉 이렇게 따라 하시면 실제로 Gemini CLI + VSCode Code Assist 환경을 바로 실행하실 수 있습니다.

 

 

 

 

 

VS Code와 함께 Gemini CLI 및 Code Assist 활용하기

이 문서는 개발자 생산성 향상을 위한 강력한 도구인 Gemini CLI와 VS Code의 Gemini Code Assist를 소개합니다. 두 도구는 유료 서비스인 GitHub Copilot과 유사한 기능을 제공하지만, 무료로 사용할 수 있다는 큰 장점을 가집니다.

목차

1. Gemini CLI 개요 및 특징
2. Gemini CLI 설치 및 인증
3. Gemini CLI 주요 명령어 및 기능
4. VS Code와 Gemini Code Assist 연동
5. Gemini CLI를 활용한 실무 자동화
6. 주석 및 참고문헌

1. Gemini CLI 개요 및 특징

Gemini CLI[^1]는 터미널 환경에서 사용할 수 있는 AI 에이전트로, 다음과 같은 주요 특징을 가집니다.

• 오픈소스 기반: 누구나 자유롭게 사용하고 기여할 수 있습니다.
• Gemini 2.5 Pro 모델 기반: 100만 토큰의 거대한 컨텍스트 창[^2]을 지원하여 대규모 코드 베이스를 효율적으로 이해하고 처리합니다.
• 멀티모달 기능 지원: 텍스트 외에 이미지, PDF 등 다양한 형식의 파일을 입력으로 받아 처리할 수 있습니다.
• 무료 사용: 개인 구글 계정을 통해 1분에 1000회 요청이 가능하며, 대화 세션을 새로 시작하면 다시 100만 토큰을 사용할 수 있습니다.

2. Gemini CLI 설치 및 인증

Gemini CLI를 사용하기 위한 설치 및 인증 절차는 다음과 같습니다.

1. Node.js 설치: Gemini CLI는 Node.js를 기반으로 동작하므로, Node.js를 먼저 설치해야 합니다. Node.js 공식 홈페이지에서 운영체제에 맞는 버전을 다운로드하여 설치합니다.
2. 설치 확인: 터미널(Windows의 경우 PowerShell보다 CMD를 권장)에서 node -v와 npm -v를 입력하여 Node.js와 npm[^3]이 제대로 설치되었는지 확인합니다.
3. Gemini CLI 설치: 다음 명령어를 터미널에 입력하여 Gemini CLI를 전역으로 설치합니다.
4. npm install -g @google/gemini-cli
5. 인증: 설치 후 터미널에 gemini를 입력하면 인증 절차가 시작됩니다. 가장 간단한 방법은 구글 계정으로 로그인하는 것입니다.

3. Gemini CLI 주요 명령어 및 기능

Gemini CLI는 효율적인 작업을 위한 다양한 명령어를 제공합니다.

• gemini: 대화 세션을 시작합니다.
• help: 사용 가능한 명령어 목록을 확인합니다.
• stat: 현재 세션의 토큰 사용량 등 통계를 표시합니다.
• clear: 대화 컨텍스트를 초기화합니다.
• memory show: gemini.md 파일에 저장된 장기 기억 내용을 확인합니다.
• memory add [내용]: gemini.md 파일에 새로운 기억을 추가합니다.

컨텍스트 관리: 대화가 길어지거나 주제가 변경될 경우 clear 또는 compress 명령어를 사용하여 컨텍스트를 효율적으로 관리할 수 있습니다.

4. VS Code와 Gemini Code Assist 연동

VS Code에서 Gemini Code Assist[^4] 확장 프로그램을 설치하면 터미널 환경에 익숙하지 않은 사용자도 편리하게 Gemini를 활용할 수 있습니다.

1. 확장 프로그램 설치: VS Code의 확장 프로그램 탭(Ctrl+Shift+X)에서 Gemini Code Assist를 검색하여 설치합니다.
2. 활용: 확장 프로그램을 설치하면 VS Code 내에 Gemini 채팅창이 생성됩니다. 이 창을 통해 코드 생성, 수정, 코드 리뷰, 질문 답변 등 다양한 작업을 수행할 수 있습니다.
3. GitHub Copilot과 함께 사용: GitHub Copilot의 무료 사용량이 소진되었을 때 Gemini Code Assist로 전환하여 작업을 이어갈 수 있습니다.

5. Gemini CLI를 활용한 실무 자동화

Gemini CLI는 단순히 코딩을 돕는 것을 넘어, 다양한 실무 작업을 자동화하는 데 활용될 수 있습니다.

• 파일 시스템 제어: find_file, read_file, write_file과 같은 내장 도구를 사용하여 파일을 탐색하고 수정할 수 있습니다.
• 쉘 명령어 실행: shell 명령어로 시스템 쉘 명령을 직접 실행할 수 있습니다.
• Git 연동: git 관련 명령어를 통해 이슈 분석, PR 생성 등 Git 워크플로우를 자동화할 수 있습니다.
• 문서 관리: README.md 파일 생성, API 문서화, Q&A 문서 작성 등 다양한 문서 작업에 활용할 수 있습니다.

6. 주석 및 참고문헌

주석

참고문헌

• YouTube. (756) VSCode와 함께 써야 꿀조합 GEMINI CLI 그리고 Gemini Code Assist. (2024년 5월 20일). https://www.youtube.com/watch?v=LR2XLJpejzQ

[^1]: Gemini CLI (Command-Line Interface): 터미널에서 텍스트 기반으로 동작하는 Gemini 모델입니다.

[^2]: 컨텍스트 창(Context Window): AI 모델이 한 번에 기억하고 처리할 수 있는 정보의 양을 나타냅니다. 100만 토큰은 매우 큰 용량입니다.

[^3]: npm (Node Package Manager): Node.js의 패키지 관리자입니다.

[^4]: Gemini Code Assist: VS Code에서 Gemini를 사용할 수 있도록 해주는 확장 프로그램입니다.