← 学习导览
SOURCE STUDY · 2026

Claude Code 源码学习

不是一次性的阅读笔记,而是一个可以持续生长的知识库 —— 由 Obsidian + Claude Code 协作完成,按"第一性原理 + MECE"组织,从问题推导到源码印证。

STEP 01
确定范围
探索源码,与人确认涉及哪些文件
STEP 02
第一性原理
先推"本质上该怎么设计",再用源码印证
STEP 03
MECE 组织
按生命周期或数据流切分,不遗漏不重叠
STEP 04
大白话 + 核心代码
比喻解释概念,只放最关键的 5–15 行
核心系统三篇全部上线 · 推荐顺序阅读
01
记忆系统详解
四阶段完整 · v1.2
从"LLM 天然没有记忆"出发,按写入 → 存储 → 检索 → 注入四阶段拆解。Auto Memory 与 CLAUDE.md 双管道、MEMORY.md 索引截断、Sonnet 侧面查询挑选、过期警告。
写入存储检索注入
src/memdir/
阅读 →
02
Agent 系统详解
五阶段完整 · v0.6
主 Claude 怎么"派活"给子 Agent。6 种内置 Agent 的 whenToUse、生成器执行模式、邮箱通信、worktree 隔离、Fork 模式(未启用)的设计动机。
定义创建执行通信隔离
src/tools/AgentTool/
阅读 →
03
工具系统详解
四阶段+分类 · v0.3
LLM 没有手,工具就是手。Tool 接口与 fail-closed 默认值、条件加载与 require 死代码消除、五步执行链路(验证/权限/钩子/调用/序列化)、并发分批 vs 流式执行。
定义注册执行编排分类
src/Tool.ts · tools.ts
阅读 →
项目认知背景与方法论
0b
项目说明
待上线
学习方法论:Obsidian + Claude Code 协作、固定的 source-study 工作流、迭代打磨过程、双链构建知识网络。
doc/0b-项目说明.md
即将上线
0a
文档规范
待上线
doc/ 目录下笔记的写作规范:frontmatter 字段、标题层级、MECE 章节、引用格式、版本记录。
doc/0a-文档规范.md
即将上线
0c
未启用特性附录
待上线
源码中因 feature flag 关闭而未启用的特性汇总:FORK_SUBAGENT、COORDINATOR_MODE、EXTRACT_MEMORIES 等。
doc/0c-附录-未启用特性.md
即将上线
实战案例还原真实链路
F
Feedback 文件示例
待上线
一个真实的 feedback 类型记忆文件长什么样:frontmatter、Why、How to apply 三要素的具体写法。
doc/01-例子-Feedback文件.md
即将上线
A
Agent 实战 · 工具文档生成
待上线
以"生成全部工具文档"任务为例,还原多 Agent 并行的全链路:主 Claude 拆活、Agent 派出、结果汇总。
doc/02-01-Agent实战案例-工具文档生成.md
即将上线
待补充持续生长
+
入口链路 / Hooks / Plugins / Ink / Voice / Remote …
规划中
按相同的"第一性原理 + MECE"模板继续推进,每完成一篇就上架到这里。
src/entrypoints · hooks · plugins · ink · voice · remote
规划中