简介Claude Code源码合集整合原始破解版、学术研究版与可直接运行版三套方案面向人工智能工具研究者、前端架构学习者及逆向工程爱好者覆盖从底层原理剖析到快速上手体验的全场景需求无论是逆向溯源、架构研读还是开箱运行均有对应方案。压缩包共2000个文件以TypeScript的ts/tsx源码文件居多约1865个这些源码文件直接对应核心逻辑实现辅以js脚本、md说明文档、json配置和html展示页面整体大小94.78MB目录结构清晰。目前已有963人学习下载。其中原始破解版保留npm安装包、source map反编译源码及详细构建文档便于完整复盘逆向还原过程学术研究版提供纯净src快照与架构分析系统梳理模块设计、通信机制和核心逻辑可直接运行版预配置shim补丁与编译选项配合Bun环境执行简单命令即可启动适合快速验证和二次开发。1. 为什么有人把 Claude Code 源码拆成三种版本而不是直接 npm install搜索“Claude Code源码原始破解版学术研究版可直接运行版”的人通常不是想读编译器源码而是想要一个自己能控制的运行体不绑定官方订阅、能接第三方模型或本地模型、出了问题能翻代码排查。Claude Code 在 npm 上发布的是编译后的 JS 包严格意义上没有“传统源码”所谓三个版本本质是对同一个 npm 包做的三套改造口径。从“登录态判定、API 端点、会话回放、依赖固化”这四个改造点出发三种版本的区别就能说得很清楚。这篇笔记按“拆包 → 改点 → 运行 → 排错 → 进阶”的顺序写照着做的读者大约半小时内就能把一个改造版跑起来并且知道它到底改了什么。2. 把 npm 包拆开看源码三个版本的改造差异与边界Claude Code 在 npm 上的包名是anthropic-ai/claude-code。官方发布物不是逐行源码而是打包压缩过的 JS bundle入口、鉴权、命令解析、流式输出全都在里面。因为它不开源所谓“源码研究”其实是在这个 bundle 上做差量分析先解包再定位关键逻辑最后用补丁或环境变量覆盖默认行为。下面这一章先把解包方法写清楚再解释“原始破解版、学术研究版、可直接运行版”各自动了哪些位置。2.1 从 registry 拉原始包直接下载 tarball比全局安装干净先说明一下不建议直接npm install -g因为安装完黑匣子就进 node_modules 了想找原始包还要再拆一次。更稳妥的做法是用npm pack把 tarball 拉到当前目录手工解包这样能看到完整的文件结构也知道哪些文件是入口哪些是内置依赖。# 以 registry 格式拉包不触发安装脚本 npm pack anthropic-ai/claude-code # 解包得到 package/ 目录 tar -xzf anthropic-ai-claude-code-*.tgz # 看一眼体积和入口文件 ls -lh package | head -20这段命令里npm pack是很多读者容易忽略的动作它和npm install的关键区别是pack 只是把你的包压缩到本地不执行 postinstall不会污染全局命令。tar -xzf解包后得到的package/就是将来 node_modules 里真实生效的内容。到这里你能看到package.json里的bin字段那决定的命令行用什么指令启动常见值就是claude而启动入口一般落在cli.js上。再看一眼包信息和 bin 绑定确认后面软链要指向谁node -e const prequire(./package/package.json); console.log(p.name, p.version); console.log(p.bin);这里的p.bin输出的是“命令名 - 相对路径”的映射。拿到这个路径后后面所有补丁和包装脚本都以它为原点。很多人在这一步之后直接搜包里的“login”“subscription”字符串开始定位改造点下面两节顺着这个思路展开。2.2 原始破解版改的是“登录判定”而不是模型能力先说个容易误解的地方Claude Code 的模型推理是在远端完成的包内的 JS 只负责封装请求和整理响应所以本地无论怎么改都没法“免费变出模型能力”。所谓原始破解版在社区里真正在做的事情是把客户端的登录态校验削弱为“只要拿到 token 就算通过”再把 API 地址改成可配置端点。这样当你有自己的第三方 API 或本地模型时能绕过官方订阅身份的强制绑定。要找到这些改造点最简单的方式是在解包目录里搜索鉴权相关字符串grep -rniE login|auth|subscription|billing package --include*.js -l | head -10搜出来的文件就是“破解版”最常动的文件。常见做法是找到订阅状态判断的那段逻辑把校验分支改成恒真或者在入口处提前注入一个假凭据对象。从工程角度讲这个改动只有几行但它会让包变成“任何带 token 的人都能进”副作用是你不再能区分是有效订阅还是无效 token官方接口也会把请求打回。把这种包用于生产并不可取我一般只建议在隔离环境里做协议分析。另外需要提醒的是网上流传的现成“破解版”里很多在差分上多加了回调代码比如把机器码、会话摘要、甚至 API 密钥发到第三方服务器。这一节的目的只是让你知道原始包长什么样、改造面在哪而不是推荐你去跑一个来路不明的产物。自己从 npm 官方 tarball 解包再做 diff是更干净的路径。2.3 学术研究版把 harness 变成透明的黑盒“学术研究版”这个叫法听着玄学实际就两点保留完整的会话记录以及允许你往 harness 各个阶段插桩。harness 在这里指的是 Claude Code 内部那一套“接收自然语言 → 组织工具调用 → 把工具结果回喂模型”的运行框架。研究这套东西的人通常是想搞明白 CLI 的 Agent 循环是怎么实现的而不只是想多一个编码助手。最小插桩实践是在入口文件补两行调试输出确认请求和令牌的走向// 在 cli.js 启动阶段补两行确认生效的是哪套配置 console.error([harness] baseURL${process.env.ANTHROPIC_BASE_URL ?? (default)}); console.error([harness] hasToken${!!(process.env.ANTHROPIC_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN)});做到这一步黑盒子的第一个窗口就打开了。你可以清晰地看到请求最终会发给哪个地址有没有携带令牌。如果走的是第三方接入这里显示的是你配置的端点如果走默认逻辑会显示(default)说明环境变量没有覆盖进去。学术版下半部分通常还会做会话回放也就是把请求和响应按时间序落盘后续用--resume恢复或者离线分析。日志落盘位置一般放在用户目录或者项目目录通过环境变量指定。2.4 可直接运行版补丁、依赖、bin 三者一起打包可直接运行版解决的是“拿到包之后装不上、跑歪、被覆盖”的问题。它把三件事固定下来入口文件路径、依赖目录、环境变量预设。常见做法是把改造后的 package 整个复制到固定安装目录然后在/usr/local/bin下放一个包装脚本这个脚本负责注入 baseURL 和 token再 exec 真正的入口。# 把解包后的内容安置到固定目录 mkdir -p /opt/claude-code-local cp -r package /opt/claude-code-local/ # 写一个 bin 包装脚本 cat /usr/local/bin/claude-local EOF #!/usr/bin/env bash set -euo pipefail export ANTHROPIC_BASE_URL${ANTHROPIC_BASE_URL:-http://127.0.0.1:8080} export ANTHROPIC_AUTH_TOKEN${ANTHROPIC_AUTH_TOKEN:-local-test-token} exec node /opt/claude-code-local/package/cli.js $ EOF chmod x /usr/local/bin/claude-local这里有两个值得解释的参数。ANTHROPIC_BASE_URL是 API 寻址的根路径脚本里给它一个默认值运行者可通过外部环境变量覆盖ANTHROPIC_AUTH_TOKEN是令牌来源默认给一个local-test-token内部环境拿到它不会触发鉴权报错。包装脚本的好处是即使未来官方 npm 包版本升级覆盖全局命令你的自定义逻辑依然留在/usr/local/bin/claude-local这个独立文件里不受影响。三个版本的本质区别可以用一张表说清版本核心改动适用场景风险原始破解版削弱登录校验、替换 API 寻址协议分析、鉴权流程复现来路不明包可能含后门生产禁用学术研究版插桩、日志回放、会话落盘Agent 循环研究、问题排查需要自己维护补丁升级成本高可直接运行版bin 包装 依赖固定 配置固化日常开发、离线内网、团队分发模型质量取决于接入端点3. 把改造版跑起来的最小操作环境检测、三路安装、BASE_URL 配置上一章把包拆开看了这一章专注“跑起来”。常见诉求是在 Ubuntu 或 Windows 上装好 Claude Code然后通过第三方 API 接入 DeepSeek、Qwen、GLM或者把本地 LM Studio 拉起来当模型源。操作本身不复杂但环境变量、安装途径和启动参数这三件事但凡搞错一项就会表现出各种奇怪的连接失败所以从环境检测开始逐步来。3.1 Ubuntu / Linux 下先做三分钟环境检测避免装一半翻车新版 Claude Code 的 JS 代码依赖较新的 Node 特性Node 版本太老会出现“语法错误”或者直接进程闪退。先做三件事node -v # 建议 Node 18 以上20 LTS 更稳 npm -v uname -a # 确认是 x86_64 还是 arm64部分原生模块依赖架构检测完再决定安装方式。Ubuntu 上如果/usr/bin/node版本过旧常见做法是用 nvm 装一个用户级 Node避免动系统自带的依赖curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] . $NVM_DIR/nvm.sh nvm install 20 node -v这里nvm install 20会把 Node 20 LTS 装进用户目录后续npm install -g出来的命令也在用户目录下无需 root 权限。Windows 用户更建议直接装官方 Node LTS并且在 Windows Terminal 里操作旧版 cmd 的 PTY 兼容问题多等会会专门讲。3.2 Claude Code 安装npx 体验、npm 全局、本地 tgz 三种路径安装 Claude Code 的路径有三条临时跑、全局装、离线装按场景选。临时跑适合第一次体验不污染环境全局装适合每天用离线装适合内网机器或锁了 registry 的网络。# 方式 A临时体验用完即弃 npx --yes anthropic-ai/claude-code --version # 方式 B全局安装生成 claude 命令 npm install -g anthropic-ai/claude-code claude --version # 方式 C离线/内网环境从本地 tgz 安装 npm install -g ./anthropic-ai-claude-code-*.tgz方式 C 是“可直接运行版”最常走的安装路径它不访问 registry直接从本地 tarball 安装装完后的命令和方式 B 一致。区别在于如果你在前面自己打了补丁需要让npm install -g也带上补丁内容否则装完依然是官方原版。所以在离线场景我一般不用npm install -g管理补丁包而是直接用上一章的/opt/claude-code-local加软链方案这样补丁逻辑完全由自己控制。VSCode 用户还要注意官方有 Claude Code 的 VSCode 扩展一般装完扩展后在侧边栏就能看到会话入口但扩展本质上还是在终端里调用claude命令。所以终端里的claude --version能正常返回扩展才能正常工作。如果扩展显示“找不到 claude”优先检查全局 bin 路径是否在 PATH 里。3.3 不登录官方账号BASE_URL 指向第三方 API 或 LM Studio 本地模型这是最核心的一段配置。第三方 API 接入的基本思路是Claude Code 只认 Anthropic 格式的接口但你可以通过ANTHROPIC_BASE_URL把请求指向一个本地网关或者第三方兼容端点再由它转发并转换成目标模型。常见做法是用 cc switch 这类切换工具在几组已保存的端点和密钥间一键切换接入 DeepSeek、Qwen、GLM 等模型cli 本身只感知到 baseURL 和 token 的变化。# 设置请求根路径和令牌 export ANTHROPIC_BASE_URLhttp://127.0.0.1:8080 export ANTHROPIC_AUTH_TOKENsk-local-test # 覆盖模型名启动 claude --model claude-sonnet-4-0这里ANTHROPIC_BASE_URL是替换官方地址的关键很多“学术研究版”在启动时优先读它ANTHROPIC_AUTH_TOKEN则作为身份标识网关收到后一般会映射成真正提供模型的供应商密钥。启动参数里的--model只是模型名覆盖具体能不能生效取决于网关有没有把这个名字映射到真实目标模型。如果网关那边只认deepseek-chat那就需要把映射关系处理好否则会出现“模型名对不上”的报错。如果用 LM Studio 跑本地模型流程类似但要多一个适配层。LM Studio 默认暴露的是 OpenAI 兼容接口而 Claude Code 发的是 Anthropic 格式请求两者不能直接对话。常见做法是让一个适配服务监听127.0.0.1:8080背后指向 LM Studio 的http://127.0.0.1:1234/v1由它完成格式转换。配置时只要把ANTHROPIC_BASE_URL指到适配服务的地址即可。坑在于格式转换往往会丢掉部分system指令和工具定义所以本地模型最后表现如何很大程度上取决于适配层对“工具调用”格式的支持度而不只是模型大小。3.4 启动参数的五个实用项先记住这几个就够了Claude Code 参数不少日常用得最稳的是下面这些claude -p 把 README.md 翻译成中文 # 单次非交互模式适合脚本 claude --continue # 接着上次会话继续 claude --resume abcdef123 # 恢复指定会话 claude --model claude-sonnet-4-0 # 覆盖模型名 claude --dangerously-skip-permissions # 跳过权限询问只在可信目录用-p模式是最适合自动化验证的入口它接受一段文本参数跑完直接退出不进入交互终端配合日志重定向就很好做回归测试。--continue适合写代码过程中反复修改提问--resume适合跨天后找回历史上下文。最后那个跳过权限的参数我不建议长期开着它会让工具调用不再逐条确认在小项目里很爽但在生产仓库里等于解除了所有护栏。4. Claude Code 源码定制的常见问题排查5 个高频踩坑记录跑改造版翻车的概率比跑官方版高因为你同时面对源码改动和环境适配两个变量。下面这五个坑是我见过最频繁的每条按“现象 → 原因 → 解决”来写基本覆盖了从安装到接入第三方模型的主要故障面。4.1 安装后一敲 claude 就报 SyntaxError入口文件都解析不过现象claude --version直接抛SyntaxError: Unexpected token ?或者类似 ES2022 语法错误。原因Node 版本过低。Claude Code 的新版本 JS bundle 用了空值合并、可选链等语法Node 16 及以下不少语法不认识。很多人在 Ubuntu 上用 apt 装的 node 是 12 或 14就会立刻踩中。解决用 nvm 切换到 Node 20 LTS再重新执行安装。装完用which node确认当前 shell 指向的是 nvm 目录下那个版本而不是/usr/bin/node。如果node -v看着是 20但claude --version依然报错检查 PATH 顺序把~/.nvm/versions/node/v20/bin放到/usr/bin前面。4.2 明明设了 ANTHROPIC_BASE_URL请求却仍然走向官方地址现象环境变量设置了ANTHROPIC_BASE_URL日志里却显示请求发到默认官方地址。原因三种可能。第一种是变量名拼错比如写成了ANTHROPIC_BASEURL第二种是当前 shell 没 export只在命令行里临时赋了值第三种是改造包里有配置文件并且配置文件的优先级高于环境变量比如包内自带.env或settings.json覆盖了你的设置。解决先用env | grep ANTHROPIC确认变量存在且拼写正确再用下面命令验证入口是否真的读取到了env | grep ANTHROPIC node -e console.log(process.env.ANTHROPIC_BASE_URL)如果环境变量没问题就去解包目录里搜ANTHROPIC_BASE_URL的出现位置看读取顺序。一般会读到的结果有process.env.ANTHROPIC_BASE_URL || settings.baseUrl说明配置文件的优先级在环境变量之后你的设置不会被覆盖如果写成settings.baseUrl || process.env.ANTHROPIC_BASE_URL则配置文件优先。解决方式是直接改配置文件的 baseUrl 字段让它和你环境变量保持一致。4.3 LM Studio 本地模型接上了但模型不会调用工具只会输出一行纯文本现象模型正常回复但当问题需要执行终端命令或者读文件时模型只是“假装”理解了然后给出一段话完全没有触发工具调用。原因本地模型对 Anthropic 工具调用格式的支持不完整。Claude Code 给模型发的工具定义是 Anthropic 专属格式包含input_schema等结构本地小模型训练数据里没有见过这种格式就退化成普通文本回复。这是“本地模型跑 Agent”普遍翻车的地方。解决换一个工具调用能力更强的模型通常 30B 以上参数的效果才好一点。同时在适配层确认它是否把 Anthropic 的工具调用转换为 OpenAI 的tool_calls格式如果适配层只转对话消息不转工具定义模型永远学不会。测试工具调用最简单的命令是claude -p 执行 pwd 命令并输出结果如果回复里出现“我无法执行命令”这类的文字而不是真实路径说明工具链路没通。挨个查适配层的工具转换逻辑比调模型参数更优先。另一个细节是本地模型上下文窗口小工具定义会占据大量 token很多模型不是不会调用而是工具定义被截断或者挤出了注意力窗口所以也值得把上下文窗口拉大后再试。4.4 在 VSCode 集成终端里启动正常但切到旧版 cmd 就乱码、无输出现象Windows 下 Claude Code 在 Windows Terminal 和 VSCode 集成终端里正常但在旧版cmd.exe里启动后界面错乱或者按键不响应。原因Claude Code 的交互界面依赖 TTY 能力旧版cmd对 ANSI 转义序列和鼠标事件的支持不完整渲染就乱了。本质上不是源码问题而是终端模拟器兼容性问题。解决优先用 Windows Terminal 或 VSCode 集成终端如果只能在 cmd 里跑先设置set TERMxterm-256color再看效果。另一个常见办法是用winpty包一层启动它会把 TTY 交互翻译成 Windows 终端能理解的形式多见于 Git Bash 场景。如果只是偶尔跑一句命令用claude -p的非交互模式也能绕开问题因为不需要完整 TTY 渲染。4.5 网盘下载的“一键研究版”在后台偷偷发数据样式还很正常现象第三方下载站拿到的“可直接运行版”平时用着看不出异常但抓包发现它会周期性向一个未知域名发送数据内容包含机器信息甚至环境变量。原因这类二次封装包里混入了恶意代码。它们在入口文件旁边多放了一个回调模块或者篡改了 package.json 里的依赖在启动时偷偷加载。这就是为什么我一直强调不要跑来路不明的现成破解包你根本不知道他的 diff 里加了什么。解决只可信 npm 官方 registry 的 tarball然后自己在本地做差量修改。验证出网行为可以这样查# 启动前抓取 30 秒网络连接观察访问域名 tcpdump -i eth0 tcp port 443 -c 30 -A | grep -iE host|GET / # 同时检查解包目录里有没有可疑回调文件 find package -type f -newer package/package.json -name *.js | head -20用find过滤出修改时间异常的 JS 文件是定位后门最直接的手段。如果你用的是从命令行直接 npm 安装的包这个风险基本不存在真正危险的是手动下载的“绿色版”“一键版”。宁可自己多花十分钟解包也不要省这点时间换一个后门。5. 从研究到维护CLAUDE.md、MCP 白名单与端到端验证最后这一章不讲安装讲怎么把改造版当作正式工程来维护。Claude Code 有三个很实用的机制值得尽早利用项目级行为约束CLAUDE.md、工具能力的 MCP 扩展以及一条端到端验证链路。先在项目根目录放一份CLAUDE.md它会被自动当作项目上下文的附加约束。对团队协作来说这比口口相传规范要可靠得多# CLAUDE.md 项目说明这是 xxx 数据同步服务技术栈为 Node.js pnpm。 提交前必须运行 pnpm lint 且通过。 禁止直接修改 src/db/schema.sql只能新增 migration 文件。 外层目录 src/test 下的文件只许读取不许修改。这份文件里的约束会在每次会话启动时被注入改造版和官方版同样适用。它对替换过的模型同样有效因为它是跟随请求发送的文本指令只要模型还认识中文就能遵守大半。第二个要掌握的是 MCP 白名单。MCP 是 Claude Code 抓取外部工具能力的方式像读数据库、查 issue、跑浏览器录制都通过它做。我一般会按项目拆分工具范围避免一个全局配置污染所有仓库claude mcp add --scope project search-docs -- npx -y tools/mcp-server claude mcp list带--scope project的意思是这份 MCP 配置只对当前目录生效search-docs是逻辑名后面跟的是启动该 MCP server 的实际命令。设置完跑claude mcp list能确认当前会话能看到哪些工具这段输出也是排查“模型说自己不会用工具”的第一手依据。最后讲验证。改造版最怕的是“表面能聊实际链路是断的”。我的习惯是固定一条端到端回归命令用-p非交互模式让它执行一次真实工具调用并打印调试日志确认请求确实经过了期望端点、带上了期望令牌、触发了期望工具。claude -p 查看当前目录的 git status 并输出前 5 行 21 | tee /tmp/claude_check.log grep -E harness|baseURL|have /tmp/claude_check.log | head -5如果日志里能看到你设在网关上的地址说明 baseURL 生效如果看到默认值说明配置覆盖没成功回到第 4.2 节查读取优先级。这些年我养成的习惯是每改一次源码或配置就留一组调研日志统一追加到~/.claude_debug.log。下次再遇到奇怪现象先翻日志里 baseURL、token、模型名三行再决定要不要动代码基本不会再靠玄学猜。希望帮到你。本文还有配套的精品资源点击获取