🚀 Tutorial 2: Automatización desatendida con permisos seguros ("piloto automático")

⏱ Tiempo estimado: 20 minutos

🎯 Rama / Perfil: Emprendedores y dueños de pequeños negocios sin equipo técnico

🧠 Conocimiento previo necesario: Claude Code instalado y haber usado el modo interactivo básico (organizar archivos, clase 4 del curso), donde aprobabas cada acción manualmente.

💡 ¿Qué vas a lograr? Un archivo de configuración que le da a Claude Code autonomía para trabajar sin pedirte aprobación en cada paso, pero limitado estrictamente a una carpeta y a acciones específicas que tú elijas.

🛠 Lo que necesitas antes de empezar

• Claude Code instalado → Guía oficial de instalación
• Una carpeta de prueba dedicada (no uses tu carpeta de documentos importantes la primera vez)
• Un editor de texto para escribir JSON (VS Code, Bloc de notas, o el propio Claude Code)

📋 Pasos

Paso 1 — Entiende el orden de las reglas

Claude Code evalúa los permisos en este orden fijo: primero las reglas de negación (deny), luego las de pregunta (ask), y al final las de permiso automático (allow). La primera regla que coincide gana, sin importar qué tan específica sea otra. 🔗 Documentación oficial de permisos

Paso 2 — Localiza o crea tu archivo settings.json

Este archivo puede vivir en tres niveles: por usuario (~/.claude/settings.json, afecta todos tus proyectos), por proyecto (.claude/settings.json, se puede compartir con tu equipo) o local (.claude/settings.local.json, solo para ti, no se comparte). Para tu primera automatización, créalo a nivel de proyecto.

Paso 3 — Define qué SÍ puede hacer solo

Dentro de tu carpeta de proyecto, crea .claude/settings.json con algo como:

json

{
  "permissions": {
    "allow": [
      "Read",
      "Bash(ls:*)",
      "Bash(mkdir:*)"
    ],
    "deny": [
      "Bash(rm:*)",
      "Bash(curl:*)",
      "WebFetch"
    ],
    "defaultMode": "acceptEdits"
  }
}

Esto le dice a Claude Code: "puedes leer archivos, listar carpetas y crear carpetas sin preguntarme; nunca borres archivos, nunca descargues nada de internet; y para el resto de ediciones, procede sin pedirme confirmación en cada línea".

Paso 4 — Limita el acceso solo a la carpeta que quieres

Por defecto, Claude Code solo puede tocar la carpeta donde lo ejecutas y sus subcarpetas. Si necesitas que también lea otra carpeta puntual (por ejemplo, una carpeta compartida de facturas), agrégala explícitamente:

json

{
  "permissions": {
    "additionalDirectories": ["/Users/tunombre/facturas-2026"]
  }
}

Cualquier carpeta que no listes aquí sigue estando fuera de su alcance, sin importar qué le pidas.

Paso 5 — Haz una prueba controlada

Con esa configuración activa, pídele algo repetitivo: por ejemplo, "organiza todos los PDF de esta carpeta en subcarpetas por mes". Observa que ya no te pregunta antes de crear cada carpeta, pero sigue sin poder borrar nada ni salir de los directorios permitidos.

Paso 6 — Verifica las reglas activas

Puedes revisar en cualquier momento qué reglas están activas y de qué archivo viene cada una, directamente desde Claude Code, para confirmar que tu configuración se está aplicando como esperabas y no hay una regla de otro nivel (usuario vs. proyecto) pisándola.

✅ Resultado esperado

Un archivo .claude/settings.json funcional que convierte a Claude Code en un asistente semi-autónomo: ejecuta tareas repetitivas de organización y lectura sin pedirte aprobación paso a paso, pero con barreras explícitas que le impiden borrar archivos, acceder a internet o salir de la carpeta que tú definiste.

🔥 Tu reto (siguiente acción)

Aplica esta misma configuración a una tarea real de tu negocio (por ejemplo, clasificar recibos de gastos o renombrar fotos de producto) y corre la tarea completa sin supervisar cada paso. Anota qué reglas tuviste que ajustar después de la primera corrida.

📚 Recursos para ir más lejos

• Configure permissions — Claude Code Docs — Referencia completa de todos los modos (default, acceptEdits, plan, dontAsk, bypassPermissions) y la sintaxis de reglas.
• Guía oficial de instalación de Claude Code — Por si necesitas reinstalar o verificar tu versión antes de aplicar cambios de configuración.