기획자가 터미널을 열었습니다 - 윈도우에서 Gemini CLI 설치부터 실전 활용까지
"터미널이요? 그건 개발자들이 쓰는 거 아닌가요?"
IT 강의를 하다 보면 기획자 수강생에게 이 질문을 자주 받습니다. 맞습니다, 터미널은 원래 개발자의 영역이었죠. 그런데 2025년 하반기부터 상황이 달라졌습니다. Google이 Gemini CLI를 공개하면서, 터미널에서 AI를 직접 다루는 게 기획자한테도 쓸모 있는 일이 됐거든요.
강의 후 한 수강생이 이렇게 말했습니다. "ChatGPT 웹에서 기획서 초안 쓰는 건 해봤는데, 파일을 직접 읽고 분석하는 건 안 되잖아요. Gemini CLI로 CSV 파일 던져놓고 분석 시키니까, 이건 좀 다른 물건이더라고요." 이 말이 이 글을 쓰게 된 계기입니다.
Gemini CLI는 Google이 만든 오픈소스 AI 도구입니다. GitHub 스타 96,000개를 넘겼고, 무료로 하루 1,000번까지 사용할 수 있습니다. 신용카드 등록도 필요 없습니다. 기획자 입장에서 이 도구가 끌리는 건, 로컬 파일을 직접 읽고 Google 검색까지 연동해서, 회의록 요약이든 경쟁사 분석이든 터미널 하나로 처리할 수 있기 때문입니다.
이 글은 윈도우 환경에서 Gemini CLI를 처음 설치하는 것부터, 기획 실무에서 실제로 쓸 수 있는 수준까지 안내합니다. 터미널을 한 번도 써본 적 없는 기획자도 따라올 수 있도록 모든 과정을 스크린샷 없이도 이해할 수 있게 풀어 썼습니다.
1부. 설치 전에 알아둘 것
터미널이 뭔지부터 짚고 갑니다
윈도우에서 터미널은 "명령 프롬프트"나 "PowerShell"을 말합니다. 마우스 클릭 대신, 텍스트로 명령을 입력해서 컴퓨터에게 일을 시키는 도구죠.
여는 방법은 간단합니다. 윈도우 키를 누르고 "PowerShell"을 입력하면 됩니다. 검색 결과에서 "Windows PowerShell"을 클릭하면 파란색(또는 검은색) 창이 하나 뜨는데, 이게 터미널입니다.
여기서 한 가지. 이 글에서 "이 명령어를 입력하세요"라고 할 때, 전부 이 PowerShell 창에 입력하는 겁니다. 명령어를 입력한 뒤에는 반드시 Enter를 눌러야 실행되고요. 당연한 말 같지만, 처음 터미널을 쓰는 분들이 의외로 자주 놓치는 부분이거든요.
Gemini CLI가 뭔지, ChatGPT 웹과 뭐가 다른지
ChatGPT 웹이나 Gemini 웹은 브라우저에서 AI와 대화하는 도구입니다. Gemini CLI는 터미널에서 대화하는 도구고요. 이 차이가 생각보다 큽니다.
웹 버전에서는 파일을 업로드하고, 복사-붙여넣기로 내용을 전달합니다. 터미널 버전에서는 내 컴퓨터에 있는 파일을 AI가 직접 읽죠. "이 폴더에 있는 파일 전부 분석해줘"라고 하면, 폴더 안의 파일을 하나하나 열어서 분석합니다. 기획자 입장에서 이 차이는 꽤 큽니다. 매번 파일을 업로드할 필요가 없어지니까요.
또 하나 중요한 차이가 있는데요. Gemini CLI에는 Google 검색 기능이 내장되어 있습니다. "2026년 한국 이커머스 시장 동향을 정리해줘"라고 하면, 실시간으로 Google 검색을 해서 결과를 정리해줍니다. ChatGPT 웹에도 검색 기능이 있지만, Gemini CLI 쪽이 좀 더 자연스러운 편입니다. Google이 만든 도구니까요.
다음 그림은 웹 AI와 CLI AI의 핵심 차이를 한눈에 보여줍니다.
웹 AI는 브라우저에서 파일을 업로드하고 결과를 복사-붙여넣기하는 방식입니다. CLI AI는 터미널에서 명령어 한 줄로 내 컴퓨터의 파일을 직접 읽고 분석합니다. 파일 크기 제한이 없고, Google 검색까지 연동되는 게 핵심 차이입니다.
왜 하필 Gemini CLI인가
AI CLI 도구는 Gemini CLI만 있는 게 아닙니다. Anthropic의 Claude Code, OpenAI의 Codex CLI도 있죠. 그런데 기획자가 처음 시작하기에는 Gemini CLI가 가장 적합한 이유가 있습니다.
첫째, 무료입니다. 하루 1,000번 요청을 신용카드 없이 쓸 수 있습니다. Claude Code는 API 사용량 기반 과금 방식이라 쓸수록 비용이 발생하고, Codex CLI도 ChatGPT Plus 구독이 필요합니다. 기획자가 "이게 나한테 맞는 도구인지" 확인해보는 데 비용부터 걱정해야 한다면 선뜻 손이 안 가잖아요. Gemini CLI는 그 부담이 없습니다.
둘째, 코드 작성이 아닌 일반 작업에도 강합니다. Claude Code는 이름에서 알 수 있듯 코딩에 최적화된 도구입니다. SWE-bench 점수가 80.9%로 코드 품질이 최고 수준이지만, 기획서 작성이나 문서 요약 같은 작업에는 Gemini CLI가 더 편한 편이고요. 100만 토큰 컨텍스트 윈도우 덕분에 긴 문서도 한 번에 읽을 수 있고, Google 검색 연동으로 리서치까지 한 번에 처리됩니다.
셋째, 오픈소스입니다. Apache 2.0 라이선스로 코드가 공개되어 있죠. 이게 기획자에게 무슨 의미인지 궁금할 수 있는데, 간단히 말하면 "구글이 갑자기 서비스를 접어도 커뮤니티가 유지할 수 있다"는 뜻입니다. 실무 도구를 특정 회사에 종속시키는 건 리스크이고, 오픈소스는 그 리스크를 줄여줍니다.
2부. 윈도우에서 설치하기 - 처음부터 끝까지
전체 설치 과정은 4단계이고, 약 10분이면 끝납니다. 아래 로드맵을 먼저 확인하고 시작하면 마음이 편합니다.
Node.js 설치부터 첫 대화까지, 각 단계별 예상 소요 시간을 표시해 두었습니다. 한 단계씩 따라오면 됩니다.
1단계. Node.js 설치
Gemini CLI는 Node.js라는 프로그램 위에서 동작합니다. Node.js는 원래 자바스크립트 코드를 실행하기 위한 도구인데, Gemini CLI가 이걸 기반으로 만들어졌기 때문에 먼저 설치해야 합니다. 기획자가 Node.js를 직접 쓸 일은 없고, Gemini CLI를 설치하기 위한 사전 작업이라고 생각하면 됩니다.
Node.js 공식 사이트(nodejs.org)에 접속합니다. 메인 화면에 큰 녹색 버튼이 두 개 보이는데, 왼쪽이 LTS 버전이고 오른쪽이 Current 버전입니다. 반드시 LTS를 선택하세요. LTS는 "오래 지원되는 안정 버전"이라는 뜻이고, Gemini CLI는 Node.js 20.0.0 이상이 필요합니다. 2026년 2월 현재 LTS 버전은 이 조건을 충족하고요.
다운로드 버튼을 클릭하면 .msi 파일이 내려받아집니다. 이 파일을 실행하면 설치 마법사가 뜨는데, 여기서 주의할 점이 하나 있습니다. 설치 과정 중에 "Add to PATH"라는 체크박스가 나오거든요. 이 항목을 반드시 체크해야 합니다. PATH에 추가되지 않으면 터미널에서 node 명령어를 인식하지 못합니다. 기본값으로 체크되어 있는 경우가 많지만, 혹시 해제되어 있다면 꼭 체크해주세요.
나머지는 전부 "Next"를 클릭해서 기본 설정으로 설치하면 됩니다.
설치가 끝났으면 확인해봅시다. PowerShell을 열고 다음 두 명령어를 입력합니다.
node --version npm --version
정상적으로 설치됐다면 다음과 비슷한 결과가 나옵니다.
PS C:\Users\기획자> node --version v22.14.0 PS C:\Users\기획자> npm --version 10.9.2
v20 이상의 숫자가 나오면 성공입니다. 숫자가 위 예시와 정확히 같지 않아도 괜찮고요. 설치 시점에 따라 버전이 다를 수 있습니다. 만약 "'node'은(는) 인식할 수 없는 명령입니다" 같은 메시지가 나오면, PowerShell을 완전히 닫았다가 다시 열어보세요. 설치 직후에는 PATH가 갱신되지 않아서 새 터미널 창을 열어야 인식되는 경우가 있거든요.
터미널을 써본 적 없는 분을 위해 한 가지 더 설명하겠습니다. node --version에서 --는 대시(하이픈) 두 개입니다. 마이너스 기호 두 개를 연속으로 입력하는 겁니다. 명령어 옵션을 지정할 때 쓰는 표기법인데, 처음 보면 헷갈릴 수 있습니다.
winget을 이용하면 더 간단하게 설치할 수도 있습니다. 윈도우 11에는 winget이 기본 설치되어 있으니, PowerShell에서 아래 명령어 한 줄이면 됩니다.
winget install OpenJS.NodeJS.LTS --silent
2단계. Gemini CLI 설치
Node.js가 설치됐으면 Gemini CLI를 설치할 차례입니다. PowerShell을 관리자 권한으로 실행하세요. "관리자 권한"이란, 시작 메뉴에서 PowerShell을 검색한 뒤 "관리자로 실행"을 클릭하는 겁니다. 일반 사용자 권한으로도 설치되는 경우가 있지만, 권한 문제로 오류가 나는 걸 피하려면 관리자 권한이 안전합니다.
관리자 PowerShell에서 다음 명령어를 입력합니다.
npm install -g @google/gemini-cli
npm은 Node.js의 패키지 관리자입니다. -g는 "글로벌 설치"를 뜻하고, 이렇게 설치해야 어디서든 gemini 명령어를 쓸 수 있죠. @google/gemini-cli는 Google이 만든 Gemini CLI 패키지 이름입니다.
설치에는 보통 1~2분 걸립니다. 진행 중에 여러 줄의 텍스트가 지나가는데, 의존성 패키지가 함께 설치되는 과정이니 신경 쓰지 않아도 됩니다. 마지막에 added XXX packages라는 메시지가 나오면 설치 완료고요.
설치가 잘 됐는지 확인합니다.
gemini --version
다음과 같이 버전 번호가 출력되면 성공입니다.
PS C:\Users\기획자> gemini --version 0.31.0
2026년 2월 28일 기준 최신 안정 버전은 0.31.0입니다.
만약 'gemini'은(는) 내부 또는 외부 명령이 아닙니다라는 오류가 나오면, npm의 글로벌 설치 경로가 시스템 PATH에 등록되지 않은 겁니다. 이럴 때는 다음과 같이 해결합니다.
npm config get prefix
이 명령어를 실행하면 경로가 하나 출력됩니다. 보통 C:\Users\사용자이름\AppData\Roaming\npm 같은 경로입니다. 이 경로를 시스템 환경 변수의 PATH에 추가해야 합니다.
시작 메뉴에서 "환경 변수"를 검색하고, "시스템 환경 변수 편집"을 클릭합니다. 나타나는 창에서 "환경 변수" 버튼을 클릭합니다. "사용자 변수" 목록에서 "Path"를 찾아 더블클릭합니다. "새로 만들기"를 클릭하고, 위에서 확인한 경로를 붙여넣습니다. 확인을 누르고 PowerShell을 닫았다가 다시 열면 gemini 명령어가 인식됩니다.
설치 없이 한번 체험만 해보고 싶다면, npx 명령어를 쓸 수도 있습니다.
npx @google/gemini-cli
이 방식은 매번 패키지를 내려받아서 실행하기 때문에 느리지만, "일단 어떤 물건인지 보고 싶다"는 목적에는 적합합니다.
3단계. Google 계정으로 인증하기
Gemini CLI를 설치한 뒤 처음 gemini를 실행합니다.
가장 먼저 GEMINI라는 ASCII Art그림이 보입니다.
“Do you trust the files in this folder?”라는 질문과 함께, 이 폴더를 신뢰하면 Gemini CLI가 로컬 설정을 로드할 수 있다는 설명이 나옵니다. 여기에는 다음과 같은 항목이 포함될 수 있다고 안내합니다.
- 사용자 정의 명령
- 훅
- MCP 서버
- 에이전트 스킬
- 설정 값
또한 이러한 설정이 사용자를 대신해 코드를 실행하거나 CLI 동작을 변경할 수 있다고 경고합니다.
현재 폴더에는 “Setting overrides (1): general”이 포함되어 있다고 표시됩니다.
하단에는 선택지가 세 가지로 나옵니다.
- Trust folder (ursto)
- Trust parent folder (Users)
- Don’t trust
첫 번째 선택지가 초록색 점으로 강조되어 있어 현재 선택 상태임을 보여줍니다. 이 질문은 Gemini CLI가 특정 폴더의 설정을 신뢰할지 여부를 사용자에게 확인하는 보안 단계 화면입니다. Trust folder를 선택합니다. (ursto)는 필자의 사용가 계정 폴더입니다.
인증 방법을 물어봅니다. 이중에서 Login with Google을 선택합니다. API를 선택하게 되면 별도 과금을 사용하게 됩니다. 아래의 방법 1을 선택하세요.
방법 1. Google 계정 로그인 (가장 쉽습니다)
웹 브라우저가 열리고 인증을 할 것이라고 합니다. "Yes"를 선택합니다.
웹 브라우저가 자동으로 열리면서 Google 로그인 화면이 나타나고요. 평소 쓰는 Google 계정으로 로그인하고, 권한 승인을 하면 끝입니다. 터미널로 돌아가면 인증이 완료되어 있습니다.
여기서 주의할 점이 하나 있습니다. 회사나 학교에서 발급한 Google Workspace 계정(예: name@company.com)은 인증에 실패할 수도 있거든요. "Failed to login. Message: Request contains an invalid argument"라는 오류가 나오면, 관리자가 Gemini API 접근을 제한해놓은 겁니다. 이때는 개인 Gmail 계정을 사용하거나, 아래의 API 키 방식을 쓰면 됩니다.
이 방법으로 인증하면 무료로 분당 60회, 하루 1,000회 요청을 보낼 수 있습니다. 기획 업무에 쓰기에 충분한 양이죠. 하루 종일 써도 1,000번을 다 쓰기는 어렵습니다.
방법 2. API 키 사용
Google AI Studio에서 API 키를 발급받아 사용하는 방법입니다. Google AI Studio(aistudio.google.com/apikey)에 접속해서, Google 계정으로 로그인한 뒤 "Create API Key" 버튼을 클릭합니다. 프로젝트를 선택하거나 새로 만들면, AIza로 시작하는 긴 문자열이 생성되는데, 이것이 API 키입니다.
이 API 키를 환경 변수로 등록해야 합니다. API 키는 비밀번호와 같은 민감한 정보이니, 다른 사람에게 공유하거나 화면 캡처 시 노출되지 않도록 주의하세요.
가장 안전한 등록 방법은 GUI를 사용하는 겁니다. 시작 메뉴에서 "환경 변수"를 검색하고, "시스템 환경 변수 편집"을 클릭합니다. "환경 변수" 버튼을 누른 뒤, "사용자 변수"에서 "새로 만들기"를 클릭하세요. 변수 이름에 GEMINI_API_KEY, 변수 값에 API 키를 붙여넣고 확인을 누르면 됩니다. 이 방법은 API 키가 명령어 기록에 남지 않아서 보안상 더 안전하죠.
터미널에서 바로 설정하고 싶다면 PowerShell에서 다음 명령어를 입력합니다.
setx GEMINI_API_KEY "여기에_API키를_붙여넣으세요"
이 방식은 편하지만, API 키가 PowerShell 명령어 기록에 평문으로 남는다는 점을 알아두세요. 회사 업무에 사용한다면 GUI 방식을 권장합니다.
어떤 방식으로 설정했든, 설정 후에는 반드시 PowerShell을 닫았다가 다시 열어야 합니다. 환경 변수 변경은 현재 열려있는 터미널에는 바로 적용되지 않기 때문입니다.
환경 변수가 제대로 설정됐는지 확인하려면, 새 PowerShell 창에서 다음 명령어를 실행합니다.
echo $env:GEMINI_API_KEY
API 키가 출력되면 성공입니다.
4단계. 첫 번째 대화 시작하기
설치와 인증이 끝났으면 다음과 같은 화면이 보입니다.
혹은
PowerShell에서 다음 명령어를 입력합니다.
gemini
이것만 입력하면 Gemini CLI가 대화형 모드로 시작됩니다. 프롬프트가 바뀌면서 입력을 기다리는 상태가 됩니다. 여기서 자연어로 질문하면 됩니다.
안녕하세요, 저는 기획자입니다. 간단한 자기소개 해주세요.
AI가 답변하면, 이어서 추가 질문을 할 수 있습니다. 채팅하듯 대화를 이어가면 됩니다. 대화를 끝내려면 Ctrl+C를 누르거나 /quit을 입력합니다.
대화형 모드 말고, 질문 하나만 던지고 답변을 받는 방법도 있습니다.
gemini -p "오늘 날씨 어때?"
-p 옵션 뒤에 질문을 따옴표로 감싸서 입력하면, 답변을 출력하고 바로 종료됩니다. 간단한 질문이나 스크립트에서 자동화할 때 유용합니다.
3부. 기획자를 위한 실전 활용법
설치가 끝났으니 이제 실전입니다. 기획자가 Gemini CLI를 실무에서 어떻게 쓸 수 있는지, 구체적인 시나리오별로 정리했습니다.
다음 그림은 기획자가 Gemini CLI로 할 수 있는 6가지 핵심 활용 사례입니다.
회의록 요약부터 CSV 분석, 경쟁사 조사, PDF 분석까지 터미널 하나로 처리할 수 있습니다. 각 시나리오를 하나씩 살펴보겠습니다.
시나리오 1. 회의록 요약
기획자의 하루에서 회의가 차지하는 비중은 꽤 큽니다. 회의록 정리에도 시간이 걸리죠. Gemini CLI로 이 작업을 줄일 수 있습니다.
회의록 텍스트 파일이 있다고 가정합니다. 대화형 모드에서 다음과 같이 입력합니다.
이 회의록을 요약해줘. 결정사항, 액션아이템, 담당자를 구분해서 정리해줘. @./회의록_20260228.txt
@./ 뒤에 파일 경로를 붙이면 Gemini CLI가 해당 파일을 직접 읽습니다. 웹 버전처럼 파일을 업로드할 필요가 없죠. 파일이 현재 폴더에 있으면 @./파일이름으로, 다른 폴더에 있으면 @./폴더/파일이름으로 경로를 지정하면 됩니다.
실제로 실행하면 다음과 비슷한 형태의 답변이 나옵니다.
## 회의록 요약 ### 결정사항 1. 모바일 앱 v2.0 출시일을 3월 15일로 확정 2. 디자인 시안 B안 채택 3. 결제 모듈은 외부 솔루션(토스페이먼츠) 사용 ### 액션아이템 | 항목 | 담당자 | 기한 | |------|--------|------| | API 설계서 작성 | 김개발 | 2/28 | | 디자인 가이드 전달 | 박디자인 | 3/3 | | QA 시나리오 작성 | 이기획 | 3/5 | ### 다음 회의 - 일시: 3월 5일(수) 오후 2시 - 안건: API 설계서 리뷰, QA 시나리오 검토
마크다운 형식으로 깔끔하게 정리되어 나옵니다. 이 결과를 그대로 복사해서 Notion이나 Confluence에 붙여넣으면 바로 포맷이 적용되고요.
이 방식의 장점은 파일 크기 제한이 거의 없다는 겁니다. Gemini CLI의 컨텍스트 윈도우가 100만 토큰이거든요. 한글 기준으로 대략 50만 자 정도를 한 번에 읽을 수 있습니다. 10페이지짜리 회의록이든 50페이지짜리 기획서든 상관없습니다.
단발 실행으로도 같은 작업을 할 수 있습니다. 대화형 모드에 들어가지 않고 명령어 한 줄로 처리하는 방식입니다.
gemini -p "이 회의록에서 결정사항과 액션아이템을 정리해줘 @./회의록_20260228.txt"
시나리오 2. 기획서 초안 작성
빈 페이지에서 기획서를 시작하는 건 누구에게나 어렵죠. Gemini CLI에 맥락을 주고 초안을 뽑아내면 시작점이 생깁니다.
다음 내용으로 모바일 앱 기획서 초안을 작성해줘. 프로젝트명: 직장인 건강관리 앱 대상 사용자: 25-40세 직장인 핵심 기능: 걸음 수 추적, 식단 기록, 수면 분석 경쟁 앱: 삼성 헬스, 나이키 런 클럽 차별점: AI 기반 개인화 건강 코칭 일정: 3개월 예산: 5,000만원 마크다운 형식으로 작성하고, 각 섹션에 구체적인 내용을 채워줘.
여기서 중요한 점이 있습니다. Gemini CLI에 주는 프롬프트가 구체적일수록 결과물 품질이 올라갑니다. "기획서 써줘"보다 위처럼 핵심 정보를 나열해서 주는 게 훨씬 낫죠. 모든 AI 도구에 적용되는 원칙이지만, CLI 환경에서는 특히 그렇습니다. 웹 UI에는 이것저것 도움되는 기능이 붙어 있지만, CLI는 프롬프트 품질에 거의 전적으로 의존하니까요.
결과물을 파일로 저장하고 싶다면, /copy 명령어로 클립보드에 복사한 뒤 메모장에 붙여넣으면 됩니다. 다만 윈도우에서 /copy가 간혹 오류를 일으키는 알려진 문제가 있으니, 그럴 때는 마우스로 직접 텍스트를 선택해서 복사하세요.
시나리오 3. CSV 데이터 분석
기획자가 매출 데이터, 사용자 통계, 설문 결과를 분석해야 할 때가 있습니다. 엑셀을 열고 피벗 테이블을 만드는 것도 방법이지만, Gemini CLI를 쓰면 자연어로 분석을 요청할 수 있죠.
이 매출 데이터를 분석해줘. 월별 추이, 전월 대비 증감률, 가장 매출이 높은 제품군을 알려줘. @./sales_2025.csv
Gemini CLI는 CSV 파일을 읽고 데이터를 파악한 뒤, 요청한 분석 결과를 텍스트로 정리해줍니다. 차트를 그려주지는 않지만, 차트를 만들기 위한 데이터 정리는 해주거든요.
이 데이터를 엑셀에서 차트를 만들기 좋은 형태로 가공해줘. 월별 매출 합계와 전월 대비 증감률 컬럼을 추가해줘. @./sales_2025.csv
이런 식으로 데이터를 가공한 뒤, 결과를 엑셀에 붙여넣어 차트를 만들 수 있습니다.
시나리오 4. 경쟁사 분석과 시장 조사
기획자한테 가장 쓸모 있는 기능이 이겁니다. Google 검색 그라운딩이 내장되어 있어서, 실시간 정보를 기반으로 분석해주거든요.
2026년 한국 이커머스 시장의 최신 트렌드를 조사해줘. 주요 플레이어, 시장 규모, 성장률, 새로운 트렌드를 포함해서 보고서 형태로 정리해줘.
Gemini CLI가 Google 검색을 실행해서 최신 정보를 수집하고, 이를 정리해서 보여줍니다. AI가 정리한 내용이니 팩트 체크는 필요하지만, 리서치 출발점으로는 꽤 쓸 만합니다.
여러 경쟁 앱을 비교 분석하는 것도 가능합니다.
배달의민족, 쿠팡이츠, 요기요의 2026년 현재 시장 점유율과 주요 기능 차이를 비교 분석해줘.
시나리오 5. 이메일과 보고서 작성
기획자가 매일 쓰는 이메일과 보고서도 Gemini CLI로 초안을 뽑을 수 있죠.
거래처에 보낼 프로젝트 진행 상황 보고 이메일을 작성해줘. 현재 진행률은 70%이고, UI 디자인은 완료됨. 백엔드 개발은 다음 주 완료 예정. 전체 프로젝트는 3월 15일 완료 목표. 정중하고 전문적인 톤으로 써줘.
주간 보고서도 마찬가지입니다.
다음 내용으로 주간 업무 보고서를 작성해줘. 완료: A기능 기획 완료, B화면 디자인 리뷰 진행중: C기능 요구사항 정의 이슈: 디자인팀 일정 지연으로 D모듈 착수 1주일 연기 다음주 계획: C기능 프로토타입, E모듈 킥오프 미팅
시나리오 6. PDF와 이미지 분석
Gemini CLI는 텍스트 파일만 읽는 게 아닙니다. PDF, 이미지, 심지어 오디오와 비디오 파일도 분석할 수 있습니다. 멀티모달 입력을 지원하기 때문이죠.
경쟁사 앱의 스크린샷을 분석하는 예시입니다.
이 앱 스크린샷을 분석해줘. UI 구성 요소, 사용자 흐름, 잘된 점과 개선이 필요한 점을 정리해줘. @./competitor_app.png
PDF 보고서에서 핵심 내용을 뽑아내는 것도 가능합니다.
이 PDF에서 핵심 수치와 결론을 추출해줘. @./quarterly_report.pdf
4부. 알아두면 좋은 명령어와 기능
대화 저장과 재개
긴 작업을 하다가 중간에 멈춰야 할 때가 있습니다. Gemini CLI는 대화를 자동으로 저장하기 때문에 별도로 저장 명령을 입력할 필요가 없습니다.
나중에 이어서 하려면, 가장 최근 대화를 재개하는 명령어를 사용합니다.
gemini --resume latest
이전 대화의 맥락이 복원되면서 작업을 바로 이어갈 수 있습니다. 여러 프로젝트를 동시에 진행한다면, 먼저 저장된 세션 목록을 확인해보세요.
gemini --list-sessions
세션 목록에서 원하는 세션의 번호를 확인한 뒤, 해당 번호로 재개합니다.
gemini --resume 5
세션이 자동 저장되기 때문에, 대화 중 Ctrl+C로 나가거나 /quit을 입력해도 내용이 사라지지 않습니다. 여러 프로젝트를 동시에 진행하는 기획자라면 꽤 편한 기능이죠.
유용한 슬래시 명령어 정리
대화형 모드에서 사용할 수 있는 명령어가 몇 가지 더 있습니다. /help를 입력하면 전체 목록을 볼 수 있고요. 자주 쓰이는 것만 소개하겠습니다.
/clear는 현재 대화 내용을 초기화합니다. 새로운 주제로 넘어갈 때 쓰면 좋죠. 이전 대화의 맥락이 다음 질문에 영향을 주지 않도록 깨끗하게 정리해줍니다.
/compress는 현재까지의 대화를 압축 요약합니다. 대화가 길어지면 AI가 이전 내용을 잊어버리는 경우가 있는데, /compress를 하면 핵심만 남겨서 컨텍스트를 효율적으로 쓸 수 있게 해줍니다.
/copy는 AI의 마지막 답변을 클립보드에 복사합니다. 결과물을 다른 프로그램에 붙여넣을 때 편하죠.
/tools는 현재 사용 가능한 도구 목록을 보여줍니다. Gemini CLI가 어떤 작업을 할 수 있는지 확인할 때 씁니다.
/stats는 현재 세션의 사용량 통계를 보여줍니다. 토큰 사용량이나 요청 횟수를 확인할 수 있고요.
/model은 사용하는 AI 모델을 변경합니다. 기본 모델이 느리다고 느껴지면 경량 모델인 gemini-2.5-flash로 바꿔볼 수 있습니다. 속도와 품질 사이에 장단점이 있으니, 작업 성격에 맞게 선택하면 됩니다.
키보드 단축키
자주 쓰는 단축키도 알아두면 편합니다.
Ctrl+L은 터미널 화면을 깨끗하게 정리합니다. 이전에 출력된 텍스트가 위로 밀려나서 깨끗한 화면에서 작업할 수 있습니다. 단, /clear와는 다릅니다. Ctrl+L은 화면 표시만 정리하는 것이고, AI는 이전 대화를 여전히 기억하고 있습니다. 새로운 주제로 완전히 전환하고 싶다면 /clear를 사용해야 합니다.
Ctrl+C는 현재 진행 중인 작업을 취소합니다. AI가 너무 긴 답변을 생성하고 있을 때 중간에 끊을 수 있습니다.
Ctrl+V는 클립보드의 텍스트나 이미지를 붙여넣습니다. 스크린샷을 복사한 뒤 바로 붙여넣어서 분석을 요청할 수도 있습니다.
GEMINI.md로 프로젝트 맞춤 설정
중급 기능이긴 한데, 알아두면 꽤 편합니다. 프로젝트 폴더에 .gemini 폴더를 만들고, 그 안에 GEMINI.md 파일을 생성합니다. 이 파일에 프로젝트 정보를 적어두면, Gemini CLI가 해당 폴더에서 실행될 때마다 이 정보를 자동으로 참조합니다.
예를 들어 다음과 같은 내용을 넣어둘 수 있습니다.
# 프로젝트 정보 이 프로젝트는 직장인 건강관리 모바일 앱 기획입니다. - 대상 사용자: 25-40세 직장인 - 주요 기능: 걸음 수 추적, 식단 기록, 수면 분석, AI 건강 코칭 - 기획 문서는 /docs 폴더에 있습니다 - 경쟁사 분석 자료는 /research 폴더에 있습니다 - 모든 문서는 한국어로 작성합니다
이렇게 해두면 매번 "이 프로젝트는 뭐고, 대상 사용자는 누구고..."라는 맥락을 반복해서 설명할 필요가 없어집니다. Gemini CLI가 알아서 참조하니까요.
5부. 자주 겪는 문제와 해결법
"gemini 명령어를 찾을 수 없습니다"
가장 흔한 문제입니다. 설치는 됐는데 명령어가 인식되지 않는 경우죠.
먼저 PowerShell을 닫았다가 다시 열어보세요. 환경 변수가 갱신되지 않아서 생기는 문제인 경우가 많거든요. 그래도 안 되면 npm 글로벌 경로를 확인합니다.
npm config get prefix
출력된 경로가 시스템 PATH에 포함되어 있는지 확인합니다. 포함되어 있지 않다면, 2단계에서 설명한 환경 변수 설정 방법을 따라 PATH에 추가합니다.
최후의 수단으로, 재설치를 해봅니다.
npm uninstall -g @google/gemini-cli npm install -g @google/gemini-cli
PowerShell 실행 정책 오류
PowerShell에서 "스크립트의 실행이 시스템에서 사용할 수 없도록 설정되어 있습니다"라는 오류가 나오는 경우가 있습니다. 윈도우의 보안 정책 때문인데요. 다음 명령어로 해결할 수 있습니다.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
이 명령어는 현재 사용자에 한해 로컬에서 만든 스크립트 실행을 허용합니다. 보안상 위험한 설정은 아니니 걱정 안 해도 됩니다.
회사 네트워크에서 SSL 오류
회사에서 프록시나 방화벽을 쓰는 환경이라면, 설치나 실행 시 UNABLE_TO_GET_ISSUER_CERT_LOCALLY라는 오류가 날 수 있습니다. 회사의 보안 장비가 SSL 인증서를 중간에서 교체하기 때문에 생기는 문제거든요.
이 경우 회사의 IT팀에 "루트 CA 인증서 파일"을 요청해야 합니다. 파일을 받았다면 다음과 같이 환경 변수를 설정합니다.
setx NODE_EXTRA_CA_CERTS "C:\인증서경로\corporate-ca.pem"
프록시 환경이라면 npm에 프록시 설정도 해줘야 합니다.
npm config set proxy http://proxy.company.com:8080 npm config set https-proxy http://proxy.company.com:8080
프록시 주소는 회사 IT팀에 문의하면 알려줍니다.
인증 실패 - Google Workspace 계정 문제
회사 계정(예: name@company.com)으로 로그인했는데 인증이 실패하는 경우가 있습니다. Google Workspace 관리자가 Gemini API 접근을 제한해놓은 거죠.
해결 방법은 세 가지입니다. 가장 간단한 건 개인 Gmail 계정으로 인증하는 건데, 업무용 데이터를 개인 계정으로 처리하는 게 회사 정책상 문제가 될 수 있으니 상황에 맞게 판단해야 합니다.
두 번째는 Google AI Studio에서 API 키를 발급받아 사용하는 방법이고요. 개인 계정으로 API 키를 만들고, 환경 변수로 등록하면 됩니다.
세 번째는 회사 IT팀에 Gemini API 접근 권한을 요청하는 겁니다. 관리자가 Google Cloud 프로젝트에서 Gemini API를 활성화해주면 해결됩니다.
무료 사용량 초과
하루 1,000번의 무료 제한을 넘기면 요청이 거부됩니다. 기획 업무에서 1,000번을 다 쓰는 경우는 드물지만, 혹시 그런 상황이 오면 선택지가 두 가지입니다. 다음 날까지 기다리거나, Google AI Studio에서 유료 결제를 설정하는 거죠.
하나 더 알아둘 점이 있는데요. 무료 티어에서 사용량이 많아지면, 기본 모델(Gemini 3 Pro)에서 경량 모델(Gemini 2.5 Flash)로 자동 전환되는 경우가 있습니다. 답변 품질이 갑자기 떨어진다고 느껴지면 이 때문일 수 있으니, /stats 명령어로 현재 사용 모델을 확인해보세요.
6부. Gemini CLI를 더 잘 쓰기 위한 프롬프트 작성법
도구를 설치하는 것보다 중요한 게 있습니다. 좋은 프롬프트를 작성하는 능력이죠. AI CLI 도구를 쓰는 개발자 커뮤니티에서 자주 나오는 조언을 정리했습니다.
구체적으로 요청합니다
나쁜 예시와 좋은 예시를 비교하면 차이가 분명합니다.
나쁜 예시.
기획서 써줘
좋은 예시.
모바일 헬스케어 앱의 PRD(Product Requirements Document)를 작성해줘. 대상 사용자는 25-40세 직장인이고, 핵심 기능은 걸음 수 추적과 식단 기록이야. 각 기능별로 사용자 스토리, 수용 조건, 우선순위를 포함해줘. 마크다운 형식으로 작성하고, 분량은 A4 5페이지 이상으로 해줘.
역할을 부여합니다
너는 10년 경력의 IT 서비스 기획자야. 다음 기능에 대해 사용자 흐름도를 텍스트로 작성해줘.
역할을 부여하면 AI의 답변 톤과 깊이가 달라집니다. "기획자 관점에서", "개발자에게 전달할 문서로", "경영진에게 보고할 형식으로"처럼 맥락을 주면 결과물이 확실히 나아지죠.
단계적으로 나눠서 요청합니다
복잡한 작업을 한 번에 시키면 결과물 품질이 떨어집니다. 대화형 모드에서 단계적으로 진행하는 게 낫죠.
1단계: 이 시장 보고서를 요약해줘 @./market_report.pdf 2단계: 요약 내용을 바탕으로 우리 앱의 시장 진입 전략을 제안해줘 3단계: 제안한 전략을 경영진에게 보고할 형식으로 정리해줘
각 단계의 결과를 확인하고, 필요하면 수정을 요청한 뒤 다음 단계로 넘어가면 됩니다. 대화형 모드의 가장 큰 장점이 이런 반복적인 개선 작업에 있거든요.
출력 형식을 지정합니다
원하는 형식을 명확하게 지정하면 결과물을 바로 쓸 수 있죠.
마크다운 표 형식으로 비교표를 만들어줘.
번호 매긴 리스트로 우선순위를 정리해줘.
JIRA 티켓으로 등록할 수 있는 형식으로 써줘.
마무리
Gemini CLI가 "개발자의 도구"를 기획자에게 건네주는 건 아닙니다. 기획자가 이미 하던 일을 좀 더 빠르게 처리할 수 있게 도와주는 도구에 가깝습니다.
회의록 정리 시간이 확 줄고, 경쟁사 분석 초안이 몇 분 만에 나오고, CSV 데이터를 자연어로 파악할 수 있습니다. AI가 만든 결과물을 그대로 쓸 수는 없습니다. 팩트 체크, 맥락 보정, 톤 조절은 사람이 해야 하고요. 그래도 백지에서 시작하는 부담이 줄어드는 건 확실합니다.
Gemini CLI의 진짜 가치가 어디 있는지 짚어보면, "무료"가 아니라 "로컬 파일과의 연결"입니다. 내 컴퓨터에 있는 파일을 AI가 직접 읽고 분석하는 건, 웹 브라우저에서 파일을 업로드하는 것과 질적으로 다르거든요. 파일 업로드 용량 제한도 없고, 폴더째로 넘길 수도 있고, 여러 파일을 참조하면서 작업을 진행할 수 있습니다.
터미널이 어색한 건 처음 며칠뿐입니다. PowerShell을 열고, gemini을 입력하고, 자연어로 요청하는 패턴이 손에 익으면, 웹 브라우저를 열고 로그인하고 파일을 업로드하는 과정이 오히려 번거롭게 느껴질 겁니다. 적어도 IT 강의에서 Gemini CLI를 소개받고 쓰기 시작한 기획자 수강생들의 반응은 그렇습니다.
오늘 한번 설치해보세요. Node.js 설치부터 첫 대화까지, 10분이면 충분합니다.
참고 자료
- Gemini CLI 공식 GitHub 저장소: https://github.com/google-gemini/gemini-cli
- Gemini CLI 공식 문서: https://geminicli.com/docs/
- Google AI Studio (API 키 발급): https://aistudio.google.com/apikey
- Node.js 공식 사이트: https://nodejs.org
- Gemini CLI Cheatsheet (Phil Schmid): https://www.philschmid.de/gemini-cli-cheatsheet
- Gemini CLI Tips & Tricks (Addy Osmani): https://addyosmani.com/blog/gemini-cli/
- Claude Code vs Gemini CLI 비교 (Shipyard): https://shipyard.build/blog/claude-code-vs-gemini-cli/
댓글
댓글을 작성하려면 이 필요합니다.