claude-code-analysis README

The project's README from github.com/liuup/claude-code-analysis. As one markdown file: README.md.

Claude code 源码分析

事件背景

美国东部时间2026年3月31日凌晨4点23分，安全研究者 Chaofan Shou 在 X 发布推文, 发现 Anthropic 发布到 npm 的 Claude Code 包中，官方没有删除source map 文件, 这意味着 Claude Code 的完整 TypeScript 源码全部泄露, 包含 1902 个源文件以及 513,237 行代码.

目录结构

本仓库为对 Claude Code 泄露源码的静态分析文档集

claude-code-analysis/
├── README.md                        # 本说明文档（总索引）
├── analysis/                        # 分析文档主目录
├── src.zip                          # 源代码压缩包
└── src/                             # 源代码（仅供分析跳转引用）

总述

本目录中的分析文档基于 src/ 源码静态阅读整理，主要探讨以下系统设计问题：

  1. 软件架构设计与程序启动路径。
  2. 安全分析：用户信息的收集、利用情况，潜在的安全风险及防范措施。
  3. Agent Memory 机制（多层级存储与 Session 压缩逻辑）及实现细节。
  4. 能力扩充机制（Skills 扩展、Tool Call 机制、MCP 集成）的技术实现及运行方式。
  5. 隔离机制：通过 Sandbox 防范本地操作风险的设计与实现。
  6. 内部程序架构设计与模块特点。
  7. UI 拆解：src/components/ 内 TUI 控制台的组件构成。
  8. 竞品对比：与 Codex、Gemini CLI、Aider、Cursor 等工具的功能及体系差异分析。
  9. 源码证据与外部公开资料对照。

主要系统特征：

一图总览

+---------------------------+
| CLI / 多入口               |
| entrypoints/cli.tsx       |
| main.tsx                  |
+---------------------------+
            |
            v
+---------------------------+
| 初始化与运行环境             |
| init.ts / setup.ts        |
+---------------------------+
      |                |
      v                v
+----------------+   +---------------------------+
| 命令与控制面     |   | TUI / REPL 工作台          |
| commands.ts    |-->| App / REPL / Messages     |
| PromptInput... |   | / PromptInput             |
+----------------+   +---------------------------+
                             |
                             v
                  +---------------------------+
                  | Query / Agent 执行内核     |
                  | query.ts / QueryEngine.ts |
                  +---------------------------+
                    |           |           |
                    v           v           v
          +---------------+ +--------------------+ +----------------------+
          | Tool/Perm     | | Transcript/Memory  | | 平台扩展层             |
          | Tool.ts       | | sessionStorage     | | MCP/Plugin/Remote/   |
          | orchestration | | memdir/SessionMem  | | Swarm                |
          +---------------+ +--------------------+ +----------------------+
                    \______________   |   ______________/
                                   \  |  /
                                    \ v /
                              回流到执行内核

分章目录

第一部分：总体架构

第二部分：安全分析

第三部分：核心机制

第四部分：程序架构及亮点

第五部分：扩展分析

第六部分：组件体系详解

第七部分：同类产品对比

第八部分：证据与资料

第九部分：总结

声明

本项目仅供学术研究与技术学习使用。

本仓库所有内容均为对公开信息的二次整理与分析。Claude Code 的所有权利归 Anthropic 所有。

  1. 无侵权意图：本分析文档基于已在公共互联网上广泛流传的信息整理撰写，目的在于帮助开发者了解 AI Coding Agent 的安全边界、隐私设计与工程架构，属于正当的技术研究行为。
  2. 禁止商业使用：禁止将本仓库内容用于任何商业目的，或以此绕过、破坏 Claude Code 的安全机制与用户协议。
  3. 免责声明：本仓库作者不对因参考本文档而产生的任何直接或间接损失负责。如有任何合规疑虑，请以 Anthropic 官方文档与用户协议为准。
  4. 如需删除：若 Anthropic 认为本仓库内容侵犯其合法权益，请通过 Issue 联系，我们将在核实后第一时间进行删除处理。

Star History

Star History Chart

claude-code-analysis (liuup/claude-code-analysis)

Searching Database…

4K ·GitHub
Claude-code-analysis
Что это такое?Коллекция документов на китайском языке со статическим анализом, препарирующая исходный код Claude Code после того, как его npm-пакет случайно поставлялся с несжатыми source maps, раскрывшими полный код на TypeScript.
Это инструмент, который я запускаю, или то, что я читаю?Это набор markdown-глав и приложений, а не исполняемое ПО — здесь нечего устанавливать и запускать, только документы для чтения на GitHub.
Как изучить этот анализ?Откройте оглавление глав в README и перейдите к markdown-файлу нужной темы — от архитектуры и безопасности до Memory, Skills, MCP, Sandbox и UI-компонентов.
Нужны ли какие-то инструменты или API-ключ, чтобы этим пользоваться?Нет, это статичный репозиторий документации без кодовых зависимостей, пакетного менеджера и требований к API-ключу.
Это официально одобрено Anthropic?Нет — авторы заявляют, что это материал только для академических/технических исследований, запрещают коммерческое использование и удалят контент, если Anthropic возразит; все права на Claude Code остаются у Anthropic.
Кому было бы интересно это прочитать?Разработчикам и исследователям безопасности, которым любопытно, как внутри реально устроен боевой AI-агент для кодинга — его система памяти, песочница, механика tool-call/MCP и TUI-компоненты.
Насколько большим был утёкший исходный код?Согласно отчёту, утёкший пакет Claude Code раскрыл его полный исходный код на TypeScript: 1902 файла исходников общим объёмом 513 237 строк кода.
Какие темы охватывает анализ?Восемнадцать глав плюс приложения, охватывающие архитектуру программы, сбор пользовательских данных и риски безопасности, Agent Memory, Skills, механику Tool Call, интеграцию MCP, изоляцию Sandbox, управление контекстом/промптами, мультиагентную логику, сохранение сессий и полный разбор дерева TUI-компонентов.
Сравнивает ли он Claude Code с другими агентами для кодинга?Да, глава 16 и приложение сравнивают архитектуру и возможности Claude Code с Codex, Gemini CLI, Aider и Cursor.
Утверждения подкреплены реальным кодом или это просто догадки?Авторы говорят, что анализ основан на статическом чтении утёкшей директории src/, а отдельная глава (17) и приложение с деревом файлов сверяют утверждения с доказательствами из исходников и публичной документацией.
What are similar projects?how-claude-code-works, CodeMason, qwen-code, claude-code-book, ai-agent-deep-dive, learn-coding-agent, rea, lean-ctx
Which topics is it in?source-code-analysis, security-research, static-analysis, agent-memory, sandbox, academic-research, reverse-engineering, anthropic, china, agents, documentation, coding-agent
Creator
liuup
Size
18.5 MB
Stars
4K
Updated
CommitApr 02
Age
6mo
Commits · 90 Days