Permisos de OpenCode: 7 decisiones seguras antes de saltar avisos

El valor seguro para los permisos de OpenCode es preguntar al principio, permitir solo acciones repetidas y reversibles, y denegar rutas o comandos que serían costosos de reparar. La documentación oficial distingue allow, ask y deny; también explica que --auto aprueba solicitudes que no estén denegadas explícitamente. Por eso --auto es una comodidad, no una política de seguridad.

Los datos de Similarweb agrupan la intención alrededor de saltar permisos, permitir siempre y resolver avisos repetidos. El usuario no busca teoría: quiere reducir confirmaciones sin abrir la puerta a comandos destructivos.

Esta guía separa permisos, agentes, MCP, VS Code y CI. El objetivo es mantener fluido el trabajo normal, pero dejar visibles las acciones que tocan secretos, rutas externas, despliegues o cambios difíciles de revertir.

OpenCode permissions definen si una acción se permite, pregunta o bloquea. Mantén ask cuando no puedas explicar el riesgo, usa allow solo para tareas estrechas y repetidas, y reserva deny para comandos destructivos, rutas externas y secretos. No trates cada aviso como fricción: muchos avisos marcan un cambio real de límite.

Leer archivos y listar directorios suele ser bajo riesgo. Editar documentación o archivos pequeños puede empezar con ask y pasar a allow estrecho. Instalar paquetes, cambiar lockfiles, borrar, publicar, migrar o tocar producción debe quedarse en ask o deny. El riesgo depende del comando y del contexto del repositorio.

Según la documentación actual, `opencode --auto` aprueba lo que no esté denegado. Antes de usarlo, deniega patrones destructivos, archivos de entorno, rutas de claves, despliegues y directorios fuera del proyecto. Si tu búsqueda es saltar permisos peligrosamente, la respuesta duradera es una política revisada, no un bypass global.

Las reglas del repositorio deben vivir con el proyecto. Las preferencias personales pueden ser globales. Las excepciones de agentes deben estar cerca de la definición del agente. Nunca guardes tokens o claves en `opencode.json`; la configuración debe describir permisos, no credenciales.

Un agente de revisión puede leer mucho y escribir nada. Un agente de migración puede editar una carpeta concreta pero no desplegar. Un servidor MCP puede parecer de solo contexto y aun así modificar datos externos. Revisa el origen de cada solicitud antes de ampliar permisos globales.

Crea un repositorio mínimo con código, carpeta generada, `.env.example` y un comando inocuo. Ejecuta casos que deben permitirse, preguntar y denegarse. Si una regla permite más de lo esperado o una denegación no se entiende, estrecha el patrón antes de usarlo a diario.

Registra herramienta, comando, ruta y rol de agente. Luego revisa directorio de trabajo, rutas externas, MCP, hooks, wrappers y configuración. Corrige el patrón estrecho; no apruebes todo bash por una sola confirmación repetida.

Antes de convertir una regla de permisos de OpenCode en configuración del proyecto, compárala con una tarea real y con una tarea que no debería ejecutarse sin revisión. En un equipo pequeño, la revisión mínima debe incluir tres preguntas: qué acción se permite, qué ruta o comando queda fuera y quién puede revertir la regla si empieza a aprobar demasiado. Este paso evita que `opencode --auto` se convierta en una aprobación general disfrazada de productividad.

Un buen patrón es separar la política en lectura, edición y ejecución. La lectura amplia suele acelerar el análisis del repositorio. La edición necesita una primera revisión de diff antes de pasar a una regla estrecha. Bash requiere más cuidado: permite comandos exactos como pruebas o linters conocidos, pero mantén instalación de paquetes, borrado de archivos, migraciones, publicación y credenciales en ask o deny. Si el prompt repetido viene de una ruta externa, no lo soluciones con un permiso global; ajusta la ruta concreta.

También conviene guardar una nota de cambio junto a la regla: motivo, ejemplo aprobado, ejemplo bloqueado, fecha de revisión y enlace a la documentación oficial usada. Así la próxima persona entiende por qué existe la regla y puede actualizarla cuando cambie OpenCode, un plugin o un servidor MCP.