Gemini命令行助手

📦 Installation

See Gemini CLI installation, execution, and releases for recommended system specifications and a detailed installation guide.

Quick Install

Run instantly with npx

```bash

Using npx (no installation required)

npx @google/gemini-cli

#### Install globally with npm

#### Install globally with Homebrew (macOS/Linux)

#### Install globally with MacPorts (macOS)

#### Install with Anaconda (for restricted environments)

Install Gemini CLI globally via npm (inside the environment)

npm install -g @google/gemini-cli ```

🚀 Getting Started

Getting Started

- Quickstart Guide - Get up and running quickly. - Authentication Setup - Detailed auth configuration. - Configuration Guide - Settings and customization. - Keyboard Shortcuts - Productivity tips.

Uninstall

See the Uninstall Guide for removal instructions.

Basic Usage

Start in current directory

gemini

Include multiple directories

gemini --include-directories ../lib,../docs

Use specific model

gemini -m gemini-2.5-flash

Non-interactive mode for scripts

Get a simple text response:

gemini -p "Explain the architecture of this codebase"

For more advanced scripting, including how to parse JSON and handle errors, use the --output-format json flag to get structured output:

gemini -p "Explain the architecture of this codebase" --output-format json

For real-time event streaming (useful for monitoring long-running operations), use --output-format stream-json to get newline-delimited JSON events:

gemini -p "Run tests and deploy" --output-format stream-json

Quick Examples

Start a new project

cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide

Analyze existing code

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday

Create and activate a new environment

conda create -y -n gemini_env -c conda-forge nodejs conda activate gemini_env

🔐 Authentication Options

Choose the authentication method that best fits your needs:

Option 1: Sign in with Google (OAuth login using your Google Account)

✨ Best for: Individual developers as well as anyone who has a Gemini Code Assist License. (see quota limits and terms of service for details)

Benefits:

• Free tier: 60 requests/min and 1,000 requests/day
• Gemini 3 models with 1M token context window
• No API key management - just sign in with your Google account
• Automatic updates to latest models

Start Gemini CLI, then choose Sign in with Google and follow the browser authentication flow when prompted

gemini

If you are using a paid Code Assist License from your organization, remember to set the Google Cloud Project

```bash

Option 2: Gemini API Key

✨ Best for: Developers who need specific model control or paid tier access

Benefits:

• Free tier: 1000 requests/day with Gemini 3 (mix of flash and pro)
• Model selection: Choose specific Gemini models
• Usage-based billing: Upgrade for higher limits when needed

```bash

Option 3: Vertex AI

✨ Best for: Enterprise teams and production workloads

Benefits:

• Enterprise features: Advanced security and compliance
• Scalable: Higher rate limits with billing account
• Integration: Works with existing Google Cloud infrastructure

```bash

Get your key from https://aistudio.google.com/apikey

export GEMINI_API_KEY="YOUR_API_KEY" gemini ```

Automation & Integration

- Automate operational tasks like querying pull requests or handling complex rebases - Use MCP servers to connect new capabilities, including media generation with Imagen, Veo or Lyria - Run non-interactively in scripts for workflow automation

GitHub Integration

Integrate Gemini CLI directly into your GitHub workflows with Gemini CLI GitHub Action:

- Pull Request Reviews: Automated code review with contextual feedback and suggestions - Issue Triage: Automated labeling and prioritization of GitHub issues based on content analysis - On-demand Assistance: Mention @gemini-cli in issues and pull requests for help with debugging, explanations, or task delegation - Custom Workflows: Build automated, scheduled and on-demand workflows tailored to your team's needs

Tools & Extensions

- Built-in Tools Overview - File System Operations - Shell Commands - Web Fetch & Search - MCP Server Integration - Extend with custom tools. - Custom Extensions - Build and share your own commands.

Troubleshooting & Support

- Troubleshooting Guide - Common issues and solutions. - FAQ - Frequently asked questions. - Use /bug command to report issues directly from the CLI.