gemini

Google Gemini CLI. Terminal에서 codebase 분석, 파일 수정, shell command, Google Search grounding, MCP 및 extension workflow를 수행하는 open-source AI agent다.

• gemini를 인자 없이 실행하면 현재 directory에서 interactive session을 시작한다.
• -p/–prompt는 non-interactive 실행, –output-format json|stream-json은 script와 CI output 처리에 사용한다.
• 2026-07-19 기준 공식 Gemini CLI quickstart, installation, CLI reference, command reference를 반영했다.

# 설치 없이 실행
npx @google/gemini-cli
 
# npm global 설치
npm install -g @google/gemini-cli
 
# macOS / Linux: Homebrew
brew install gemini-cli
 
# macOS: MacPorts
sudo port install gemini-cli
 
# 설치 확인
gemini --version

• npm stable channel: npm install -g @google/gemini-cli@latest
• preview channel: npm install -g @google/gemini-cli@preview. 일반 사용에는 stable을 우선한다.
• npm global 설치 업데이트: npm install -g @google/gemini-cli@latest
• Homebrew 업데이트: brew upgrade gemini-cli
• 설치 후 gemini를 실행하고 Sign in with Google을 선택해 browser authentication을 진행한다.
• 설치 위치가 PATH에 없으면 npm config get prefix로 npm global prefix를 확인한다.

gemini
gemini -i "이 저장소 구조를 설명해줘"
gemini -p "변경사항을 요약해줘"
gemini -p "테스트 결과를 분석해줘" --output-format json
gemini --include-directories ../lib,../docs
gemini --resume latest

• gemini [OPTIONS]: interactive TUI 시작
• gemini -p PROMPT: non-interactive 실행
• gemini -i PROMPT: initial prompt와 함께 interactive session 시작
• gemini –resume latest|INDEX|UUID: 이전 session 재개
• gemini mcp COMMAND: MCP server 관리
• gemini skills COMMAND: agent skill 관리

• -m, –model MODEL: session model 선택
• -p, –prompt PROMPT: non-interactive prompt
• -i, –prompt-interactive PROMPT: initial interactive prompt
• -o, –output-format text|json|stream-json: output 형식
• –include-directories DIRS: 추가 workspace directory
• -r, –resume SESSION: session 재개
• -s, –sandbox: sandbox mode 활성화
• –approval-mode default|auto_edit|yolo|plan: tool approval mode
• –yolo: deprecated. –approval-mode=yolo를 사용한다.

• Session/context: /clear, /compress, /resume, /rewind, /restore, /stats
• Model/behavior: /model, /plan, /permissions, /settings
• Project: /init, /directory, /memory, /tools
• Integration: /mcp, /extensions, /skills, /hooks
• Authentication/help: /auth, /about, /docs, /help, /quit
• @PATH: file 또는 directory content를 prompt에 포함한다.
• !COMMAND: shell command를 직접 실행한다.

• Esc 두 번: conversation rewind UI
• Ctrl+Z 또는 platform별 undo key: prompt 편집 undo
• @FILE: file context 추가
• !COMMAND: shell mode command 실행

• 사용자 설정: ~/.gemini/settings.json
• 프로젝트 설정: .gemini/settings.json
• 지속적인 context instruction: GEMINI.md
• project별 session과 extension 관련 파일은 .gemini 아래에서 관리한다.

• gemini: command not found가 나오면 gemini –version, npm list -g @google/gemini-cli, npm config get prefix 순서로 설치와 PATH를 확인한다.
• global 설치 버전이 오래됐으면 npm install -g @google/gemini-cli@latest로 갱신한다.
• Windows에서 Unix command가 실패하면 Git Bash 또는 WSL을 사용하거나 Windows equivalent command로 바꾼다.
• 자동 실행 범위를 넓히기 전에 –sandbox와 –approval-mode 정책을 먼저 검토한다.

gemini --help

Local gemini binary was not available in this workspace on 2026-07-19.
 
Verified from official Gemini CLI documentation:
  gemini [options]
  -m, --model MODEL
  -p, --prompt PROMPT
  -i, --prompt-interactive PROMPT
  -o, --output-format text|json|stream-json
  -r, --resume SESSION
  -s, --sandbox
      --approval-mode default|auto_edit|yolo|plan
      --include-directories DIRS
  -h, --help
  -v, --version

• Claude Code
• Codex CLI
• Node.js
• Official Gemini CLI quickstart

• codex:: 2026-07-19 Created the gemini:ko CLI page with official installation, authentication, update, options, commands, shortcuts, config, and troubleshooting guidance.