简介这份资源面向AI工具研究者、前端架构学习者与逆向工程爱好者系统整理了Claude Code的三套源码方案覆盖从底层破解还原到开箱即用的完整需求。包内共2000个文件以1324个ts与541个tsx源码为主体辅以js脚本、md文档、json配置及少量html、yaml压缩包约94.78MB。第一套为原始破解版本保留npm安装包、自动化还原脚本与source map反编译源码并附构建流程文档第二套学术研究版提供纯净src快照与架构分析文档梳理模块设计、通信机制与核心逻辑第三套可运行版已配置shim补丁、依赖与tsconfig执行bun install与bun run dev即可启动。目前已有968人学习下载适合希望深入理解大型AI应用架构或快速搭建本地测试环境的开发者参考。1. 从一份 Claude Code 源码包说起它到底能跑出什么很多人第一次拿到 Claude Code 源码包第一反应是「这不就是个命令行工具吗」结果解压完发现目录里躺着 CLI 入口、工具调用层、会话状态管理、权限校验模块还有一堆和模型 API 打交道的适配代码瞬间不知道从哪下手。这份资源把三个版本打包在一起原始破解版、学术研究版、可直接运行版分别对应「想看真实实现」「想改着做实验」「想先跑起来再说」三种诉求。如果你是从业者想搞清楚一个终端里的 AI 编程助手是怎么把自然语言变成文件读写、命令执行、代码检索的这份源码比看任何二手拆解都直接。新手也能跟因为可直接运行版已经把依赖和启动脚本铺好了照着走就能看到第一个交互回合。2. 三个版本怎么选先分清你的目标是读还是跑2.1 原始破解版、学术研究版、可直接运行版的差异这三个版本不是简单的压缩包重复它们的目录结构和入口文件有明显区别。原始破解版最接近真实发布形态代码里保留了完整的工具注册表和权限判定逻辑适合做源码剖析学术研究版通常会把模型调用层抽象成接口方便你替换成自己的推理后端或本地模型适合做实验可直接运行版则把环境变量、依赖锁文件、启动脚本都配好了目标是让你在十分钟内看到第一个响应。版本入口文件依赖处理适合场景改动风险原始破解版主 CLI 入口需手动补依赖源码剖析、架构学习中改错难回滚学术研究版抽象接口层部分依赖已隔离替换模型、做对比实验低接口清晰可直接运行版启动脚本锁文件完整快速验证、演示低但定制空间小选型建议很直接如果你连它怎么启动都不知道先从可直接运行版入手跑通一个完整回合后再去读原始破解版的工具调用链。如果你已经能跑起来想研究「它怎么决定要不要执行一条 shell 命令」那就切到原始破解版重点看权限校验和工具分发那两个模块。学术研究版适合你已经有一个本地模型或第三方 API想把它塞进这个框架里做对照。2.2 环境准备Node 版本、包管理器和目录约定不管选哪个版本环境准备都是第一步。常见做法是 Node 18 以上包管理器用 npm 或 pnpm 都行但要注意锁文件对应的版本。我一般会先看目录里有没有.nvmrc或engines字段有就按它来没有就默认 18 LTS。# 查看当前 Node 版本低于 18 先升级 node -v # 如果有 .nvmrc直接切换 nvm use # 安装依赖优先用锁文件对应的包管理器 npm ci # 或者 pnpm install --frozen-lockfile这段命令的逻辑很简单node -v确认版本底线nvm use读取项目约定的 Node 版本npm ci或pnpm install --frozen-lockfile保证依赖树和锁文件完全一致避免因为依赖漂移导致启动失败。参数上ci比install更严格不会自动更新锁文件适合第一次复现。如果你用的是学术研究版还要检查有没有额外的requirements.txt或模型配置文件别漏了。提示如果npm ci报错说锁文件不匹配先别急着删锁文件检查一下包管理器版本是否和生成锁文件时一致。3. 把源码跑起来从安装依赖到第一个交互回合3.1 可直接运行版的启动流程与参数说明可直接运行版的目标是让你最快看到效果。通常目录里会有一个start.sh或run.js里面已经写好了环境变量读取和入口调用。你需要做的第一件事是复制一份环境变量模板填入模型 API 的地址和密钥。# 复制环境变量模板 cp .env.example .env # 编辑 .env填入你的模型服务地址和密钥 # MODEL_BASE_URLhttps://your-model-endpoint/v1 # MODEL_API_KEYyour-key-here # 启动 bash start.sh # 或者 node run.js --config .env逻辑说明.env.example是模板里面通常有MODEL_BASE_URL、MODEL_API_KEY、DEFAULT_MODEL这几个关键变量。start.sh会先加载.env再调用主入口。参数上--config指定配置文件路径有些版本还支持--model覆盖默认模型、--workspace指定工作目录。如果你看到启动后卡在「connecting」不动八成是MODEL_BASE_URL写错了或者网络不通先 curl 一下那个地址。3.2 原始破解版的入口定位与工具调用链原始破解版的入口通常是一个cli.js或index.js里面会注册一堆工具读文件、写文件、执行命令、搜索代码。你要找的是「工具注册表」和「权限校验」这两个地方。常见做法是搜索registerTool或tools关键字找到工具列表后再看每个工具的execute方法。// 伪代码示意实际变量名以源码为准 const tools [ { name: readFile, execute: async (args) { /* 读文件逻辑 */ } }, { name: writeFile, execute: async (args) { /* 写文件逻辑 */ } }, { name: runCommand, execute: async (args) { /* 执行命令逻辑 */ } }, ]; // 权限校验通常在调用 execute 之前 function checkPermission(toolName, args) { // 这里会判断是否允许写、是否允许执行 return allowed; }这段伪代码的重点不是照抄而是让你知道该看哪几个函数。tools数组决定了模型能调用哪些能力checkPermission决定了哪些调用会被拦截。参数上每个工具的args结构不同读文件通常是path执行命令通常是command和cwd。如果你想把某个工具禁掉直接在这个数组里删掉对应项或者把权限校验改成始终返回 false。3.3 学术研究版的模型替换与接口适配学术研究版的价值在于它把模型调用抽象成了一个接口你只需要实现chat或complete方法就能把默认模型换成自己的。常见做法是找到modelAdapter或llmProvider目录里面会有一个基类或接口定义。// 自定义模型适配器示例 class MyModelAdapter { async chat(messages, options) { // messages 是对话历史options 包含 temperature、maxTokens 等 const response await fetch(this.baseUrl, { method: POST, headers: { Content-Type: application/json, Authorization: Bearer ${this.apiKey} }, body: JSON.stringify({ messages, ...options }), }); return response.json(); } }逻辑说明chat方法接收对话历史和参数返回模型响应。参数上messages是标准格式options里temperature控制随机性maxTokens控制生成长度。替换后记得在配置里把provider改成你的适配器名称。如果你用的是本地模型注意接口格式要和适配器里解析的字段对齐否则会报解析错误。4. 避坑与排查源码包跑不起来时先看这几条4.1 依赖安装失败锁文件、Node 版本与镜像源现象npm ci报错EBADENGINE或lockfileVersion不匹配。原因通常是 Node 版本低于项目要求或者包管理器版本和锁文件生成时不一致。解决先用node -v确认版本低于 18 就升级再看锁文件里的lockfileVersion如果是 3 就用 npm 9 以上如果是 2 就用 npm 7 或 8。镜像源问题也会导致安装卡住可以临时切到国内镜像但注意别把锁文件改了。4.2 启动后无响应环境变量与网络连通性现象运行start.sh后终端没有任何输出或者一直停在「connecting」。原因一般是.env没加载、MODEL_BASE_URL写错、或者网络不通。解决先cat .env确认变量存在再curl -v $MODEL_BASE_URL看能不能通。如果用的是本地模型检查端口是否监听。有些版本会静默失败可以在入口文件里加一行console.log(process.env.MODEL_BASE_URL)确认读取到了。4.3 工具调用被拦截权限配置与路径限制现象模型明明说要读文件但实际没有执行或者报「permission denied」。原因是权限校验模块默认只允许在工作目录内操作或者写操作需要显式开启。解决找到权限配置文件或环境变量常见的有ALLOW_WRITE、WORKSPACE_ROOT。把工作目录设成你实际想操作的路径写权限按需开启。注意别把根目录设成工作目录否则模型可能改到系统文件。4.4 模型返回格式不匹配适配器字段与解析逻辑现象替换模型后程序报Cannot read property content of undefined。原因是你的模型返回格式和适配器里解析的字段不一致。解决先打印原始响应看它实际返回的是choices[0].message.content还是response.text然后改适配器里的解析逻辑。常见做法是在适配器里加一层兼容把不同格式统一成内部标准格式。4.5 源码改动后无法回滚版本管理与备份习惯现象改了几个文件后跑不起来想回退却发现没存原始版本。原因是直接在工作目录里改没有用 git 或备份。解决拿到源码包第一件事就是git init并提交一次原始状态之后每次改动前开分支。如果没有 git至少把原始压缩包再解压一份放旁边。这个习惯能省掉很多后悔药。5. 进阶用法把源码包变成你自己的实验平台跑通之后这份源码包最大的价值不是「能用」而是「能改」。我一般会做三件事第一把工具调用链画出来标出哪些是模型决策、哪些是本地执行这样你能清楚看到 AI 编程助手的边界在哪第二把权限校验改成可配置的策略比如按目录白名单、按命令黑名单这样既能放开能力又不至于失控第三把会话状态持久化默认可能是内存存储改成文件或 SQLite 后就能做多轮实验对比。// 会话持久化示意 const sessionStore { async save(sessionId, messages) { // 写入文件或数据库 await fs.writeFile(./sessions/${sessionId}.json, JSON.stringify(messages)); }, async load(sessionId) { const data await fs.readFile(./sessions/${sessionId}.json, utf8); return JSON.parse(data); }, };这段代码的关键是save和load两个方法参数sessionId用来区分不同会话messages是对话历史。持久化之后你可以对比不同模型在同一会话下的表现也可以回放某次工具调用序列。验证方法很简单启动后跑一个读文件加写文件的任务然后检查sessions目录下有没有生成对应文件再重启程序看能不能恢复上下文。注意持久化会话时不要把 API 密钥写进文件只存对话内容和工具调用记录。从那以后我每次拿到新的源码包都强制先跑一遍可直接运行版确认环境没问题再动原始代码并且第一件事就是 git init。希望帮到你。本文还有配套的精品资源点击获取