Google Gemini CLI 나도 전문가처럼 할수 있다

✨ 1. Gemini CLI, 그것이 알고싶다

Google이 발표한 Gemini CLI는 개발자의 터미널에서 직접 작동하는 강력한 오픈소스 AI 에이전트입니다. Anthropic의 Claude Code CLI를 정조준한 경쟁 도구로, 현재 개인 사용자에게는 하루 1,000건, 1분당 60건의 요청이라는 파격적인 무료 정책을 제공하고 있습니다.

핵심 장점: Claude CLI와 달리 Node.js 기반으로 제작되어 Windows, macOS, Linux 등 모든 운영체제에서 완벽하게 호환됩니다. 이제 복잡한 WSL 설정 없이 바로 시작할 수 있습니다!

🛠️ 2. 설치부터 실행까지: 5단계면 끝!

Gemini CLI를 사용하기 위한 모든 준비 과정을 단계별로 안내합니다. 각 단계를 클릭하여 자세한 내용을 확인하세요.

Gemini CLI는 Node.js 환경에서 실행됩니다. 컴퓨터에 Node.js가 없다면 먼저 설치해야 합니다. 버전 18 이상을 권장합니다.

Node.js 공식 다운로드 페이지 가기

이미 설치되어 있다면 이 단계는 건너뛰세요. 터미널(명령 프롬프트)에서 node -v를 입력해 버전을 확인할 수 있습니다.

터미널(Windows) 또는 Terminal(macOS)을 열고 아래 명령어를 입력하여 컴퓨터 전체에서 Gemini CLI를 사용할 수 있도록 설치합니다.

npm install -g @google/gemini-cli

원하는 프로젝트 폴더로 이동한 후, 터미널에 gemini를 입력해 실행합니다. 처음 실행 시 구글 계정으로 로그인하라는 메시지가 나타납니다.

cd C:\MyProject
gemini

브라우저가 자동으로 열리며 구글 로그인 및 권한 허용 창이 나타납니다. 안내에 따라 인증을 완료하면 터미널에서 Gemini를 사용할 준비가 끝납니다.

Gemini CLI는 실행된 폴더를 작업 폴더로 인식합니다. 이 폴더 안에 GEMINI.md 파일을 만들면, Gemini는 이 파일의 내용을 프로젝트의 핵심 지침이자 '기억'으로 사용합니다.

아래 명령어로 기본 지침 파일을 생성할 수 있습니다.

GEMINI.md 파일 생성해줘.

💡 꿀팁: 이 파일에 "모든 답변은 한국어로 해줘.", "이 프로젝트는 웹 기반 그림판이야." 와 같이 프로젝트의 규칙과 맥락을 자세히 적어두면 훨씬 똑똑하게 작동합니다.

GEMINI.md 파일의 내용을 확인하거나 수정 후 다시 불러올 수 있습니다.

현재 메모리 내용 보기:

/memory show

GEMINI.md 파일 수정 후 메모리 새로고침:

/memory refresh

🚀 3. 고급 활용: AI 에이전트에 날개 달기 (MCP)

MCP(Model-Component-Protocol)는 Gemini가 웹 브라우징, 파일 수정, 터미널 명령어 실행 등 컴퓨터와 직접 상호작용할 수 있게 해주는 '도구'입니다. 이 도구들을 설정하면 Gemini가 진정한 AI 에이전트로 거듭납니다.

가장 쉬운 MCP 설정법 (Claude 사용자라면)

이미 Claude 데스크탑 앱을 사용하고 있다면, 설정 파일을 그대로 복사해와서 매우 간단하게 MCP를 활성화할 수 있습니다.

아래 경로에서 claude_desktop_config.json 파일을 찾으세요.

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS/Linux: ~/.config/Claude/claude_desktop_config.json

이 파일을 텍스트 에디터로 열고, "mcpServers": { ... } 부분을 전부 복사합니다.

이제 Gemini의 설정 파일인 settings.json을 찾습니다.

Windows: C:\Users\사용자이름\.gemini\settings.json
macOS/Linux: ~/.gemini/settings.json

이 파일을 열어 1단계에서 복사한 "mcpServers" 내용을 붙여넣고 저장하면 끝입니다!

Gemini CLI를 재시작한 후, 아래 명령어를 입력하여 MCP 서버 목록이 제대로 뜨는지 확인합니다.

/mcp

🔬 4. 코딩을 넘어서: 다양한 활용법

Gemini CLI는 단순 코딩을 넘어 다양한 작업을 수행할 수 있습니다.

파일 및 이미지 분석

작업 폴더 내의 파일이나 이미지를 분석할 수 있습니다. 파일을 탐색기에서 터미널로 드래그 앤 드롭하면 경로가 자동으로 입력됩니다.

⚠️ 중요: 파일 분석은 현재 작업 폴더(gemini가 실행된 폴더) 내에 있는 파일만 가능합니다. 다른 경로의 파일은 분석할 수 없습니다.

스크린샷 2024-06-27.png 이 파일은 어떤 내용이야?

폴더 전체 분석

@ 기호를 사용하면 파일이나 폴더를 참조할 수 있습니다. @.은 현재 폴더 전체를 의미합니다.

@. 파일들을 요약하고, 이 프로젝트의 목적을 설명해줘.

💡 5. 실전! AI 코딩 전략: 더 나은 결과물을 위한 팁

AI 에이전트를 더 효과적으로 사용하기 위한 몇 가지 전략입니다.

로그 시스템 구축: 복잡한 작업을 시킬 때는 "모든 과정에 로그를 남겨줘" 라고 지시하여 디버깅을 쉽게 만드세요.
MVC 패턴 활용: 모델(데이터), 뷰(화면), 컨트롤러(로직)를 분리해서 코드를 짜달라고 요청하면 훨씬 구조적인 코드를 얻을 수 있습니다.
단일 책임 원칙: "하나의 함수는 하나의 기능만 수행하도록 만들어줘" 라고 지시하여 코드의 재사용성과 유지보수성을 높이세요.
깊이 생각하게 만들기 (반복 질문): 한 번에 모든 것을 시키기보다, 하나의 작업에 대해 다양한 관점으로 여러 번 질문하며 결과를 구체화해 나가면 훨씬 깊이 있는 결과물을 얻을 수 있습니다.

🔗 6. 더 알아보기

더 많은 명령어와 고급 기능이 궁금하다면 Gemini CLI 공식 GitHub 문서를 확인하세요.

Gemini CLI 공식 명령어 문서 바로가기

다른내일