Claude Code 满血源码是怎么来的?一个 12.8K Star 项目来求助,才发现全网都卡在同一个地方
Source: http://x.com/i/article/2040078213016416256
一个 12.8K star 的 Claude Code 开源项目,到我仓库提 issue 求助:他们搞不定 Computer Use。
我调研了一圈,发现这不是个别问题——几乎所有 Claude Code 源码还原项目都卡在同一个地方:Native 模块。
所有人都能从 source map 里提 TypeScript 源码,这一步没门槛。但 Claude Code 的系统级能力——录音、截屏、鼠标控制、键盘输入、应用检测——全靠 5 个用 Zig/Swift/C++ 编译的 .node 二进制。
这些文件不在 source map 里,npm 包里也只有 audio-capture 一个。其余 4 个被 Bun 编译器打包进了 200MB 的单文件二进制深处。
目前社区的应对方式:
- claude-code-best(12.8K star):用 AppleScript/JXA 纯 TS 重写替代,能用但性能和精度有差距
- claurst(7.6K star):用 Rust 从零重写了 Computer Use,思路很硬核,推荐去看
- 其他项目:空 stub 或直接跳过
claude-code-best 的 computer-use-swift 源码,第 4 行写着"用 AppleScript/JXA/screencapture 替代原始 Swift 原生模块"
我选了另一条路——从编译二进制里把原始模块手术提取出来。以下是完整过程:
一、找到二进制藏在哪
从源码的自动更新逻辑 nativeInstaller/download.ts 里,找到了 GCS 存储桶地址。Anthropic 在上面托管了 6 个平台的编译二进制:
macOS arm64 / x64(各 ~197MB) Linux arm64 / x64(各 ~230MB) Windows arm64 / x64(各 ~237MB)
全部下载下来。
二、从二进制里"手术"提取
三个平台的二进制格式完全不同,需要分别处理:
macOS(Mach-O 格式):扫描 magic bytes 0xCFFAEDFE,过滤 file_type == MH_DYLIB,通过 LC_ID_DYLIB load command 定位库名和偏移量。一个 darwin-arm64 二进制里就藏了 7 个 dylib:
Bun 编译器把 arm64 和 x64 两个架构的模块同时塞进了同一个二进制——所以不能只按平台名假设内容。
Linux(ELF 格式):扫描 \x7fELF magic,过滤 e_type == ET_DYN 共享库,通过 napi_register_module、processImage、startRecording 等导出符号识别是哪个模块。
Windows(PE 格式):扫描 MZ 头 + PE 签名,过滤 IMAGE_FILE_DLL 标志位。
三、6 个平台,20 个 .node 文件
Computer Use 目前只支持 macOS 不是巧合——computer-use-input 和 computer-use-swift 需要 macOS 独有的 API(CGEvent、Accessibility、ScreenCaptureKit)。
[图片:screenshots/08-our-image-processor-prebuilds.png — 我们的 vendor/image-processor,6 个平台目录]
四、验证——不是"能加载",是真的能用
每一个都是真实系统调用,不是 mock。
五、把模块接回 TypeScript 源码
提取出来还不够——原始源码里的 import 路径、加载逻辑、平台判断全部指向 Bun 编译时的内部路径。需要:
- 重建 vendor/ 目录结构,按平台归档所有 .node 文件
- 修改 native 加载器,让 require() 指向正确的本地路径
- 处理 computer-use-swift 的特殊情况:它不是 .node 而是 .dylib,通过 FFI 调用而非 NAPI
做完这一步,bun install && bun run start 四行命令跑起满血 Claude Code。
这就是"满血"的含义。Source map 人人都能提,二进制手术是我们选的路。
仓库: github.com/JrCx7scC/claude-code-source 完整方法论:REVERSE_ENGINEERING.md 大概率会被 DMCA,需要的趁早 clone 或私聊备份。
也推荐看看 claurst( github.com/Kuberwastaken/claurst ),7.6K star 的 Rust 重写版,思路完全不同但同样硬核。