Files

2026-04-03 13:01:19 +08:00

9.7 KiB

Raw Permalink Blame History

Claude Code 源码快照（安全研究用）

本仓库镜像了一份公开暴露的 Claude Code 源码快照，该快照于 2026 年 3 月 31 日 通过 npm 分发包中的 source map 暴露问题而可访问。本仓库仅用于教育、防守性安全研究和软件供应链分析目的。

研究背景

本仓库研究方向包括：

软件供应链暴露与构建产物泄露
安全软件工程实践
代理式开发者工具架构
真实世界 CLI 系统的防御性分析

此存档旨在支持：

教育学习
安全研究实践
架构审查
打包和发布流程失败的讨论

本仓库不声索原始代码的所有权，也不应被视为 Anthropic 的官方仓库。

公开快照是如何可访问的

Chaofan Shou (@Fried_rice) 公开指出 Claude Code 源码可以通过 npm 包中暴露的 .map 文件访问：

"Claude Code 源代码通过其 npm registry 中的 map 文件泄露了！"

— @Fried_rice，2026 年 3 月 31 日

发布的 source map 引用了托管在 Anthropic R2 存储桶中的未混淆 TypeScript 源码，使 src/ 快照可供公众下载。

仓库范围

Claude Code 是 Anthropic 的 CLI 工具，用于在终端中与 Claude 交互，执行软件工程任务，如编辑文件、运行命令、搜索代码库和协调工作流程。

本仓库包含用于研究和分析的镜像 src/ 快照。

公开暴露发现日期：2026-03-31
语言：TypeScript
运行时：Bun
终端 UI：React + Ink
规模：约 1,900 个文件，512,000+ 行代码

目录结构

src/
├── main.tsx                 # 入口点编排（基于 Commander.js 的 CLI 路径）
├── commands.ts              # 命令注册表
├── tools.ts                 # 工具注册表
├── Tool.ts                  # 工具类型定义
├── QueryEngine.ts           # LLM 查询引擎
├── context.ts               # 系统/用户上下文收集
├── cost-tracker.ts          # Token 成本追踪
│
├── commands/                # 斜杠命令实现（约 50 个）
├── tools/                   # 代理工具实现（约 40 个）
├── components/              # Ink UI 组件（约 140 个）
├── hooks/                   # React hooks
├── services/                # 外部服务集成
├── screens/                 # 全屏 UI（Doctor、REPL、Resume）
├── types/                   # TypeScript 类型定义
├── utils/                   # 工具函数
│
├── bridge/                  # IDE 和远程控制桥接
├── coordinator/             # 多代理协调器
├── plugins/                 # 插件系统
├── skills/                  # 技能系统
├── keybindings/             # 键位配置
├── vim/                     # Vim 模式
├── voice/                   # 语音输入
├── remote/                  # 远程会话
├── server/                  # 服务器模式
├── memdir/                  # 持久化内存目录
├── tasks/                   # 任务管理
├── state/                   # 状态管理
├── migrations/              # 配置迁移
├── schemas/                 # 配置模式（Zod）
├── entrypoints/             # 初始化逻辑
├── ink/                     # Ink 渲染器封装
├── buddy/                   # 伙伴精灵
├── native-ts/               # 原生 TypeScript 工具
├── outputStyles/            # 输出样式
├── query/                   # 查询管道
└── upstreamproxy/           # 代理配置

架构概述

1. 工具系统 (`src/tools/`)

Claude Code 可调用的每个工具都实现为自包含的模块。每个工具定义其输入模式、权限模型和执行逻辑。

工具	描述
`BashTool`	Shell 命令执行
`FileReadTool`	文件读取（图片、PDF、笔记本）
`FileWriteTool`	文件创建/覆盖
`FileEditTool`	部分文件修改（字符串替换）
`GlobTool`	文件模式匹配搜索
`GrepTool`	基于 ripgrep 的内容搜索
`WebFetchTool`	获取 URL 内容
`WebSearchTool`	网络搜索
`AgentTool`	子代理生成
`SkillTool`	技能执行
`MCPTool`	MCP 服务器工具调用
`LSPTool`	语言服务器协议集成
`NotebookEditTool`	Jupyter 笔记本编辑
`TaskCreateTool` / `TaskUpdateTool`	任务创建和管理
`SendMessageTool`	代理间消息传递
`TeamCreateTool` / `TeamDeleteTool`	团队代理管理
`EnterPlanModeTool` / `ExitPlanModeTool`	计划模式切换
`EnterWorktreeTool` / `ExitWorktreeTool`	Git worktree 隔离
`ToolSearchTool`	延迟工具发现
`CronCreateTool`	定时触发器创建
`RemoteTriggerTool`	远程触发器
`SleepTool`	主动模式等待
`SyntheticOutputTool`	结构化输出生成

2. 命令系统 (`src/commands/`)

用户以 / 前缀调用的斜杠命令。

命令	描述
`/commit`	创建 git 提交
`/review`	代码审查
`/compact`	上下文压缩
`/mcp`	MCP 服务器管理
`/config`	设置管理
`/doctor`	环境诊断
`/login` / `/logout`	认证
`/memory`	持久化内存管理
`/skills`	技能管理
`/tasks`	任务管理
`/vim`	Vim 模式切换
`/diff`	查看更改
`/cost`	查看使用成本
`/theme`	更改主题
`/context`	上下文可视化
`/pr_comments`	查看 PR 评论
`/resume`	恢复之前的会话
`/share`	分享会话
`/desktop`	桌面应用交接
`/mobile`	移动应用交接

3. 服务层 (`src/services/`)

服务	描述
`api/`	Anthropic API 客户端、文件 API、引导程序
`mcp/`	模型上下文协议服务器连接和管理
`oauth/`	OAuth 2.0 认证流程
`lsp/`	语言服务器协议管理器
`analytics/`	基于 GrowthBook 的功能标志和分析
`plugins/`	插件加载器
`compact/`	对话上下文压缩
`policyLimits/`	组织策略限制
`remoteManagedSettings/`	远程托管设置
`extractMemories/`	自动记忆提取
`tokenEstimation.ts`	Token 数量估算
`teamMemorySync/`	团队记忆同步

4. 桥接系统 (`src/bridge/`)

双向通信层，连接 IDE 扩展（VS Code、JetBrains）与 Claude Code CLI。

bridgeMain.ts — 桥接主循环
bridgeMessaging.ts — 消息协议
bridgePermissionCallbacks.ts — 权限回调
replBridge.ts — REPL 会话桥接
jwtUtils.ts — 基于 JWT 的认证
sessionRunner.ts — 会话执行管理

5. 权限系统 (`src/hooks/toolPermission/`)

在每个工具调用时检查权限。根据配置的权限模式（default、plan、bypassPermissions、auto 等）提示用户批准/拒绝或自动解析。

6. 功能标志

通过 Bun 的 bun:bundle 功能标志进行死代码消除：

import { feature } from 'bun:bundle'

// 非活动代码在构建时完全剥离
const voiceCommand = feature('VOICE_MODE')
  ? require('./commands/voice/index.js').default
  : null

重要标志：PROACTIVE、KAIROS、BRIDGE_MODE、DAEMON、VOICE_MODE、AGENT_TRIGGERS、MONITOR_TOOL

关键文件详解

`QueryEngine.ts`（约 46K 行）

LLM API 调用的核心引擎。处理流式响应、工具调用循环、思考模式、重试逻辑和 token 计数。

`Tool.ts`（约 29K 行）

定义所有工具的基础类型和接口——输入模式、权限模型和进度状态类型。

`commands.ts`（约 25K 行）

管理所有斜杠命令的注册和执行。使用条件导入来按环境加载不同的命令集。

`main.tsx`

基于 Commander.js 的 CLI 解析器和 React/Ink 渲染器初始化。在启动时并行处理 MDM 设置、Keychain 预取和 GrowthBook 初始化，以加快启动速度。

技术栈

类别	技术
运行时	Bun
语言	TypeScript（严格模式）
终端 UI	React + Ink
CLI 解析	Commander.js（extra-typings）
模式验证	Zod v4
代码搜索	ripgrep
协议	MCP SDK、LSP
API	Anthropic SDK
遥测	OpenTelemetry + gRPC
功能标志	GrowthBook
认证	OAuth 2.0、JWT、macOS Keychain

值得关注的设计模式

并行预取

通过在重型模块评估开始前并行预取 MDM 设置、Keychain 读取和 API 预连接来优化启动时间。

// main.tsx — 在其他导入之前作为副作用触发
startMdmRawRead()
startKeychainPrefetch()

懒加载

重型模块（OpenTelemetry、gRPC、分析工具和某些功能门控子系统）通过动态 import() 延迟加载，直到实际需要时才加载。

代理蜂群

子代理通过 AgentTool 生成，由 coordinator/ 处理多代理编排。TeamCreateTool 支持团队级并行工作。

技能系统

skills/ 中定义的可重用工作流通过 SkillTool 执行。用户可以添加自定义技能。

插件架构

内置和第三方插件通过 plugins/ 子系统加载。

研究/所有权免责声明

本仓库用作教育和防守性安全研究存档。
旨在研究源码暴露、打包失败和现代代理式 CLI 系统的架构。
原始 Claude Code 源码仍为 Anthropic 的财产。
本仓库与 Anthropic 没有关联、未被 Anthropic 认可或由 Anthropic 维护。

9.7 KiB Raw Permalink Blame History Unescape Escape