Volver al Blog
2026-03-27Actualizado el 2026-11-15
Toolsify Editorial Team
Developer Tools

OpenCode: configura un agente de programación para tu repositorio

AI CodingOpen SourceDeveloper ToolsCode AssistantOpenCodeopencode the open source ai coding agent
Sponsored

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.

Sponsored