Guía de Configuración

Personalice Gemini CLI para adaptarse a su flujo de trabajo

Comandos de Configuración

Comandos esenciales para gestionar su configuración

gemini config list

Mostrar todas las configuraciones actuales

gemini config get <key>

Obtener el valor de una configuración específica

gemini config set <key> <value>

Establecer un valor de configuración

gemini config unset <key>

Eliminar una configuración (volver al valor por defecto)

gemini config reset

Restablecer todas las configuraciones a valores por defecto

gemini config export

Exportar configuración a un archivo

gemini config import <file>

Importar configuración desde un archivo

Opciones de Configuración

Configuraciones detalladas organizadas por categoría

Configuración API

Configurar claves API y ajustes de modelo

api-key

Requerido

Su clave API de Google AI

Tipo:string
Example:
gemini config set api-key YOUR_API_KEY

model

Modelo por defecto a usar

Tipo:string
Por defecto:gemini-pro
Example:
gemini config set model gemini-pro

temperature

Nivel de creatividad (0.0 a 1.0)

Tipo:number
Por defecto:0.7
Example:
gemini config set temperature 0.7

max-tokens

Longitud máxima de respuesta

Tipo:number
Por defecto:2048
Example:
gemini config set max-tokens 2048

Configuración de Interfaz

Personalizar la apariencia y comportamiento del CLI

theme

Tema de color para el CLI

Tipo:string
Por defecto:auto
Opciones:auto, light, dark
Example:
gemini config set theme dark

output-format

Formato de salida por defecto

Tipo:string
Por defecto:text
Opciones:text, markdown, json
Example:
gemini config set output-format markdown

stream

Habilitar respuestas en streaming

Tipo:boolean
Por defecto:true
Example:
gemini config set stream true

history-limit

Número de turnos de conversación a recordar

Tipo:number
Por defecto:10
Example:
gemini config set history-limit 20

Variables de Entorno

Configuración alternativa usando variables de entorno

Variables de Entorno Comunes

GEMINI_API_KEY=your_api_key

Clave API para autenticación

GEMINI_MODEL=gemini-pro

Modelo por defecto a usar

GEMINI_CONFIG_DIR=~/.config/gemini

Directorio de configuración

Configurar Variables de Entorno

Bash/Zsh:

export GEMINI_API_KEY=your_key

PowerShell:

$env:GEMINI_API_KEY="your_key"

Archivo .env:

GEMINI_API_KEY=your_key

Archivos de Configuración

Entender ubicaciones y formatos de archivos de configuración

File Locations

Config Global:

~/.config/gemini/config.json

Config Proyecto:

.gemini/config.json

Archivo Entorno:

.env

Example Config File

{
  "api-key": "your_api_key",
  "model": "gemini-pro",
  "temperature": 0.7,
  "max-tokens": 2048,
  "theme": "dark",
  "stream": true,
  "tools-enabled": true,
  "safe-mode": true
}

Mejores Prácticas

Recomendaciones para configuración segura y efectiva

Security

  • • Nunca hacer commit de claves API al control de versiones
  • • Usar variables de entorno para datos sensibles
  • • Habilitar modo seguro para ejecución de herramientas
  • • Rotar regularmente sus claves API
  • • Revisar y limitar permisos de herramientas

Performance

  • • Ajustar temperatura según el caso de uso
  • • Establecer límites de tokens apropiados
  • • Habilitar streaming para mejor UX
  • • Configurar timeouts razonables
  • • Limitar el tamaño del historial de conversación

Recursos Relacionados

Explore más guías de configuración y configuración

Guía de InstalaciónEjemplos de UsoSolución de Problemas