LLMs之PE之SystemPrompt：analysis_claude_code的简介、使用方法、案例应用之详细攻略-EW帮帮网

2025年7月，analysis_claude_code项目是一个对 Claude Code v1.0.33 版本进行深度逆向工程分析的完整研究资料库。其核心内容是通过对超过 50,000 行混淆的源代码进行系统性的技术分析，揭示这一现代 AI 编程助手的核心架构设计、实现机制和运行逻辑。注意，该研究项目并非官方出品，而是研究人员在学习“Agent 模型公司是如何做 Agent 工程？”时，借助 Claude Code 工具自身来分析其混淆后代码的产物。因此，分析结果仅供技术参考和学习，可能并非 100% 准确。

项目的研究目标包括：

深度理解：深入理解 Claude Code 的系统架构和核心机制。
完整还原：还原混淆代码背后的技术实现逻辑。
严格验证：确保分析结果的准确性和一致性。
开源重建：为复现类似系统提供技术实现指南。
知识共享：为 AI Agent 系统的设计与实现提供宝贵的技术参考。

GitHub地址：https://github.com/shareAI-lab/analysis_claude_code

1、核心技术特点与发现

通过对 Claude Code 的逆向分析，该项目揭示了其内部的多项突破性技术创新和核心机制：

实时 Steering 机制

基础架构：采用了名为 h2A 的双重缓冲异步消息队列。
核心特性：实现了零延迟的消息传递，吞吐量可超过每秒 10,000 条消息。
实现原理：基于 Promise 的异步迭代器，并结合了智能背压控制，实现了真正的非阻塞异步处理，从而支持实时的流式响应。

分层多 Agent 架构

主 Agent (nO)：作为主循环引擎，负责核心任务的调度和状态管理。
SubAgent (I2A)：作为子任务代理，为不同的任务提供隔离的执行环境。
Task Agent：专用的任务处理器，支持并发执行。
权限隔离：每个 Agent 都拥有独立的权限范围和资源访问控制，确保了系统的稳定性和安全性。

智能上下文管理

自动压缩：当 Token 使用量达到 92% 的阈值时，系统会自动触发上下文压缩。
内存优化：使用名为 wU2 的压缩器，能够智能地保留对话中的关键信息。
持久化存储：通过 CLAUDE.md 文件作为长期记忆的存储介质，用于保存用户偏好和配置信息。
动态管理：系统会根据 Token 的使用情况动态调整上下文窗口的大小。

强化安全防护

6 层权限验证：构建了从用户界面（UI）输入到工具执行的完整安全链，覆盖了消息路由、工具调用、参数内容、系统资源访问和输出过滤等多个层面。
沙箱隔离：所有的工具执行都在一个完全隔离的沙箱环境中进行，防止恶意代码影响系统。
输入验证：具备多层次的恶意输入检测和过滤机制。
权限网关：实现了细粒度的功能权限控制。

2、系统架构全景

                    Claude Code Agent 系统架构
    ┌─────────────────────────────────────────────────────────────────┐
    │                        用户交互层                               │
    │   ┌─────────────┐  ┌─────────────┐  ┌─────────────┐           │
    │   │   CLI接口   │  │  VSCode集成 │  │   Web界面   │           │
    │   │   (命令行)  │  │   (插件)    │  │  (浏览器)   │           │
    │   └─────────────┘  └─────────────┘  └─────────────┘           │
    └─────────────┬───────────────┬───────────────┬───────────────────┘
                  │               │               │
    ┌─────────────▼───────────────▼───────────────▼───────────────────┐
    │                      Agent核心调度层                           │
    │                                                                 │
    │  ┌─────────────────┐         ┌─────────────────┐               │
    │  │  nO主循环引擎   │◄────────┤  h2A消息队列   │               │
    │  │  (AgentLoop)    │         │  (AsyncQueue)   │               │
    │  │  • 任务调度     │         │  • 异步通信     │               │
    │  │  • 状态管理     │         │  • 流式处理     │               │
    │  │  • 异常处理     │         │  • 背压控制     │               │
    │  └─────────────────┘         └─────────────────┘               │
    │           │                           │                         │
    │           ▼                           ▼                         │
    │  ┌─────────────────┐         ┌─────────────────┐               │
    │  │  wu会话流生成器 │         │  wU2消息压缩器  │               │
    │  │ (StreamGen)     │         │ (Compressor)    │               │
    │  │  • 实时响应     │         │  • 智能压缩     │               │
    │  │  • 流式输出     │         │  • 上下文优化   │               │
    │  └─────────────────┘         └─────────────────┘               │
    └─────────────┬───────────────────────┬─────────────────────────────┘
                  │                       │
    ┌─────────────▼───────────────────────▼─────────────────────────────┐
    │                     工具执行与管理层                              │
    │                                                                   │
    │ ┌────────────┐ ┌────────────┐ ┌────────────┐ ┌─────────────────┐│
    │ │MH1工具引擎 │ │UH1并发控制│ │SubAgent管理│ │  权限验证网关   ││
    │ │(ToolEngine)│ │(Scheduler) │ │(TaskAgent) │ │ (PermissionGW)  ││
    │ │• 工具发现  │ │• 并发限制  │ │• 任务隔离  │ │ • 权限检查     ││
    │ │• 参数验证  │ │• 负载均衡  │ │• 错误恢复  │ │ • 安全审计     ││
    │ │• 执行调度  │ │• 资源管理  │ │• 状态同步  │ │ • 访问控制     ││
    │ └────────────┘ └────────────┘ └────────────┘ └─────────────────┘│
    │       │              │              │              │            │
    │       ▼              ▼              ▼              ▼            │
    │ ┌────────────────────────────────────────────────────────────────┐│
    │ │                    工具生态系统                              ││
    │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐││
    │ │ │ 文件操作工具│ │ 搜索发现工具│ │ 任务管理工具│ │ 系统执行工具│││
    │ │ │• Read/Write │ │• Glob/Grep  │ │• Todo系统   │ │• Bash执行   │││
    │ │ │• Edit/Multi │ │• 模式匹配   │ │• 状态跟踪   │ │• 命令调用   │││
    │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘││
    │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐││
    │ │ │ 网络交互工具│ │ 特殊功能工具│ │ MCP集成工具 │ │ 开发者工具  │││
    │ │ │• WebFetch   │ │• Plan模式   │ │• 协议支持   │ │• 代码诊断   │││
    │ │ │• WebSearch  │ │• 退出计划   │ │• 服务发现   │ │• 性能监控   │││
    │ │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘││
    │ └────────────────────────────────────────────────────────────────┘│
    └─────────────┬─────────────────────────────────────────────────────┘
                  │
    ┌─────────────▼─────────────────────────────────────────────────────┐
    │                    存储与持久化层                                │
    │                                                                   │
    │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
    │ │短期记忆存储 │ │中期压缩历史 │ │长期持久存储 │ │状态缓存系统 │ │
    │ │(Messages)   │ │(Compressed) │ │(CLAUDE.md)  │ │(StateCache) │ │
    │ │• 当前会话   │ │• 历史摘要   │ │• 用户偏好   │ │• 工具状态   │ │
    │ │• 上下文队列 │ │• 关键信息   │ │• 配置信息   │ │• 执行历史   │ │
    │ │• 临时缓存   │ │• 压缩算法   │ │• 持久化机制 │ │• 性能指标   │ │
    │ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
    └───────────────────────────────────────────────────────────────────┘

3、仓库结构

about_claude_code/
├── claude_code_v_1.0.33/                    # v1.0.33版本完整分析工作区
│   └── stage1_analysis_workspace/           # 第一阶段分析结果
│       ├── Claude_Code_Agent系统完整技术解析.md  # 核心技术解析文档
│       ├── chunks/                          # 代码分块文件 (102个)
│       │   ├── chunks.1.mjs ~ chunks.102.mjs  # 去混淆后的代码块
│       │   ├── chunks.index.json            # 分块索引文件
│       │   └── cli.chunks.mjs               # CLI主文件分块
│       ├── analysis_results/                # 分析结果汇总
│       │   └── merged-chunks/               # 合并优化的代码块
│       ├── scripts/                         # 分析脚本工具集
│       │   ├── beautify.js                  # 代码美化脚本
│       │   ├── split.js                     # 代码分割脚本
│       │   ├── merge-again.js               # 代码合并脚本
│       │   └── llm.js                       # LLM分析接口
│       ├── docs/                            # 详细技术文档集
│       └── source/                          # 原始源码文件
├── work_doc_for_this/                       # 项目工作文档
│   ├── CLAUDE_CODE_REVERSE_SOP.md           # 逆向工程标准作业程序
│   ├── stage_1_analysis_sop.md              # 第一阶段分析方法论
│   └── stage_2_reconstruction_sop.md        # 第二阶段重建方法论
├── LICENSE                                  # 开源许可证
└── README.md                                # 项目说明文档

analysis_claude_code的分析方法

该仓库本身不是一个可直接安装使用的软件，而是研究资料。其“使用方法”即为理解其逆向工程的分析方法论，主要分为两个阶段：

第一阶段：静态代码分析

代码预处理 (Pre-processing)：

首先使用 beautify.js 脚本对原始的混淆代码进行美化和格式化，提高可读性。

接着运行 split.js 脚本，将美化后的主文件智能地分割成 102 个更小的代码块，便于逐一分析。

最后生成分块索引文件，方便管理和查找。

LLM 辅助分析 (LLM-Assisted Analysis)：

利用 GPT-4 等大语言模型来识别代码中的设计模式和整体架构。

对混淆后的函数进行逐一解析，理解其具体逻辑。

构建不同模块之间的依赖关系图，并追踪关键 API 的调用链。

交叉验证 (Cross-Validation)：

进行多轮（3轮）深度分析，以确保结果的准确性。

检查不同技术文档描述之间的一致性。

确保每一个技术论断都有源代码的具体位置作为支撑。

第二阶段：动态行为验证

运行时分析 (Runtime Analysis)：

通过工具追踪关键函数的实际执行路径。

监控系统在运行过程中核心状态的变化。

收集内存使用和执行时间等性能指标数据。

集成测试 (Integration Testing)：

验证不同组件之间交互逻辑的正确性。

在极限条件下测试系统的稳定性和行为。

验证系统的错误处理和恢复机制是否按预期工作。

analysis_claude_code的应用场景与价值

该项目的研究成果具有多方面的应用价值，为不同领域的人员提供参考：

教育研究价值：

AI Agent 架构学习：提供了一个完整的现代 AI Agent 系统的实现案例。

异步编程模式：展示了高性能异步系统的设计思想和实现参考。

安全架构设计：是学习多层安全防护实现方案的绝佳材料。

性能优化技巧：分享了内存管理和并发控制方面的最佳实践。

系统设计参考：

架构模式借鉴：可以借鉴其分层架构和组件化的设计思想。

工具系统设计：为设计插件化的工具执行框架提供灵感。

状态管理方案：提供了分布式状态同步机制的参考。

安全分析应用：

安全机制审计：可用于分析和审计多层权限验证的实现细节。

沙箱技术研究：有助于理解隔离执行环境的设计原理。

输入验证模式：展示了恶意输入检测和过滤的技术。

开源开发指导：

项目架构搭建：为开发类似的 AI Agent 系统提供架构设计蓝图。

核心组件实现：为关键组件的开源实现提供详细指南。

测试策略制定：基于其分析结果，可以设计出更全面的测试用例。

LLMs之PE之SystemPrompt：analysis_claude_code的简介、使用方法、案例应用之详细攻略

相关文章