Пространство дизайна современных и будущих систем агентов ИИ

Английский | 中文

Всесторонний архитектурный анализ Claude Code на уровне исходного кода (v2.1.88, ~1 900 файлов TypeScript, ~512 тысяч строк кода), в сочетании с отображённой коллекцией анализов сообществ, руководством по пространству проектирования для конструкторов агентов и сравнением между системами.

[! СОВЕТ] TL; DR — Только 1,6% кодовой базы Claude Code — это логика принятия решений на основе ИИ. Остальные 98,4% — это детерминированная инфраструктура — элементы разрешений, управление контекстом, маршрутизация инструментов и логика восстановления. Цикл агента — это простой цикл while; настоящая инженерная сложность заключается в окружающих системах. Этот репозиторий разбирает эту архитектуру и превращает её в практические руководства по проектированию для всех, кто строит системы агентов ИИ.

---

Содержание

Из нашей газеты

• 🌟 Ключевые моменты
• 📖 Руководство по чтению
• 🏗️ Архитектура с первого взгляда
• 🧭 Ценности и принципы проектирования
• 🔄 Агентный цикл запросов
• 🛡️ Безопасность и разрешения
• 🧩 Расширяемость
• 🧠 Контекст и память
• 👥 Делегация субагентов
• 💾 Сохранение сессии

За пределами бумаги

• 🛰️ Новые сигналы в пространстве проектирования агентов

Dive into Claude Code

The Design Space of Today’s and Future AI Agent Systems

English | 中文

A comprehensive source-level architectural analysis of Claude Code (v2.1.88, ~1,900 TypeScript files, ~512K lines of code), combined with a curated collection of community analyses, a design-space guide for agent builders, and cross-system comparisons.

[!TIP] TL;DR – Only 1.6% of Claude Code’s codebase is AI decision logic. The other 98.4% is deterministic infrastructure – permission gates, context management, tool routing, and recovery logic. The agent loop is a simple while-loop; the real engineering complexity lives in the systems around it. This repo dissects that architecture and distills it into actionable design guidance for anyone building AI agent systems.

---

Table of Contents

From Our Paper

• 🌟 Key Highlights
• 📖 Reading Guide
• 🏗️ Architecture at a Glance
• 🧭 Values and Design Principles
• 🔄 The Agentic Query Loop
• 🛡️ Safety and Permissions
• 🧩 Extensibility
• 🧠 Context and Memory
• 👥 Subagent Delegation
• 💾 Session Persistence

Beyond the Paper

• 🛰️ New Signals in the Agent Design Space
• 🛠️ Build Your Own AI Agent: A Design Guide
• ⚖️ Cross-System Comparison: Claude Code vs OpenClaw vs Hermes-Agent
• 🔎 Find Resources by Design Question
• 🌐 Community Projects & Research
• 🚀 Other Notable AI Agent Projects
• 🤝 Contributing
• 🔖 Citation

---

Key Highlights