beginner30 minLección 4 de 5

Comprendiendo la Interfaz CLI

Domina la interfaz de línea de comandos de OpenCode. Aprende todos los comandos disponibles, indicadores, opciones y cómo navegar la sesión interactivamente de manera efectiva.

Comprendiendo la Interfaz CLI

Estructura de Comandos

OpenCode sigue una estructura CLI estándar:

bash
opencode [command] [options] [arguments]

Comandos Principales

ComandoDescripciónEjemplo
opencodeIniciar sesión interactivaopencode
opencode chatIniciar sesión de chatopencode chat
opencode runEjecutar una sola indicaciónopencode run "fix the bug"
opencode configGestionar configuraciónopencode config list
opencode providersListar proveedores LLMopencode providers
opencode skillsListar habilidades disponiblesopencode skills
opencode versionMostrar versiónopencode --version

Comandos de Sesión Interactiva

Una vez en una sesión interactiva, use estos comandos:

Navegación

ComandoDescripción
/helpMostrar todos los comandos disponibles
/quit o /exitSalir de OpenCode
/clearLimpiar conversación actual
/historyVer historial de conversación
/save [name]Guardar sesión en archivo
/load [name]Cargar sesión guardada

Gestión de Sesión

ComandoDescripción
/model [name]Cambiar modelo LLM
/agent [name]Cambiar agente
/skill [name]Cargar una habilidad específica
/debugAlternar modo de depuración
/verboseAlternar salida detallada

Opciones de Línea de Comandos

Opciones Globales

OpciónDescripción
-h, --helpMostrar ayuda
-v, --versionMostrar versión
-c, --config [path]Especificar archivo de configuración
-p, --provider [name]Establecer proveedor LLM
-m, --model [name]Establecer modelo
--debugHabilitar modo de depuración
--verboseHabilitar salida detallada

Opciones del Comando Run

OpciónDescripción
-f, --file [path]Leer entrada desde archivo
-o, --output [path]Escribir salida a archivo
--no-colorDeshabilitar salida coloreada
--timeout [ms]Establecer tiempo de espera en milisegundos

Patrones de Uso de Ejemplo

Ejecución de Una Sola Indicación

bash
opencode run "Explain what this function does"

Leer desde Archivo

bash
opencode run -f question.txt

Escribir a Archivo

bash
opencode run -o answer.md "Write a README for this project"

Modo de Depuración

bash
opencode --debug

La salida de depuración muestra:

  • Solicitudes y respuestas de API
  • Invocaciones de herramientas
  • Verificaciones de permisos
  • Decisiones de enrutamiento de agentes

Completado con Tabulador

OpenCode soporta completado con tabulador para:

  • Comandos (/he/help)
  • Rutas de archivos (/read src/ma/read src/main.py)
  • Nombres de modelos (/model gpt/model gpt-4o)

Atajos de Teclado

AtajoAcción
EnterEnviar mensaje
Ctrl+CCancelar operación actual
Ctrl+DSalir de sesión
Ctrl+LLimpiar pantalla
Flecha ArribaComando anterior
Flecha AbajoSiguiente comando
TabAutocompletado

Variables de Entorno

VariableDescripción
OPENCODE_CONFIGRuta al archivo de configuración
OPENCODE_PROVIDERProveedor LLM predeterminado
OPENCODE_MODELModelo predeterminado
OPENCODE_DEBUGHabilitar modo de depuración
OPENAI_API_KEYClave API de OpenAI
ANTHROPIC_API_KEYClave API de Anthropic
GOOGLE_API_KEYClave API de Google

Practice Questions

Practice Question

¿Qué comando ejecuta OpenCode con una sola indicación sin entrar en modo interactivo?

Practice Question

¿Qué opción habilita el modo de depuración desde la línea de comandos?

Practice Question

¿Cómo cambia de modelos durante una sesión interactiva?

Practice Question

¿Qué atajo de teclado cancela la operación actual?

Practice Question

¿Qué hace el indicador -f en el comando run?


Success

Key Takeaways

  • OpenCode soporta modos de ejecución tanto interactivos como de una sola indicación
  • Use /help en modo interactivo para ver todos los comandos disponibles
  • El indicador --debug muestra información detallada sobre las operaciones de IA
  • El completado con tabulador funciona para comandos, rutas de archivos y nombres de modelos
  • Las variables de entorno pueden configurar valores predeterminados para proveedor y modelo
  • Los atajos de teclado proporcionan acceso rápido a acciones comunes
  • El indicador -f permite leer indicaciones desde archivos para procesamiento por lotes
Progreso80%