Plongée dans le Code Claude : L'espace de conception des systèmes d'agents IA actuels et futurs

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

April 14, 2026

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

cs.AI

Résumé

Claude Code est un outil de codage agentique capable d'exécuter des commandes shell, de modifier des fichiers et d'appeler des services externes au nom de l'utilisateur. Cette étude décrit son architecture complète en analysant le code source TypeScript public et en le comparant avec OpenClaw, un système d'IA agentique open-source indépendant qui répond à de nombreuses questions de conception similaires dans un contexte de déploiement différent. Notre analyse identifie cinq valeurs humaines, philosophies et besoins qui motivent l'architecture (autorité décisionnelle humaine, sécurité et sûreté, exécution fiable, amplification des capacités et adaptabilité contextuelle) et les retrace à travers treize principes de conception jusqu'à des choix d'implémentation spécifiques. Le cœur du système est une simple boucle while qui appelle le modèle, exécute les outils et répète le processus. Cependant, la majeure partie du code réside dans les systèmes entourant cette boucle : un système de permissions avec sept modes et un classifieur basé sur le ML, un pipeline de compaction à cinq couches pour la gestion du contexte, quatre mécanismes d'extensibilité (MCP, plugins, compétences et hooks), un mécanisme de délégation de sous-agents avec isolation des arborescences de travail, et un stockage de session orienté ajout. Une comparaison avec OpenClaw, une passerelle d'assistant personnel multi-canaux, montre que les mêmes questions de conception récurrentes produisent des réponses architecturales différentes lorsque le contexte de déploiement change : d'une classification de sécurité par action à un contrôle d'accès au niveau du périmètre, d'une boucle CLI unique à un runtime embarqué dans un plan de contrôle de passerelle, et d'extensions de fenêtre contextuelle à l'enregistrement de capacités à l'échelle de la passerelle. Nous identifions enfin six orientations de conception ouvertes pour les futurs systèmes agentiques, fondées sur la littérature empirique, architecturale et politique récente.

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.