구글 제미나이(Gemini) CLI 완벽 가이드: 설치부터 Playwright 연동(MCP)까지 🚀

Gemini CLI, 대체 정체가 뭐야? 🤔

Gemini CLI(Command Line Interface)는 이름 그대로 터미널, 즉 명령줄 환경에서 제미나이 AI 모델과 직접 소통하게 해주는 도구입니다. 복잡한 API 연동이나 별도의 프로그램 없이, 간단한 명령어를 통해 코드 생성, 디버깅, 문서 요약, 아이디어 구상 등 제미나이의 거의 모든 기능을 활용할 수 있죠. 마치 터미널에 나만의 AI 비서가 생긴 것과 같습니다.

웹 UI를 벗어나 개발자들이 가장 많은 시간을 보내는 터미널 환경에 AI를 통합함으로써, 작업의 흐름을 끊지 않고 생산성을 극대화할 수 있다는 것이 가장 큰 장점입니다. 쉘 스크립트와 연동하면 단순 반복 작업을 자동화하는 것도 식은 죽 먹기죠!

준비물: 딱 두 가지만 챙기세요!

거창한 준비물은 필요 없습니다. 아래 두 가지만 준비되었다면 당신은 이미 Gemini CLI를 사용할 준비가 된 셈입니다. 😉

• Node.js (버전 18 이상): Gemini CLI는 Node.js 환경에서 실행됩니다. 혹시 설치되어 있지 않거나 버전이 낮다면, Node.js 공식 홈페이지에서 LTS 버전을 설치해주세요. 터미널에 node -v를 입력해서 버전을 확인할 수 있습니다.
• 구글 계정: 제미나이 서비스를 이용하기 위한 기본 인증 수단입니다. 구글 계정만 있다면 분당 60회, 하루 1,000회까지 무료로 요청을 보낼 수 있습니다. 이 정도면 개인적인 용도로는 차고 넘치죠!

설치: 5분 컷! OS별 맞춤 가이드

가장 중요한 설치 과정입니다. 하지만 걱정 마세요. 운영체제와 상관없이 명령어 한 줄이면 충분합니다. 터미널을 열고 아래 명령어를 입력하세요.

npx https://github.com/google-gemini/gemini-cli

# run_gemini.bat 파일을 만든 후 아래 내용을 추가
@echo off
echo Launching Gemini CLI...
npx https://github.com/google-gemini/gemini-cli
echo Gemini CLI execution completed.
pause
                            

혹은, 컴퓨터 전역에 설치해서 gemini라는 짧은 명령어로 사용하고 싶다면 아래 명령어를 사용하세요.

npm install -g @google/gemini/cli

명령어를 실행하면 설치가 진행되고, 처음 실행 시 몇 가지 설정 과정이 나타납니다.

1. 테마 선택: 마음에 드는 터미널 테마를 고르세요. 방향키로 이동하고 엔터로 선택하면 됩니다.
2. 인증 방식 선택: 'Login with Google'을 선택하고 엔터를 누르세요.
3. 브라우저 인증: 잠시 후 웹 브라우저가 열리면, 준비해둔 구글 계정으로 로그인하고 권한을 허용해주세요.

브라우저 창에 인증 성공 메시지가 나타나면 모든 과정이 끝난 것입니다. 터미널로 돌아오면 제미나이가 당신을 반겨줄 겁니다! 👋

기본 사용법: 제미나이와 첫 대화하기

이제 본격적으로 제미나이를 사용해볼 시간입니다. 설치 후 실행된 프롬프트, 또는 새로 터미널을 열고 gemini(전역 설치 시)나 npx https://github.com/google-gemini/gemini-cli를 입력하면 대화형 모드가 시작됩니다. 정말 간단하죠?

이제 궁금한 것을 무엇이든 물어보세요. 예를 들어...

# 간단한 파이썬 코드 요청하기
> "피보나치 수열을 계산하는 파이썬 함수를 만들어줘"

# 현재 디렉토리 파일에 대해 질문하기 (VSCode 터미널 등에서 유용)
> "@index.js 이 자바스크립트 코드의 기능을 설명해줘"

# git 명령어 물어보기
> "git에서 마지막 커밋을 취소하는 방법을 알려줘"
                            

줄바꿈은 Shift + Enter, 메시지 전송은 Enter입니다. /help를 입력하면 사용 가능한 모든 명령어를 확인할 수 있으니 꼭 한번 실행해보세요.

꿀팁 대방출: 실전 활용 능력 레벨업!

기본적인 대화만으로도 훌륭하지만, Gemini CLI의 진가는 API 키 연동과 고급 기능에서 드러납니다. 당신의 생산성을 한 단계 더 끌어올릴 꿀팁들을 소개합니다.

1. API 키 설정으로 한계 돌파하기

기본 구글 계정 인증만으로도 충분하지만, 더 많은 요청이 필요하거나 특정 프로젝트에 연결하고 싶다면 API 키를 사용하는 것이 좋습니다.

1. Google AI Studio에 접속하여 새로운 API 키를 생성합니다.
2. 발급받은 키를 터미널의 환경 변수로 등록합니다. 운영체제에 맞는 명령어를 사용하세요.

macOS / Linux (.bashrc, .zshrc 등)

export GEMINI_API_KEY="여기에_당신의_API_키를_붙여넣으세요"

Windows (Command Prompt)

set GEMINI_API_KEY="여기에_당신의_API_키를_붙여넣으세요"

Windows (PowerShell)

$env:GEMINI_API_KEY = "여기에_당신의_API_키를_붙여넣으세요"

이렇게 설정하고 터미널을 재시작하면, 다음부터 Gemini CLI는 이 API 키를 사용하여 인증을 시도합니다.

2. 프로젝트 맞춤형 AI, GEMINI.md

프로젝트 루트 디렉토리에 GEMINI.md 파일을 만들어두면, Gemini CLI가 해당 디렉토리에서 실행될 때 이 파일을 먼저 읽어 컨텍스트를 파악합니다. 예를 들어, "이 프로젝트는 React와 TypeScript를 사용하고, 코딩 스타일은 Prettier 규칙을 따른다"와 같은 규칙을 적어두면 훨씬 더 프로젝트에 적합한 답변을 생성해줍니다. 똑똑하죠?

3. Playwright 연동: 브라우저 자동화를 CLI에서! (MCP 활용)

Gemini CLI의 가장 강력한 기능 중 하나는 MCP(Multi-modal Command Palette)를 통해 Playwright와 같은 외부 도구를 연동하는 것입니다. 이를 통해 터미널에서 자연어 명령으로 웹 브라우저를 제어하는 마법 같은 경험을 할 수 있습니다. E2E 테스트 스크립트 초안을 만들거나 웹사이트 정보를 가져오는 작업을 자동화해 보세요.

1단계: Playwright MCP 서버 설치

먼저 Gemini CLI와 Playwright를 연결해 줄 서버를 전역으로 설치해야 합니다.

npm install -g @executeautomation/playwright-mcp-server

2단계: Gemini CLI 설정 파일에 서버 등록

다음으로 Gemini CLI에게 Playwright 서버의 존재를 알려줘야 합니다. 아래 경로의 setting.json 파일을 열고 내용을 추가하세요. 파일이 없다면 새로 만들면 됩니다.

• Windows: C:\Users\{사용자명}\.gemini\setting.json
• macOS / Linux: ~/.gemini/setting.json

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@executeautomation/playwright-mcp-server"]
    }
  }
}

이미 `setting.json` 파일에 다른 내용이 있다면, `mcpServers` 객체 안에 `playwright` 설정을 추가해주면 됩니다.

3단계: 실행 및 명령어 예시

모든 설정이 끝났습니다! 이제 터미널에서 Gemini CLI를 실행하고 @playwright 명령어를 사용해 보세요.

# 구글에 접속해서 Gemini CLI를 검색하고 스크린샷 찍기
> @playwright "go to https://google.com, search for Gemini CLI, and take a screenshot"
                            

이 명령을 실행하면, Gemini CLI가 Playwright를 제어하여 실제로 브라우저를 열고 지시한 작업을 수행한 후 결과를 알려줍니다. 정말 놀랍지 않나요?

마무리: 이제 당신도 터미널 위 AI 마법사

지금까지 Gemini CLI의 설치부터 고급 활용법까지 숨 가쁘게 달려왔습니다. 이제 여러분은 더 이상 코딩하다 말고 브라우저를 찾아 헤맬 필요가 없습니다. 검은 터미널 화면 안에서 명령어 몇 줄로 코드 리뷰, 리팩토링, 심지어 웹 브라우저 제어까지 해결하는 'AI 마법사'가 될 준비를 마쳤습니다.

지금 바로 터미널을 열고 npx https://github.com/google-gemini/gemini-cli를 입력해보세요. 신세계가 여러분을 기다리고 있습니다! 😉