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. Para aprender a usarlos en la práctica, leé los 6 tips de Boris Cherny para dominar Claude Code. Y para optimizar tu configuración desde el día uno, revisá cómo ahorrar tokens con CLAUDE.md.
¿Cuáles son los 8 conceptos clave de Claude Code?
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
¿Querés tus devs entregando 3x más con Claude Code?
Sin reescribir el repo. Sin formaciones largas. Sin tocar tu stack.
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 abierto 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
¿Cómo se resumen los 8 conceptos en una tabla de referencia rápida?
| Concepto | Para qué sirve |
|---|---|
| CLAUDE.MD | Reglas y memoria persistente del proyecto |
| Context Window | Espacio de atención limitado del modelo |
| Planning Mode | Planificá antes de ejecutar cambios |
| MCP | Conecta Claude con herramientas externas |
| Hooks | Automatizaciones antes/después de acciones |
| Subagentes | Asistentes paralelos para trabajo complejo |
| Skills | Atajos reutilizables tipo plug-and-play |
| Checkpoints | Puntos de seguridad antes de cambios grandes |
¿Querés tus devs entregando 3x más con Claude Code?
Sin reescribir el repo. Sin formaciones largas. Sin tocar tu stack.
Preguntas frecuentes sobre Claude Code conceptos
Es un archivo Markdown que vive en la raíz de tu proyecto donde definís las reglas, patrones y context de tu proyecto para que Claude Code entienda cómo operar consistentemente desde el primer prompt. Incluye cosas como: lenguajes/frameworks del proyecto, comandos de build y test, convenciones de naming, comportamiento de git, paths sensibles a evitar y cualquier regla específica del equipo. Claude lee el CLAUDE.md automáticamente al arrancar cada sesión, así que cuanto más completo y conciso esté, menos vas a tener que repetir reglas en cada conversación. Un CLAUDE.md bien armado baja el consumo de tokens hasta 80% porque evita pings explicativos. Leé la guía completa sobre cómo ahorrar tokens con CLAUDE.md y cómo armar tu carpeta Claude desde cero.
Es el espacio de atención limitado de Claude — el "memoria de trabajo" que el modelo puede leer simultáneamente para responder. Opus 4.7 tiene 200K tokens de ventana de contexto (aprox. 150.000 palabras o un libro técnico mediano), Sonnet 4.6 también 200K, Haiku 4.5 200K. Cuando se llena, las respuestas pierden precisión porque el modelo empieza a "olvidar" lo que viene de más atrás. Si se llena podés usar el comando /compact para liberar espacio: el sistema resume la conversación previa y deja el resumen + el final activo. Tip pro: cargá solo los archivos que necesitás (no el repo entero) y usá subagentes para tareas paralelas que comerían tu ventana principal. Más detalles en la documentación oficial de modelos y la doc de Claude Code.
Son automatizaciones (scripts shell o comandos) que se ejecutan antes o después de acciones específicas del agente: pre-tool-use, post-tool-use, on-stop, on-error, etc. Sirven para validar procesos (correr linter después de cada edit), prevenir errores (bloquear commits con secrets), agregar context (loggear cada acción) o automatizar follow-ups (correr tests al cerrar un archivo). Se configuran en ~/.claude/settings.json con un trigger y un comando a ejecutar. Ejemplo típico: hook PostToolUse que corre npm run lint --fix después de cada Edit, garantizando que el código siempre cumpla estándares sin que Claude tenga que recordarlo. Los hooks transforman Claude Code de un asistente a un workflow con guardrails reales. Los 6 tips de Boris Cherny muestran cómo usarlos en un flujo real junto con la documentación oficial.
Son instancias secundarias de Claude que el agente principal lanza para dividir el trabajo en paralelo: una para buscar archivos, otra para correr tests, otra para validar docs, todas trabajando simultáneamente. Cada subagente tiene su propia ventana de contexto aislada (no contamina la principal) y reporta el resultado al orquestador cuando termina. Esto acelera tareas complejas 3-5x vs hacerlas secuencialmente y evita saturar la conversación principal con outputs largos de file searches. Casos típicos: refactor de módulo grande (1 subagente por archivo), audit de seguridad (1 por tipo de vulnerabilidad), batch de tests sobre features distintas. Para ver subagentes en acción a escala leé la guía completa de OpenClaw y el repo oficial de Claude Code.
Son puntos de seguridad automáticos que guardan el estado del proyecto (filesystem + conversación) en momentos clave, permitiéndote volver atrás si algo sale mal sin tener que usar git reset o reescribir manualmente. Claude Code crea checkpoints antes de operaciones destructivas (rm, big refactor, migration) y al cerrar sesión. Los listás con /checkpoints y restaurás con /restore <id>. Esto es útil cuando Claude hace algo inesperado: en vez de perder media hora arreglando, restaurás al checkpoint anterior y retomás con un prompt mejor. Es complementario a git, no lo reemplaza — checkpoints capturan también el state de conversación que git no ve. Para el flujo completo de desarrollo con Claude Code revisá los 6 tips de Boris Cherny para dominar Claude Code y la documentación oficial.
Fuentes e inspiración
Mirá los posts originales donde desarrollamos estas ideas en redes.
