CC源码剖析 #01 · 整体架构概览：目录结构与模块划分

基于 2026-03-31 公开的源码快照，~512,000 行代码

一、项目背景

Claude Code 源码于 2026 年 3 月 31 日通过 npm 包中的 .map 文件意外暴露，指向 Anthropic R2 存储桶中未经混淆的 TypeScript 源码。此镜像仅用于教育、安全研究和软件供应链分析。

• 语言：TypeScript（strict 模式）
• 运行时：Bun
• 终端 UI：React + Ink
• 规模：约 1,900 个文件，512,000+ 行代码

二、顶层目录结构

C:\dev\claude\claude-code\
├── src/                    # 全部业务逻辑
├── .vscode/                # VSCode 调试配置
├── README.md               # 研究背景文档（非官方）
└── package.json

三、src/ 模块全景图

3.1 核心运行模块

3.2 通信层

3.3 任务与状态

3.4 UI 与交互

3.5 生态扩展

3.6 其他

四、最关键模块详解

4.1 tools/ — 工具系统（Agent 的"手"）

Claude Code 的 Agent 通过 Tool 与外界交互。每个 Tool 都是一个自包含模块：

每个 Tool 定义：

• 输入 Schema（Zod 验证）
• 权限模型（Permission Model）
• 执行逻辑

4.2 bridge/ — 进程间通信（最复杂模块）

Claude Code 可作为 VSCode/JetBrains 插件使用，Bridge 是 IDE 扩展与 CLI 之间的双向通信层。

核心文件：

通信模式：双向 IPC，支持消息队列、心跳检测、JWT 鉴权。

4.3 coordinator/ — 多 Agent 编排

处理多 Agent 协作场景：

• Sub-agent 的派生与管理
• 团队级并行工作（TeamCreateTool）
• 任务协调与结果聚合

4.4 services/ — 外部集成

4.5 entrypoints/ — 各端点入口

Claude Code 支持多种启动方式：

• CLI 模式：终端直接运行
• VSCode 扩展：集成到 VSCode
• JetBrains 扩展
• Remote 模式：远程连接

每个端点有独立的初始化逻辑。

五、核心文件 TOP 5

六、关键技术栈

七、启动流程（简化版）

main.tsx（入口）
  ├── Commander.js CLI 解析
  ├── 并行预加载（MDM配置/Keychain/API预连接）
  ├── GrowthBook 初始化
  └── Ink React 渲染
       ├── commands.ts 注册 Slash Commands
       ├── tools.ts 注册 Tool
       ├── QueryEngine 初始化
       └── 等待用户输入 → 进入 Tool Call 循环

八、Feature Flags（编译时裁剪）

Claude Code 使用 Bun 的 bun:bundle 特性标志在编译时裁剪未激活代码：

1
2
3
4
5

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

九、模块依赖关系（简化视图）

main.tsx
├── commands.ts
├── tools.ts
├── QueryEngine.ts
│   └── context.ts
├── coordinator/
├── bridge/  ←→ IDE Extensions（VSCode/JetBrains）
├── services/
│   ├── api/
│   ├── mcp/
│   └── lsp/
└── entrypoints/

下一步

下一篇：02 - 入口点解析：从 CLI 到 REPL，深入 main.tsx、commands.ts 与 REPL 初始化流程。

Claude Code 源码研究系列 · 2026 · skyseraph