Claude Code: qué configurar más allá del prompt
Claude Code: qué configurar más allá del prompt
“Respeta la arquitectura.”“Lanza las pruebas.”“Revisa los cambios antes de dar por terminado.”
Si te encuentras repitiendo estas indicaciones en cada sesión, merece la pena plantearse dónde deberían residir de forma permanente.
1. CLAUDE.md: el contexto del proyectoEste archivo es el lugar indicado para documentar la estructura del repositorio, las convenciones del equipo, los comandos de compilación y todo lo relacionado con las pruebas. Por ejemplo, puedes especificar cómo ejecutar los tests o qué carpetas albergan cada módulo. Son instrucciones dirigidas al modelo, así que escribir una prohibición aquí no equivale a establecer un control técnico real.
2. Skills: procedimientos que se reutilizanUn archivo SKILL.md puede describir procesos recurrentes: cómo auditar una API, preparar una entrega o aplicar los estándares del equipo. Estas skills se pueden invocar de forma explícita o cargarse automáticamente cuando el contexto lo hace pertinente. También admiten scripts, plantillas y documentación de apoyo.
3. Hooks: acciones vinculadas a eventosPermiten lanzar verificaciones y automatizaciones en momentos precisos del flujo de trabajo. Algunos ejemplos habituales:
• Aplicar formato tras una edición.• Validar una llamada antes de ejecutarla.• Enviar una notificación al concluir una tarea.
Un matiz importante: no todos los hooks son ajenos a la IA. Existen hooks basados en prompts y en agentes, por lo que un disparador automático no convierte cualquier evaluación en algo determinista.
4. Subagentes: trabajo con contexto independienteEs posible delegar una investigación o revisión concreta a un subagente y recibir únicamente sus conclusiones. Esto evita que la conversación principal se llene de detalles intermedios. La clave está en definir bien el alcance: qué debe revisar, qué evidencia tiene que devolver y cuándo debe detenerse.
5. Plugins: configuración compartidaAgrupan capacidades como skills, hooks, subagentes y servidores MCP en un paquete instalable. Son especialmente útiles para distribuir una configuración común entre distintos proyectos y mantenerla bajo control de versiones.
¿Qué papel juega MCP?Conecta Claude Code con herramientas y servicios externos. Mientras una skill explica cómo trabajar con un sistema determinado, MCP proporciona el acceso real a sus herramientas y datos.
Para comenzar, lo más práctico es identificar una fricción concreta: si una convención se repite, documentarla. Si lo que se repite es un procedimiento, crear una skill. Si una validación debe ejecutarse ante un evento específico, configurar un hook. Después, comprobar si el cambio reduce de verdad los errores o el trabajo manual.
¿Cuál de estas funcionalidades te ahorraría más instrucciones repetidas?Claude Code: configuración persistente más allá del prompt de sesión
Resumen técnico
Claude Code ofrece cinco capas de configuración persistente para eliminar instrucciones repetidas por sesión. CLAUDE.md almacena contexto del proyecto: estructura de repositorio, convenciones y comandos de compilación. Los archivos SKILL.md encapsulan procedimientos reutilizables invocables explícitamente. Los hooks ejecutan acciones ante eventos concretos —formato, validación, notificaciones— incluyendo variantes basadas en prompts, no solo lógica determinista. Los subagentes delegan tareas con contexto aislado. Los plugins agrupan skills, hooks, subagentes y servidores MCP en paquetes instalables y versionables. MCP actúa como capa de acceso a herramientas y datos externos.
Análisis de implicaciones
La distinción crítica: escribir una restricción en CLAUDE.md no impone un control técnico, es una instrucción al modelo. Los hooks basados en prompts tampoco garantizan evaluaciones deterministas, aunque se disparen automáticamente. Los subagentes con alcance acotado evitan la contaminación de contexto en la conversación principal, pero requieren definición explícita de qué evidencia devolver y cuándo detenerse. La configuración mediante plugins permite distribuir estándares de equipo entre proyectos manteniendo versionado centralizado.
Aplicación práctica
Un equipo puede crear un CLAUDE.md que documente rutas de módulos, comandos como npm test o pytest y convenciones de nombrado. Una SKILL.md de revisión de API describe el procedimiento estándar de inspección. Un hook de pre-ejecución valida llamadas a herramientas externas antes de lanzarlas. Un subagente recibe el encargo de auditar dependencias y devuelve únicamente un informe estructurado. Todo empaquetado en un plugin instalable en cualquier repositorio del equipo en minutos.
Contexto del sector
La tendencia hacia agentes de código autónomos exige mecanismos de configuración estables más allá del prompt único. GitHub Copilot Workspace y Cursor abordan parte de este problema con reglas de proyecto, pero sin la granularidad de hooks por eventos o subagentes con contexto aislado. MCP como estándar de integración de herramientas posiciona a Claude Code en un ecosistema extensible, relevante especialmente para equipos que gestionan múltiples proyectos con estándares comunes.
Artículo relacionado