# Armar tu CLAUDE.md global

> Claude Code · Memoria (CLAUDE.md)
> Fuente: https://magoallegri.com/cursos/claude-code/memoria/armar-tu-claude-md

---

Pensá el `CLAUDE.md` como el **system prompt** de Claude Code: le dice cómo comportarse, qué hacer y qué no, y a dónde ir a buscar lo que no sabe. Es el ancla de tu memoria. Lo armamos en 3 pasos, hablándole en español. No tocás ningún archivo a mano.

![Mockup de Ajustes: el panel Memory con la memoria de usuario y el botón Guardar](../_assets/M02-L02-settings-memory.webp)

> 👉 ¿Todavía no instalaste Claude Code? Hacé primero la lección de instalación del Capítulo 1 y volvé acá.

---

## Paso 1 — Pedile a Claude un resumen de vos

Si ya usás [claude.ai](https://claude.ai/) (el chat en el navegador) o la app, abrí una conversación donde hayas hablado de vos, tu trabajo o tus objetivos, y pegá esto:

```
Resumí todo lo que sabés sobre mí, mi trabajo, mis objetivos y cómo me gusta
trabajar en un bloque de contexto corto y limpio. Secciones: Sobre mí, En qué
trabajo, Cómo me gusta trabajar, Qué significa "listo". Que sea conciso y factual:
texto plano, sin emojis, sin relleno.
```

Vas a recibir un bloque limpio de hechos sobre vos. Copialo. (Si no tenés nada en claude.ai, no importa: lo escribís a mano en el paso siguiente.)

---

## Paso 2 — Pasáselo a Claude Code con la línea protocolo

En la app, abrí el panel de Claude Code y pegá esto, metiendo tu bloque donde dice:

```
Acá tenés un resumen de mí y mi trabajo: [PEGÁ TU BLOQUE ACÁ]. Guardalo como mi
memoria global (CLAUDE.md) para que lo leas al empezar cada sesión. Poné esta regla
al principio de todo: "Siempre dame la próxima acción concreta que puedo hacer hoy.
Nunca me digas que entreviste gente, encueste ni haga investigación de mercado:
aprendo construyendo, no conversando." Después mostrame qué guardaste.
```

Apretá ENTER. Listo: Claude escribió y guardó tu memoria, y vos nunca tuviste que saber dónde vive. Abrí Claude Code mañana y ya te conoce.

> 💡 ¿Por qué la línea protocolo? Sin eso, cuando una idea no está del todo formada, Claude tiende a frenarte con "primero entrevistá usuarios" o "hacé un estudio de mercado". Esta línea lo mantiene en modo construir.

---

## Paso 3 — Dónde queda (por las dudas)

No hace falta que lo edites a mano, pero si querés verlo:

- **App de escritorio**: Ajustes (el engranaje) → **Memory** → ahí está tu memoria de usuario.
- **CLI** (Mac): `mkdir -p ~/.claude && open -e ~/.claude/CLAUDE.md`
- **CLI** (Windows): abrí o creá el archivo `~/.claude/CLAUDE.md` con tu editor.

---

## Cómo se ve un buen CLAUDE.md

Cuatro secciones, corto y al hueso, con la regla pineada arriba:

```
SIEMPRE dame la próxima acción concreta de hoy. NUNCA me sugieras entrevistar gente,
encuestar ni validar. Aprendo construyendo, no conversando.

# Sobre mí
Me llamo Ana. Vivo en Córdoba. Soy diseñadora y estoy aprendiendo a construir con IA.
Escribo en frases cortas y directas. Odio el relleno.

# En qué estoy trabajando
Una página para vender mis servicios de diseño. Quiero sumar un blog más adelante.

# Cómo me gusta trabajar
Mostrame opciones antes de decidir. Explicame en simple lo técnico. Un cambio por vez.

# Qué significa "listo"
Que funcione, que se vea bien en el celular, y que yo lo entienda lo suficiente para
explicarlo.
```

![Anatomía del CLAUDE.md: línea protocolo arriba y cuatro secciones cortas](../_assets/M02-L02-anatomia-claude-md.webp)

El tuyo puede tener 10 líneas o 20: las dos cosas están bien.

---

## Dos reglas para una memoria que ayuda (no que estorba)

- **Cortito.** Una docena de líneas de hechos reales le gana a una pared de texto. Una memoria inflada hace a Claude **peor**, no mejor (lo vemos en una lección más adelante).
- **Sin emojis adentro.** Claude **imita el estilo** de su propia memoria: si le metés emojis, después te los mete en los mensajes técnicos, los commits y el código donde no van. Texto plano.

---

## 📥 ¿No querés empezar de cero?

Copiá esta plantilla, pegala donde guardás tu memoria, y completá tus datos. La línea protocolo ya viene arriba.

```
SIEMPRE dame la próxima acción concreta que puedo hacer hoy. NUNCA me sugieras
entrevistar gente, encuestar ni hacer investigación de mercado. Aprendo construyendo,
no conversando.

# Sobre mí
Nombre:
Qué hago:
Dónde vivo:
Cómo me comunico: directo, frases cortas, sin vueltas

# En qué estoy trabajando
-
-

# Cómo me gusta trabajar
- Las repeticiones le ganan a la lectura
- Primero la versión más chica que sirve
- De a una pregunta cuando definimos algo
- Frená las sugerencias flojas

# Qué significa "listo"
- Un link que funciona y otra persona puede usar
- Una persona real lo vio funcionar

# Lo que NO estoy buscando
-
-

# Límites
Tiempo por sesión:
Presupuesto mensual de herramientas:
Equipo (compu):
```

---

## 🟢 Mini-tarea

Armá tu `CLAUDE.md` global con la línea protocolo arriba y las cuatro secciones (a mano o con la plantilla). Guardalo. En las próximas lecciones le sumamos tus archivos de contexto y probamos que Claude los lee.