Explorando o Código Claude: O Espaço de Projeto dos Sistemas de Agentes de IA Atuais e 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
Resumo
O Claude Code é uma ferramenta de codificação agentiva que pode executar comandos shell, editar arquivos e chamar serviços externos em nome do usuário. Este estudo descreve sua arquitetura abrangente por meio da análise do código-fonte TypeScript publicamente disponível e compara-a ainda com o OpenClaw, um sistema de agente de IA open-source independente que responde a muitas das mesmas questões de projeto a partir de um contexto de implantação diferente. Nossa análise identifica cinco valores humanos, filosofias e necessidades que motivam a arquitetura (autoridade de decisão humana, segurança e proteção, execução confiável, amplificação de capacidade e adaptabilidade contextual) e os rastreia através de treze princípios de projeto até escolhas de implementação específicas. O núcleo do sistema é um simples loop *while* que chama o modelo, executa ferramentas e repete. A maior parte do código, no entanto, reside nos sistemas em torno deste loop: um sistema de permissões com sete modos e um classificador baseado em *machine learning*, um pipeline de compactação de cinco camadas para gerenciamento de contexto, quatro mecanismos de extensibilidade (MCP, *plugins*, *skills* e *hooks*), um mecanismo de delegação de subagentes com isolamento de árvore de trabalho e armazenamento de sessão orientado a anexos. Uma comparação com o OpenClaw, um *gateway* de assistente pessoal multicanal, mostra que as mesmas questões de projeto recorrentes produzem respostas arquiteturais diferentes quando o contexto de implantação muda: desde a classificação de segurança por ação até o controle de acesso no nível do perímetro, de um único loop de CLI a um *runtime* embutido dentro de um plano de controle de *gateway*, e de extensões de janela de contexto ao registro de capacidades em todo o *gateway*. Finalmente, identificamos seis direções abertas de projeto para futuros sistemas de agentes, fundamentadas na literatura empírica, arquitetônica e de políticas recente.
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.