Clase 06 · Módulo 02
CLAUDE.md, permisos y modo plan
CLAUDE.md, permisos y modo plan
Qué logras en esta clase
Pasas de «pedir y cruzar los dedos» a trabajar con Claude Code bajo control.
- Escribes un
CLAUDE.mdútil para tu web. - Eliges el modo de permisos según la tarea.
- Bloqueas con una regla lo que Claude no debe tocar.
- Usas el modo plan antes de cada bloque grande.
02
Cada sesión parte en blanco
Claude no recuerda la conversación de ayer. CLAUDE.md es lo que lee al empezar cada sesión para saber en qué proyecto está.
03
Dos memorias que se cargan solas
CLAUDE.md | Memoria automática | |
|---|---|---|
| Quién la escribe | Tú | Claude, mientras trabaja |
| Dónde vive | En tu proyecto | En tu computador, fuera del proyecto |
| Se comparte por Git | Sí | No, es local a esa máquina |
| Cómo la revisas | Abres el archivo | Comando /memory |
Con /memory ves qué archivos están cargados, los abres y activas o desactivas la memoria automática.
04
Dónde puede vivir un CLAUDE.md
| Ubicación | Alcance |
|---|---|
./CLAUDE.md en la raíz del proyecto | Ese proyecto; viaja con el repositorio |
~/.claude/CLAUDE.md | Todos tus proyectos |
./CLAUDE.local.md | Ese proyecto, solo para ti; va en .gitignore |
Si existen varios, se suman: no se reemplazan entre sí. En este curso trabajas con el de la raíz del proyecto.
05
Crear el primero con /init
- Abre Claude Code en la carpeta de tu proyecto.
- Escribe
/init. - Claude analiza los archivos y propone un
CLAUDE.mdinicial. - Léelo completo y corrige lo que no sea cierto.
- Guárdalo con un commit.
Si el archivo ya existe, /init propone mejoras en vez de reemplazarlo. En un proyecto recién creado saldrá corto: lo irás completando en los módulos siguientes.
06
Qué pertenece a un CLAUDE.md de una web
- Qué es el sitio y para quién, en dos o tres líneas.
- Los comandos para levantarlo y construirlo.
- Cómo se organizan las carpetas.
- Las decisiones de diseño fijas: colores, tipografías, espaciados (módulo 4).
- Lo que no se debe tocar ni instalar sin preguntar.
No pertenecen: procedimientos largos, textos del sitio ni nada que ya esté escrito en el código.
07
Instrucción vaga contra instrucción verificable
La primera no se puede comprobar, así que no cambia nada. La segunda permite mirar un diff y decir si se cumplió. Escribe solo instrucciones de las que puedas decir «sí» o «no».
08
Corto y sin contradicciones
La documentación recomienda menos de 200 líneas por archivo. Más largo, y las instrucciones importantes se diluyen.
- Cada línea que agregas compite por atención con las demás.
- Dos instrucciones que se contradicen hacen que Claude elija una al azar.
- Si necesitas más, existen reglas por tema en
.claude/rules/.
09
Orienta, no bloquea
CLAUDE.md es contexto. Los permisos, en cambio, los aplica el programa Claude Code antes de ejecutar cada acción, sin depender de lo que el modelo decida.
10
Lo que debe cumplirse siempre
Si una regla no puede fallar nunca, no va en CLAUDE.md: va en los permisos.
11
Los modos de permisos
| Modo | Qué hace sin preguntarte |
|---|---|
| Manual | Solo leer archivos |
| Edit automatically | Leer, editar archivos del proyecto y comandos comunes de archivos |
| Plan | Leer y explorar; no edita hasta que apruebas el plan |
| Auto | Todo, con un clasificador que revisa cada acción |
| Bypass permissions | Todo, sin revisión |
En la terminal, «Edit automatically» aparece como «accept edits».
12
Cómo cambiar de modo
- VS Code: clic en el indicador de modo, al pie del cuadro de texto.
- Terminal:
Shift+Tabpasa de un modo al siguiente. - App de escritorio: el selector bajo el cuadro de texto.
El modo vale para la sesión en curso y puedes cambiarlo en cualquier momento, incluso a mitad de una tarea.
13
Auto: cuándo sí y cuándo no
Desde la versión 2.1.283, Auto es el modo en que parte cada sesión. Reduce interrupciones, pero quien revisa cada acción es un clasificador, no tú.
| Conviene Auto | Conviene Manual o Plan |
|---|---|
| Tareas repetidas que ya conoces | Estás aprendiendo |
| Proyecto sin claves ni datos reales | Hay archivo .env o base de datos conectada |
| Todo está guardado en Git | Cambios en pagos, formularios o configuración |
14
Reglas: allow, ask y deny
Además del modo, puedes fijar reglas por acción. El comando /permissions abre el diálogo para gestionarlas.
- allow: se ejecuta sin preguntar.
- ask: siempre pregunta.
- deny: nunca se ejecuta.
Si dos reglas chocan, gana la más restrictiva: primero deny, después ask, al final allow.
15
Cómo se escribe una regla
La forma es Herramienta(patrón):
Read(./.env)
Bash(npm run *)La primera se refiere a leer el archivo .env. Puesta en deny, Claude no puede abrir tu archivo de claves aunque se lo pidan. La segunda se refiere a ejecutar cualquier comando que empiece con npm run. Puesta en allow, deja de preguntarte cada vez que levanta el sitio.
16
Dónde quedan guardadas
| Archivo | Alcance |
|---|---|
.claude/settings.json | El proyecto; se comparte por Git |
.claude/settings.local.json | El proyecto, solo para ti |
~/.claude/settings.json | Todos tus proyectos |
Cuando respondes «Yes, and don't ask again» a una solicitud, esa aprobación también queda guardada para ese proyecto y ese comando.
17
El límite de las reglas
Las reglas sobre archivos, como negar la lectura de .env, son firmes. Para lo demás, tu protección real sigue siendo la combinación: modo adecuado, diff revisado y commit previo.
18
Planificar antes de construir
En modo plan, Claude investiga y propone, pero no edita nada hasta que apruebas. Es el modo para todo pedido que toque más de un par de archivos.
19
Tres formas de entrar al modo plan
Shift+Taben la terminal, o el indicador de modo en VS Code.- El comando
/plan, solo o seguido de la tarea. - Iniciar con
claude --permission-mode plan.
Claude lee el proyecto, puede hacerte preguntas y entrega una lista de pasos con los archivos que crearía o cambiaría.
20
El recorrido de un plan
Al aprobar eliges cómo sigue: que continúe en Auto, que te pida aprobar cada edición, o seguir planificando. En VS Code puedes editar el plan directamente antes de aceptarlo.
21
Qué mirar en un plan
- ¿Entendió lo que pedí o resolvió otra cosa?
- ¿Qué archivos toca? ¿Hay alguno que no esperaba?
- ¿Instala paquetes nuevos? ¿Hacen falta?
- ¿Reutiliza lo que ya existe o lo duplica?
- ¿Dice cómo se comprueba que quedó funcionando?
Corregir un plan cuesta una frase. Corregir lo ya construido cuesta rehacerlo.
22
Qué modo para qué tarea
| Tarea | Modo |
|---|---|
| Entender un proyecto o un error | Manual |
| Corregir un texto o un estilo puntual | Manual o Edit automatically |
| Sección nueva, página nueva, cambio de estructura | Plan, y luego aprobar ediciones |
| Rutina conocida en proyecto sin claves | Auto |
Ninguno es «el correcto». Lo correcto es cambiar de modo cuando cambia el riesgo de la tarea.
23
Tres errores frecuentes
Los otros dos:
- Aprobar el plan sin leerlo. El plan es el momento más barato para corregir.
- Dejar que
CLAUDE.mdcrezca sin revisarlo. Instrucciones viejas o contradictorias producen resultados erráticos y difíciles de explicar.
24
Lo que te llevas
CLAUDE.mdse lee al inicio de cada sesión; corto, concreto y verificable.CLAUDE.mdorienta; los permisos bloquean.- Auto es el modo inicial; con claves o datos reales, Manual o Plan.
- Una regla deny sobre
.envimpide que Claude lea tus claves. - Todo pedido grande empieza en modo plan y se revisa antes de aprobar.
25
Hazlo ahora
En 15 minutos, en tu carpeta practica:
- Ejecuta
/init, lee elCLAUDE.mdpropuesto y agrégale una instrucción verificable. - Crea un archivo
.envcon una línea inventada y confirma que está en.gitignore. - Abre
/permissionsy agrega la regla deny para leer.env. - Pídele a Claude que te muestre el contenido de
.envy observa qué pasa. - Usa
/planpara pedir un cambio de dos archivos, corrige algo del plan y apruébalo.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026