OpenCode

OpenCode es un asistente de programación para la terminal. VirtuAI puede aparecer en él como proveedor de modelos. No eliges un modelo sin más: eliges uno de tus agentes de VirtuAI, y su prompt del sistema, su modelo y sus herramientas se mantienen tal como los configuraste en VirtuAI.

El agente se ejecuta en VirtuAI. Cuando quiere leer un archivo, editar código o ejecutar un comando, OpenCode lo hace en tu máquina, en la carpeta que abriste. VirtuAI nunca lee tu disco directamente.

Antes de comenzar

OpenCode instalado
La CLI de VirtuAI, vinculada con tu espacio de trabajo. Consulta CLI de VirtuAI.
Al menos un agente con Web Chatbot activado y Harness configurado como Deep en Deep Agent Mode. Solo estos agentes se ofrecen a OpenCode.

Configuración

Actualiza la CLI y vincúlala, si aún no lo hiciste:

pipx upgrade virtuai-cli
virtuai pair <CODE> --server https://<your-virtuai-host>

Conecta OpenCode:
Ventana de terminal
```
virtuai opencode
```
Esto agrega un proveedor virtuai a ~/.config/opencode/opencode.json, muestra tus agentes como sus modelos y asigna las ranuras build y plan de OpenCode a tus agentes Build y Plan. Tus otros proveedores, complementos y servidores MCP no se modifican.
Revisa las líneas workspace y credential que se imprimen. Indican de qué espacio de trabajo son los agentes que obtuviste.
Reinicia OpenCode si se estaba ejecutando.

Vuelve a ejecutar virtuai opencode cada vez que agregues agentes o les cambies el nombre y, luego, reinicia OpenCode.

Uso diario

Usa cd para entrar en tu proyecto e inicia OpenCode.
Elige un agente de VirtuAI como modelo o usa los agentes build y plan.
Trabaja como siempre. El agente conoce tu carpeta de trabajo y sabe si es un repositorio de Git.

Agente	Qué puede hacer en tu disco
Plan y cualquier agente marcado como de solo lectura	Solo leer y buscar. VirtuAI lo aplica de forma obligatoria, independientemente de lo que permita OpenCode.
Build y los demás agentes	Leer, buscar, editar archivos y ejecutar comandos

Cada sesión de OpenCode tiene su propia conversación con cada agente. Cuando cambias de Plan a Build en una sesión, Build comienza con el plan a la vista, así que puedes decir simplemente “Proceed”. Eso solo sucede la primera vez que se usa Build en la sesión. Si vuelves atrás y cambias el plan, pídele a Build que lo vuelva a leer.

Permisos

Mantén bash y edit permitidos para Build en OpenCode. Si OpenCode los rechaza, el agente no puede cambiar nada.

Costo y contexto

El monto en dólares que muestra OpenCode es su propia estimación, y es más bajo que el real. Los presupuestos y el uso de tu espacio de trabajo en VirtuAI son las cifras reales.
VirtuAI compacta la conversación por su cuenta cuando se acerca al límite del modelo, por lo que la compactación automática de OpenCode está desactivada. La barra de contexto puede bajar sola cuando eso sucede. /compact sigue funcionando.

Protege el token

OpenCode no puede leer el llavero del sistema, así que virtuai opencode escribe una copia de tu token de la CLI en opencode.json, que solo tú puedes leer. Trata ese archivo como una contraseña: no lo confirmes en un repositorio ni lo compartas.

virtuai unpair no quita esa copia. Borra tú mismo el bloque provider.virtuai de opencode.json.

Solución de problemas

La lista de modelos está vacía : Solo aparecen los agentes con Web Chatbot activado y el harness Deep. También ejecuta virtuai status para verificar el servidor y el espacio de trabajo.

Aparecen agentes del espacio de trabajo equivocado : El espacio de trabajo viene con tu credencial. virtuai opencode prueba primero tu token de vinculación y, luego, tu token de inicio de sesión. Vuelve a vincular desde el espacio de trabajo que quieres y, luego, ejecuta virtuai opencode.

Errores 401 sin motivo aparente : Alguien vinculó otra máquina al espacio de trabajo, lo que reemplaza el token. Ejecuta virtuai pair <CODE>, luego virtuai opencode y reinicia OpenCode.

El agente indica que no puede editar ni escribir archivos : OpenCode cambia sus herramientas de edición cuando el ID del modelo contiene gpt-. Los IDs de tus modelos son IDs de agentes, así que cambia el nombre del agente.

Los agentes nuevos no aparecen : Vuelve a ejecutar virtuai opencode y reinicia OpenCode.