当今及未来AI代理系统的设计空间

英文 |中文

对Claude代码（v2.1.88，~1,900个TypeScript文件，~51.2万行代码）的全面源代码级架构分析，结合精心策划的社区分析集、面向代理构建者的设计空间指南及跨系统比较。

[!提示] TL;DR——Claude Code 代码库中只有 1.6% 是 AI 决策逻辑。另外 98.4% 是确定性基础设施——权限门、上下文管理、工具路由和恢复逻辑。代理循环是一个简单的 while-循环;真正的工程复杂性存在于其周围的系统中。该仓库剖析了该架构，并将其提炼为任何构建 AI 代理系统的可操作设计指导。

---

目录

摘自我们的报纸

• 🌟 主要亮点
• 📖 阅读指南
• 🏗️ 建筑一览
• 🧭 价值观与设计原则
• 🔄 代理查询循环
• 🛡️ 安全与许可
• 🧩 可扩展性
• 🧠 语境与记忆
• 👥 子代理委派
• 💾 会话持久性

超越纸张

• 🛰️ 代理设计空间中的新信号

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