CLI
El CLI de OpenCode proporciona acceso por línea de comandos a la funcionalidad de OpenCode. Por defecto, ejecutar opencode inicia la interfaz de usuario de terminal (TUI).
opencodePasa comandos para interacción programática:
opencode run "Explain how closures work in JavaScript"Flags del TUI
| Flag | Corto | Propósito |
|---|---|---|
--continue | -c | Continuar sesión anterior |
--session | -s | Especificar ID de sesión |
--prompt | — | Proporcionar prompt inicial |
--model | -m | Establecer modelo (provider/model) |
--agent | — | Seleccionar agente |
Comandos
run
Ejecutar OpenCode en modo no interactivo:
opencode run [message..]Flags:
--continue,-c: Continuar última sesión--model,-m: Establecer modelo--file,-f: Adjuntar archivo(s)--format: Salida comodefaultojson
auth
Gestionar credenciales:
opencode auth login # Configurar claves API
opencode auth list # Mostrar proveedores
opencode auth logout # Eliminar credencialesmodels
Listar modelos disponibles:
opencode models [provider]
opencode models --refresh # Actualizar lista en caché
opencode models --verbose # Mostrar costossession
Gestionar sesiones:
opencode session list
opencode session list --format jsonserve
Iniciar servidor HTTP sin cabeza:
opencode serve --port 4096web
Iniciar servidor con interfaz web:
opencode web --port 4096agent
Gestionar agentes:
opencode agent create # Crear agente personalizado
opencode agent list # Listar agentesmcp
Gestionar servidores MCP:
opencode mcp add # Agregar servidor
opencode mcp list # Mostrar servidores
opencode mcp auth # Autenticar
opencode mcp debug # Depurarstats
Mostrar estadísticas de uso:
opencode stats --days 30
opencode stats --modelsupgrade
Actualizar OpenCode:
opencode upgrade # Última versión
opencode upgrade v0.1.48 # Versión específicaFlags Globales
| Flag | Corto | Propósito |
|---|---|---|
--help | -h | Mostrar ayuda |
--version | -v | Imprimir versión |
--print-logs | — | Enviar logs a stderr |
--log-level | — | Establecer nivel (DEBUG, INFO, WARN, ERROR) |
Variables de Entorno
Configuración Principal
| Variable | Propósito |
|---|---|
OPENCODE_CONFIG | Ruta del archivo de configuración |
OPENCODE_CONFIG_DIR | Directorio de configuración |
OPENCODE_CONFIG_CONTENT | Configuración JSON inline |
Funciones
| Variable | Propósito |
|---|---|
OPENCODE_DISABLE_AUTOUPDATE | Desactivar actualizaciones |
OPENCODE_ENABLE_EXPERIMENTAL_MODELS | Habilitar modelos experimentales |
OPENCODE_DISABLE_AUTOCOMPACT | Desactivar compactación |