Gemini CLI Chinese Usage Guide

Basic Introduction

Gemini CLI is an open-source command-line AI tool provided by Google that brings the powerful capabilities of Gemini directly to your terminal. It provides a lightweight way to access Gemini, offering you the most direct path from prompt to model. By setting up a relay station (proxy), you can use Gemini CLI service normally even in network-restricted environments.

🚀 Why Choose Gemini CLI?

🧠 Powerful Gemini 2.5 Pro: Access 1 million token context window

🔧 Built-in Tools: Google Search basic functionality, file operations, Shell commands, web scraping

🔌 Extensible: Support for MCP (Model Context Protocol) for custom integrations

💻 Terminal-First: Designed for developers working in the command line

🛡️ Open Source: Apache 2.0 License

📦 Installation Methods

Quick Installation

Run Instantly with npx (No Installation Required)

Global Installation with npm

Installation with Homebrew (macOS/Linux)

System Requirements

Node.js version 20 or higher

macOS, Linux, or Windows

Configuring Relay Station (Proxy) Usage

1. Set Environment Variables

Before using the relay station, you need to configure the following environment variables:

Note: You can also add these environment variables to .bashrc, .zshrc, or other shell configuration files so that they are automatically set each time you start the terminal.

🚀 Quick Start

Basic Usage

Start in Current Directory

Include Multiple Directories

Use Specific Model

Script Non-Interactive Mode

Get simple text response:

Get structured JSON output:

Quick Examples

Start a New Project

Analyze Existing Code

📋 Main Features

Code Understanding and Generation

Query and edit large codebases

Use multimodal capabilities to generate new applications from PDFs, images, or sketches

Debug issues and troubleshoot problems using natural language

Automation and Integration

Automate operational tasks such as querying pull requests or handling complex rebase operations

Connect new features using MCP servers

Run non-interactively in scripts to automate workflows

Advanced Features

Get real-time information using built-in Google Search

Conversation checkpoints to save and restore complex sessions

Custom context files (GEMINI.md) to customize behavior for your project

Common Commands and Feature Examples

Explore Codebase

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Work with Existing Code

> Implement a draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. First, make a plan

Automate Workflows

> Create a slideshow showing git history from the past 7 days, grouped by feature and team member
> Create a full-screen web application for wall display showing our most interactive GitHub issues

System Interaction

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by expense month

GitHub Integration

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

Pull Request Review: Automatic code review with contextual feedback and suggestions

Issue Triage: Automatically tag and prioritize GitHub issues based on content analysis

On-Demand Help: Mention @gemini-cli in issues and pull requests for help with debugging, explanation, or task delegation

Custom Workflows: Build automated, scheduled, and on-demand workflows tailored to your team's needs

Troubleshooting

If you encounter problems during use, you can refer to the following points:

Check if environment variables are set correctly:

Check if network connection is stable and relay station is accessible:

Check for error messages, which usually indicate the problem

If using SOCKS proxy, ensure the proxy format is correct, for example socks5://<user>:<pass>@<proxy>:<port>

Use built-in command to report issues:

Release Notes

Preview

New preview versions are released every Tuesday at 23:59 UTC. Install using the preview tag:

Stable

New stable versions are released every Tuesday at 20:00 UTC. Install using the latest tag:

Nightly

Nightly versions are released every day at 00:00 UTC. Install using the nightly tag:

MCP Server Usage

Configure MCP servers in ~/.gemini/settings.json to extend Gemini CLI with custom tools:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

Official Roadmap: Check out upcoming features

NPM Package: Package registry

GitHub Issues: Report bugs or request features

Security Advisory: Security updates

Uninstall

If you need to uninstall Gemini CLI, please refer to the official uninstall guide.

Gemini CLI Relay Station Configuration and Usage Tutorial

Gemini CLI Chinese Usage Guide#

Basic Introduction#

🚀 Why Choose Gemini CLI?#

📦 Installation Methods#

Quick Installation#

Run Instantly with npx (No Installation Required)#

Global Installation with npm#

Installation with Homebrew (macOS/Linux)#

System Requirements#

Configuring Relay Station (Proxy) Usage#

1. Set Environment Variables#

🚀 Quick Start#

Basic Usage#

Start in Current Directory#

Include Multiple Directories#

Use Specific Model#

Script Non-Interactive Mode#

Quick Examples#

Start a New Project#

Analyze Existing Code#

📋 Main Features#

Code Understanding and Generation#

Automation and Integration#

Advanced Features#

Common Commands and Feature Examples#

Explore Codebase#

Work with Existing Code#

Automate Workflows#

System Interaction#

GitHub Integration#

Troubleshooting#

Release Notes#

Preview#

Stable#

Nightly#

MCP Server Usage#

📚 Related Resources#

Uninstall#