Claude Code 架构分析：对 TypeScript 源码的逆向工程揭示了 AI 智能体工具的 5 项核心价值与 13 项设计原则

这篇论文做了什么？

研究团队（刘嘉诚、赵晓涵、尚欣怡、沈志强）于 2026 年 4 月 17 日在 arXiv 上发表了对 Claude Code 架构的深度分析——这是 Anthropic 的 AI 编程智能体，过去一年已成为该类别中最具影响力的工具之一。

方法颇为独特：作者对已发布 Claude Code 软件包的 TypeScript 源码进行逆向工程（作为 npm 模块发布，技术上可读），绘制架构图，并与 OpenClaw——试图复制 Claude Code 功能的开源智能体——进行对比。

目标不是”复制 Claude Code”，而是：理解 Anthropic 隐式遵循的设计原则，以便更广泛的社区能构建更好的智能体。

发现了什么——5 项核心价值

分析提炼出 5 项价值，它们在结构上指导着 Claude Code 的架构：

1. 人类权威 — 用户始终拥有最终决定权。智能体可以建议、规划、执行——但关键决策（破坏性操作、提交代码、部署）需要明确批准。

2. 安全性 — 多层防御：运行时权限、沙箱化、审计日志、回滚。智能体不能”意外”破坏项目。

3. 执行力 — 智能体不仅谈论解决方案，还付诸实施。Shell 访问、文件编辑、git 操作——均在同一上下文中完成。

4. 能力 — 广泛的工具集（bash、read、edit、grep、网络抓取等）使智能体适用于真实工作，而非仅演示。

5. 适应性 — 技能机制无需重新编译即可扩展。MCP 服务器访问支持与外部系统的集成。

作者随后推导出 13 项设计原则，将上述 5 项价值付诸实践——例如”每个破坏性工具需要明确批准”、“上下文保留不超过 N 条消息以提高令牌效率”、“工具结果作为下一个输入返回给模型，不混淆角色”。

惊喜：核心是简单的 while 循环

论文最有趣的发现是 Claude Code 的核心实际上非常简单：

while not done:
    response = model(current_context)
    if response contains tool_call:
        result = execute_tool(tool_call)
        context.append(result)
    else:
        wait_for_user_input()

所有复杂性——智能性、上下文、工具、安全性——都在于：

• 提示词和系统消息（如何指导模型）
• 工具集及其权限（智能体可以做什么，在什么条件下）
• 上下文管理（保留什么、压缩什么、删除什么）

核心中没有神奇的”智能体编排”库。只有循环、模型和精心设计的工具。

为何这对所有构建智能体的人都重要？

结论意义深远：

• 不需要复杂框架。 LangGraph、CrewAI、AutoGen、AGP——都提供丰富的编排功能，但 Claude Code 表明强大的简单性同样具有竞争力。
• 价值观 > 功能。 Anthropic 遵循的 5 项核心价值在产品的每个方面都清晰可见——从用户体验到安全阈值。
• OpenClaw 复制品证实： 如果价值观和工具定义得当，用简单架构构建有竞争力的智能体是可能的。

本文是预印本。代码可获取（论文提及可重现性），分析足够具体，可作为自己智能体项目的蓝图。对于正在考虑在 AI 智能体领域自建还是采购的工程师——这是必读的参考点。