简介这份资源为疑似 Claude Code 项目的源码压缩包面向希望研究 AI 编程助手内部实现、学习大型 TypeScript 工程架构的开发者适合具备一定前端与 Node.js 基础的中高级读者参考。包内共 1903 个文件以 1332 个 ts 与 552 个 tsx 为主辅以 18 个 js 和 1 个 md整体约 9.42MB涵盖核心逻辑、组件实现与接口调用等模块目录结构相对完整。目前已有 393 人学习下载。通过阅读可了解该项目的整体框架、模块划分与主要功能点观察其编程范式、数据结构设计与接口组织方式为自身项目的架构设计与代码优化提供参考也可用于错误排查与功能扩展思路的借鉴。源码阅读需结合版本控制与许可协议尊重原作者知识产权合理合法使用。1. 当“claude code 源码”被端上来先分清你要的是壳还是脑上周群里有人甩出一份压缩包文件名写着claude-code-source.zip配文“claude code 源码据说是源码”。下载解压后目录里躺着package.json、cli.js、几个.node二进制还有一堆被 webpack 压得只剩单字母变量名的 chunk。有人兴奋地说要二次开发有人打开cli.js发现全是nn就沉默了。这个场景几乎每个月都会重演一次标题里的“源码”两个字把三种完全不同的东西混成了一件——官方 CLI 的分发产物、社区逆向出来的可读实现、以及围绕它写的接入层胶水代码。你真正要解决的问题决定了你该拿哪一份想搞懂 agent 循环怎么调度工具去看可读实现想接自己的模型或改交互去改接入层想直接跑起来用官方安装包就够了。这篇不站队只把三条路各自怎么走、参数怎么设、哪里会翻车讲清楚让你拿到任何一份“据说是源码”的东西时十分钟内能判断它值不值得投入。2. 拆开一个 Claude Code 分发包你手里那份“源码”到底是什么2.1 三种“源码”的形态与判别方法先把概念钉死。市面上流通的所谓 claude code 源码按可读性从低到高排基本是这三类第一类是官方 npm 分发产物。你npm i -g anthropic-ai/claude-code之后全局目录里那个cli.js就是它。特点是单文件、体积大几 MB 到十几 MB、变量名被压缩、字符串常量还在。它能读但读起来像在啃黑匣子。判别方法很简单看文件头有没有#!/usr/bin/env node看package.json里bin字段指向谁看有没有sourceMappingURL注释。第二类是社区逆向/重写的可读实现。这类东西通常以 GitHub 仓库形式存在用 TypeScript 写目录结构清晰有src/agent/、src/tools/、src/query/这种分层。它未必和官方逐行对应但把 agent 循环、工具调用协议、上下文压缩这些核心机制复现出来了。判别方法看有没有tsconfig.json、有没有测试目录、commit 历史是不是连续的人肉提交。第三类是接入层胶水。典型代表是各种“cc switch”类的工具作用是把 Claude Code 的请求转发到 DeepSeek、Qwen、GLM 等兼容 OpenAI 协议的模型上。它本身不是 Claude Code 的源码而是改ANTHROPIC_BASE_URL和请求体格式的中间件。判别方法看它有没有proxy、adapter、transform这类关键词看它是不是只处理 HTTP 层。提示拿到一份压缩包先别急着npm install。先find . -name *.ts | head如果全是.js和.node那大概率是第一类如果有成片的.ts且目录分层才可能是第二类。2.2 用三条命令判断一份源码能不能读假设你已经解压到./cc-src下面这三步能在两分钟内给出结论。# 1. 看入口和依赖判断是分发产物还是工程 cat package.json | python3 -c import sys,json; djson.load(sys.stdin); print(bin:, d.get(bin)); print(main:, d.get(main)); print(deps:, list(d.get(dependencies,{}).keys())[:10]) # 2. 统计源码文件类型分布.ts 多还是 .js 多 find . -type f \( -name *.ts -o -name *.js -o -name *.node \) | sed s/.*\.// | sort | uniq -c | sort -rn # 3. 找 sourcemap有 map 就能还原出接近原始的代码 find . -name *.map -size 100k | head第一条命令输出里如果bin指向一个压缩过的cli.jsdependencies只有个位数那基本是分发产物。第二条命令如果.js数量远超.ts且.node存在说明核心逻辑被编译成原生模块了读 JS 只能看到调用壳。第三条最关键有 sourcemap 就等于有后悔药。很多分发产物会带.map文件用source-map库或者浏览器开发者工具就能还原出带变量名的源码这一步能把可读性拉高一个档次。参数说明-size 100k是为了过滤掉那些只有几行的占位 mapsed s/.*\.//取扩展名注意文件名里带点的会被误切但统计用途足够。2.3 从可读实现里该盯哪几个模块如果你拿到的是第二类可读实现别从头读到尾会累死。按这个顺序看每个模块花二十分钟模块目录看什么对应你要解决的问题src/query或src/agent主循环怎么组织消息怎么追加agent 为什么能连续调工具src/tools每个工具的 schema 和 execute 实现怎么加自己的工具src/context或src/compact上下文超限时怎么压缩长会话为什么突然失忆src/permission权限判定和确认流程怎么让它别乱执行命令主循环是灵魂。你会发现它本质就是一个while把历史消息发给模型模型返回tool_use就执行工具、把结果塞回消息列表再发一轮直到模型返回纯文本或达到轮次上限。看懂这个循环你就理解了所有 coding agent 的骨架剩下的都是工具和提示词的差异。3. 把可读实现跑起来环境、依赖与最小验证3.1 本地跑通的最小步骤假设你拿到的是一个 TypeScript 写的可读实现目录里有package.json和tsconfig.json。下面是从零到能对话的完整流程。# 1. 锁定 Node 版本agent 类项目对 Node 版本敏感 node -v # 建议 20.x 或 22.x LTS18 以下容易在 fetch/stream 上翻车 # 2. 装依赖优先用 lockfile 保证可复现 npm ci || npm install # 3. 编译 TypeScript如果项目是 ts 直跑可跳过 npx tsc --noEmit # 先只做类型检查确认代码本身没坏 npx tsc # 真正产出 dist/ # 4. 配置密钥注意别写进代码 export ANTHROPIC_API_KEY你的key export ANTHROPIC_BASE_URLhttps://api.anthropic.com # 用第三方兼容端点时改这里 # 5. 跑最小验证让它执行一条只读命令 node dist/cli.js -p 列出当前目录下所有 .ts 文件不要修改任何东西逻辑说明npm ci比npm install更严格它完全按package-lock.json装能避免“我这儿能跑你那儿报错”的玄学。tsc --noEmit先做类型检查是个好习惯很多逆向实现类型定义不全直接编译会报一堆错先看清楚是类型问题还是逻辑问题。最后那条-p是 print 模式只输出结果不进入交互适合做冒烟测试。参数说明-p后面跟的提示词要明确加“不要修改任何东西”因为 agent 默认有文件写权限第一次跑就让它写文件是血泪教训。如果你的实现里权限确认是交互式的第一次跑最好留在终端前面盯着。3.2 接入第三方模型的配置差异热词里反复出现“cc switch 接入 deepseek、qwen、glm”这背后是一个现实需求官方端点贵或不可达时用兼容协议顶上。核心改动只有两处base URL 和请求体格式。# 以兼容 OpenAI 协议的端点为例 export ANTHROPIC_BASE_URLhttps://your-endpoint.example.com/v1 export ANTHROPIC_API_KEY你的第三方key # 有些实现需要显式指定模型名否则会用默认的 claude 模型名去请求 export ANTHROPIC_MODELdeepseek-chat # 或 qwen-max、glm-4 等逻辑说明Claude Code 的请求走的是 Anthropic Messages API 格式而多数第三方模型走 OpenAI Chat Completions 格式。两者字段名不同system的位置、tool_use与tool_calls的结构所以中间必须有一层转换。cc switch 这类工具干的就是这件事拦截请求、改字段、转发、再把响应转回来。参数说明ANTHROPIC_MODEL不是所有实现都认有的写死在代码里需要你去src/config里改默认值。改完先用-p模式发一句“你好”验证连通性别一上来就让它改代码。第三方模型对 tool_use 的支持参差不齐如果发现它不调工具只聊天多半是模型侧不支持 function calling不是你的配置问题。3.3 验证 agent 循环是否真的在工作跑通对话不等于 agent 循环正常。用一个需要两步工具调用的任务来验证node dist/cli.js -p 先读取 package.json 里的 name 字段然后基于这个名字创建一个 hello.txt内容就是这个名字如果它先调了读文件工具、拿到结果、再调写文件工具说明循环和工具调度都正常。如果它直接编了一个名字就写文件说明工具结果没被正确回灌到下一轮消息里——这是逆向实现最常见的 bug通常出在消息拼接时把tool_result的tool_use_id对错了。注意验证阶段用一个临时目录别在真实项目根目录跑。agent 的写权限一旦放开它可能覆盖你不想动的文件。4. 避坑与排查读源码和跑源码时最容易翻车的五件事4.1 现象解压后npm install卡在 postinstall 不动原因分发产物或某些逆向包会在postinstall里下载原生二进制.node网络不通时就一直挂着。解决先npm install --ignore-scripts跳过脚本装完再单独看postinstall干了什么需要的话手动补下载。如果核心逻辑就在那个.node里那这份“源码”对你没有二次开发价值果断放弃。4.2 现象TypeScript 编译报几百个类型错误原因逆向实现往往只保证运行时能跑类型定义是残缺的strict模式下必然爆。解决把tsconfig.json里的strict临时设为falseskipLibCheck设为true先让它编译出dist/跑起来再逐个模块补类型。别一上来就追求类型完美那是重构阶段的事。4.3 现象接第三方模型后工具调用全部失效原因第三方端点不支持 Anthropic 的tool_use块格式或者转换层没把tool_use映射成tool_calls。解决抓一次实际请求体看结构确认转换层是否处理了工具字段。如果模型本身不支持 function calling那这条路走不通换模型或退回纯对话用法。4.4 现象长会话跑到一半突然“失忆”忘了前面说过的约束原因上下文超限触发了压缩逻辑而压缩实现把关键约束也压掉了。解决找到compact相关代码看它保留哪些消息。常见做法是保留 system prompt 和最近 N 轮中间的历史做摘要。你可以把关键约束写进 system prompt 或项目根目录的配置文件里这类内容通常不会被压缩掉。4.5 现象agent 执行了rm或覆盖文件没有二次确认原因权限模块被简化或默认放行。解决在工具执行前加一层白名单校验只读命令直接放行写操作和删除操作强制确认。如果你只是读源码学习把执行入口的权限检查打开再跑如果要长期用这层校验必须自己补别指望逆向实现帮你兜底。5. 从读懂到改造给 agent 加一个自定义工具并验证它被正确调用读源码的终点是能改。最有价值的改造是加一个自己的工具因为这一步会逼你走通 schema 定义、注册、执行、结果回灌整条链路。下面以加一个count_lines工具为例。// src/tools/countLines.ts import { z } from zod; // 1. 定义输入 schemaagent 靠它生成给模型的工具描述 export const countLinesSchema z.object({ path: z.string().describe(要统计行数的文件路径), }); // 2. 实现执行逻辑返回值会被序列化后塞回消息 export async function countLines(input: z.infertypeof countLinesSchema) { const fs await import(fs/promises); const content await fs.readFile(input.path, utf-8); const lines content.split(\n).length; return { path: input.path, lines }; } // 3. 导出工具描述注册到工具列表 export const countLinesTool { name: count_lines, description: 统计指定文件的总行数, schema: countLinesSchema, execute: countLines, };逻辑说明schema 不只是校验它会被转成 JSON Schema 发给模型模型据此决定什么时候调、传什么参数。description写得越清楚模型误用的概率越低。execute的返回值必须是可序列化的因为要拼进消息体。注册通常在src/tools/index.ts里把新工具加进数组即可。改完重新编译用这条命令验证node dist/cli.js -p 用 count_lines 工具统计 src/tools/countLines.ts 有多少行如果模型正确调用了工具并返回了行数说明整条链路通了。如果它说“我没有这个工具”检查注册是否生效、schema 是否被正确序列化。如果它调用了但参数传错回去改description和字段的.describe()。参数说明z.string().describe(...)里的描述会直接出现在发给模型的工具定义里别写“路径”这种含糊词写“要统计行数的文件路径”能显著降低传错概率。这是提示词工程在工具层的体现比在对话里反复纠正有效得多。我自己的习惯是每加一个工具就先写一条只读的验证命令确认调用链通了再让它碰真实文件。这套流程走下来你对 agent 的理解就不再停留在“据说”层面了。希望帮到你。本文还有配套的精品资源点击获取