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.
Estructura de Comandos
OpenCode sigue una estructura CLI estándar:
opencode [command] [options] [arguments]Comandos Principales
Comando | Descripción | Ejemplo |
|---|---|---|
opencode | Iniciar sesión interactiva | opencode |
opencode chat | Iniciar sesión de chat | opencode chat |
opencode run | Ejecutar una sola indicación | opencode run "fix the bug" |
opencode config | Gestionar configuración | opencode config list |
opencode providers | Listar proveedores LLM | opencode providers |
opencode skills | Listar habilidades disponibles | opencode skills |
opencode version | Mostrar versión | opencode --version |
Comandos de Sesión Interactiva
Una vez en una sesión interactiva, use estos comandos:
Navegación
Comando | Descripción |
|---|---|
/help | Mostrar todos los comandos disponibles |
/quit o /exit | Salir de OpenCode |
/clear | Limpiar conversación actual |
/history | Ver historial de conversación |
/save [name] | Guardar sesión en archivo |
/load [name] | Cargar sesión guardada |
Gestión de Sesión
Comando | Descripción |
|---|---|
/model [name] | Cambiar modelo LLM |
/agent [name] | Cambiar agente |
/skill [name] | Cargar una habilidad específica |
/debug | Alternar modo de depuración |
/verbose | Alternar salida detallada |
Opciones de Línea de Comandos
Opciones Globales
Opción | Descripción |
|---|---|
-h, --help | Mostrar ayuda |
-v, --version | Mostrar versión |
-c, --config [path] | Especificar archivo de configuración |
-p, --provider [name] | Establecer proveedor LLM |
-m, --model [name] | Establecer modelo |
--debug | Habilitar modo de depuración |
--verbose | Habilitar salida detallada |
Opciones del Comando Run
Opción | Descripción |
|---|---|
-f, --file [path] | Leer entrada desde archivo |
-o, --output [path] | Escribir salida a archivo |
--no-color | Deshabilitar salida coloreada |
--timeout [ms] | Establecer tiempo de espera en milisegundos |
Patrones de Uso de Ejemplo
Ejecución de Una Sola Indicación
opencode run "Explain what this function does"Leer desde Archivo
opencode run -f question.txtEscribir a Archivo
opencode run -o answer.md "Write a README for this project"Modo de Depuración
opencode --debugLa 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
Atajo | Acción |
|---|---|
Enter | Enviar mensaje |
Ctrl+C | Cancelar operación actual |
Ctrl+D | Salir de sesión |
Ctrl+L | Limpiar pantalla |
Flecha Arriba | Comando anterior |
Flecha Abajo | Siguiente comando |
Tab | Autocompletado |
Variables de Entorno
Variable | Descripción |
|---|---|
OPENCODE_CONFIG | Ruta al archivo de configuración |
OPENCODE_PROVIDER | Proveedor LLM predeterminado |
OPENCODE_MODEL | Modelo predeterminado |
OPENCODE_DEBUG | Habilitar modo de depuración |
OPENAI_API_KEY | Clave API de OpenAI |
ANTHROPIC_API_KEY | Clave API de Anthropic |
GOOGLE_API_KEY | Clave API de Google |
Preguntas de Práctica (Practice Questions)
Cómo responder
Pregunta de opción múltiple con 4 opciones. Selecciona una opción y elige Comprobar respuesta.
¿Qué comando ejecuta OpenCode con una sola indicación sin entrar en modo interactivo?
Cómo responder
Pregunta de opción múltiple con 4 opciones. Selecciona una opción y elige Comprobar respuesta.
¿Qué opción habilita el modo de depuración desde la línea de comandos?
Cómo responder
Pregunta de opción múltiple con 4 opciones. Selecciona una opción y elige Comprobar respuesta.
¿Cómo cambia de modelos durante una sesión interactiva?
Cómo responder
Pregunta de opción múltiple con 4 opciones. Selecciona una opción y elige Comprobar respuesta.
¿Qué atajo de teclado cancela la operación actual?
Cómo responder
Pregunta de opción múltiple con 4 opciones. Selecciona una opción y elige Comprobar respuesta.
¿Qué hace el indicador -f en el comando run?
Key Takeaways
- OpenCode soporta modos de ejecución tanto interactivos como de una sola indicación
- Use
/helpen modo interactivo para ver todos los comandos disponibles - El indicador
--debugmuestra 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
-fpermite leer indicaciones desde archivos para procesamiento por lotes