Esplorare il Codice Claude: Lo Spazio Progettuale dei Sistemi Agente IA Attuali e Futuri

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

April 14, 2026

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

cs.AI

Abstract

Claude Code è uno strumento di codifica agentico in grado di eseguire comandi shell, modificare file e richiamare servizi esterni per conto dell'utente. Questo studio ne descrive l'architettura completa analizzando il codice sorgente TypeScript pubblicamente disponibile e confrontandolo ulteriormente con OpenClaw, un sistema di agenti IA open-source indipendente che affronta molti degli stessi problemi di progettazione da un contesto di deployment differente. La nostra analisi identifica cinque valori, filosofie e necessità umane che motivano l'architettura (autorità decisionale umana, sicurezza e protezione, esecuzione affidabile, amplificazione delle capacità e adattabilità contestuale) e le rintraccia attraverso tredici principi di progettazione fino a scelte implementative specifiche. Il cuore del sistema è un semplice ciclo while che chiama il modello, esegue strumenti e si ripete. La maggior parte del codice, tuttavia, risiede nei sistemi che circondano questo ciclo: un sistema di permessi con sette modalità e un classificatore basato su ML, una pipeline di compattazione a cinque livelli per la gestione del contesto, quattro meccanismi di estensibilità (MCP, plugin, skill e hook), un meccanismo di delega dei subagent con isolamento dell'area di lavoro e una memorizzazione di sessione orientata all'append. Un confronto con OpenClaw, un gateway per assistente personale multi-canale, mostra che gli stessi ricorrenti problemi di progettazione producono risposte architetturali diverse quando il contesto di deployment cambia: dalla classificazione della sicurezza per azione al controllo degli accessi a livello di perimetro, da un unico ciclo CLI a un runtime embedded all'interno di un piano di controllo gateway, e dalle estensioni della finestra contestuale alla registrazione delle capacità a livello di gateway. Identifichiamo infine sei direzioni progettuali aperte per i futuri sistemi agentici, basate su recenti letterature empiriche, architetturali e politiche.

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.