Guía del usuario en chino de Gemini CLI

Introducción básica

Gemini CLI es una herramienta de inteligencia artificial de línea de comandos de código abierto proporcionada por Google que lleva el poder de Gemini directamente a su terminal. Proporciona un acceso ligero a Gemini, brindándole la ruta más directa desde el indicador al modelo. Al configurar un relé (proxy), puede utilizar el servicio CLI de Gemini normalmente cuando la red está restringida.

🚀 ¿Por qué elegir Gemini CLI?

🧠 Potente Gemini 2.5 Pro: acceso a 1 millón de ventanas contextuales de tokens

🔧 Herramientas integradas: funciones básicas de búsqueda de Google, operaciones de archivos, comandos de Shell, rastreo web

🔌 Extensible: admite MCP (Protocolo de contexto de modelo) para una integración personalizada

💻 Terminal First: Diseñado para desarrolladores que trabajan en la línea de comandos

🛡️ Código abierto: Licencia Apache 2.0

📦 Método de instalación

Instalación rápida

Ejecutar instantáneamente usando npx (no requiere instalación)

# Usa el repositorio oficial
npx https://github.com/google-gemini/gemini-cli

Instalar globalmente usando npm

instalación npm -g @google/gemini-cli

Instalar usando Homebrew (macOS/Linux)

instalar cerveza gemini-cli

Requisitos del sistema

Node.js versión 20 o superior

MacOS, Linux o Windows

Configurar la estación de transferencia (agente) a utilizar

1. Establecer variables de entorno

Antes de utilizar la estación repetidora, debe configurar las siguientes variables de entorno:

# Establecer clave API
exportar GEMINI_API_KEY=sk-xxxxx

#Establecer dirección de estación de transferencia API
exportar GOOGLE_GEMINI_BASE_URL=https://yossapi.com

#cmd usa esto

establecer GEMINI_API_KEY=sk-xxxxx
establecer GOOGLE_GEMINI_BASE_URL=https://yossapi.com

Nota: También puede agregar estas variables de entorno a un .bashrc, .zshrc u otro archivo de configuración de shell para que se configuren automáticamente cada vez que inicie el terminal.

🚀 Inicio rápido

Uso básico

Comenzar en el directorio actual

geminis

Contiene varios directorios

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

Utilice un modelo específico

géminis -m géminis-2.5-flash

Script en modo no interactivo

Obtenga una respuesta de texto simple:

gemini -p "Explica la arquitectura de este código base"

Obtenga una salida JSON estructurada:

gemini -p "Explica la arquitectura de este código base" --formato de salida json

Ejemplo rápido

Iniciar un nuevo proyecto

cd nuevo-proyecto/
geminis
> Escribe un bot de Discord para mí que responda preguntas usando el archivo FAQ.md que proporciono

Analizar el código existente

clon de git https://github.com/google-gemini/gemini-cli
cd gemini-cli
geminis
> Dame un resumen de todos los cambios de ayer.

📋 Funciones principales

Comprensión y generación de código.

Consultar y editar grandes bases de código.

Utilice capacidades multimodales para generar nuevas aplicaciones a partir de archivos PDF, imágenes o bocetos.

Depuración y resolución de problemas utilizando lenguaje natural.

Automatización e Integración

Automatizar tareas operativas como consultar solicitudes de extracción o manejar operaciones complejas de cambio de base.

Nuevas funciones mediante conexión al servidor MCP

Ejecutar de forma no interactiva en scripts para la automatización del flujo de trabajo.

Funciones avanzadas

Obtenga información en tiempo real mediante la búsqueda integrada de Google

Puntos de control de conversación para guardar y restaurar conversaciones complejas

Archivo de contexto personalizado (GEMINI.md) para personalizar el comportamiento de su proyecto

Comandos comunes y ejemplos de funciones

Explora la base del código

> Describir los principales componentes de la arquitectura de este sistema.
> ¿Qué mecanismos de seguridad existen?
> Proporcionar a los nuevos desarrolladores un documento de introducción paso a paso

Trabajar con código existente

> Implementar un primer borrador para el número 123 de GitHub
> Ayúdame a migrar este código base a la última versión de Java. Primero haz un plan

Flujo de trabajo automatizado

> Haga una presentación de diapositivas que muestre los últimos 7 días del historial de git, agrupados por función y miembro del equipo
> Crear una aplicación web de pantalla completa para una exhibición en la pared que muestre nuestros problemas de GitHub más interactivos

Interacción del sistema

> Convierta todas las imágenes en este directorio a png y cámbieles el nombre usando fechas de datos exif
> Organizar mis facturas en PDF por mes de gasto

Integración de GitHub

Integre la CLI de Gemini directamente en su flujo de trabajo de GitHub usando la Acción de GitHub de la CLI de Gemini:

Revisión de solicitud de extracción: revisión de código automatizada con sugerencias y comentarios contextuales

Clasificación de problemas: etiquetar y priorizar automáticamente los problemas de GitHub según el análisis de contenido

Ayuda bajo demanda: mencione @gemini-cli en problemas y solicitudes de extracción para obtener ayuda con la depuración, explicación o delegación de tareas.

Flujos de trabajo personalizados: cree flujos de trabajo automatizados, programados y bajo demanda que se ajusten a las necesidades de su equipo

Solución de problemas

Si encuentra problemas durante el uso, puede consultar los siguientes puntos:

Compruebe si las variables de entorno están configuradas correctamente:

eco $GEMINI_API_KEY
eco $GOOGLE_GEMINI_BASE_URL

Compruebe si la conexión de red es estable y si se puede acceder a la estación de transferencia:

rizo -yo https://yossapi.com

Compruebe si aparece algún mensaje de error, estos mensajes generalmente indican el problema

Si usa el proxy SOCKS, asegúrese de que el formato del proxy sea correcto, por ejemplo socks5://<usuario>:<contraseña>@<proxy>:<puerto>

Informar un problema usando comandos integrados:

# Informar errores directamente en la CLI
/error

Notas de la versión

Vista previa

Se publican nuevas versiones preliminares todos los martes a las 23:59 UTC. Instale usando la etiqueta preview:

instalación npm -g @google/gemini-cli@preview

Versión estable (Estable)

Cada martes a las 20:00 UTC se lanzan nuevas versiones estables. Instale usando la etiqueta latest:

instalación npm -g @google/gemini-cli@latest

Todas las noches

Los lanzamientos nocturnos se publican diariamente a las 00:00 UTC. Instale usando la etiqueta nightly:

instalación npm -g @google/gemini-cli@nightly

Uso del servidor MCP

Configure el servidor MCP en ~/.gemini/settings.json para ampliar la CLI de Gemini con herramientas personalizadas:

> @github enumera mis solicitudes de extracción abiertas
> @slack Envía un resumen del compromiso de hoy al canal #dev
> @database ejecuta una consulta para encontrar usuarios inactivos

📚 Recursos relacionados

Hoja de ruta oficial: consulte las próximas funciones

Paquetes NPM: registro de paquetes

Problemas de GitHub: informar un error o solicitar una función

Recomendación de seguridad: Actualizaciones de seguridad

Desinstalar

Si necesita desinstalar Gemini CLI, consulte la guía de desinstalación oficial.

Tutorial de configuración y uso de la estación de transferencia CLI de Gemini

Guía del usuario en chino de Gemini CLI#

Introducción básica#

🚀 ¿Por qué elegir Gemini CLI?#

📦 Método de instalación#

Instalación rápida#

Ejecutar instantáneamente usando npx (no requiere instalación)#

Instalar globalmente usando npm#

Instalar usando Homebrew (macOS/Linux)#

Requisitos del sistema#

Configurar la estación de transferencia (agente) a utilizar#

1. Establecer variables de entorno#

🚀 Inicio rápido#

Uso básico#

Comenzar en el directorio actual#

Contiene varios directorios#

Utilice un modelo específico#

Script en modo no interactivo#

Ejemplo rápido#

Iniciar un nuevo proyecto#

Analizar el código existente#

📋 Funciones principales#

Comprensión y generación de código.#

Automatización e Integración#

Funciones avanzadas#

Comandos comunes y ejemplos de funciones#

Explora la base del código#

Trabajar con código existente#

Flujo de trabajo automatizado#

Interacción del sistema#

Integración de GitHub#

Solución de problemas#

Notas de la versión#

Vista previa#

Versión estable (Estable)#

Todas las noches#

Uso del servidor MCP#

📚 Recursos relacionados#

Desinstalar#