• Home
• IT | AI
• VSCode에서 Gemini CLI·Gemini Code Assist 쓰는 법 정리, 설치부터 장단점까지

VSCode에서 Gemini CLI·Gemini Code Assist 쓰는 법 정리, 설치부터 장단점까지

By derella sohn 3월 28, 2026 0

VSCode 안에서 Gemini CLI나 Gemini Code Assist를 쓰려는 사람은 점점 많아질 것 같습니다. 이미 코딩을 VSCode에서 한다면, AI 도구도 같은 화면에 붙는 게 자연스럽기 때문입니다.

하지만 비슷한 이름의 도구가 많아서 처음 설치할 때 헷갈릴 수 있습니다. CLI와 확장 기능의 역할을 구분해서 보는 게 먼저입니다.

설치 전에 볼 부분

• Gemini CLI와 Code Assist 차이
• VSCode에서 필요한 인증과 설정
• Codex나 Claude Code와 비교한 장단점

“Cursor 결제하려다가 이거 나와서 그냥 이거 써요 ㅎㅎ”

개발자 커뮤니티에서 종종 보이는 반응입니다. 구글 계정만 있으면 무료로, VSCode를 벗어나지 않고, Gemini 2.5 모델을 쓸 수 있다는 게 알려지면서 빠르게 퍼지고 있어요.

VSCode에서 구글 Gemini를 활용하는 방법은 크게 두 가지입니다. Gemini CLI와 Gemini Code Assist인데, 이름이 비슷해서 혼동하기 쉽지만 성격이 꽤 다릅니다. 오늘은 이 둘을 각각 어떻게 설치하고 쓰는지, 그리고 각각의 장단점이 무엇인지를 깔끔하게 정리해드릴게요.

---

먼저 — 둘의 차이를 한 줄로

구분	Gemini CLI	Gemini Code Assist
형태	터미널 명령줄 에이전트	VSCode 확장 프로그램
작동 방식	VSCode 통합 터미널에서 실행	사이드바·인라인에서 채팅·자동완성
핵심 강점	자율 에이전트 (파일 읽기·쓰기·실행)	에디터 통합 (채팅·인라인 자동완성)
오픈소스	오픈소스	구글 독점 확장
무료 사용	구글 계정 로그인 시 무료	개인용 무료 (하루 240회 채팅)

한마디로, Gemini CLI는 터미널에서 AI 에이전트를 부리는 것이고 Gemini Code Assist는 에디터 안에서 AI와 대화하고 코드 자동완성을 받는 것입니다. 둘을 함께 쓰면 시너지가 극대화되고, 실제로 Code Assist의 에이전트 모드는 Gemini CLI를 기반으로 작동합니다.

---

1부 — Gemini CLI 설치 및 VSCode 연동법

Gemini CLI가 뭔가요?

구글이 2025년 6월 오픈소스로 공개한 터미널 기반 AI 에이전트입니다. 단순히 질문에 답하는 게 아니라, ReAct(추론+행동) 루프를 통해 버그 수정·신기능 개발·테스트 작성 같은 복잡한 작업을 자율적으로 처리합니다. 컨텍스트 창이 100만 토큰이라 대규모 코드베이스도 한 번에 파악할 수 있어요.

Step 1 — Node.js 설치 확인

Gemini CLI는 Node.js 18 이상이 필요합니다. 터미널에서 아래 명령어로 확인하세요.

node --version

버전이 안 나오거나 18 미만이면 nodejs.org에서 최신 LTS 버전을 설치하세요.

Step 2 — Gemini CLI 설치

npm install -g @google/gemini-cli

설치가 완료되면 아래 명령어로 확인합니다.

gemini --version

Step 3 — 인증 방법 선택 (3가지)

터미널에서 gemini를 입력하면 처음 실행 시 인증 방법을 선택합니다.

• ① 구글 계정 로그인 (권장, 무료): 별도 API 키 없이 바로 사용. 개인 개발·학습·테스트에 적합합니다.
• ② Gemini API 키 (종량제): Google AI Studio에서 발급한 API 키 입력. 더 많은 사용량이 필요할 때.
• ③ Google Cloud 프로젝트: Gemini Code Assist Standard/Enterprise 구독자용. 팀·기업 환경에 적합합니다.

Step 4 — VSCode 통합 터미널에서 실행

VSCode를 열고 통합 터미널(Ctrl+`)을 엽니다. 프로젝트 폴더에서 아래를 입력하면 Gemini CLI가 실행됩니다.

gemini

Step 5 — VSCode와 더 깊이 연동하기 (IDE 통합)

통합 터미널에서 Gemini CLI를 실행한 뒤 아래 명령어 한 줄로 VSCode와 연동합니다.

/ide install

이렇게 하면 Gemini CLI가 VSCode에서 현재 열린 파일, 선택한 텍스트, 작업공간 전체를 인식합니다. 그리고 코드 수정 제안이 생기면 VSCode 안에서 바로 diff(변경 비교 화면)를 볼 수 있어요. 수락하기 전에 diff 화면에서 직접 수정도 가능합니다.

Gemini CLI 주요 명령어

GEMINI.md — 클로드 코드의 CLAUDE.md와 같은 역할

프로젝트 폴더 안에 GEMINI.md 파일을 만들어두면 Gemini CLI가 실행될 때마다 자동으로 읽어 지침으로 삼습니다. 코딩 스타일, 절대 하지 말 것, 프로젝트 소개 등을 적어두면 매번 설명을 반복하지 않아도 됩니다.

# 프로젝트 규칙
## 코딩 스타일
- 주석은 한국어로 작성
- 변수명은 카멜케이스
## 절대 하지 말 것
- .env 파일 수정 금지
- package.json 임의 변경 금지
## 프로젝트 소개
- Next.js 14 기반 블로그
- 데이터베이스: Supabase

Gemini CLI 장단점

장점

• 진짜 에이전트답게 동작: 파일을 직접 읽고 쓰고 수정하며 쉘 명령까지 실행합니다. 말 한마디로 여러 파일을 동시에 바꾸는 게 가능해요.
• 100만 토큰 컨텍스트: 대규모 레거시 코드베이스도 통째로 파악할 수 있습니다.
• 완전 무료 (구글 계정): API 키도, 신용카드도 필요 없습니다.
• 오픈소스: GitHub에서 소스코드 확인 가능. 커뮤니티 플러그인·MCP 서버 연동도 가능합니다.
• VSCode IDE 통합: /ide install 한 번으로 열린 파일·선택 텍스트 인식, 네이티브 diff 보기까지.
• GEMINI.md로 프로젝트 맥락 유지: 세션이 달라도 프로젝트 규칙을 기억합니다.

단점

• 터미널에 익숙해야 합니다: 명령줄이 낯선 분들에게는 진입 장벽이 있어요.
• 세션 간 대화 기억 안 됨: 새 세션을 시작하면 이전 대화 내용이 사라집니다. GEMINI.md로 보완은 가능하지만 불편합니다.
• 대화 히스토리 수동 관리: 챗 스레드를 직접 관리해야 하는 번거로움이 있어요.
• 구글 계정 무료 사용 한도 존재: 과도하게 사용하면 일시적으로 제한될 수 있습니다.
• 인라인 자동완성 없음: 코드를 치는 동안 자동으로 코드가 제안되는 기능은 Code Assist 전용입니다.

2부 — Gemini Code Assist 설치 및 사용법

Gemini Code Assist가 뭔가요?

구글이 공식으로 제공하는 VSCode 확장 프로그램입니다. 에디터 사이드바에서 채팅하고, 코드를 작성하는 동안 인라인 자동완성을 받고, 선택한 코드에 대한 설명·리팩토링·버그 수정을 요청하는 방식으로 사용합니다. 개인용은 무료예요.

Step 1 — 확장 프로그램 설치

1. VSCode에서 확장 프로그램 뷰 열기: Ctrl+Shift+X (Mac: Cmd+Shift+X)
2. 검색창에 “Gemini Code Assist” 입력
3. 구글 공식 배지가 붙은 확장 프로그램 선택 → 설치 클릭
4. 설치 완료 후 왼쪽 활동 바에 Gemini 아이콘 표시됨

Step 2 — 구글 계정 로그인

1. Gemini Code Assist 아이콘 클릭
2. 사이드바 하단 “Google에 로그인” 클릭
3. 외부 웹사이트 열기 허용 → 구글 계정으로 로그인
4. VSCode로 돌아오면 자동 연결 완료

이게 전부입니다. API 키도, 카드 등록도 필요 없어요.

Step 3 — 주요 사용 방법

① 채팅 (Chat): 사이드바 채팅창에서 자연어로 질문합니다. @파일명으로 특정 파일을 컨텍스트로 추가할 수 있어요.

@src/app.js 이 파일에서 메모리 누수가 발생할 수 있는 부분을 찾아줘

② 인라인 자동완성: 코드를 작성하는 도중 자동으로 다음 줄이 제안됩니다. Tab을 누르면 수락, Esc면 거절이에요.

③ 인라인 채팅: 코드를 선택한 뒤 Ctrl+I를 누르면 선택 영역에 대해 바로 질문할 수 있습니다.

이 함수 리팩토링해줘

④ 에이전트 모드: 채팅창에서 /agent를 입력하면 Gemini CLI 기반의 에이전트 모드가 활성화됩니다. 파일을 직접 읽고 수정하는 자율 작업이 가능해져요.

무료 사용 한도 (개인용)

하루 240회 채팅이면 일반적인 개발 작업에서는 충분한 수준이에요. 월 18만 건 자동완성도 웬만한 개발자에게는 넘기 어려운 한도입니다.

Gemini Code Assist 장단점

장점

• 설치가 극단적으로 간단: 확장 프로그램 설치 + 구글 로그인이 전부. Node.js도 필요 없습니다.
• 인라인 자동완성: 코드를 치는 도중 자연스럽게 제안이 나오는 경험은 CLI로는 불가능한 영역입니다.
• 에디터 이탈 없음: 사이드바, 인라인 채팅 모두 VSCode 안에서 완결됩니다.
• 무료 + 넉넉한 한도: 하루 240회 채팅, 월 18만 건 자동완성을 공짜로 씁니다.
• Cursor 대체 가능: 자동완성 + 사이드바 채팅 조합이면 유료 Cursor와 사용 경험이 비슷합니다.
• 두 위치에서 사용 가능: 주 사이드바와 보조 사이드바 모두 지원합니다.

단점

• 에이전트 기능이 CLI보다 제한적: 에이전트 모드가 있지만 CLI만큼 강력하지 않아요. 복잡한 멀티파일 자율 작업은 CLI가 훨씬 낫습니다.
• 응답이 너무 길면 잘림: Gemini 응답이 길어서 제대로 표현되지 못할 경우 다음 응답에 붙어서 나오는 현상이 있습니다.
• 세션 간 기억 없음: CLI와 마찬가지로 각 대화는 독립적으로 처리됩니다.
• 오픈소스가 아닌 독점 확장: 내부 동작 방식을 알 수 없고, 구글 정책에 종속됩니다.

둘을 함께 쓰는 게 가장 좋은 이유

사실 Gemini CLI와 Code Assist는 경쟁 관계가 아닙니다. Code Assist의 에이전트 모드 자체가 Gemini CLI를 기반으로 작동하고, 두 제품의 할당량도 공유됩니다. 오픈AI Codex가 CLI로 실행되고 IDE 확장도 따로 있는 것과 유사한 구조예요.

실무에서 가장 좋은 조합은 이렇습니다.

• 코드 작성 중 자동완성이 필요할 때 → Code Assist 인라인 자동완성
• 현재 파일에 대해 빠르게 물어보고 싶을 때 → Code Assist 사이드바 채팅
• 여러 파일을 동시에 수정하는 복잡한 작업 → Gemini CLI 에이전트
• 처음 보는 코드베이스 파악 → Gemini CLI + @폴더 명령
• 반복 자동화 작업 → Gemini CLI +!쉘 명령

Cursor vs Gemini 조합 — 솔직한 비교

가볍게 시작하거나 예산이 없다면 VSCode + Gemini Code Assist + Gemini CLI 조합이 충분히 실용적입니다. 반면 여러 AI 모델을 비교해가며 쓰거나 팀 협업 기능이 필요하다면 Cursor가 여전히 강점이 있어요.

마치며 — 무료로 시작하는 AI 코딩의 현실적인 선택

Gemini CLI와 Code Assist는 각자 강점이 다릅니다. CLI는 강력한 에이전트이고, Code Assist는 에디터 통합의 편의성이 강점이에요. 둘 다 구글 계정 하나로 무료로 쓸 수 있다는 게 가장 큰 매력입니다.

처음 시작하신다면 Gemini Code Assist 확장 프로그램 설치부터 해보세요. 확장 설치 + 구글 로그인, 2분이면 됩니다. 거기서 익숙해진 다음 터미널 작업이 많아지면 Gemini CLI를 추가로 도입하는 순서가 자연스럽습니다.

Cursor를 결제하려다 멈칫하고 있다면, 이 조합을 먼저 한 달 써보세요. 충분히 설득력 있는 무료 대안입니다.

이 글은 2026년 3월 28일 기준으로 작성됐습니다. 무료 한도와 기능은 구글 정책에 따라 변경될 수 있으니 최신 정보는 developers.google.com/gemini-code-assist에서 확인하세요.

Releated Posts

유용한정보자동차

테슬라 FSD 국내 허가 총정리 — 미국산은 됐는데, 내 차는 왜 안 되나

정말 많은 분들이 기다리시던 소식입니다. 드디어 국내에서도 모델3와 모델Y에 FSD가 열렸습니다. 그런데 기쁘기만 하지는 않습니다. 테슬라코리아가 7월 10일,…

이 글 공유하기:

• X
• Facebook

이것이 좋아요:

좋아하기 로드 중...

Byderella sohn 7월 11, 2026

IT | AI

루나 울트라 vs 오즈모 포켓 4P — 2026 듀얼렌즈 짐벌 카메라 완벽 비교

저도 오즈모 포켓3 유저인데요. 드디어 DJI에 맞설 상대가 나타났습니다. 2026년 상반기, 짐벌 카메라 시장에 격전이 벌어졌습니다. DJI가 6월…

이 글 공유하기:

• X
• Facebook

이것이 좋아요:

좋아하기 로드 중...

Byderella sohn 7월 5, 2026

IT | AI

스페이스X, 90조 원에 커서 인수 확정 — 머스크의 AI 코딩 전쟁 참전

이 기업을 인수할줄은 정말 몰랐네요. IPO 끝나자마자 곧바로 칼을 빼들었습니다. 스페이스X가 나스닥 상장 나흘 만에 또 하나의 기록을…

이 글 공유하기:

• X
• Facebook

이것이 좋아요:

좋아하기 로드 중...

Byderella sohn 6월 18, 2026

IT | AI

클로드 페이블 5 완벽 정리 — 미토스급 AI, 드디어 일반 공개

저도 실제로 오늘 써봤습니다. 앤트로픽이 드디어 꺼내 들었습니다. 6월 9일(현지 시간), 앤트로픽이 클로드 페이블 5(Claude Fable 5)를 일반…

이 글 공유하기:

• X
• Facebook

이것이 좋아요:

좋아하기 로드 중...

Byderella sohn 6월 11, 2026