Tutorial ｜在本地研究 Claude Code 源码¶

难度：⭐⭐ 时间：~30 min 前置：基本 Git + 命令行 + 一个趁手的编辑器产物：把源码放到本地，能高效跳转阅读 + 跑配套练习测试

1. 为什么要在本地读¶

在线浏览适合速览，但深入研究时本地有明显优势：

⚠️ 源码不含 package.json / 锁文件 / node_modules —— 主体不能 bun install 跑起来，研究以纯读代码为主。能跑的只有 learn_doc/practice-tests/ 这个独立练习工程（见第 5 节）。

把源码放到一个本地目录，保持 src/ 在根：

mkdir -p ~/code/cc-source && cd ~/code/cc-source
# 把源码放进来，确保目录结构是 src/ + learn_doc/ + ...

本手册所有文件路径都以 src/ 为根，例如 src/main.tsx:42。

code ~/code/cc-source

常用操作：

手册里随处可见 src/xxx.ts:123 这样的引用：

时长	路径
1 小时	00-index.md 技术栈 + 架构骨架 → phase-01-entry.md
5-8 小时	通读 7 阶段（phase-01 ~ phase-07）
深入	挑感兴趣的 deep-dive（17 篇源码深度拆解）

learn_doc/practice-tests/ 是一个独立的小工程（有自己的依赖配置），可以真正跑起来：

cd learn_doc/practice-tests
# 按该目录的 README 安装依赖后：
npm test     # 或 bun test / pnpm test

里面是对照手册练习的答案测试（手写 Store、5 行 agent loop、LRU cache、GitCommitTool 等），跑一遍能验证你对核心抽象的理解。