这是一个围绕 Claude Code 源码快照整理的研究型仓库，重点不是“如何运行这个项目”，而是：
- 理解它的总体架构
- 理解它的运行时、工具系统和权限边界
- 理解它的 MCP / 插件 / 技能 / 远程体系
- 为安全研究、产品分析和工程研究提供材料
如果你是第一次打开这个仓库，建议不要直接从 src/ 开始读，而是先从下面的文档入口进入。
- 分析首页：
ANALYSIS_README.md - 模块总览：
PROJECT_MODULE_ANALYSIS.md - 分卷电子书：
docs/book/README.md - 发布整理说明：
docs/PUBLISHING_NOTES.md
ANALYSIS_README.mdPROJECT_MODULE_ANALYSIS.mddocs/book/02-overall-architecture.mddocs/book/03-execution-chain-and-runtime.mddocs/book/17-security-review.md
PROJECT_MODULE_ANALYSIS.mddocs/book/01-project-positioning-and-snapshot-boundary.mddocs/book/02-overall-architecture.mddocs/book/03-execution-chain-and-runtime.mddocs/book/05-tool-system.md
docs/book/05-tool-system.mddocs/book/06-permissions-policy-and-sandbox.mddocs/book/09-mcp-ecosystem.mddocs/book/12-remote-bridge-and-direct-connect.mddocs/book/17-security-review.md
docs/book/02-overall-architecture.mddocs/book/07-repl-tui-and-interaction.mddocs/book/08-state-session-and-recovery.mddocs/book/12-remote-bridge-and-direct-connect.mddocs/book/18-product-review.md
| 文档 | 作用 |
|---|---|
README.md |
仓库首页与中文导航入口 |
ANALYSIS_README.md |
分析材料总入口 |
PROJECT_MODULE_ANALYSIS.md |
单文件模块地图与阅读指南 |
docs/book/README.md |
章节化电子书目录 |
docs/book/ |
分章深度分析正文 |
docs/PUBLISHING_NOTES.md |
发布与整理建议 |
src/ |
源码快照本体 |
目前文档已经系统覆盖：
- 项目定位与快照边界
- 总体架构与主执行链
- 命令系统与工具系统
- 权限、策略与沙箱
- REPL / TUI / 状态恢复
- MCP、插件、技能、LSP
- 远程、桥接、Direct Connect
- 记忆系统与上下文注入
- API、认证、订阅、配额与产品控制面
- 安全视角、产品视角与工程成熟度总结
并且关键章节已经补了 Mermaid 图，适合直接在 GitHub 上阅读和跳转。
这不是官方开发仓库，也不是可直接运行的完整工程。更准确地说，它是一个围绕 Claude Code 源码快照建立起来的研究仓库。
当前仓库更适合用来：
- 阅读架构
- 做安全研究
- 做产品与工程分析
- 写博客、做分享或整理报告
不适合直接当作：
- 官方源码镜像
- 可直接构建发布的完整项目
- 法律意义上的原始开发仓库
这个仓库整理的对象，是一份通过 npm 分发链路中的 source map 暴露而可被获取的 Claude Code 源码快照。仓库保留这份材料的目的，是用于：
- 教育用途
- 防御性安全研究
- 软件供应链分析
- agent 系统架构研究
它不代表对原始代码拥有所有权，也不应被理解为官方 Anthropic 仓库。
如果你现在就想开始看内容，最推荐直接点这里：
如果你想从“完整地图”开始：
如果你想按书的方式系统阅读：