快速入门

学习Claude源码之前必看

先把背景说清楚

你现在看到的这一整套 Claude Code 源码学习,研究对象并不是 Anthropic 官方主动开源发布的完整仓库。
而是一份泄露出来的代码。

具体可以看这里:

刚刚,Claude Code 源码泄露了!

这份代码之所以会流传出来,核心背景是:

  • Claude Code 本体并不开源
  • 但其 npm 分发产物里包含了可被追溯的 source map 信息
  • 有人据此还原出了大量 TypeScript 源码
  • 最终形成了现在这份可供分析的源码镜像

所以你要先建立一个正确认知:

我们现在研究的,不是官方 GitHub 开源项目,而是一份通过分发包线索逆出的源码快照。

为什么这件事会引起这么大关注

因为 Claude Code 代表的是当前 AI 编程工具里非常重要的一类产品形态:

  • 命令行智能体
  • 工具调用型 Agent
  • 多轮工程任务执行系统
  • 带权限、状态、MCP、LSP、插件、远程会话的完整运行时

平时大家只能“用”它,却很难真正看到它内部怎么设计。
而这份源码镜像,第一次让很多人能够从实现层去看 Claude Code 的真实结构。

一张图看清这份代码的来源路径

加载图表中...

这份代码适合拿来做什么

最适合的用途有三类:

  1. 学习 Claude Code 的整体架构
  2. 研究 AI 编程 Agent 的工程实现方式
  3. 借鉴它的模块划分、工具协议、权限系统和运行时设计

也就是说,我们更关注的是:

  • 它为什么强
  • 它怎么组织系统
  • 它的能力是如何拼装出来的

而不是把它当成一个普通开源项目去直接复刻。

这份代码不适合拿来做什么

也要把边界说清楚。

这份源码镜像并不适合你做下面这些事:

  • 指望它百分之百完整可运行
  • 指望它等价于官方最新线上版本
  • 指望它包含所有私有服务和后端依赖
  • 指望它天然适合作为生产项目二次发布

因为它本质上仍然是一份还原出来的代码快照,不是官方发布的完整开发仓库。

研究这份源码,正确姿势是什么

最推荐的姿势不是“逐文件扫过去”,而是:

  1. 先看主干骨架
  2. 再看核心循环
  3. 再看工具、上下文、权限
  4. 最后看 MCP、LSP、插件、远程、多 Agent
加载图表中...

这也是为什么我把这个专题设计成一整套循序渐进的教程,而不是简单扔几个代码片段。

这份源码我是怎么拿到的

关于这份源码的来龙去脉、背景说明,以及更完整的上下文,我站内已经单独写过一篇文章,建议你先看:

刚刚,Claude Code 源码泄露了!

你可以把那篇文章理解成“事件背景介绍”,而当前这个专题则是“系统源码拆解课程”。

如果你也想拿到这份源码

我不建议在这里直接堆下载链接。
更稳妥的方式是通过公众号获取,我会在公众号里统一维护下载说明和后续更新。

获取方式

  1. 先关注公众号
  2. 发送关键词:Claude
  3. 按自动回复获取下载方式

如果后续关键词或获取方式有调整,以公众号最新自动回复为准。

公众号二维码

下面这个二维码可以直接扫码关注:

公众号二维码

为什么我建议你先关注再下载

原因很简单:

  • 这类内容后续可能会有补充说明
  • 我会持续更新学习路线和分析文章
  • 有些问题需要结合上下文讲,不适合只丢一个压缩包

所以更好的方式不是“拿到源码就结束”,而是跟着专题把它真正吃透。

学这个专题前,你最好先有这些预备知识

如果你完全零基础,建议你至少先补下面几项:

  • 终端与命令行
  • 文件路径与目录
  • Git 基础
  • TypeScript / React 基本阅读能力
  • AI Agent 的基本概念

否则你在看 main.tsxQueryEngine.tsTool.ts 这些文件时,会比较容易卡住。

小结

这篇文章你只需要记住三件事:

  1. 这不是官方开源仓库,而是一份基于分发产物线索还原出来的源码镜像
  2. 最有价值的学习方式是把它当成 Agent 系统架构样本来研究
  3. 想获取源码,可以关注公众号后发送关键词 Claude源码

接下来再进入后面的正文,你会更清楚自己在看什么、为什么值得看。