---
title: "Cómo proteger tus archivos en Claude Code"
description: "Dos formas de evitar que tu agente modifique archivos sensibles: .claudeignore para lo que no debe tocar y AGENTS.md para reglas de negocio."
url: "https://www.devlights.com/es/blog/proteger-archivos-claude-code"
language: es
published: 2026-11-06T13:06:23.530Z
updated: 2026-11-06T13:08:57.814Z
type: article
authors: ["Sara Zamudio"]
category: "Tech Tips"
tags: ["Claude", "Claude Code", "Agentes de código", "IA"]
---

# 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.

¿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](https://www.devlights.com/es/blog/agents-md-instrucciones-agente-codigo). Sirve para reglas más específicas: no solo qué archivos no tocar, sino también qué acciones no hacer.

markdown

```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.