OpenCode: configura un agente de programación para tu repositorio
OpenCode es un agente de programación de código abierto con interfaces de terminal, escritorio y web. Su utilidad depende del modelo conectado y del contexto del repositorio que recibe. Esta guía sigue la documentación de v2 consultada el 15 de noviembre de 2026; los tutoriales antiguos pueden utilizar otros campos. La guía de instalación describe los paquetes compatibles y el comando /connect.
Conecta el repositorio y el proveedor
Instala una versión adecuada para tu sistema, abre el directorio del proyecto y ejecuta opencode. Usa /connect para configurar un proveedor disponible en tu cuenta. Que el cliente funcione no significa que el modelo sea gratuito: siguen aplicándose la facturación y las condiciones de tratamiento de datos del proveedor.
Crea opencode.jsonc en el repositorio y añade el esquema siguiente. La referencia de configuración explica los ajustes del proyecto, globales y administrados. Revisa esas capas cuando una opción parezca no funcionar; la configuración administrada puede prevalecer. Mantén las credenciales fuera de los archivos versionados.
Delimita la ejecución de comandos
Este ejemplo de v2 pide confirmación para comandos de shell, bloquea los envíos y pregunta antes de acceder a directorios externos:
{
"$schema": "https://opencode.ai/config.json",
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git push *", "effect": "deny" },
{ "action": "external_directory", "resource": "*", "effect": "ask" }
]
}
Prevalece la última regla coincidente; revisa también las modificaciones específicas del agente. Son permisos de herramientas, no un aislamiento del sistema operativo. La referencia de permisos explica las acciones y la coincidencia de patrones.
Investiga un fallo concreto
Para un formulario que se envía dos veces, comienza con Plan: «Rastrea el controlador de envío y la petición de red. Explica por qué un clic genera dos peticiones y propone la corrección mínima». Plan evita editar archivos normales del proyecto, pero sus comandos siguen sujetos a permisos. Build realiza la implementación, según la referencia de agentes.
Entrega a Build los archivos afectados y estos criterios: una petición por clic, validación sin cambios y una comprobación de regresión del envío repetido. Pide reutilizar el marco de pruebas existente y mostrar la salida real de los comandos. Una explicación convincente no demuestra que el código sea correcto.
Revisa antes de adoptar
Inspecciona git diff, ejecuta la prueba pertinente y las comprobaciones exigidas, y revisa cambios inesperados en dependencias o archivos generados. Conserva un punto de partida limpio en Git: deshacer archivos no revierte operaciones remotas ni cambios en bases de datos. Compara proveedores con el mismo fallo y registra tiempo de revisión, errores pendientes y costes reales. Así obtienes una base de selección útil, sin inventar puntuaciones ni asumir que todos los modelos se comportan igual.