Guía: El diccionario de Claude Code — 8 conceptos clave

Claude Code tiene términos propios que, si los entendés, cambian completamente cómo usás la herramienta. Esta guía te explica los 8 conceptos clave en simple, con ejemplos reales.

1. CLAUDE.MD — El archivo con tus reglas

Es el archivo que le enseña a Claude a entender tu proyecto antes de empezar. Ahí definís cómo funciona la operación, qué patrones hay que seguir y qué nunca debe pasar.

En vez de repetir instrucciones cada vez, organizás una sola vez y el trabajo es mucho más consistente.

Ejemplo de un CLAUDE.MD:

## Proyecto: mi-app

## API
api.mi-app.com

## Reglas
- Siempre hacer commit después de cambios
- Nunca subir archivos .env
- Usar TypeScript siempre

2. Ventana de Contexto — El espacio de atención de Claude

Claude tiene un espacio de atención limitado. Todo lo que lee, analiza o ejecuta ocupa ese espacio.

Cuando mezclás tareas, archivos extra y órdenes sueltas, la respuesta pierde precisión. Cuando el contexto se llena, usá /compact para liberar espacio.

• Tokens usados: podés ver cuánto contexto estás usando con el indicador de progreso
• Límite actual de Claude: 200K tokens
• Tip: /compact → resume el contexto sin perder el hilo

3. Modo de Planificación — Pensá antes de ejecutar

Antes de hacer algo, Claude puede pensar primero en la estructura. Analiza la situación, organiza los pasos y muestra el plan antes de ejecutar cualquier cambio.

Esto reduce el trabajo repetido, evita errores y hace que las decisiones sean más seguras.

$ claude 'añadir autenticación a la API'

Plan (3 pasos):
1. Añadir middleware.ts con JWT
2. Crear ruta /api/auth/login
3. Actualizar rutas protegidas

¿Aprobás? (s/n)

4. MCP — Conecta Claude con otras herramientas

MCP (Model Context Protocol) es el estándar que permite a Claude hablar con otras herramientas sin trucos. Conecta sistemas, organiza flujos y transforma herramientas separadas en una sola operación integrada.

Ejemplos de servidores MCP que podés conectar:

• GitHub (12 tools) — gestionar repos, PRs, issues
• Supabase (8 tools) — consultar y modificar base de datos
• Filesystem (6 tools) — leer y escribir archivos locales
• Playwright (15 tools) — automatizar el navegador

5. Hooks — Automatizaciones antes y después de acciones

Automatizaciones que se ejecutan antes o después de una acción importante. Pueden validar procesos, revisar patrones, prevenir errores y asegurar que la operación siga lo que se definió.

En vez de depender de la memoria de alguien, transformás el cuidado en un sistema.

{
  "hooks": {
    "pre-commit": [
      "npm run lint",
      "npm run test"
    ],
    "post-save": [
      "prettier --write"
    ]
  }
}

6. Subagentes — Asistentes paralelos

Asistentes más pequeños que dividen el trabajo en paralelo. Mientras uno investiga, otro organiza, y otro ejecuta una tarea específica.

Esto acelera el trabajo complejo y evita saturar la conversación principal.

Creando 3 subagentes...
Agente 1: Investigando docs de API
Agente 2: Escribiendo pruebas unitarias
Agente 3: Actualizando esquema
[=====] 3/3 completado
Tiempo total: 12s (vs 45s en serie)

7. Skills — Atajos reutilizables

Procesos listos que guardás para usar cuando los necesitás. En vez de explicar lo mismo desde cero, transformás un flujo repetitivo en un atajo inteligente.

Esto le da más consistencia, velocidad y estructura al trabajo.

$ claude /commit
Ejecutando skill: commit...
> git diff --staged
> Generando mensaje de commit
> git commit -m 'feat: nueva funcionalidad'
Commit realizado ✅

8. Checkpoints — Puntos de seguridad

Puntos de seguridad antes de cambios grandes. Guardan el estado actual de tu proyecto para que puedas volver atrás si algo sale mal.

Checkpoint creado:
Nombre: before-auth-rewrite
Archivos: 14 tracked
Tamaño: 2.3 MB

Restaurar con:
claude checkpoint restore before-auth-rewrite

Resumen — Los 8 conceptos clave

• CLAUDE.MD → Las reglas de tu proyecto
• Context Window → El espacio de atención limitado
• Planning Mode → Planificá antes de ejecutar
• MCP → Conecta Claude con otras herramientas
• Hooks → Automatizaciones antes/después de acciones
• Subagentes → Asistentes paralelos para trabajo complejo
• Skills → Atajos reutilizables
• Checkpoints → Puntos de seguridad antes de cambios grandes