ClaudeCode Wiki

这是一份面向 Claude Code CLI 源码的中文 Wiki。它以 Web 端阅读为主,同时兼容移动端扫读:先帮你建立认知地图,再引导你进入关键模块和核心流程。

不是目录抄录,而是源码阅读入口与架构理解门户。

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

先总览,再快速启动,再进入核心流程和扩展生态。

快速启动

先建立整体结构感,再沿着最短阅读路径进入主干模块。

核心流程

把启动流程、一次提示词链路、权限与状态反馈串成真正的动态执行图。

扩展生态

理解 bridge、remote、plugins、skills、MCP 等能力如何挂接到主系统。

你会在这里得到什么

这份 Wiki 主要帮你解决三件事:快速找到源码入口、理解核心模块如何协作、判断修改一个功能应该落在哪一层。

先抓住启动入口、主循环、工具系统与状态系统之间的骨架。

减少“从目录里盲翻文件”的时间,优先看真正关键的入口文件。

帮助你判断一个问题属于命令层、工具层、服务层还是状态与 UI 层。

推荐阅读顺序

  1. 先看 快速启动总览,明确整份 Wiki 的阅读方式。
  2. 再看 整体结构,建立“启动入口 -> 输入处理 -> QueryEngine -> Tools/Commands -> UI/State -> Services/Extensions”的主线。
  3. 接着看 模块职责,把源码目录映射成职责边界。
  4. 有了整体图之后,进入 模块拆解,按模块族逐层理解关键入口文件。
  5. 最后再阅读 核心流程扩展生态,把静态结构变成动态时序。

从哪里进入源码最合适

如果你第一次读这个仓库,优先沿着下面四个入口走,建立一条从“启动”到“执行”的稳定主线。

程序入口。负责启动期预取、环境准备、命令注册和 REPL 启动。

命令总入口。适合先理解用户能显式触发哪些能力。

工具总入口。适合先理解模型能调用哪些执行能力。

主循环核心。负责把消息、模型、工具和状态真正串起来。

继续阅读