334 lines
14 KiB
Markdown
334 lines
14 KiB
Markdown
# Claude Code (Reverse-Engineered)
|
||
|
||
Anthropic 官方 [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 工具的源码反编译/逆向还原项目。目标是将 Claude Code 核心功能跑通，必要时删减次级能力。
|
||
|
||
## 能力清单
|
||
|
||
> ✅ = 已实现 ⚠️ = 部分实现 / 条件启用 ❌ = stub / 移除 / feature flag 关闭
|
||
|
||
### 核心系统
|
||
|
||
| 能力 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| REPL 交互界面（Ink 终端渲染） | ✅ | 主屏幕 5000+ 行，完整交互 |
|
||
| API 通信 — Anthropic Direct | ✅ | 支持 API Key + OAuth |
|
||
| API 通信 — AWS Bedrock | ✅ | 支持凭据刷新、Bearer Token |
|
||
| API 通信 — Google Vertex | ✅ | 支持 GCP 凭据刷新 |
|
||
| API 通信 — Azure Foundry | ✅ | 支持 API Key + Azure AD |
|
||
| 流式对话与工具调用循环 (`query.ts`) | ✅ | 1700+ 行，含自动压缩、token 追踪 |
|
||
| 会话引擎 (`QueryEngine.ts`) | ✅ | 1300+ 行，管理对话状态与归因 |
|
||
| 上下文构建（git status / CLAUDE.md / memory） | ✅ | `context.ts` 完整实现 |
|
||
| 权限系统（plan/auto/manual 模式） | ✅ | 6300+ 行，含 YOLO 分类器、路径验证、规则匹配 |
|
||
| Hook 系统（pre/post tool use） | ✅ | 支持 settings.json 配置 |
|
||
| 会话恢复 (`/resume`) | ✅ | 独立 ResumeConversation 屏幕 |
|
||
| Doctor 诊断 (`/doctor`) | ✅ | 版本、API、插件、沙箱检查 |
|
||
| 自动压缩 (compaction) | ✅ | auto-compact / micro-compact / API compact |
|
||
|
||
### 工具 — 始终可用
|
||
|
||
| 工具 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| BashTool | ✅ | Shell 执行，沙箱，权限检查 |
|
||
| FileReadTool | ✅ | 文件 / PDF / 图片 / Notebook 读取 |
|
||
| FileEditTool | ✅ | 字符串替换式编辑 + diff 追踪 |
|
||
| FileWriteTool | ✅ | 文件创建 / 覆写 + diff 生成 |
|
||
| NotebookEditTool | ✅ | Jupyter Notebook 单元格编辑 |
|
||
| AgentTool | ✅ | 子代理派生（fork / async / background / remote） |
|
||
| WebFetchTool | ✅ | URL 抓取 → Markdown → AI 摘要 |
|
||
| WebSearchTool | ✅ | 网页搜索 + 域名过滤 |
|
||
| AskUserQuestionTool | ✅ | 多问题交互提示 + 预览 |
|
||
| SendMessageTool | ✅ | 消息发送（peers / teammates / mailbox） |
|
||
| SkillTool | ✅ | 斜杠命令 / Skill 调用 |
|
||
| EnterPlanModeTool | ✅ | 进入计划模式 |
|
||
| ExitPlanModeTool (V2) | ✅ | 退出计划模式 |
|
||
| TodoWriteTool | ✅ | Todo 列表 v1 |
|
||
| BriefTool | ✅ | 简短消息 + 附件发送 |
|
||
| TaskOutputTool | ✅ | 后台任务输出读取 |
|
||
| TaskStopTool | ✅ | 后台任务停止 |
|
||
| ListMcpResourcesTool | ✅ | MCP 资源列表 |
|
||
| ReadMcpResourceTool | ✅ | MCP 资源读取 |
|
||
| SyntheticOutputTool | ✅ | 非交互会话结构化输出 |
|
||
|
||
### 工具 — 条件启用
|
||
|
||
| 工具 | 状态 | 启用条件 |
|
||
|------|------|----------|
|
||
| GlobTool | ✅ | 未嵌入 bfs/ugrep 时启用（默认启用） |
|
||
| GrepTool | ✅ | 同上 |
|
||
| TaskCreateTool | ⚠️ | `isTodoV2Enabled()` 为 true 时 |
|
||
| TaskGetTool | ⚠️ | 同上 |
|
||
| TaskUpdateTool | ⚠️ | 同上 |
|
||
| TaskListTool | ⚠️ | 同上 |
|
||
| EnterWorktreeTool | ⚠️ | `isWorktreeModeEnabled()` |
|
||
| ExitWorktreeTool | ⚠️ | 同上 |
|
||
| TeamCreateTool | ⚠️ | `isAgentSwarmsEnabled()` |
|
||
| TeamDeleteTool | ⚠️ | 同上 |
|
||
| ToolSearchTool | ⚠️ | `isToolSearchEnabledOptimistic()` |
|
||
| PowerShellTool | ⚠️ | Windows 平台检测 |
|
||
| LSPTool | ⚠️ | `ENABLE_LSP_TOOL` 环境变量 |
|
||
| ConfigTool | ❌ | `USER_TYPE === 'ant'`（永远为 false） |
|
||
|
||
### 工具 — Feature Flag 关闭（全部不可用）
|
||
|
||
| 工具 | Feature Flag |
|
||
|------|-------------|
|
||
| SleepTool | `PROACTIVE` / `KAIROS` |
|
||
| CronCreate/Delete/ListTool | `AGENT_TRIGGERS` |
|
||
| RemoteTriggerTool | `AGENT_TRIGGERS_REMOTE` |
|
||
| MonitorTool | `MONITOR_TOOL` |
|
||
| SendUserFileTool | `KAIROS` |
|
||
| OverflowTestTool | `OVERFLOW_TEST_TOOL` |
|
||
| TerminalCaptureTool | `TERMINAL_PANEL` |
|
||
| WebBrowserTool | `WEB_BROWSER_TOOL` |
|
||
| SnipTool | `HISTORY_SNIP` |
|
||
| WorkflowTool | `WORKFLOW_SCRIPTS` |
|
||
| PushNotificationTool | `KAIROS` |
|
||
| SubscribePRTool | `KAIROS_GITHUB_WEBHOOKS` |
|
||
| ListPeersTool | `UDS_INBOX` |
|
||
| CtxInspectTool | `CONTEXT_COLLAPSE` |
|
||
|
||
### 工具 — Stub / 不可用
|
||
|
||
| 工具 | 说明 |
|
||
|------|------|
|
||
| TungstenTool | ANT-ONLY stub |
|
||
| REPLTool | ANT-ONLY，`isEnabled: () => false` |
|
||
| SuggestBackgroundPRTool | ANT-ONLY，`isEnabled: () => false` |
|
||
| VerifyPlanExecutionTool | 需 `CLAUDE_CODE_VERIFY_PLAN=true` 环境变量，且为 stub |
|
||
| ReviewArtifactTool | stub，未注册到 tools.ts |
|
||
| DiscoverSkillsTool | stub，未注册到 tools.ts |
|
||
|
||
### 斜杠命令 — 可用
|
||
|
||
| 命令 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| `/add-dir` | ✅ | 添加目录 |
|
||
| `/advisor` | ✅ | Advisor 配置 |
|
||
| `/agents` | ✅ | 代理列表/管理 |
|
||
| `/branch` | ✅ | 分支管理 |
|
||
| `/btw` | ✅ | 快速备注 |
|
||
| `/chrome` | ✅ | Chrome 集成 |
|
||
| `/clear` | ✅ | 清屏 |
|
||
| `/color` | ✅ | Agent 颜色 |
|
||
| `/compact` | ✅ | 压缩对话 |
|
||
| `/config` (`/settings`) | ✅ | 配置管理 |
|
||
| `/context` | ✅ | 上下文信息 |
|
||
| `/copy` | ✅ | 复制最后消息 |
|
||
| `/cost` | ✅ | 会话费用 |
|
||
| `/desktop` | ✅ | Claude Desktop 集成 |
|
||
| `/diff` | ✅ | 显示 diff |
|
||
| `/doctor` | ✅ | 健康检查 |
|
||
| `/effort` | ✅ | 设置 effort 等级 |
|
||
| `/exit` | ✅ | 退出 |
|
||
| `/export` | ✅ | 导出对话 |
|
||
| `/extra-usage` | ✅ | 额外用量信息 |
|
||
| `/fast` | ✅ | 切换 fast 模式 |
|
||
| `/feedback` | ✅ | 反馈 |
|
||
| `/files` | ✅ | 已跟踪文件 |
|
||
| `/heapdump` | ✅ | Heap dump（调试） |
|
||
| `/help` | ✅ | 帮助 |
|
||
| `/hooks` | ✅ | Hook 管理 |
|
||
| `/ide` | ✅ | IDE 连接 |
|
||
| `/init` | ✅ | 初始化项目 |
|
||
| `/install-github-app` | ✅ | 安装 GitHub App |
|
||
| `/install-slack-app` | ✅ | 安装 Slack App |
|
||
| `/keybindings` | ✅ | 快捷键管理 |
|
||
| `/login` / `/logout` | ✅ | 登录 / 登出 |
|
||
| `/mcp` | ✅ | MCP 服务管理 |
|
||
| `/memory` | ✅ | Memory / CLAUDE.md 管理 |
|
||
| `/mobile` | ✅ | 移动端 QR 码 |
|
||
| `/model` | ✅ | 模型选择 |
|
||
| `/output-style` | ✅ | 输出风格 |
|
||
| `/passes` | ✅ | 推荐码 |
|
||
| `/permissions` | ✅ | 权限管理 |
|
||
| `/plan` | ✅ | 计划模式 |
|
||
| `/plugin` | ✅ | 插件管理 |
|
||
| `/pr-comments` | ✅ | PR 评论 |
|
||
| `/privacy-settings` | ✅ | 隐私设置 |
|
||
| `/rate-limit-options` | ✅ | 限速选项 |
|
||
| `/release-notes` | ✅ | 更新日志 |
|
||
| `/reload-plugins` | ✅ | 重载插件 |
|
||
| `/remote-env` | ✅ | 远程环境配置 |
|
||
| `/rename` | ✅ | 重命名会话 |
|
||
| `/resume` | ✅ | 恢复会话 |
|
||
| `/review` | ✅ | 代码审查（本地） |
|
||
| `/ultrareview` | ✅ | 云端审查 |
|
||
| `/rewind` | ✅ | 回退对话 |
|
||
| `/sandbox-toggle` | ✅ | 切换沙箱 |
|
||
| `/security-review` | ✅ | 安全审查 |
|
||
| `/session` | ✅ | 会话信息 |
|
||
| `/skills` | ✅ | Skill 管理 |
|
||
| `/stats` | ✅ | 会话统计 |
|
||
| `/status` | ✅ | 状态信息 |
|
||
| `/statusline` | ✅ | 状态栏 UI |
|
||
| `/stickers` | ✅ | 贴纸 |
|
||
| `/tasks` | ✅ | 任务管理 |
|
||
| `/theme` | ✅ | 终端主题 |
|
||
| `/think-back` | ✅ | 年度回顾 |
|
||
| `/upgrade` | ✅ | 升级 CLI |
|
||
| `/usage` | ✅ | 用量信息 |
|
||
| `/insights` | ✅ | 使用分析报告 |
|
||
| `/vim` | ✅ | Vim 模式 |
|
||
|
||
### 斜杠命令 — Feature Flag 关闭
|
||
|
||
| 命令 | Feature Flag |
|
||
|------|-------------|
|
||
| `/voice` | `VOICE_MODE` |
|
||
| `/proactive` | `PROACTIVE` / `KAIROS` |
|
||
| `/brief` | `KAIROS` / `KAIROS_BRIEF` |
|
||
| `/assistant` | `KAIROS` |
|
||
| `/bridge` | `BRIDGE_MODE` |
|
||
| `/remote-control-server` | `DAEMON` + `BRIDGE_MODE` |
|
||
| `/force-snip` | `HISTORY_SNIP` |
|
||
| `/workflows` | `WORKFLOW_SCRIPTS` |
|
||
| `/web-setup` | `CCR_REMOTE_SETUP` |
|
||
| `/subscribe-pr` | `KAIROS_GITHUB_WEBHOOKS` |
|
||
| `/ultraplan` | `ULTRAPLAN` |
|
||
| `/torch` | `TORCH` |
|
||
| `/peers` | `UDS_INBOX` |
|
||
| `/fork` | `FORK_SUBAGENT` |
|
||
| `/buddy` | `BUDDY` |
|
||
|
||
### 斜杠命令 — ANT-ONLY（不可用）
|
||
|
||
`/tag` `/backfill-sessions` `/break-cache` `/bughunter` `/commit` `/commit-push-pr` `/ctx_viz` `/good-claude` `/issue` `/init-verifiers` `/mock-limits` `/bridge-kick` `/version` `/reset-limits` `/onboarding` `/share` `/summary` `/teleport` `/ant-trace` `/perf-issue` `/env` `/oauth-refresh` `/debug-tool-call` `/agents-platform` `/autofix-pr`
|
||
|
||
### CLI 子命令
|
||
|
||
| 子命令 | 状态 | 说明 |
|
||
|--------|------|------|
|
||
| `claude`（默认） | ✅ | 主 REPL / 交互 / print 模式 |
|
||
| `claude mcp serve/add/remove/list/get/...` | ✅ | MCP 服务管理（7 个子命令） |
|
||
| `claude auth login/status/logout` | ✅ | 认证管理 |
|
||
| `claude plugin validate/list/install/...` | ✅ | 插件管理（7 个子命令） |
|
||
| `claude setup-token` | ✅ | 长效 Token 配置 |
|
||
| `claude agents` | ✅ | 代理列表 |
|
||
| `claude doctor` | ✅ | 健康检查 |
|
||
| `claude update` / `upgrade` | ✅ | 自动更新 |
|
||
| `claude install [target]` | ✅ | Native 安装 |
|
||
| `claude server` | ❌ | `DIRECT_CONNECT` flag |
|
||
| `claude ssh <host>` | ❌ | `SSH_REMOTE` flag |
|
||
| `claude open <cc-url>` | ❌ | `DIRECT_CONNECT` flag |
|
||
| `claude auto-mode` | ❌ | `TRANSCRIPT_CLASSIFIER` flag |
|
||
| `claude remote-control` | ❌ | `BRIDGE_MODE` + `DAEMON` flag |
|
||
| `claude assistant` | ❌ | `KAIROS` flag |
|
||
| `claude up/rollback/log/error/export/task/completion` | ❌ | ANT-ONLY |
|
||
|
||
### 服务层
|
||
|
||
| 服务 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| API 客户端 (`services/api/`) | ✅ | 3400+ 行，4 个 provider |
|
||
| MCP (`services/mcp/`) | ✅ | 24 个文件，12000+ 行 |
|
||
| OAuth (`services/oauth/`) | ✅ | 完整 OAuth 流程 |
|
||
| 插件 (`services/plugins/`) | ✅ | 基础设施完整，无内置插件 |
|
||
| LSP (`services/lsp/`) | ⚠️ | 实现存在，默认关闭 |
|
||
| 压缩 (`services/compact/`) | ✅ | auto / micro / API 压缩 |
|
||
| Hook 系统 (`services/tools/toolHooks.ts`) | ✅ | pre/post tool use hooks |
|
||
| 会话记忆 (`services/SessionMemory/`) | ✅ | 会话记忆管理 |
|
||
| 记忆提取 (`services/extractMemories/`) | ✅ | 自动记忆提取 |
|
||
| Skill 搜索 (`services/skillSearch/`) | ✅ | 本地/远程 skill 搜索 |
|
||
| 策略限制 (`services/policyLimits/`) | ✅ | 策略限制执行 |
|
||
| 分析 / GrowthBook / Sentry | ⚠️ | 框架存在，实际 sink 为空 |
|
||
| Voice (`services/voice.ts`) | ❌ | `VOICE_MODE` flag 关闭 |
|
||
|
||
### 内部包 (`packages/`)
|
||
|
||
| 包 | 状态 | 说明 |
|
||
|------|------|------|
|
||
| `color-diff-napi` | ✅ | 997 行完整 TypeScript 实现（语法高亮 diff） |
|
||
| `audio-capture-napi` | ❌ | stub，`isNativeAudioAvailable()` 返回 false |
|
||
| `image-processor-napi` | ❌ | stub，`getNativeModule()` 返回 null |
|
||
| `modifiers-napi` | ❌ | stub，`isModifierPressed()` 返回 false |
|
||
| `url-handler-napi` | ❌ | stub，`waitForUrlEvent()` 返回 null |
|
||
| `@ant/claude-for-chrome-mcp` | ❌ | stub，`createServer()` 返回 null |
|
||
| `@ant/computer-use-mcp` | ❌ | stub，`buildTools()` 返回 [] |
|
||
| `@ant/computer-use-input` | ❌ | stub，仅类型声明 |
|
||
| `@ant/computer-use-swift` | ❌ | stub，仅类型声明 |
|
||
|
||
### Feature Flags（30 个，全部返回 `false`）
|
||
|
||
`ABLATION_BASELINE` `AGENT_MEMORY_SNAPSHOT` `BG_SESSIONS` `BRIDGE_MODE` `BUDDY` `CCR_MIRROR` `CCR_REMOTE_SETUP` `CHICAGO_MCP` `COORDINATOR_MODE` `DAEMON` `DIRECT_CONNECT` `EXPERIMENTAL_SKILL_SEARCH` `FORK_SUBAGENT` `HARD_FAIL` `HISTORY_SNIP` `KAIROS` `KAIROS_BRIEF` `KAIROS_CHANNELS` `KAIROS_GITHUB_WEBHOOKS` `LODESTONE` `MCP_SKILLS` `PROACTIVE` `SSH_REMOTE` `TORCH` `TRANSCRIPT_CLASSIFIER` `UDS_INBOX` `ULTRAPLAN` `UPLOAD_USER_SETTINGS` `VOICE_MODE` `WEB_BROWSER_TOOL` `WORKFLOW_SCRIPTS`
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- [Bun](https://bun.sh/) >= 1.0
|
||
- Node.js >= 18（部分依赖需要）
|
||
- 有效的 Anthropic API Key（或 Bedrock / Vertex 凭据）
|
||
|
||
### 安装
|
||
|
||
```bash
|
||
bun install
|
||
```
|
||
|
||
### 运行
|
||
|
||
```bash
|
||
# 开发模式（watch）
|
||
bun run dev
|
||
|
||
# 直接运行
|
||
bun run src/entrypoints/cli.tsx
|
||
|
||
# 管道模式（-p）
|
||
echo "say hello" | bun run src/entrypoints/cli.tsx -p
|
||
|
||
# 构建
|
||
bun run build
|
||
```
|
||
|
||
构建产物输出到 `dist/cli.js`（~25.75 MB，5326 模块）。
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
claude-code/
|
||
├── src/
|
||
│ ├── entrypoints/
|
||
│ │ ├── cli.tsx # 入口文件（含 MACRO/feature polyfill）
|
||
│ │ └── sdk/ # SDK 子模块 stub
|
||
│ ├── main.tsx # 主 CLI 逻辑（Commander 定义）
|
||
│ └── types/
|
||
│ ├── global.d.ts # 全局变量/宏声明
|
||
│ └── internal-modules.d.ts # 内部 npm 包类型声明
|
||
├── packages/ # Monorepo workspace 包
|
||
│ ├── color-diff-napi/ # 完整实现（终端 color diff）
|
||
│ ├── modifiers-napi/ # stub（macOS 修饰键检测）
|
||
│ ├── audio-capture-napi/ # stub
|
||
│ ├── image-processor-napi/# stub
|
||
│ ├── url-handler-napi/ # stub
|
||
│ └── @ant/ # Anthropic 内部包 stub
|
||
│ ├── claude-for-chrome-mcp/
|
||
│ ├── computer-use-mcp/
|
||
│ ├── computer-use-input/
|
||
│ └── computer-use-swift/
|
||
├── scripts/ # 自动化 stub 生成脚本
|
||
├── dist/ # 构建输出
|
||
└── package.json # Bun workspaces monorepo 配置
|
||
```
|
||
|
||
## 技术说明
|
||
|
||
### 运行时 Polyfill
|
||
|
||
入口文件 `src/entrypoints/cli.tsx` 顶部注入了必要的 polyfill：
|
||
|
||
- `feature()` — 所有 feature flag 返回 `false`，跳过未实现分支
|
||
- `globalThis.MACRO` — 模拟构建时宏注入（VERSION 等）
|
||
|
||
### 类型状态
|
||
|
||
经过系统性修复，tsc 错误从 ~1341 降至 **~289**（减少 78%）。剩余错误分散在小文件中，均为反编译产生的源码级类型问题，**不影响 Bun 运行时**。详见 [RECORD.md](./RECORD.md) 第六节。
|
||
|
||
### Monorepo
|
||
|
||
项目采用 Bun workspaces 管理内部包。原先手工放在 `node_modules/` 下的 stub 已统一迁入 `packages/`，通过 `workspace:*` 解析。
|
||
|
||
## 许可证
|
||
|
||
本项目仅供学习研究用途。Claude Code 的所有权利归 [Anthropic](https://www.anthropic.com/) 所有。
|