Gemini CLI Chinese Usage Guide

Basic Introduction

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

🚀 Why Choose Gemini CLI?

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

🔧 Built-in tools: Google Search grounding, file operations, shell commands, web scraping

🔌 Extensible: Supports 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

Configure 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 the current directory

Include multiple directories

Use a specific model

Script non-interactive mode

Get a 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 using natural language

Automation and Integration

Automate operational tasks such as querying pull requests or handling complex rebases

Connect new capabilities using MCP servers

Run non-interactively in scripts for workflow automation

Advanced Features

Use built-in Google Search to get real-time information

Conversation checkpoints to save and restore complex sessions

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

Common Commands and Feature Examples

Explore the codebase

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

Work with existing code

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

Automate workflows

> Create a slide deck showing the git history of the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interacted 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

Use Gemini CLI GitHub Action to integrate Gemini CLI directly into your GitHub workflow:

Pull request review: Automated code review with contextual feedback and suggestions

Issue triage: Automatically label and prioritize GitHub issues based on content analysis

On-demand help: 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

Troubleshooting

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

Check whether the environment variables are set correctly:

Check whether the network connection is stable and the relay station is accessible:

Check whether there is error information output, which usually indicates where the problem is

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

Use built-in commands to report issues:

Release Notes

Preview

A new preview version is released every Tuesday at 23:59 UTC. Install using the preview tag:

Stable

A new stable version is released every Tuesday at 20:00 UTC. Install using the latest tag:

Nightly

A nightly version is 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's custom tools:

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

Official Roadmap: View upcoming features

NPM Package: Package registry

GitHub Issues: Report bugs or request features

Security Advisories: 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#

Configure Relay Station (Proxy) Usage#

1. Set Environment Variables#

🚀 Quick Start#

Basic Usage#

Start in the current directory#

Include multiple directories#

Use a 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 the codebase#

Work with existing code#

Automate workflows#

System interaction#

GitHub Integration#

Troubleshooting#

Release Notes#

Preview#

Stable#

Nightly#

MCP Server Usage#

📚 Related Resources#

Uninstall#