Inicio / Una instalación estructurada
El mapa de una instalación estructurada
Una instalación de Claude Code que aguanta con el tiempo se lee como un mapa de siete elementos, el motor, la constitución CLAUDE.md, la memoria de archivos, el transporte git, los hooks, las skills y el latido programado, en lugar de como un amontonamiento de ajustes sin plan.
Una instalación de Claude Code que funciona bien no depende de un solo ajuste logrado, depende de siete elementos que se complementan: el motor que ejecuta los comandos, la constitución CLAUDE.md que fija las reglas, la memoria de archivos que guarda un rastro entre sesiones, el transporte git que sincroniza esa memoria, los hooks que disparan una acción ante un evento del ciclo de vida, las skills que aprenden un gesto repetible, y el latido programado que hace funcionar todo el conjunto sin intervención manual. Este reparto en siete elementos es el adoptado por este módulo, una referencia para construir en orden más que una taxonomía publicada tal cual por Anthropic.
Tres familias detrás de los siete elementos
Los siete elementos se agrupan en tres familias. Una familia ejecuta: el motor, único elemento que corre de forma permanente durante una sesión. Una familia persiste: CLAUDE.md, la memoria de archivos y el transporte git, que guardan un rastro de una sesión a otra. Una familia automatiza: los hooks, las skills y el latido, que hacen actuar a las dos primeras familias sin que tengas que volver a pedirlo cada vez. Instalar un hook o una skill antes de que exista la memoria de archivos equivale a programar una automatización que no tiene nada que leer ni que escribir.
Un mapa más estable que sus propias direcciones
La documentación en sí cambia más rápido que este mapa. El dominio docs.claude.com/en/docs/claude-code, todavía citado en cursos más antiguos, redirige ahora hacia code.claude.com/docs/en para cada página del producto, verificado el 2 de septiembre de 2026. Los siete elementos del mapa siguen siendo los mismos de un dominio a otro: son ellos los que hay que retener, no la dirección que los documenta este mes.
# Ubicación esquemática de los siete elementos en un equipo
~/.claude/CLAUDE.md # constitución global
~/.claude/skills/ # skills personales
mon-projet/.claude/CLAUDE.md # constitución de proyecto
mon-projet/.claude/skills/ # skills del proyecto
mon-projet/.claude/settings.json # hooks y latido programado
mon-projet/memoire/.git/ # transporte git de la memoria de archivos
La lección siguiente empieza por el primero de los siete elementos, el motor, instalado y conectado. La última lección del módulo cierra el mapa comprobando que cada uno de los siete elementos ocupa su lugar.
Las siete capas de una instalación estructurada
Un desarrollador instala Claude Code en su equipo y lanza una primera sesión en la carpeta de su proyecto. Después coloca un archivo CLAUDE.md vacío en la raíz del repositorio.
Escribe en una frase lo que esta situación establece, y en una frase lo que no establece.
Lo que esto establece: Esta situación establece que ahora existe un archivo CLAUDE.md en la raíz del repositorio, listo para recibir reglas en el próximo arranque de sesión.
Lo que esto no establece: No establece que los otros seis elementos del mapa, memoria de archivos versionada, transporte git, hooks, skills y latido programado, también estén en su lugar.
Los tres calibrados falsos más frecuentes
- Demasiado amplio El desarrollador ahora cuenta con una instalación estructurada en el conjunto de los siete elementos del mapa.
- Demasiado estrecho Este resultado no prueba nada en absoluto, ya que un archivo vacío todavía no contiene ninguna regla que leer.
- Fuera de tema Esta situación muestra que el desarrollador eligió trabajar directamente en la carpeta de su proyecto en lugar de en una carpeta separada.
- Los siete elementos del mapa se reparten en tres familias, lo que ejecuta, lo que persiste y lo que automatiza, y el orden entre estas familias importa para evitar construir una automatización sobre una memoria que todavía no existe.
- Una skill o un hook instalado antes de que exista la memoria de archivos trabaja en el vacío, ya que no tiene nada que leer ni que escribir en el momento en que se dispara.
- El nombre de dominio de la documentación oficial de Claude Code ha cambiado, code.claude.com reemplaza ahora a docs.claude.com para las páginas del producto, un recordatorio de que el mapa sigue siendo más estable que las direcciones que lo documentan.
- Las seis lecciones siguientes del módulo desarrollan cada una uno o dos de estos siete elementos, en el orden en que mejor se construyen en un equipo nuevo.
Enumera ahora mismo, en una hoja o en un archivo de texto, los siete elementos del mapa, motor, CLAUDE.md, memoria de archivos, transporte git, hooks, skills, latido, y anota junto a cada uno si está ausente, parcial o ya instalado en tu equipo, antes de añadir el más mínimo ajuste nuevo.
Cada afirmación datable de esta lección remite aquí al texto público que la respalda. Una fuente que no se abre no prueba nada.
- Claude Code, guía de instalación, dominio actual de la documentación oficial consultée le 2026-09-02