Claude Code源码仓库推荐+极简本地部署

Claude Code 相关的公开源码仓库，现在 GitHub 上已经不少了。

但真正的问题不是“仓库多不多”，而是：

哪个仓库最适合拿来学习 Claude Code 架构？ 哪个仓库最适合本地部署、边学边改？ 哪个仓库虽然很火，但其实并不适合作为学习入口？

我专门把几个主流仓库都过了一遍，最后筛出了一套相对清晰的选择思路。

如果你的目标是：

• 学习 Claude Code 的整体架构

• 研究它的工具系统、Agent 机制和上下文管理

• 在本地跑起来做二次开发

这篇文章可以直接帮你少走很多弯路。

（上一篇文章部署的是一个编译版本，这次我们部署简单快捷版本）

先说结论：最值得关注的几个仓库

下面这张表，可以当作一个快速索引。

目前看下来，我把这几个仓库分成三类：

1. 推荐学习 + 二次开发：beita6969/claude-code

这个仓库最大的优势，不是“最原始”，而是最适合真正上手。

它把工程化补得比较完整：

• 依赖关系相对清楚

• 缺失模块做了 stub

• 构建和运行路径比较明确

• README 里把修复点和扩展入口讲得比较直白

如果你是想一边读源码，一边尝试改功能、加工具、做二开，这个仓库是我最推荐的起点。

2. 最推荐学习架构：xorespesp/claude-code

如果你更在意的是“结构清晰”“改动相对克制”“适合读懂整体设计”，那我更推荐这个仓库。

它的特点是：

• 目录结构干净

• src/、shims/、vendor/ 分层清晰

• README 对启动链路、架构模块、Memory、Agent、Compaction 这些讲得比较系统

• 本地也可以跑起来，不会停留在纯源码考古阶段

所以如果你的重点是“先把 Claude Code 架构看明白”，这个版本非常合适。

3. 最适合做原貌参考：ChinaSiro/claude-code-sourcemap

这个仓库更像是“原始材料仓库”。

它最有价值的地方在于：

• 保留了 sourcemap 还原结果

• 保留了原始包和提取脚本

• 很适合做源码对照和考古

但它的问题也很明显：

• 不适合作为初学者直接部署的版本

• 缺少成熟的构建体系

• 缺失依赖、私有模块、Bun 宏、Feature Flag 等问题并没有真正帮你铺平

所以它适合“研究”，不适合“上手”。

我这里选择 xorespesp/claude-code 来演示

如果只是追求“能跑”，其实可选项不少。

但如果目标是：

• 尽量保留 Claude Code 的整体结构

• 改动尽量少

• 同时又方便本地部署学习

那 xorespesp/claude-code 是一个很平衡的选择。

仓库地址，源码包在文末claude code学习群自取：

https://github.com/xorespesp/claude-code

实操：在 Windows 上跑起来 xorespesp/claude-code

下面我用 Windows 环境演示一遍完整安装流程。

0. 安装前先检查 3 件事

在安装之前，先不要着急 git clone。

先确认你的机器已经具备这些前置条件：

• Bun >= 1.3.5

• Node.js >= 24

• Git 已安装

先在 PowerShell 里执行下面几个命令：

git --versionbun --versionnode --version

如果都能正常输出版本号，说明基础环境已经具备。

如果某个命令直接报错，说明对应工具还没装好，不建议继续往下执行 bun install。

这里特别提醒一句：

没有 Bun，后面的 bun install 和 bun run dev 都跑不起来。

1. Clone 仓库

从 GitHub 下载源码：

git clone https://github.com/xorespesp/claude-code.git E:\01AI\01_Claude_code_Xore

这里的 E:\01AI\01_Claude_code_Xore 可以替换成你自己的目录。

比如你也可以换成：

git clone https://github.com/xorespesp/claude-code.git D:\code\claude-code

Clone 成功之后，你就已经把完整源码拉到本地了。

如果你的网络环境不稳定，建议提前准备好代理，或者自己备一个压缩包版本。

2. 进入目录并安装依赖

接下来进入项目目录，并用 Bun 安装依赖：

cd 你的目录bun install

这一步的作用，类似于传统项目里的 npm install。

你可以把 Bun 理解成一个更现代的 JavaScript / TypeScript 运行时，它同时具备：

• 运行时能力

• 包管理能力

• 打包能力

Claude Code 这类项目选择 Bun，一个很关键的原因是：

它可以直接运行 TypeScript，不需要你先手动编译成 JavaScript。

所以在这个仓库里，Bun 不只是“安装依赖的工具”，它本身就是项目运行的一部分。

如果这一步能顺利跑完，说明项目基础环境已经基本没问题了。

3. 配置模型接口并启动项目

安装完依赖后，就可以开始运行。

我这里接的是 DeepSeek 的兼容接口，你也可以换成自己的服务。

PowerShell 下可以这样设置环境变量并启动：

cd E:\01AI\01_Claude_code_Xore$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"$env:ANTHROPIC_API_KEY = "你自己的key"$env:ANTHROPIC_MODEL = "deepseek-chat"$env:API_TIMEOUT_MS = "600000"bun run dev

这里几个变量的含义分别是：

• ANTHROPIC_BASE_URL：接口地址

• ANTHROPIC_API_KEY：你的 API Key

• ANTHROPIC_MODEL：使用的模型名称

• API_TIMEOUT_MS：请求超时时间

如果你不是用 DeepSeek，那么需要把 BASE_URL 和 MODEL 替换成你对应平台的配置。

4. 首次启动会让你确认权限

第一次运行时，一般会看到信任目录之类的提示。

这一步通常会让你选择：

• 是否信任当前文件夹

• 是否继续执行

我这里的操作是：

• 选择 1，信任当前文件夹

• 再选择 1，确认继续

这一步本质上是在确认当前工作目录是安全的，属于正常流程。

5. 成功进入 Claude Code 交互界面

如果一切顺利，接下来就会进入 Claude Code 的交互界面。

走到这里，说明这个版本已经成功在本地跑起来了。

接下来你就可以做两件很有意思的事情：

• 验证它现在到底接的是哪个模型

• 让它分析自己，观察它如何理解自身的架构和能力

6. 简单做两个验证测试

测试 1：问它当前在使用哪个模型

启动之后，可以直接问：

“你现在在使用哪个模型？”

这样做的目的，不只是为了确认配置有没有生效，更是为了验证当前接口和模型路由是否正常。

测试 2：让它分析自己

接着你还可以继续问它：

“请分析一下你自己的架构和能力。”

这个测试很有意思，因为它能帮助我们观察：

• 它对自身工具系统的理解

• 它对运行环境的认知

• 它是否能正确识别自己的工作方式

从结果来看，这个版本已经足够拿来做：

• 架构学习

• 工具系统研究

• Prompt 行为观察

• Agent 机制实验

• 本地二次开发

源码包在下方群聊自取

文末说明

本文内容仅用于技术研究、架构学习和工程分析。相关源码和版权归原作者所有，使用时请自行关注对应仓库说明与相关规范。