Permisos y acceso a archivos en Claude Code: guía de diagnóstico 2026

El sistema de permisos de Claude Code es la capa que decide si cada llamada a una herramienta (leer un archivo, escribirlo, ejecutar un comando de shell, hacer un fetch web) se lleva a cabo. Cuando algo se bloquea, el mensaje de error a veces es obvio (“Tool use denied”) y a veces es oscuro (“EACCES” sin más contexto), y la corrección correcta depende de cuál de los cuatro niveles distintos es el responsable. Esta guía gratuita es el manual completo de diagnóstico y reparación para los errores de permisos: la capa del sistema operativo, los modos de permiso, las reglas allow/deny de settings.json, los hooks y las peculiaridades multiplataforma.

Escrita para el ingeniero que recibe un “permission denied” en una escritura rutinaria, el arquitecto que define políticas de equipo, el SRE que añade registro de auditoría para cumplimiento y cualquiera responsable de mantener Claude Code confiable y seguro. Cada error se explica con el síntoma exacto, el comando de diagnóstico y la corrección específica en Windows, macOS y Linux.

Lo que aprenderás

• El modelo de permisos de cuatro niveles (SO, modo, reglas y hooks) y cómo saber cuál te está bloqueando.
• Los cuatro modos de permiso (default, plan, auto-accept, bypass) y el adecuado para cada tarea.
• Fallos de lectura de archivos: EACCES, alcance del directorio de trabajo y additionalDirectories.
• Fallos de escritura: sistemas de solo lectura, carpetas padre faltantes, bloqueos y cuarentena del antivirus.
• Patrones de permiso de la herramienta Bash: coincidencia exacta vs prefijo y las reglas deny que ganan.
• Casos de Windows: acceso entre unidades, rutas UNC, sincronización de OneDrive y confusión de rutas WSL.
• Casos de macOS: Acceso Total al Disco, cuarentena xattr, rutas protegidas por SIP y translocación de apps.
• Casos de Linux: propiedad tras sudo, ACL POSIX, contextos SELinux y perfiles de AppArmor.
• Sistemas de archivos de red: mapeo de UID en NFS, conexiones sshfs obsoletas y expiración de credenciales SMB.
• Herencia de permisos en servidores MCP y hooks que dan seguridad real: auditoría y prohibir push a main.

Esta guía es gratuita: sin registro ni correo. Publicamos guías gratuitas de resolución de problemas porque ahorrarte un incidente en producción vale la pena, compres o no una de nuestras guías de pago. Descárgala y reduce la fricción sin sacrificar la seguridad.