Погружение в код Клода: Пространство проектирования современных и будущих систем ИИ-агентов
Dive into Claude Code: The Design Space of Today's and Future AI Agent Systems
April 14, 2026
Авторы: Jiacheng Liu, Xiaohan Zhao, Xinyi Shang, Zhiqiang Shen
cs.AI
Аннотация
Claude Code — это инструмент агентного кодирования, способный выполнять shell-команды, редактировать файлы и вызывать внешние сервисы от имени пользователя. В данном исследовании описывается его комплексная архитектура на основе анализа публично доступного исходного кода на TypeScript, а также проводится сравнение с OpenClaw — независимой системой ИИ-агентов с открытым исходным кодом, которая предлагает альтернативные решения для схожих проектных задач в ином контексте развертывания. Наш анализ выявляет пять человеческих ценностей, философских установок и потребностей, лежащих в основе архитектуры (авторитет человеческих решений, безопасность и защищенность, надежное выполнение, усиление возможностей и контекстная адаптивность), и прослеживает их через тринадцать проектных принципов до конкретных реализационных решений. Ядро системы представляет собой простой цикл while, который вызывает модель, запускает инструменты и повторяется. Однако большая часть кода сосредоточена в подсистемах, окружающих этот цикл: система разрешений с семью режимами и ML-классификатором, пятиуровневый конвейер компрессии для управления контекстом, четыре механизма расширяемости (MCP, плагины, навыки и хуки), механизм делегирования суб-агентам с изоляцией рабочих деревьев и сессионное хранилище с добавлением записей. Сравнение с OpenClaw, многоканальным шлюзом персонального ассистента, показывает, что одни и те же повторяющиеся проектные вопросы порождают различные архитектурные ответы при изменении контекста развертывания: от классификации безопасности на уровне действия до контроля доступа на уровне периметра, от единого CLI-цикла до встраиваемой среды выполнения в плоскости управления шлюзом и от расширения контекстного окна до регистрации возможностей на уровне шлюза. В заключение мы определяем шесть открытых проектных направлений для будущих систем агентов, основанных на recent эмпирической, архитектурной и политической литературе.
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.