Windows 환경에서 VSCode에 Gemini CLI 무료 설치 방법 정리(Git, Node.js)

 

 

 

Windows 개발 환경 세팅 - VSCode에서 Gemini CLi 무료로 사용하기

 

1. Git 설치 및 세팅

1) git 설치

구글에 git이라고만 검색해도 install 페이지가 나옵니다

Git - Install

Git - Install

 

노란색으로 표시해둔 설치파일 받았어요

 

설치 완료 후 cmd에서 확인

> cmd

git --version

git version 확인

2)  git 세팅 

git 사용자 정보를 등록하자 

> cmd

git config --global user.name "사용자명"
git config --global user.email "이메일"

저는 깃허브 가입한 이메일을 넣어 세팅했습니다 

 

그리고 git init 명령 입력

git init

 

☞ 프로젝트 폴더에 .git 폴더가 생성 

 

 

2. Node.js 설치 

Node.js 20 이상이 설치되어 있어야 Gemini CLI를 설치할 수 있다 

Node.js — Node.js® 다운로드

Node.js — Node.js® 다운로드

다운로드 페이지 화면

Node를 .msi 파일로 설치하고 cmd 새로 열어 설치 확인하기 

> cmd

node -v
npm -v

버전이 나오면 node 설치가 잘 된 것입니다

 

3. Gemini CLI 전역 설치

계속 사용한다면 전역설치를 권장

> cmd

npm install -g @google/gemini-cli

 

명령어 실행 위치는 상관없습니다 -g가 global(전역 설치)기 때문

 

설치 후 확인

gemini --version

제미나이도 버전이 잘 나옵니다

 

 

4. 실행

gemini

 

1 눌러 구글 로그인해주기

 

제미나이 명령어 실행 후 (그대로 cmd창에) 구글 로그인을 진행해주면 됩니다 

 

로그인 후 인증 완료

브라우저에서 인증 완료 

 

로그인 끝났으니 재시작

친절하게 알려준대로 키보드에서 r을 누릅니다 

이제 여기서도 바로 대화 가능! 

 

 

5. VSCode 연동 *

>VSCode 실행 

 

1) VSCode에서 제미나이 실행시키기 

기존 혹은 새로 만들어진 프로젝트 폴더 열기 → 상단 메뉴의 Terminal에서 New Terminal 클릭 

 

터미널에서 아래 명령어 입력 

gemini

 

제미나이가 이제 VSCode에서 실행됩니다 

실행 화면

엔터치면 CLI Companion을 설치하라는 화면이 나옵니다 

자동 설치는 안되서 수동 설치를 진행할께요 

 

2) extension 2개  설치 

VSCode extension 클릭 → Gemini CLI Companion 검색 

이 중에 2개 설치할 예정

설치해야 하는 대상 

① Gemini CLI Companion 

② Gemini Code Assist

 

설치 완료 후에는 이렇게 나옵니다!

 

install 후 VSCode 재시작

터미널에서 다시 제미나이 시작 

gemini

 

이제 자유롭게 사용하시면 됩니다! 

 

 

6. 세팅과 사용방법 *

1) 세팅

① GEMINI.md 생성

 프로젝트 폴더 안에 GEMINI.md를 만든다 

(C:\xampp\htdocs\Adsafe\GEMINI.md)

 

② 내용 작성 

# Gemini Project Rules 
- 모든 답변은 한국어로 작성한다.
- 개발 초보자도 이해할 수 있도록 설명한다. 
- 코드 설명 시 흐름 → 역할 → 예시 순서로 설명한다. 
- PHP / JS 혼합 프로젝트 기준으로 설명한다. 

 

③ 터미널 재시작 

 

④ 테스트 

터미널에서 gemini를 부른다 

gemini

 

'이 프로젝트의 규칙을 요약해줘' 입력

☞ 방금 적은 md 파일의 내용이 나와야 함 

 

세팅과 설치 완료! 

이제 이어서 '프로젝트 폴더 구조를  설명해주세요' 등 자유롭게 써보시면 됩니다

 

2) Gemini Code Assist 사용 방법

Gemini Code Assist : VSCode 안에서 쓰는 AI 코딩 어시스턴트

 

* 코드 기반 방법은 두 가지로 정리해볼 수 있을 거 같아요 

① 전체 프로젝트 물어보기 혹은 코드  설명해줘 질문용 

② 특정 코드 기준으로 설명 혹은 수정받고 싶을 때

 

---

① 전체 프로젝트, 코드 설명해줘 질문용

Command Palette 실행 (Ctrl + Shift + P) 

Gemini Code Assist :Open Chat  선택

두번째 Open Chat 선택

사용하려면 구글 로그인 필요 

로그인 완료

 

예시) '이 프로젝트의 전체 구조 설명해주세요'

친절하게 설명해줍니다

 

 

② 특정 코드 기준으로 설명 혹은 수정받고 싶을 때 (실행 순서 중요)

코드 드래그해서 선택 → 마우스 오른쪽 버튼 클릭 → Gemini Code Assist → 원하는 작업 선택

마우스 오른쪽 버튼 클릭 시 찾을 수 있음

 

해당 작업 차이 설명 

아래에 설명

 

- Generate code : 선택한 코드를 수정/보완/완성하고 싶을 때 사용 (가장 많이 사용)

'이 함수 개선해줘', '코드 리팩토링 해줘', '에러 고쳐줘' 등 

드래그한 코드를 기준으로 Gemini가 코드를 새로 생성, 아래에 변경 코드가 나타나면 적용할지 말지 선택 가능 

 

- Genetate Unit Tests : 선택한 함수에 대해 테스트 코드 만들고 싶을 때 사용 

 

- Pin selection to current chat prompt : 지금 선택한 코드를 채팅 질문에 첨부해 보내는 기능 

사용 방법 : 코드 드래그 후 Pin selection~ 메뉴 클릭 , 채팅에 '이 코드 수강생 눈높이로 설명해줘' 치면 

선택한 코드가 자동 포함됨 

 

- Add file to Gemini context : 파일 전체를 Gemini가 참고하게 하고 싶을 때, 

'이 파일 전체 구조 분석해줘' 

☞ 해당 줄뿐 만 아니라 파일 전체를 이해한 상태로 답변해줌 

---

③ GEMINI.md 파일에 Rules 추가 

→ Gemini가 이 파일을 프로젝트 context로 읽는다 

# AdSafe Project Context 

- PHP 기반 프로젝트
- 의료 광고 문구 검수 서비스 
- JS / PHP에 공통 검수 룰 존재 
- 룰을 DB 기반으로 통합하려는 구조 

## Coding Rules
- 순수 PHP (Laravel X)
- DB는 mysql 사용
- 보안 우선 

 

☞ 이 프로젝트는 이런 성격이다를 계속 Gemini가 계속 기억

 

 

써보니 Cursor가 더 더 좋긴 합니다