Cómo proteger tus archivos en Claude Code

Dos formas de evitar que tu agente modifique archivos sensibles: .claudeignore para lo que no debe tocar y restricciones en AGENTS.md para tus reglas de negocio.

Sara Zamudio

Marketing • nov 2026 • 2 min de lectura

¿Tu agente modificó un archivo que no debía? Hay dos formas de evitarlo, y las dos se configuran en minutos.

Método 1: .claudeignore

Funciona igual que el .gitignore. Creás el archivo en la raíz del proyecto y listás todo lo que el agente no puede tocar: variables de entorno, archivos de configuración, carpetas de build, lo que sea.

Claude Code lo lee automáticamente y evita leer o modificar esos archivos. Una línea por archivo o carpeta, y listo.

.env
.env.local
/config/secrets.js
/dist
/node_modules

Es la opción ideal para archivos sensibles: credenciales, secretos, artefactos generados que nadie debería editar a mano.

Método 2: restricciones en AGENTS.md

El segundo método es agregar una sección de restricciones en tu AGENTS.md. Sirve para reglas más específicas: no solo qué archivos no tocar, sino también qué acciones no hacer.

markdown

## Restricciones
- No modificar archivos en /migrations
- No actualizar package.json sin avisar
- No tocar /lib/auth sin PR aprobado

La diferencia con el .claudeignore es que acá podés ser más descriptivo. Podés explicarle al agente por qué no debe hacer algo, no solo qué. Y un agente que entiende el motivo de una regla la aplica mejor en situaciones que no previste.

Por ejemplo, en vez de solo “No modificar /migrations”, podrías agregar: “Las migraciones ya aplicadas en producción no se editan; si hace falta un cambio, se crea una migración nueva.”

Cuándo usar cada uno

	.claudeignore	AGENTS.md (restricciones)
Sirve para	Archivos y carpetas sensibles	Reglas de negocio y acciones
Formato	Una línea por ruta	Texto libre, con explicación
Ejemplo	`.env`, `/dist`, `/node_modules`	“No actualizar dependencias sin avisar”
Ideal para	Qué archivos no tocar	Qué acciones no hacer y por qué

Lo que viene: hooks

Hay una tercera forma de controlar lo que hace el agente: los hooks. Pero eso da para un video completo, así que lo vemos en el próximo episodio.

Usalos juntos

Cada uno cubre una parte distinta del problema:

.claudeignore → archivos sensibles
AGENTS.md     → reglas de negocio

Con los dos configurados, tu agente va a saber exactamente dónde no meterse. Guardá este artículo para la próxima vez que arranques un proyecto: lo ideal es dejar ambos archivos listos antes de la primera línea de código.

Autor