무료로 강력한 AI 코딩: Gemini CLI 시작하기와 팁

Gemini CLI 설치 및 시작 방법

Gemini CLI를 설치하려면 Node.js가 먼저 필요합니다. Node.js를 설치한 후 아래와 같이 명령어로 Gemini CLI를 설치할 수 있습니다.

npm install -g @google/gemini-cli

설치가 완료되면 터미널에 gemini라고 입력해 실행합니다. 구글 계정으로 로그인하거나, AI 스튜디오에서 API 키를 받아 .env 파일에 등록하면 인증이 완료됩니다.

VSCode와 Gemini CLI를 함께 쓰는 이유

터미널에서만 Gemini CLI를 쓰면 생성된 파일이나 폴더를 확인하기 불편할 수 있습니다. VSCode나 Cursor 같은 에디터에서 Gemini CLI를 같이 활용하면 파일 탐색, 결과물 확인, 코드 수정 등이 훨씬 쉬워집니다. 여러 작업을 관리할 때 에디터와 CLI 조합이 최고의 효율을 발휘합니다.

Gemini Code Assist 플러그인 활용

VSCode에 Gemini Code Assist 확장 프로그램을 설치하면 Gemini와 직접 채팅하거나 코딩 보조를 받을 수 있습니다. 질문이나 코드 수정을 요청할 수 있고, 대화형으로 코드 조각을 드래그해서 수정도 가능합니다. Copilot을 쓰다가 무료 사용량이 다 소진됐다면, Gemini Code Assist로 바로 넘어갈 수 있어 편리합니다.

무료와 사용량 제약에 대한 비교

Copilot이나 Claude Code는 무료 사용량이 제한되어 금방 소진될 수 있습니다. 반면 Gemini는 한 대화 세션에서 최대 100만 토큰까지 사용할 수 있어서 하루 종일 작업해도 부족함을 잘 느끼지 않습니다. 비용 부담 없이 넉넉하게 AI를 활용할 수 있는 점이 큰 장점입니다.

프로젝트별 맞춤 설정 및 대화 기록 활용

Gemini CLI는 각 프로젝트마다 gemini.md 같은 마크다운 파일을 만들어 규칙이나 정보, 작업 기록을 정리할 수 있습니다. 예를 들어 "한국어로만 답변해달라", "가상 환경 사용" 등의 지시 사항을 기억하게 해두면, 반복적인 설정을 자동화할 수 있습니다. 초기 설정, 마일스톤 기록, 문제 해결 과정 등을 체계적으로 저장할 수 있습니다.

기본 명령어와 내장 도구

터미널에서 주요 명령어로 대화를 초기화(clear), 토큰 사용량 확인(stat), 메모리 관리(memory) 등 다양한 관리를 할 수 있습니다. 내장된 파일 시스템이나 웹 명령어 도구를 활용하면 폴더 정리, 파일 생성, 웹 데이터 수집까지 자동화가 가능합니다.

고급 설정: 세팅 및 환경 변수 파일

.env 파일로 API 키, 모델 설정 등 민감한 정보를 관리합니다. settings.json 파일을 활용하면 사용 환경에 맞는 세부 옵션(컨텍스트 파일 추가, 툴 사용 제한, MCP 서버 설정 등)을 지정해 맞춤형 AI 환경을 만들 수 있습니다.

MCP 서버 연동 및 확장성

MCP(Model Context Protocol) 서버 기능을 통해 Gemini CLI는 외부 데이터베이스, API, 회사 내부 시스템 등 다양한 외부 자원과 연결해 자동화 워크플로우를 구현할 수 있습니다. 예를 들어, 깃 이슈 분석이나 PR 리뷰 자동화 등도 가능합니다. 서버 설정은 settings.json 파일에서 손쉽게 할 수 있습니다.

프롬프트 엔지니어링 팁

더 좋은 결과를 원한다면 요청을 구체적으로 작성할 것! "타입스크립트의 머티리얼 UI 스타일 컴포넌트 만들어줘"처럼 명확히 적으면 AI가 더 정확하게 작업합니다. 복잡한 프롬프트는 마크다운 문서로 만들어 저장해두고, 필요할 때마다 활용하면 업무 효율이 크게 올라갑니다.

다양한 활용 분야

Gemini CLI는 코딩뿐 아니라 문서 작성, API 문서 자동화, 슬라이드, 보고서, 데이터 처리, 이미지 편집, 문서 요약, 웹 기사 정리 등에도 쓸 수 있습니다. 반복 작업이나 콘텐츠 제작, 학습 자료 준비, 데이터 시각화 등 다양한 분야에서 생산성을 높일 수 있습니다.

---

Gemini CLI와 VSCode, 그리고 Code Assist의 조합은 개발자뿐만 아니라 문서 작성, 데이터 관리, AI 자동화 등 다양한 작업에 강력한 시너지를 발휘합니다. 무료로 넉넉하게 사용할 수 있고, 설정과 확장이 편리하며, 협업과 생산성 향상에 꼭 맞는 도구입니다.

출처 및 참고 :

https://www.youtube.com/watch?v=LR2XLJpejzQ