Si usas Claude Code sin tocar la carpeta .claude, estás dejando el 90 % del potencial sin explotar
La carpeta .claude es el verdadero motor de Claude Code. Todo lo que querrías que hiciera de forma automática vive ahí dentro. La mayoría de quienes practican vibe coding nunca llegan a abrirla. Instalan la herramienta, lanzan unos cuantos prompts, chocan con algún límite y asumen que eso es todo lo que da de sí. Craso error.
Estos son los archivos que Claude Code utiliza como referencia:
CLAUDE.md → Es el reglamento de tu proyecto. Estilo de código, convenciones, errores habituales que conviene evitar. Claude lo consulta antes de ponerse con cualquier tarea, así no tienes que explicar lo mismo en cada prompt. Eso sí, es orientativo, no una orden.
.claude/hooks/ → Esto sí es determinista. Se ejecuta siempre que ocurre el evento que hayas definido, sin excepción. Puedes automatizar commits tras cada cambio, cargar el contexto del proyecto al arrancar o guardar el estado antes de que se compacte el contexto. Claude no puede saltarse estos hooks.
.claude/skills/ → Mete un archivo SKILL.md en una carpeta y Claude sabrá exactamente cuándo echar mano de él. Un skill para generar carruseles, otro para gestionar el flujo de trabajo. Claude elige el que toca según la tarea que tenga entre manos.
.claude/agents/ → Subagentes con su propia ventana de contexto aislada. Un revisor de código, un investigador, un analizador de registros. Pueden funcionar en paralelo y entregar sus resultados. Tu conversación principal se mantiene limpia y ordenada.
.claude/commands/ → Comandos de barra (/). Es una función más veterana, pero sigue siendo útil. Crea, por ejemplo, un comando /ship que ejecute el linter, compile y despliegue el proyecto de un solo golpe.
.claude/plugins/ → Será una funcionalidad de primer nivel en 2026. Permite agrupar hooks, skills, agentes y servidores MCP en un único paquete para compartir. Aquí es donde el potencial real de la herramienta se desbloquea del todo.
.claude/rules/ → Reglas que se aplican en función de la ruta de los archivos. Solo se cargan cuando los archivos encajan con un patrón glob concreto. Así, las reglas de tu API no entorpecen tu trabajo de frontend.
.mcp.json → Va en la raíz del proyecto, no dentro de .claude. Aquí se declaran los servidores MCP que usa tu proyecto. Claude se conecta a ellos de forma automática.
La distinción que casi todo el mundo pasa por alto: CLAUDE.md es orientativo, los hooks son deterministas y las skills se cargan únicamente cuando se necesitan. Ese es el modelo mental que hay que interiorizar.
En cuanto entiendes para qué sirve cada pieza, Claude Code deja de parecer un chatbot glorificado y empieza a comportarse como un desarrollador diez veces más productivo.
Si quieres aprender a integrar la IA en tus flujos de trabajo y ahorrar tiempo de verdad, Uniaverso ofrece 52 clases de quince minutos, sin tecnicismos, para cualquier edad y sin necesidad de formación previa. Si sabes escribir un WhatsApp, puedes seguirlo sin problema. Las plazas son limitadas.
Descubre Uniaverso y empieza a sacarle partido a la IA
Arquitectura de la carpeta .claude en Claude Code: guía técnica completa
Resumen técnico
La carpeta .claude centraliza la configuración avanzada de Claude Code. Sus componentes principales son: CLAUDE.md (instrucciones orientativas por proyecto), .claude/hooks/ (ejecución determinista por eventos), .claude/skills/ (archivos SKILL.md cargados contextualmente), .claude/agents/ (subagentes con contexto aislado ejecutables en paralelo), .claude/commands/ (comandos slash heredados), .claude/rules/ (reglas filtradas por patrones glob) y .mcp.json (servidores MCP en raíz del proyecto). La funcionalidad .claude/plugins/ se consolida como característica de primer nivel en 2026.
Análisis de implicaciones
La distinción crítica es el comportamiento de cada capa: CLAUDE.md es orientativo y puede ser ignorado por el modelo, mientras que hooks son deterministas e ineludibles. Esto cambia fundamentalmente el diseño de workflows: las reglas blandas gestionan estilo y convenciones, los hooks garantizan automatizaciones como commits o preservación de contexto antes de compactación. .claude/agents/ permite paralelización real de tareas sin contaminar la ventana de contexto principal, resolviendo uno de los problemas más críticos en proyectos de larga duración.
Aplicación práctica
Implementación concreta: crear CLAUDE.md con convenciones de código y errores frecuentes del proyecto. Configurar un hook en .claude/hooks/ que ejecute git commit automático tras modificaciones. Añadir un SKILL.md en .claude/skills/carousel/ para generación de carruseles reutilizables. Definir un agente revisor en .claude/agents/ que analice PRs de forma aislada. Crear un comando /ship en .claude/commands/ que encadene linter, build y deploy. Colocar .mcp.json en la raíz con los servidores MCP del proyecto para conexión automática.
Contexto del sector
El auge del vibe coding ha popularizado herramientas como Claude Code, Cursor y GitHub Copilot Workspace, pero la mayoría de usuarios opera en modo superficial. La arquitectura de .claude posiciona a Claude Code como entorno de desarrollo programable, no solo asistente conversacional. La llegada de plugins en 2026 apunta hacia un ecosistema distribuible de configuraciones, comparable a extensiones de IDE pero orientado a agentes autónomos.
