Permisos
OpenCode usa la configuración permission para decidir si una acción determinada debe ejecutarse automáticamente, avisarle o bloquearse.
A partir de v1.1.1, la configuración booleana heredada tools está obsoleta y se ha fusionado en permission. La antigua configuración tools todavía se admite por compatibilidad con versiones anteriores.
Cada regla de permiso se resuelve en una de:
"allow"— ejecutar sin aprobación"ask"— solicitar aprobación"deny"— bloquea la acción
Puede establecer permisos globalmente (con *) y anular herramientas específicas.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"*": "ask",
"bash": "allow",
"edit": "deny"
}
}También puedes configurar todos los permisos a la vez:
{
"$schema": "https://opencode.ai/config.json",
"permission": "allow"
}Para la mayoría de los permisos, puede utilizar un objeto para aplicar diferentes acciones según la entrada de la herramienta.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"bash": {
"*": "ask",
"git *": "allow",
"npm *": "allow",
"rm *": "deny",
"grep *": "allow"
},
"edit": {
"*": "deny",
"packages/web/src/content/docs/*.mdx": "allow"
}
}
}Las reglas se evalúan según la coincidencia de patrones, y la última regla coincidente gana. Un patrón común es poner primero la regla general "*" y después reglas más específicas.
Los patrones de permisos utilizan una simple coincidencia de comodines:
*coincide con cero o más de cualquier carácter?coincide exactamente con un carácter- Todos los demás caracteres coinciden literalmente
Puede usar ~ o $HOME al comienzo de un patrón para hacer referencia a su directorio de inicio. Esto es particularmente útil para las reglas external_directory.
~/projects/*->/Users/username/projects/*$HOME/projects/*->/Users/username/projects/*~->/Users/username
Utilice external_directory para permitir llamadas a herramientas que toquen rutas fuera del directorio de trabajo donde se inició OpenCode. Esto se aplica a cualquier herramienta que tome una ruta como entrada (por ejemplo, read, edit, glob, grep y muchos comandos bash).
La expansión del hogar (como ~/...) solo afecta la forma en que se escribe un patrón. No hace que una ruta externa forme parte del espacio de trabajo actual, por lo que las rutas fuera del directorio de trabajo aún deben permitirse a través de external_directory.
Por ejemplo, esto permite el acceso a todo lo que se encuentra en ~/projects/personal/:
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"external_directory": {
"~/projects/personal/**": "allow"
}
}
}Cualquier directorio permitido aquí hereda los mismos valores predeterminados que el espacio de trabajo actual. Dado que read tiene por defecto allow, también se permiten lecturas para entradas bajo external_directory a menos que se anulen. Agregue reglas explícitas cuando una herramienta deba restringirse en estas rutas, como bloquear ediciones mientras se mantienen las lecturas:
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"external_directory": {
"~/projects/personal/**": "allow"
},
"edit": {
"~/projects/personal/**": "deny"
}
}
}Mantenga la lista centrada en rutas confiables y aplique reglas adicionales de permitir o denegar según sea necesario para otras herramientas (por ejemplo, bash).
Los permisos OpenCode están codificados por el nombre de la herramienta, además de un par de medidas de seguridad:
read— leer un archivo (coincide con la ruta del archivo)edit— todas las modificaciones de archivos (cubreedit,write,patch)glob— globalización de archivos (coincide con el patrón global)grep— búsqueda de contenido (coincide con el patrón de expresiones regulares)bash: ejecuta comandos de shell (coincide con comandos analizados comogit status --porcelain)task— lanzamiento de subagentes (coincide con el tipo de subagente)skill— cargar una habilidad (coincide con el nombre de la habilidad)lsp: ejecución de consultas LSP (actualmente no granulares)webfetch— obteniendo una URL (coincide con la URL)websearch— búsqueda web (coincide con la consulta)external_directory: se activa cuando una herramienta toca rutas fuera del directorio de trabajo del proyecto.doom_loop: se activa cuando la misma llamada de herramienta se repite 3 veces con entrada idéntica
Si no especifica nada, OpenCode comienza desde valores predeterminados permisivos:
- La mayoría de los permisos están predeterminados en
"allow". doom_loopyexternal_directorypor defecto son"ask".reades"allow", pero los archivos.envestán denegados de forma predeterminada:
{
"permission": {
"read": {
"*": "allow",
"*.env": "deny",
"*.env.*": "deny",
"*.env.example": "allow"
}
}
}Cuando OpenCode solicita aprobación, la interfaz de usuario ofrece tres resultados:
once— aprobar solo esta solicitudalways: aprueba solicitudes futuras que coincidan con los patrones sugeridos (para el resto de la sesión actual OpenCode)reject— rechazar la solicitud
La herramienta proporciona el conjunto de patrones que always aprobaría (por ejemplo, las aprobaciones de bash generalmente incluyen en la lista blanca un prefijo de comando seguro como git status*).
Puede anular los permisos por agente. Los permisos del agente se combinan con la configuración global y las reglas del agente tienen prioridad. Más información sobre los permisos de los agentes.
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"bash": {
"*": "ask",
"git *": "allow",
"git commit *": "deny",
"git push *": "deny",
"grep *": "allow"
}
},
"agent": {
"build": {
"permission": {
"bash": {
"*": "ask",
"git *": "allow",
"git commit *": "ask",
"git push *": "deny",
"grep *": "allow"
}
}
}
}
}También puede configurar los permisos del agente en Markdown:
---
description: Code review without edits
mode: subagent
permission:
edit: deny
bash: ask
webfetch: deny
---
Only analyze code and suggest changes.