Explorando el Código Claude: El Espacio de Diseño de los Sistemas de Agentes de IA Actuales y Futuros

Dive into Claude Code: The Design Space of Today's and Future AI Agent Systems

April 14, 2026

Autores: Jiacheng Liu, Xiaohan Zhao, Xinyi Shang, Zhiqiang Shen

cs.AI

Resumen

Claude Code es una herramienta de codificación agéntica que puede ejecutar comandos de shell, editar archivos e invocar servicios externos en nombre del usuario. Este estudio describe su arquitectura integral mediante el análisis del código fuente TypeScript disponible públicamente y lo compara además con OpenClaw, un sistema de agente IA de código abierto independiente que responde a muchos de los mismos interrogantes de diseño desde un contexto de despliegue diferente. Nuestro análisis identifica cinco valores, filosofías y necesidades humanas que motivan la arquitectura (autoridad de decisión humana, seguridad y protección, ejecución confiable, amplificación de capacidades y adaptabilidad contextual) y las rastrea a través de trece principios de diseño hasta decisiones de implementación específicas. El núcleo del sistema es un simple bucle while que llama al modelo, ejecuta herramientas y se repite. Sin embargo, la mayor parte del código reside en los sistemas que rodean este bucle: un sistema de permisos con siete modos y un clasificador basado en ML, una canalización de compactación de cinco capas para la gestión del contexto, cuatro mecanismos de extensibilidad (MCP, plugins, habilidades y hooks), un mecanismo de delegación a subagentes con aislamiento de árbol de trabajo, y un almacenamiento de sesiones orientado a anexos. Una comparación con OpenClaw, una pasarela de asistente personal multicanal, muestra que los mismos interrogantes de diseño recurrentes producen respuestas arquitectónicas diferentes cuando cambia el contexto de despliegue: desde la clasificación de seguridad por acción hasta el control de acceso a nivel de perímetro, desde un único bucle CLI hasta un tiempo de ejecución embebido dentro de un plano de control de pasarela, y desde extensiones de ventana de contexto hasta el registro de capacidades a nivel de toda la pasarela. Finalmente, identificamos seis direcciones de diseño abiertas para futuros sistemas de agentes, basadas en literatura empírica, arquitectónica y de políticas reciente.

English

Claude Code is an agentic coding tool that can run shell commands, edit files, and call external services on behalf of the user. This study describes its comprehensive architecture by analyzing the publicly available TypeScript source code and further comparing it with OpenClaw, an independent open-source AI agent system that answers many of the same design questions from a different deployment context. Our analysis identifies five human values, philosophies, and needs that motivate the architecture (human decision authority, safety and security, reliable execution, capability amplification, and contextual adaptability) and traces them through thirteen design principles to specific implementation choices. The core of the system is a simple while-loop that calls the model, runs tools, and repeats. Most of the code, however, lives in the systems around this loop: a permission system with seven modes and an ML-based classifier, a five-layer compaction pipeline for context management, four extensibility mechanisms (MCP, plugins, skills, and hooks), a subagent delegation mechanism with worktree isolation, and append-oriented session storage. A comparison with OpenClaw, a multi-channel personal assistant gateway, shows that the same recurring design questions produce different architectural answers when the deployment context changes: from per-action safety classification to perimeter-level access control, from a single CLI loop to an embedded runtime within a gateway control plane, and from context-window extensions to gateway-wide capability registration. We finally identify six open design directions for future agent systems, grounded in recent empirical, architectural, and policy literature.