diff --git a/README.md b/README.md index 6419a6e..91d9464 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,7 @@ # Claude Code — Compiled & Fixed +**[English](README.md)** | **[中文](README_CN.md)** + A working, buildable version of the [Claude Code](https://github.com/anthropics/claude-code) CLI, reconstructed from the leaked source (2026-03-31) with all missing files, broken imports, and runtime errors fixed. --- diff --git a/README_CN.md b/README_CN.md new file mode 100644 index 0000000..34062d4 --- /dev/null +++ b/README_CN.md @@ -0,0 +1,174 @@ +# Claude Code — 编译修复版 + +**[English](README.md)** | **[中文](README_CN.md)** + +基于 2026-03-31 泄露的 Claude Code CLI 源码，修复所有缺失文件、断裂引用和运行时错误，使其可以正常编译运行。 + +--- + +## 项目背景 + +2026 年 3 月 31 日，Anthropic 的 Claude Code CLI 完整源码通过 npm 注册表中的 `.map` 文件泄露。原始泄露版本**无法编译** — 缺少 22+ 个源文件、存在断裂的内部引用、依赖 Anthropic 内部包、并使用了未发布的 Bun 特性（`bun:bundle`）。 + +本仓库修复了以上所有问题。最终效果：一条 `bun build` 命令即可生成可用的 ~23MB 单文件 bundle。 + +--- + +## 相比原始泄露版本的修改 + +### 补充的缺失源文件（22 个 stub） + +泄露的源码引用了不存在的文件。已创建对应的 stub： + +| 文件 | 用途 | +|------|------| +| `src/global.d.ts` | TypeScript 全局类型声明 | +| `src/utils/protectedNamespace.ts` | 命名空间保护 | +| `src/utils/useEffectEvent.ts` | React `useEffectEvent` polyfill | +| `src/entrypoints/sdk/coreTypes.generated.ts` | SDK 生成类型 | +| `src/entrypoints/sdk/runtimeTypes.ts` | SDK 运行时类型 | +| `src/entrypoints/sdk/toolTypes.ts` | SDK 工具类型 | +| `src/tools/REPLTool/REPLTool.ts` | REPL 工具 stub | +| `src/tools/SuggestBackgroundPRTool/` | PR 建议工具 stub | +| `src/tools/VerifyPlanExecutionTool/` | 计划验证工具 stub | +| `src/tools/WorkflowTool/` | 工作流工具 stub | +| `src/tools/TungstenTool/TungstenLiveMonitor.tsx` | Tungsten 监控 stub | +| `src/commands/agents-platform/` | Agent 平台命令 stub | +| `src/commands/assistant/` | 助手命令 stub | +| `src/components/agents/SnapshotUpdateDialog.tsx` | 快照对话框 stub | +| `src/assistant/AssistantSessionChooser.tsx` | 会话选择器 stub | +| `src/services/compact/snipCompact.ts` | 剪裁压缩 stub | +| `src/services/compact/cachedMicrocompact.ts` | 微压缩 stub | +| `src/services/contextCollapse/` | 上下文折叠 stub | +| `src/ink/devtools.ts` | 开发工具 stub | +| `src/skills/bundled/verify/` | 验证 skill stub | +| `src/utils/filePersistence/types.ts` | 文件持久化类型 stub | + +### 源码修复 + +| 修复项 | 文件 | 说明 | +|--------|------|------| +| `useEffectEvent` 导入 | `src/components/tasks/BackgroundTasksDialog.tsx`, `src/state/AppState.tsx` | React 19 实验性 Hook 在 `react-reconciler@0.31` 中不可用 — 改为本地 polyfill | +| 版本检查跳过 | `src/utils/autoUpdater.ts` | `assertMinVersion()` 会访问 Anthropic 服务器 — 直接跳过 | +| 组织验证跳过 | `src/main.tsx` | `validateForceLoginOrg()` 需要 Anthropic 认证 — 注释掉 | +| 认证检查跳过 | `src/main.tsx` | 登录流程依赖 Anthropic OAuth — 启用自动执行 | +| `SandboxManager` 替换 | `node_modules/@anthropic-ai/sandbox-runtime/` | 将 14 个方法的 stub 替换为 [anthropic-experimental/sandbox-runtime](https://github.com/anthropic-experimental/sandbox-runtime) 的真实实现 | + +### Bun 兼容 Shim + +| 文件 | 用途 | +|------|------| +| `shims/macro.ts` | 提供 `MACRO` 全局变量（VERSION、BUILD_TIME 等）— 原本由 Anthropic 内部 Bun 构建注入 | +| `shims/bun-bundle.ts` | 提供 `feature()` 函数 — 替代 Anthropic 内部的 `bun:bundle` | + +### 缺失依赖（补充 28 个包） + +原始 `package.json` 不完整。已补充 28 个缺失依赖，包括 `@anthropic-ai/` 系列 SDK、OpenTelemetry 包和其他必要模块。 + +### 内部包处理 + +两个 Anthropic 内部包无法从 npm 安装： + +- `@anthropic-ai/sandbox-runtime` — 已替换为[开源实现](https://github.com/anthropic-experimental/sandbox-runtime) +- `@ant/claude-for-chrome-mcp` — 已在 `node_modules/` 中创建 stub + +--- + +## 快速开始 + +### 前置要求 + +- **Bun** 1.3+ — `curl -fsSL https://bun.sh/install | bash` +- **Node.js** 18+（可选，Bun 自带 npm） + +### 编译 + +```bash +git clone git@github.com:roger2ai/Claude-Code-Compiled.git +cd Claude-Code-Compiled + +# 安装依赖 +bun install + +# 修补 Commander.js（多字符短标志不支持） +# 详见 docs/BUILD.md §4.1 — 每次 bun install 后需重新应用 + +# 编译 +bun build shims/macro.ts src/main.tsx --target=bun --outdir=./dist + +# 合并为单文件 +cat dist/shims/macro.js dist/src/main.js > dist/bundle.js +echo 'if (typeof main === "function") main().catch(e => { console.error(e); process.exit(1); });' >> dist/bundle.js +``` + +输出：`dist/bundle.js`（~23 MB，~5,750 模块，~300ms 编译时间） + +### 运行 + +```bash +# 查看帮助（不需要 API key） +bun dist/bundle.js --help + +# 交互式 REPL（需要真实终端 + API key） +export ANTHROPIC_API_KEY=你的密钥 +bun dist/bundle.js + +# 单次执行模式 +bun dist/bundle.js -p "say hello" +``` + +--- + +## 项目结构 + +``` +claude-code/ +├── src/ # 源码（~1,900 个 TypeScript 文件，512K+ 行） +│ ├── main.tsx # CLI 入口 +│ ├── QueryEngine.ts # LLM 查询引擎 +│ ├── Tool.ts # 工具类型定义 +│ ├── tools/ # 43 个工具实现 +│ ├── commands/ # 80+ 个斜杠命令 +│ ├── components/ # 346 个 React/Ink UI 组件 +│ ├── services/ # 21 个服务模块 +│ ├── screens/ # 全屏 UI（REPL、Doctor 等） +│ └── utils/ # 290+ 个工具函数文件 +├── shims/ # Bun 兼容 shim +├── docs/ # 架构与编译文档 +├── dist/ # 编译输出（gitignored） +└── package.json # 依赖声明（574 个包） +``` + +--- + +## 文档 + +| 文档 | 内容 | +|------|------| +| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 全景架构总览 | +| [docs/ARCHITECTURE-TOOLS.md](docs/ARCHITECTURE-TOOLS.md) | 43 个工具详细分析 | +| [docs/ARCHITECTURE-SERVICES.md](docs/ARCHITECTURE-SERVICES.md) | 21 个服务模块 | +| [docs/ARCHITECTURE-COMPONENTS.md](docs/ARCHITECTURE-COMPONENTS.md) | 346 个 UI 组件 | +| [docs/ARCHITECTURE-COMMANDS.md](docs/ARCHITECTURE-COMMANDS.md) | 命令、Skill、Plugin | +| [docs/ARCHITECTURE-UTILS.md](docs/ARCHITECTURE-UTILS.md) | 工具函数层 | +| [docs/ARCHITECTURE-BRIDGE-REMOTE.md](docs/ARCHITECTURE-BRIDGE-REMOTE.md) | IDE 桥接与远程会话 | +| [docs/API-CONFIG.md](docs/API-CONFIG.md) | API 配置（环境变量、认证、代理） | +| [docs/BUILD.md](docs/BUILD.md) | 详细编译指南与所有补丁 | +| [docs/REFACTORING-ASSESSMENT.md](docs/REFACTORING-ASSESSMENT.md) | 重构可行性评估 | + +--- + +## 已知限制 + +1. **TUI 需要真实终端** — 管道或非 TTY 环境下静默退出 +2. **需要 API key** — 实际对话必须设置 `ANTHROPIC_API_KEY` +3. **部分工具是 stub** — REPLTool、WorkflowTool 等为空实现 +4. **macOS Keychain** — Linux 上回退到明文文件存储 +5. **WSL2 沙箱** — 需要 `apt install bubblewrap socat` 才能使用沙箱功能 +6. **Commander.js 补丁** — 多字符短标志（`-d2e`）每次 `bun install` 后需手动修补 `node_modules` + +--- + +## 原始来源 + +源码由 [@Fried_rice](https://x.com/Fried_rice) 于 2026-03-31 泄露。所有原始源码归 [Anthropic](https://www.anthropic.com) 所有。本仓库仅作为可编译参考，不用于生产环境。