​
快速启动总览

“快速启动”不是目录罗列，而是把这份源码压缩成一条最省认知成本的阅读路径。你先抓住主线，再进入模块细节，效率会高很多。

先建立主干结构，再逐步下钻到模块与流程。

优先读入口、主循环、工具与状态，再看扩展能力。

适合第一次读源码、准备改功能、或需要快速找到入口的人。

​
读完这一页你会得到什么

你会拿到一条稳定的第一阅读主线，知道为什么不该按目录顺序硬啃源码，也知道下一步该跳向哪个页面继续深入。

​
推荐的第一条主线

  1. src/main.tsx
  2. src/entrypoints/init.ts
  3. src/utils/processUserInput/processUserInput.ts
  4. src/commands.ts
  5. src/tools.ts
  6. src/QueryEngine.ts
  7. src/state/AppStateStore.ts
  8. src/services/ 与 src/bridge/
这条路径的意义在于：你先知道程序如何启动，再理解输入如何被解析，接着知道命令与工具分别扮演什么角色，最后再进入状态管理和外部集成。

​
为什么不按目录顺序读

  • src/utils/ 与 src/components/ 体量很大，但它们是支撑层，不应该成为第一入口。
  • commands/、tools/、services/ 彼此交织，如果不先知道主循环，很容易只见局部不见整体。
  • 这个仓库大量使用 feature flag 和 lazy import，表面上的“存在”不代表运行时一定启用，因此需要先抓主干再看枝叶。

​
这一栏包含什么

讲清楚为什么这份 Wiki 采用职责链视角，而不是目录树视角。

把目录压缩成模块边界、上游与下游，帮助你快速定位问题。

按 9 个模块族逐个下钻，解释关键入口、协作关系和阅读顺序。

​
适合什么读者

  • 想快速摸清 Claude Code CLI 整体架构的人
  • 想找“从哪里改”或“从哪里接入新能力”的工程师
  • 想理解命令、工具、UI、状态、服务之间协作关系的读者

​
阅读建议

  • 先读结构，再看职责，再做模块拆解。
  • 每读完一个页面，都回头对照 关键入口文件索引 看源码位置。
  • 如果你关心运行时行为，读完本栏后直接跳到 提示词到渲染。