Desvelan la arquitectura oculta de los Equipos de Agentes de Claude: un diseño minimalista basado en el sistema de ficheros

Un ingeniero ha logrado descifrar los mecanismos internos mediante los que Claude Code coordina múltiples agentes de inteligencia artificial, revelando una arquitectura sorprendentemente elegante y desprovista de la complejidad que cabría esperar en sistemas distribuidos modernos. Según el análisis realizado mediante ingeniería inversa, la solución implementada por Anthropic prescinde de bases de datos centralizadas, servidores daemon o capas de red complejas. En su lugar, aprovecha tmux —un multiplexor de terminales ampliamente utilizado— para ejecutar cada agente como un proceso independiente de la interfaz de línea de comandos de Claude. Estos procesos se lanzan con parámetros no documentados previamente (--agent-id, --agent-name, --team-name y --agent-color) que permiten identificar y diferenciar cada miembro del equipo. La coordinación entre agentes se logra mediante un mecanismo ingeniosamente simple: ficheros JSON almacenados en directorios específicos del sistema de ficheros del usuario (~/.claude/teams/ para los mensajes e inboxes, ~/.claude/tasks/ para las tareas). Estos ficheros están protegidos mediante bloqueos fcntl, garantizando que múltiples procesos pueden acceder a ellos de forma segura sin conflictos de concurrencia. El protocolo subyacente incorpora características sofisticadas a pesar de su aparente sencillez. Incluye gestión de dependencias entre tareas con detección de ciclos, escrituras atómicas de configuración y un sistema estructurado para solicitudes de cierre ordenado y aprobaciones de planes. Esta combinación de minimalismo y robustez representa una decisión de diseño arquitectónico que desafía las convenciones modernas de desarrollo de sistemas distribuidos. El hallazgo ha tenido implicaciones prácticas inmediatas. El mismo ingeniero ha replicado la totalidad del protocolo como servidor MCP (Model Context Protocol) independiente, permitiendo que cualquier cliente compatible con MCP pueda ejecutar equipos de agentes, no solo Claude Code. Esto abre la posibilidad de que otras herramientas de desarrollo impulsadas por IA accedan a capacidades de coordinación multiagente, democratizando una funcionalidad que estaba confinada a un único entorno. La arquitectura revela una filosofía de diseño que prioriza la claridad, la mantenibilidad y la eficiencia sobre la abstracción y la complejidad. En un panorama donde muchos sistemas de IA distribuidos optan por arquitecturas de microservicios con orquestadores especializados, esta aproximación basada en el sistema de ficheros sugiere que las soluciones más elegantes no siempre requieren la tecnología más sofisticada.