Uso de OpenCode CLI

OpenCode ofrece una potente interfaz de línea de comandos (CLI) que no solo puede iniciar la TUI interactiva, sino que también permite automatizar y realizar operaciones mediante scripts a través de comandos.

De forma predeterminada, OpenCode CLI inicia la TUI, pero su verdadera capacidad reside en la invocación programática.

OpenCode CLI no es solo una herramienta de comandos, sino una interfaz de desarrollo de IA programable.

OpenCode CLI se puede abstraer en tres capas:

Capa de interacción：tui / web / attach
Capa de ejecución：run / agent / mcp / github
Capa de servicio：serve / acp

👉 En esencia es unAgente de IA + entorno de desarrollo local + CLI programable + API de servidorpunto de entrada unificado.

A continuación se muestra la tabla completa de comandos de OpenCode CLI:

Comportamiento básico

Comando / Uso	Descripción	Nota
`opencode`	Iniciar TUI de forma predeterminada	Sin parámetros
`opencode run "msg"`	Ejecutar tareas de forma no interactiva	Automatización / Script

Parámetros de inicio de tui

Banderas	Abreviatura	Descripción
`--continue`	`-c`	Continuar la última sesión
`--session`	`-s`	Especificar ID de sesión
`--fork`	—	Bifurcar sesión
`--prompt`	—	Prompt inicial
`--model`	`-m`	Especificar modelo
`--agent`	—	Especificar agente
`--port`	—	Puerto de escucha
`--hostname`	—	Dirección del host

Comandos principales de CLI

Comando	Descripción	Subcomandos clave
`agent`	Gestionar agentes	create / list
`auth`	Gestionar autenticación	login / list / logout
`attach`	Conectar al backend remoto	—
`github`	Automatización de GitHub	install / run
`mcp`	Gestión de servicios MCP	add / list / auth / debug
`models`	Ver lista de modelos	—
`run`	Ejecución no interactiva	—
`serve`	Iniciar servicio API	—
`web`	Servicio de Web UI	—
`session`	Gestión de sesiones	list
`stats`	Estadísticas de tokens/costos	—
`export`	Exportar sesión	—
`import`	Importar sesión	—
`acp`	Iniciar servicio de protocolo ACP	—
`uninstall`	Desinstalar	—
`upgrade`	Actualizar versión	—

Parámetros del comando run

Banderas	Abreviatura	Descripción
`--continue`	`-c`	Continuar sesión
`--session`	`-s`	Especificar sesión
`--fork`	—	Bifurcar
`--share`	—	Compartir sesión
`--model`	`-m`	Especificar modelo
`--agent`	—	Especificar agente
`--file`	`-f`	Adjuntar archivo
`--format`	—	Formato de salida (json)
`--title`	—	Título de la sesión
`--attach`	—	Conectar a un servicio existente
`--port`	—	Puerto local

Parámetros de comandos de servicio

serve / web / acp

Banderas	Descripción
`--port`	Puerto de escucha
`--hostname`	Dirección del host
`--mdns`	Descubrimiento en LAN
`--cors`	Permitir CORS

Parámetros de session / stats

Comando Banderas Descripción

session `--max-count (-n)` Últimos N registros

session `--format` table/json

stats `--days` Últimos N días

stats `--tools` Estadísticas de herramientas

stats `--models` Uso de modelos

stats `--project` Filtro por proyecto

Comando	Banderas	Descripción
session	`--max-count (-n)`	Últimos N registros
session	`--format`	table/json
stats	`--days`	Últimos N días
stats	`--tools`	Estadísticas de herramientas
stats	`--models`	Uso de modelos
stats	`--project`	Filtro por proyecto

Banderas globales

Banderas	Abreviatura	Descripción
`--help`	`-h`	Ayuda
`--version`	`-v`	Versión
`--print-logs`	—	Salida de registros
`--log-level`	—	Nivel de registro

Variables de entorno

Variable	Tipo	Función
`OPENCODE_AUTO_SHARE`	boolean	Compartir automáticamente
`OPENCODE_CONFIG`	string	Ruta de configuración
`OPENCODE_TUI_CONFIG`	string	Configuración de TUI
`OPENCODE_DISABLE_AUTOUPDATE`	boolean	Deshabilitar actualizaciones
`OPENCODE_SERVER_PASSWORD`	string	Autenticación de API
`OPENCODE_MODELS_URL`	string	Origen del modelo

Funciones experimentales

Variable	Tipo	Función
`OPENCODE_EXPERIMENTAL`	boolean	Habilitar todas las funciones experimentales
`OPENCODE_EXPERIMENTAL_LSP_TOOL`	boolean	Herramientas LSP
`OPENCODE_EXPERIMENTAL_PLAN_MODE`	boolean	Modo de planificación
`OPENCODE_EXPERIMENTAL_FILEWATCHER`	boolean	Vigilancia de archivos

I. Uso básico

1. Iniciar TUI (comportamiento predeterminado)

opencode

Equivale a entrar en la interfaz de terminal interactiva

2. Especificar el directorio del proyecto

opencode /path/to/project

Iniciar TUI en el directorio especificado, por ejemplo, iniciar en el directorio opencode-ejemplo-test:

opencode opencode-ejemplo-test

3. Modo no interactivo (llamada desde script)

opencode run 解释一下 JavaScript 中闭包的原理

Devuelve el resultado directamente sin entrar en la interfaz.

II. Capacidades principales de CLI

Las capacidades principales de OpenCode CLI se pueden resumir en tres categorías:

Modo interactivo:TUI (predeterminado)
Ejecución de comandos:run / serve
Gestión del sistema:agent / auth / session, etc.

III. Parámetros comunes (Flags)

Parámetro	Abreviatura	Descripción
--continue	-c	Continuar la sesión anterior
--session	-s	Especificar ID de sesión
--fork		Bifurcar desde la sesión actual
--model	-m	Especificar modelo (provider/model)
--agent		Especificar agente
--port		Puerto de servicio
--hostname		Dirección de escucha

IV. Explicación detallada de los comandos principales

1. run (el más utilizado)

Se usa para ejecución no interactiva:

opencode run 分析这个 Go 项目的上下文使用方式

Escenarios aplicables:

Automatización con scripts
CI/CD
Preguntas y respuestas rápidas

Conectar al servicio en segundo plano (evitar arranque en frío)

# 启动后台服务
opencode serve

# 使用 run 连接
opencode run --attach http://localhost:4096 解释 async/await

Parámetros comunes

Parámetro	Descripción
--model	Especificar modelo
--file	Adjuntar archivo
--format	Formato de salida (json / predeterminado)
--share	Compartir sesión

V. auth (gestión de autenticación)

Iniciar sesión

opencode auth login

Configurar la clave de API (se almacena localmente)

Ver proveedores con sesión iniciada

opencode auth list

Cerrar sesión

opencode auth logout

VI. models (gestión de modelos)

Ver todos los modelos

opencode models

Filtrar por proveedor

opencode models anthropic

Actualizar la lista de modelos

opencode models --refresh

VII. agent (sistema de agentes)

Crear agente

opencode agent create

Puede personalizar el prompt + herramientas

Ver agente

opencode agent list

VIII. session (gestión de sesiones)

Ver sesiones

opencode session list

Limitar cantidad

opencode session list -n 10

IX. serve (modo servicio)

Iniciar el servicio API:

opencode serve

Proporciona interfaz HTTP (sin interfaz gráfica)

Parámetros opcionales:

--port: puerto
--hostname: dirección de escucha

X. web (Web UI)

opencode web

Iniciar la versión con interfaz web

XI. mcp (capacidad de extensión)

Agregar servicio MCP

opencode mcp add

Ver lista

opencode mcp list

MCP se utiliza para extender las capacidades de IA (como llamadas a herramientas)

XII. stats (estadísticas de uso)

opencode stats

Ver uso de Token y costos

XIII. export / import

Exportar sesión

opencode export

Importar sesión

opencode import session.json

XIV. Actualización y desinstalación

Actualizar

opencode upgrade

Desinstalar

opencode uninstall

XV. Parámetros globales

Parámetro	Descripción
--help	Ver ayuda
--version	Ver versión
--log-level	Nivel de registro

XVI. Variables de entorno (configuración avanzada)

OpenCode admite controlar el comportamiento mediante variables de entorno, por ejemplo:

OPENCODE_DISABLE_AUTOUPDATE=true
OPENCODE_SERVER_PASSWORD=123456

Usos comunes:

Desactivar actualización automática
Configurar autenticación del servicio
Ruta de configuración personalizada

XVII. Recomendaciones de uso (importante)

Usar TUI para desarrollo diario
Usar run para automatización
Combinar agent para tareas complejas
Usar serve + attach para llamadas de alta frecuencia

Otras extensiones