Claude Code 源码快照复原与运行指南

English

这个仓库基于公开可获取的 Claude Code 源码快照做了运行复原，把一份仅包含 src/ 的源码快照，推进到可本地运行使用 claude code cli，目的是方便启动验证、源码阅读和架构研究。

当前启动方式很简单：

bun install
bun run start

Buddy 使用

当前仓库已经补齐了 buddy 的最小可用版本。启动 CLI 后，可以直接在 REPL 中输入下面这些命令：

/buddy
/buddy status
/buddy reroll
/buddy pet
/buddy mute
/buddy unmute

使用流程如下：

1. 第一次输入 /buddy 会孵化一个 companion，并把结果写入 ~/.claude.json
2. 输入 /buddy status 可以查看当前 buddy 的名字、物种、稀有度、静音状态和 personality
3. 输入 /buddy reroll 会重掷一个新的 buddy，并更新 ~/.claude.json 中保存的 companion seed
4. 输入 /buddy pet 会触发一次抚摸反馈，界面上会出现爱心和气泡
5. 输入 /buddy mute / /buddy unmute 可以关闭或恢复 buddy 的展示和反应
6. 当你在对话里直接提到 buddy 名字时，它会在回合结束后给出简短气泡反应

补充说明：

• 当前恢复的是“最小可用版” buddy，不保证与 Anthropic 内部原始实现完全一致
• 源码模式下默认已启用 buddy；如需关闭，可在启动前设置 CLAUDE_CODE_ENABLE_BUDDY=0

详细修复过程见：docs/reconstruction-process.md

当前状态：核心 CLI / REPL 主干已经可用，适合研究和运行验证；但它仍不是官方 1:1 发布仓库，工程文件、生成产物以及部分内部能力仍存在占位或降级。

当前状态总览

分类	状态	说明	相关文件
CLI 启动链	已验证可用	bun run start、bun run help、--version、REPL 首屏都已验证正常	src/entrypoints/cli.tsx src/setup.ts
欢迎页与首页信息	已验证可用	Tips for getting started、Recent activity、medium · /effort 已正常显示	src/utils/logoV2Utils.ts src/projectOnboardingState.ts tools/runtime-preload.ts
本地会话历史	已验证可用	Recent activity 已能读取并展示本地会话记录	src/utils/logoV2Utils.ts
主干源码	基本完整	CLI、命令加载、REPL UI、会话存储、工具框架等主干代码都在，但未逐项回归所有命令和 provider 分支	src/entrypoints/cli.tsx src/setup.ts
工程与发布层	已重建	当前工程文件是为“最小可启动复原”补出来的，不是原始发布仓库	package.json tsconfig.json bunfig.toml tools/runtime-preload.ts
SDK 生成类型	占位	这些文件目前是 placeholder，不是原始生成产物	src/entrypoints/sdk/coreTypes.generated.ts src/entrypoints/sdk/runtimeTypes.ts src/entrypoints/sdk/toolTypes.ts
Bundled verify skill	降级	当前使用的是 fallback 简化内容，不是原始内联产物	src/skills/bundled/verifyContent.ts
Chrome 集成	降级	缺少内部包时会退回静态工具名列表，不是原始内部实现	src/utils/claudeInChrome/browserTools.ts
Tungsten	不可用	该能力在公开快照中被明确禁用	src/tools/TungstenTool/TungstenTool.ts src/tools/TungstenTool/TungstenLiveMonitor.tsx
ripgrep	兼容回退	当前优先走系统 rg 回退，不是原始 bundled 形态	src/utils/ripgrep.ts
子进程执行层	兼容修补	针对当前依赖版本做了执行层兼容处理	src/utils/execFileNoThrow.ts

当前明确不可用的命令

类别	内容
Stub 命令	debug-tool-call、share、summary、onboarding、bughunter、oauth-refresh、good-claude、mock-limits、ant-trace、issue、autofix-pr、reset-limits、teleport、env、perf-issue、break-cache、backfill-sessions、ctx_viz
代表文件	src/commands/share/index.js src/commands/onboarding/index.js src/commands/autofix-pr/index.js

总体结论

这个仓库现在已经可以看作“高完整度源码快照 + 可运行复原版”：

• 适合用来做启动验证、源码阅读、架构分析和 CLI / REPL 行为研究。
• 不等同于官方完整仓库，也不等同于原始构建环境。
• 当前缺失的主要是原始工程/发布层、生成产物，以及部分私有内部集成与内部命令。

免责声明

• 源码版权归 Anthropic 所有。
• 本仓库内容仅用于技术研究与学习，请勿用于商业用途。
• 如有侵权，请联系删除。