Gemini CLI 치트시트
가장 일반적인 Gemini CLI 명령어와 플래그에 대한 빠른 참조 가이드.
기본 사용법
gemini "여기에 프롬프트 입력"
가장 기본적인 명령어. Gemini 모델에 프롬프트를 보내고 응답을 출력합니다.
예시: gemini "세계에서 가장 큰 5개 도시는 무엇인가요?"
npx @google/generative-ai '...'
영구 설치 없이 Gemini CLI를 실행. 빠른 테스트나 가끔 사용할 때 완벽합니다.
예시: npx @google/generative-ai "기술 블로그에 좋은 이름을 제안해주세요."
파일 및 입력 처리
gemini -f [FILE_PATH] '...'
파일 내용을 프롬프트 컨텍스트의 일부로 포함합니다. 파일 내용이 프롬프트 앞에 추가됩니다.
예시: gemini -f readme.md "이 README 파일을 요약해주세요."
cat [FILE_PATH] | gemini '...'
파일 내용(또는 표준 출력)을 Gemini CLI에 컨텍스트로 직접 파이프합니다.
예시: cat package.json | gemini '이러한 종속성의 목적을 설명해주세요.'
gemini --files="file1.py,file2.py" "이 파일들을 비교"
여러 파일을 Gemini에 보내서 분석합니다.
예시: gemini --files="v1.js,v2.js" "버전 간에 무엇이 변경되었나요?"
출력 제어
gemini --json "이 텍스트에서 데이터 추출"
스크립트에서 쉽게 파싱할 수 있도록 JSON 형식으로 출력을 요청합니다.
예시: gemini --json "다음에서 이름, 이메일, 전화번호 추출: 홍길동, hong@example.com, 555-1234"
gemini --markdown "문서 생성"
Markdown 형식으로 출력을 요청합니다.
예시: gemini --markdown "REST API 문서를 작성해주세요"
gemini --code-only "함수 생성"
설명 텍스트 없이 코드 블록만 출력합니다.
예시: gemini --code-only "피보나치 수를 계산하는 Python 함수를 작성해주세요"
모델 제어
gemini --model=gemini-1.5-pro "복잡한 질문"
사용할 Gemini 모델을 지정합니다.
예시: gemini --model=gemini-1.5-flash "이 단락을 요약해주세요"
gemini --temperature=0.7 "창의적인 이야기"
응답의 무작위성을 제어합니다(0.0-1.0). 낮은 값일수록 더 결정적입니다.
예시: gemini --temperature=0.9 "SF 단편 소설을 써주세요"
gemini --max-tokens=500 "긴 응답"
응답의 길이를 제한합니다.
예시: gemini --max-tokens=100 "이 기사를 요약해주세요"
고급 사용법
gemini --system="당신은 도움이 되는 어시스턴트입니다" "프롬프트"
모델의 동작을 안내하는 시스템 프롬프트를 설정합니다.
예시: gemini --system="당신은 Python 전문가입니다" "이 코드를 도와주세요"
gemini --save=mychat "대화 시작"
나중에 계속하기 위해 대화를 저장합니다.
예시: gemini --save=project-planning "새로운 웹 앱을 계획해봅시다"
gemini --load=mychat "토론 계속"
이전에 저장된 대화를 계속합니다.
예시: gemini --load=project-planning "우리가 논의한 주요 기능은 무엇이었나요?"
시스템 및 웹 도구
gemini '현재 디렉토리의 파일을 테이블 형식으로 나열'
`ls` 명령을 실행하고 출력을 이해합니다. 특정 형식이나 분석을 요청할 수 있습니다.
예시: gemini 'src 폴더의 내용을 재귀적으로 표시하고 .css 파일을 식별해주세요'
gemini '`components` 디렉토리에서 모든 `useState` 인스턴스 찾기'
파일 내 콘텐츠에 대해 `grep` 검색을 수행합니다. 코드 분석 및 발견에 유용합니다.
예시: gemini '모든 `.ts` 파일에서 `TODO:` 텍스트를 검색해주세요.'
gemini '`src/blog` 폴더에서 모든 마크다운 파일 찾기'
glob 패턴을 사용하여 경로로 파일을 찾습니다. 에이전트는 일반적으로 이러한 파일을 읽거나 분석합니다.
예시: gemini '블로그에서 모든 `.md` 파일을 읽고 각각의 요약을 알려주세요.'
gemini 'AI에 관한 최신 뉴스를 웹에서 검색'
Google 검색을 사용하여 웹 검색을 수행하고 시사 문제나 최신 정보에 대한 질문에 답변합니다.
예시: gemini '마지막 Google I/O 이벤트의 주요 발표는 무엇이었나요?'
gemini '패키지 관리에는 pnpm을 사용하는 것을 선호한다는 것을 기억해주세요.'
에이전트가 향후 상호작용을 위해 특정 사실이나 선호도를 기억할 수 있게 합니다.
예시: gemini '앞으로 패키지 설치를 제안할 때 pnpm을 사용해주세요.' '네, pnpm을 사용하는 것을 기억하겠습니다.'
gemini '`npm run test` 명령을 실행하고 성공하는지 알려주세요.'
임의의 셸 명령을 실행하고 출력을 분석합니다. 매우 강력하지만 잠재적으로 위험한 도구입니다.
예시: gemini 'npm을 사용하여 `is-odd` 패키지를 설치하고 이를 사용하는 node 스크립트를 작성해주세요.'
프로 팁
export GOOGLE_API_KEY="YOUR_KEY"
API 키를 환경 변수로 설정하여 매번 명령에서 제공할 필요가 없도록 합니다.
예시: 지속성을 위해 .bashrc 또는 .zshrc 파일에 추가하세요.
gemini -f code.js "이 코드를 리팩토링해주세요. 원시 업데이트된 코드만 출력해주세요."
프롬프트를 사용하여 출력 형식을 제어합니다. '원시 코드'를 요청하면 출력을 새 파일로 직접 파이프하려는 경우에 도움이 됩니다.
예시: gemini -f old.py "..." > new.py