这一章回答三个基础问题：
- 这个仓库到底是什么。
- 它适合拿来做什么。
- 它不适合被当成什么。
当前仓库不是官方 Claude Code 开发仓库，而是一个以研究为目的保存的源码快照镜像。对读者来说，它最适合用于架构阅读、功能映射、安全研究、供应链分析和静态逆向，不适合直接当作“可完整编译运行的上游源码仓库”。
- 顶层说明：README.md
- 入口文件：src/main.tsx
- 命令注册表：src/commands.ts
- 工具注册表：src/tools.ts
flowchart LR
A[本仓库] --> B[README.md\n中文入口与导航]
A --> C[docs/\n文档化解析]
A --> D[src/\nClaude Code 源码快照]
D --> E[可静态分析]
D --> F[可提炼架构与设计]
A -.缺失.-> G[完整构建元数据]
A -.需真实环境验证.-> H[OAuth / Remote / IDE / MCP 外部系统]
从 README.md 可以确认，这个仓库被维护者定义为：
- 通过 npm 分发产物中的 source map 暴露出来的源码快照。
- 用于教育、防御性安全研究与供应链分析。
- 不主张对原始代码拥有所有权。
- 不应被视为官方 Anthropic 仓库。
从目录结构也能印证这一点：顶层只有 README.md 和 src/，没有常见的工程化文件。这说明你手里的更像是“足够用于阅读内部实现的源码镜像”，而不是完整的开发工作区。
- 阅读 Claude Code 的总体架构和模块边界。
- 分析 CLI、工具调用、权限控制、多代理、Bridge、MCP、插件等能力的设计。
- 做静态安全研究，例如 source map 暴露后的可见面、权限设计、防护思路。
- 为研究报告、课程展示、内部分享、技术博客撰写结构化说明。
- 结合源码做能力盘点，评估某个功能是不是内建、特性开关控制，还是由插件/MCP 扩展提供。
- 直接把这个仓库当成可运行的官方开发环境。
- 假设所有功能都能在当前仓库中直接启动、登录、联网验证。
- 把 README 的背景叙述等同于上游产品文档。
- 推断“当前线上产品一定等于这个快照”。
基于当前可见文件，至少存在以下边界：
- 未看到完整的构建元数据，例如
package.json、bunfig.toml、tsconfig.json。 - 很多能力显然依赖真实账号、真实服务端、真实 IDE/远程环境，比如 OAuth、Bridge、CCR、Remote Session、MCP 网络服务。
- 大量功能由
bun:bundle的 feature flag 控制，源码存在不代表当前分发版本一定启用。 - 顶层仓库没有配套文档站和测试入口，因此“如何运行”不能只靠本仓库回答。
推荐把它当成三件东西的组合：
- 一个 CLI/TUI 产品的源码切面。
- 一个功能注册中心样本。
- 一个横向扩展系统的研究材料。
更具体地说：
- 想理解“产品有哪些能力”，看 src/commands.ts 和 src/tools.ts。
- 想理解“程序是怎么起来的”，看 src/main.tsx。
- 想理解“交互时真正发生了什么”，看 src/QueryEngine.ts。
- 想理解“安全边界在哪”，看 src/utils/permissions。
后续文档都基于以下默认前提：
- 这是研究型源码快照，不是完整开发仓库。
- 文档只对源码能确认的行为做强结论。
- 涉及运行时外部系统的内容，只做结构说明，不假设一定可在本仓库复现。