hoborg/collection-claude-code-source-code

Files

Shangding Gu fa8e3d407d Revise README-CN with latest updates and project details

Updated README-CN.md to include recent developments and project comparisons.

2026-04-03 10:42:31 -07:00

24 KiB

Raw Permalink Blame History

Claude Code 开源代码合集

Claude Code 源码档案与 Python 重写的研究仓库

🔥🔥🔥 最新动态（太平洋时间）

2026年4月2日 12:20：Nano Claude Code v3.0：多智能体包（multi_agent/）、记忆包（memory/）、技能包（skill/），内置技能、参数替换、fork/inline 执行、AI 记忆搜索、git worktree 隔离、代理类型定义（~5000 行 Python）
2026年4月2日 07:40：Nano Claude Code v2.0：最小 Python 重实现（~3400 行），支持开源与闭源模型、技能与记忆
2026年4月1日 08:36：Nano Claude Code v1.0：最小 Python 重实现（~1300 行）
2026年4月1日 00:20：Claude Code 源码解析（视频：中文）
2026年3月31日 19:45：Claude Code 研究报告（中文）
2026年3月31日 17:13：Claude Code 架构分析（中文）
2026年3月31日 16:43：Claude Code 功能全览（中文）
2026年3月31日 15:00：Hacker News 社区关于 Claude Code 泄露的讨论
2026年3月31日 11:48：Anthropic 如何为 Claude Code 构建 7 层记忆与梦境系统
2026年3月31日 09:50：Claude Code 记忆系统解析
2026年3月31日 09:48：Claude Code 源代码疑似泄露：我们目前所知道的
2026年3月31日 09:04：拆解 Claude Code 架构（中文）
2026年3月31日 07:07：逐步解读 Claude Code 源码（中文）
2026年3月31日 05:41：Claude Code 为何优于其他工具：深度分析
2026年3月31日 05:03：Anthropic AI 编程工具再次泄露自身源代码
2026年3月31日 03:28：Claude Code 源码曝光：提示词、自愈机制与多代理架构（中文）
2026年3月31日 03:02：社区对 Claude Code 源码曝光的反应
2026年3月31日 02:57：Claude Code 背后的代码
2026年3月31日 01:23：关于 Claude Code 源码泄露的病毒式传播帖子

子项目	语言	性质	文件数
original-source-code	TypeScript	原始泄露源码档案	1,884 个
claude-code-source-code	TypeScript	反编译源码档案（v2.1.88）+ 文档	1,940 个
claw-code	Python	清室架构重写	109 个
nano-claude-code	Python	最小化多模型提供商重实现	~30 个

一、original-source-code

2026 年 3 月 31 日原始泄露的 Claude Code TypeScript 源码，按原始状态完整保存。包含 1,884 个 TypeScript/TSX 文件（打包为 src.zip，约 9.5MB），覆盖完整的 src/ 目录树——正是这批文件引发了社区讨论和后续研究。

original-source-code/
├── src/                  # 完整 TypeScript 源码树（1,884 个 .ts/.tsx 文件）
│   ├── main.tsx          # CLI 入口
│   ├── query.ts          # 核心代理循环
│   ├── commands.ts       # 斜杠命令定义
│   ├── tools.ts          # 工具注册
│   └── ...               # 其余所有源码目录（与 claude-code-source-code/src 结构相同）
├── src.zip               # 压缩档案（~9.5MB）
└── readme.md

此目录作为未修改的原始参考快照保存，未添加任何注释、文档或构建工具。如需研究注解版本，请使用 claude-code-source-code。

二、claude-code-source-code

Claude Code v2.1.88 的反编译/解包源码，从 npm 包 @anthropic-ai/claude-code@2.1.88 还原，约 163,318 行 TypeScript 代码，并附有深度分析文档。

整体架构

claude-code-source-code/
├── src/
│   ├── main.tsx              # CLI 入口与 REPL 引导（4,683 行）
│   ├── query.ts              # 主代理循环核心（最大单文件，785KB）
│   ├── QueryEngine.ts        # SDK/Headless 查询生命周期引擎
│   ├── Tool.ts               # 工具接口定义 + buildTool 工厂
│   ├── commands.ts           # 斜杠命令定义（~25K 行）
│   ├── tools.ts              # 工具注册与预设
│   ├── context.ts            # 用户输入上下文处理
│   ├── history.ts            # 会话历史管理
│   ├── cost-tracker.ts       # API 成本追踪
│   ├── setup.ts              # 首次运行初始化
│   │
│   ├── cli/                  # CLI 基础设施（stdio、structured transports）
│   ├── commands/             # ~87 个斜杠命令实现
│   ├── components/           # React/Ink 终端 UI（33 个子目录）
│   ├── tools/                # 40+ 工具实现（44 个子目录）
│   ├── services/             # 业务逻辑层（22 个子目录）
│   ├── utils/                # 工具函数库
│   ├── state/                # 应用状态管理
│   ├── types/                # TypeScript 类型定义
│   ├── hooks/                # React Hooks
│   ├── bridge/               # Claude Desktop 远程桥接
│   ├── remote/               # 远程模式
│   ├── coordinator/          # 多代理协调
│   ├── tasks/                # 任务管理
│   ├── assistant/            # KAIROS 助手模式
│   ├── memdir/               # 长期记忆管理
│   ├── plugins/              # 插件系统
│   ├── voice/                # 语音模式
│   └── vim/                  # Vim 模式
│
├── docs/                     # 深度分析文档（中英双语）
│   ├── en/                   # English analysis
│   └── zh/                   # 中文分析
├── vendor/                   # 第三方依赖
├── stubs/                    # 模块存根
├── types/                    # 全局类型定义
├── utils/                    # 顶层工具函数
├── scripts/                  # 构建脚本
└── package.json

核心执行流程

用户输入
  ↓
processUserInput()         # 解析 /slash 命令
  ↓
query()                    # 主代理循环（query.ts）
  ├── fetchSystemPromptParts()    # 组装系统提示词
  ├── StreamingToolExecutor       # 并行工具执行
  ├── autoCompact()               # 上下文自动压缩
  └── runTools()                  # 工具编排调度
  ↓
yield SDKMessage           # 流式返回给消费者

技术栈

组件	技术
语言	TypeScript 6.0+
运行时	Bun（编译为 Node.js >= 18 bundle）
Claude API	Anthropic SDK
终端 UI	React + Ink
代码压缩	esbuild
数据验证	Zod
工具协议	MCP（Model Context Protocol）

主要模块说明

工具系统（40+ 工具）

类别	工具
文件操作	FileReadTool、FileEditTool、FileWriteTool
代码搜索	GlobTool、GrepTool
系统执行	BashTool
网络访问	WebFetchTool、WebSearchTool
任务管理	TaskCreateTool、TaskUpdateTool、TaskGetTool、TaskListTool
子代理	AgentTool
代码环境	NotebookEditTool、REPLTool、LSPTool
Git 工作流	EnterWorktreeTool、ExitWorktreeTool
配置与权限	ConfigTool、AskUserQuestionTool
记忆与规划	TodoWriteTool、EnterPlanModeTool、ExitPlanModeTool
自动化	ScheduleCronTool、RemoteTriggerTool、SleepTool
MCP 集成	MCPTool

斜杠命令（~87 个）

/commit /commit-push-pr /review /resume /session /memory /config /skills /help /voice /desktop /mcp /permissions /theme /vim /copy 等

权限系统

三种模式：default（询问用户）/ bypass（自动允许）/ strict（自动拒绝）
工具级别粒度控制
基于 ML 的自动化权限推断分类器
权限规则持久化存储

上下文管理

自动压缩策略（autoCompact）：Reactive 压缩、微压缩、裁剪压缩
上下文折叠（CONTEXT_COLLAPSE）
Token 计数与估计
会话转录与持久化

分析文档（`docs/`）

文档	内容
01-遥测与隐私	双层分析管道（Anthropic + Datadog）、无退出开关
02-隐藏功能与模型代号	Capybara、Tengu、Fennec、Numbat 等内部代号
03-卧底模式	Anthropic 员工在公开库自动进入卧底模式
04-远程控制与紧急开关	每小时轮询、6+ Killswitch、危险变更弹窗
05-未来路线图	KAIROS 自主代理、语音模式、17 个未上线工具

三、claw-code

对 Claude Code 的 Python 清室重写（不包含原始代码副本），专注于架构镜像与研究。由 @instructkr（Sigrid Jin）完成，成为全球最快达到 30K stars 的 GitHub 仓库之一。

整体架构

claw-code/
├── src/
│   ├── __init__.py               # 包导出接口
│   ├── main.py                   # CLI 入口（~200 行）
│   ├── query_engine.py           # 查询引擎核心
│   ├── runtime.py                # 运行时会话管理
│   ├── models.py                 # 共享数据类
│   ├── commands.py               # 命令元数据与执行框架
│   ├── tools.py                  # 工具元数据与执行框架
│   ├── permissions.py            # 权限上下文管理
│   ├── context.py                # 移植上下文
│   ├── setup.py                  # 工作区初始化
│   ├── session_store.py          # 会话持久化
│   ├── transcript.py             # 会话转录存储
│   ├── port_manifest.py          # 工作区清单生成
│   ├── execution_registry.py     # 执行注册表
│   ├── history.py                # 历史日志
│   ├── parity_audit.py           # 与 TypeScript 源码奇偶审计
│   ├── remote_runtime.py         # 远程模式模拟
│   ├── bootstrap_graph.py        # 启动图生成
│   ├── command_graph.py          # 命令图分割
│   ├── tool_pool.py              # 工具池组装
│   │
│   ├── reference_data/           # JSON 快照数据（驱动命令/工具元数据）
│   │   ├── commands_snapshot.json
│   │   └── tools_snapshot.json
│   │
│   ├── commands/                 # 命令实现子目录
│   ├── tools/                    # 工具实现子目录
│   ├── services/                 # 业务逻辑服务
│   ├── components/               # 终端 UI 组件（Python 版）
│   ├── state/                    # 状态管理
│   ├── types/                    # 类型定义
│   ├── utils/                    # 工具函数
│   ├── remote/                   # 远程模式
│   ├── bridge/                   # 桥接模块
│   ├── hooks/                    # Hook 系统
│   ├── memdir/                   # 记忆管理
│   ├── vim/                      # Vim 模式
│   ├── voice/                    # 语音模式
│   └── plugins/                  # 插件系统
│
└── tests/                        # 验证测试

核心类

类 / 模块	职责
`QueryEnginePort`	查询引擎，处理消息提交、流式输出、会话压缩
`PortRuntime`	运行时管理，负责路由、会话启动、轮次循环
`PortManifest`	工作区清单，生成 Markdown 概览
`ToolPermissionContext`	工具权限上下文（allow/deny/ask）
`WorkspaceSetup`	环境检测与初始化报告
`TranscriptStore`	会话转录，支持追加、压缩、回放

CLI 命令

python3 -m src.main [COMMAND]

# 概览
summary              # Markdown 工作区概览
manifest             # 打印清单
subsystems           # 列出 Python 模块

# 路由与索引
commands             # 列出所有命令
tools                # 列出所有工具
route [PROMPT]       # 将提示词路由到对应命令/工具

# 执行
bootstrap [PROMPT]   # 启动运行时会话
turn-loop [PROMPT]   # 运行轮次循环（--max-turns）
exec-command NAME    # 执行命令
exec-tool NAME       # 执行工具

# 会话管理
flush-transcript     # 持久化会话转录
load-session ID      # 加载已保存会话

# 远程模式
remote-mode TARGET   # 模拟远程控制
ssh-mode TARGET      # 模拟 SSH 分支
teleport-mode TARGET # 模拟 Teleport 分支

# 审计与配置
parity-audit         # 与 TypeScript 源码一致性比较
setup-report         # 启动配置报告
bootstrap-graph      # 启动阶段图
command-graph        # 命令图分割视图
tool-pool            # 工具池组装视图

设计特点

快照驱动：通过 JSON 快照文件加载命令/工具元数据，无需完整实现逻辑
清室重写：不包含原始 TypeScript 代码，独立实现
奇偶审计：内置 parity_audit.py 追踪与原实现的差距
轻量架构：109 个文件实现核心框架，适合学习与扩展

四、nano-claude-code

Claude Code 的最小化可运行 Python 重实现（~5,000 行）。与专注架构映射的 claw-code 不同，nano-claude-code 是一个真正可立即使用的编程助手。支持 20+ 闭源模型和本地开源模型，已从 ~900 行原型成长为具备多智能体编排、持久记忆和技能系统的 v3.0 版本。

功能特性

功能	详情
多模型提供商	Anthropic · OpenAI · Gemini · Kimi · Qwen · Zhipu · DeepSeek · Ollama · LM Studio · 自定义端点
交互式 REPL	readline 历史、Tab 补全斜杠命令
代理循环	流式 API + 自动工具调用循环
18 个内置工具	Read · Write · Edit · Bash · Glob · Grep · WebFetch · WebSearch · MemorySave · MemoryDelete · MemorySearch · MemoryList · Agent · SendMessage · CheckAgentResult · ListAgentTasks · ListAgentTypes · Skill · SkillList
Diff 视图	Edit 和 Write 操作的 Git 风格红绿差异显示
上下文压缩	自动压缩长对话，保持在模型上下文限制内
持久记忆	双作用域记忆（用户 + 项目），4 种类型，AI 搜索，过期警告
多智能体	生成类型化子代理（coder/reviewer/researcher/…），git worktree 隔离，后台模式
技能系统	内置 `/commit` · `/review` + 支持参数替换和 fork/inline 执行的自定义 Markdown 技能
插件工具	通过 `tool_registry.py` 注册自定义工具
权限系统	`auto` / `accept-all` / `manual` 三种模式
17 个斜杠命令	`/model` · `/config` · `/save` · `/cost` · `/memory` · `/skills` · `/agents` · …
上下文注入	自动加载 `CLAUDE.md`、git 状态、当前目录、持久记忆
会话持久化	保存/加载对话至 `~/.nano_claude/sessions/`
扩展思考	开启/关闭（仅限 Claude 模型）
成本追踪	Token 用量 + 估算 USD 费用
非交互模式	`--print` 参数用于脚本/CI 场景

支持的模型

闭源（API）： Claude（Anthropic）、GPT / o 系列（OpenAI）、Gemini（Google）、Kimi（Moonshot AI）、Qwen（阿里云百炼）、GLM（智谱）、DeepSeek

开源（本地，通过 Ollama）： llama3.3/3.2、qwen2.5-coder、deepseek-r1、phi4、mistral、mixtral、gemma3、codellama 及 ollama list 中的任意模型

自托管： vLLM、LM Studio 或任何通过 CUSTOM_BASE_URL 配置的 OpenAI 兼容端点

项目结构

nano-claude-code/
├── nano_claude.py       # 入口：REPL + 斜杠命令 + 渲染          (~748 行)
├── agent.py             # 代理循环：消息格式 + 工具分发          (~174 行)
├── providers.py         # 多提供商适配器 + 消息格式转换          (~507 行)
├── tools.py             # 工具分发 + 所有包的自动注册            (~467 行)
├── tool_registry.py     # 中央工具注册表 + 插件入口             (~98 行)
├── context.py           # 系统提示构建：CLAUDE.md + git + 记忆  (~135 行)
├── compaction.py        # 上下文压缩（auto-compact）            (~196 行)
├── config.py            # 配置加载/保存/默认值                  (~72 行)
├── memory.py            # 向后兼容 shim → memory/
├── skills.py            # 向后兼容 shim → skill/
├── subagent.py          # 向后兼容 shim → multi_agent/
│
├── memory/              # 持久记忆包
│   ├── store.py         # 记忆条目的保存/加载/删除/搜索
│   ├── scan.py          # 索引扫描、新鲜度助手
│   ├── context.py       # 系统提示注入 + AI 排名搜索
│   ├── types.py         # MEMORY_TYPES 定义
│   └── tools.py         # MemorySave · MemoryDelete · MemorySearch · MemoryList
│
├── skill/               # 技能系统包
│   ├── loader.py        # SkillDef、文件解析、参数替换
│   ├── builtin.py       # 内置技能：/commit、/review
│   ├── executor.py      # inline + fork 执行模式
│   └── tools.py         # Skill · SkillList
│
├── multi_agent/         # 多智能体编排包
│   ├── subagent.py      # AgentDefinition、SubAgentTask、SubAgentManager、worktree 工具
│   └── tools.py         # Agent · SendMessage · CheckAgentResult · ListAgentTasks · ListAgentTypes
│
├── tests/               # 101 个测试（monkeypatch，不触碰真实 ~/.nano_claude/）
├── docs/                # 文档与演示素材
└── requirements.txt

快速开始：

pip install anthropic openai httpx rich
export ANTHROPIC_API_KEY=sk-ant-...
python nano_claude.py

# 启动时切换模型
python nano_claude.py --model gpt-4o
python nano_claude.py --model ollama/qwen2.5-coder

# 非交互 / CI 场景
python nano_claude.py --print "写一个 Python 斐波那契函数" --accept-all

记忆——跨会话持久化，双作用域（用户 ~/.nano_claude/memory/ 和项目 .nano_claude/memory/）：

/memory                  # 列出所有记忆（含新鲜度信息）
MemorySave(name="...", type="feedback", content="...", scope="user")
MemorySearch(query="...", use_ai=True)

技能——可复用提示模板，在 REPL 中直接调用：

/commit                  # 内置：审查暂存变更并创建 git commit
/review 123              # 内置：审查 PR #123
/skills                  # 列出所有可用技能及触发词和参数提示

多智能体——生成类型化子代理，支持可选的 git worktree 隔离：

Agent(prompt="...", subagent_type="coder", isolation="worktree", wait=False)
SendMessage(agent_name="my-agent", message="...")
/agents                  # 显示所有活跃和已完成的子代理任务

四个项目对比

维度	original-source-code	claude-code-source-code	claw-code	nano-claude-code
语言	TypeScript	TypeScript	Python	Python
代码量	~163,000 行	~163,000 行 + 文档	~5,000 行	~5,000 行
性质	原始泄露源码档案	反编译源码档案 + 分析	清室架构重写	最小化功能重实现
功能完整度	完整（100%）	完整（100%）	架构框架（~20%）	核心循环 + 记忆 + 多智能体 + 技能
核心循环	`query.ts`（785KB）	`query.ts`（785KB）	`QueryEnginePort`（~200 行）	`agent.py`（~174 行）
工具系统	40+ 完整实现	40+ 完整实现	快照元数据 + 执行框架	18 个完整实现 + 插件注册表
记忆系统	是（7 层，复杂）	是（7 层，复杂）	否	是（双作用域，4 类型，AI 搜索）
多智能体	是（完整协调器）	是（完整协调器）	否	是（类型化代理，worktree 隔离）
技能系统	是（~87 个命令）	是（~87 个命令）	仅快照元数据	是（内置 + 自定义 Markdown 技能）
多模型提供商	否（仅 Anthropic）	否（仅 Anthropic）	否	是（10+ 提供商）
可立即运行	否	否	有限（仅 CLI 元数据）	是
主要用途	原始参考快照	深度学习完整实现细节	架构理解、移植研究	轻量级全功能编程助手

许可与声明

本仓库仅供学术研究与教育目的使用。所有子项目均基于公开可获取的信息构建。使用者应自行遵守相关法律法规及服务条款。

24 KiB Raw Permalink Blame History Unescape Escape

Claude Code 开源代码合集

🔥🔥🔥 最新动态（太平洋时间）

目录

一、original-source-code

二、claude-code-source-code

整体架构

核心执行流程

技术栈

主要模块说明

工具系统（40+ 工具）

斜杠命令（~87 个）

权限系统

上下文管理

分析文档（docs/）

三、claw-code

整体架构

核心类

CLI 命令

设计特点

四、nano-claude-code

功能特性

支持的模型

项目结构

四个项目对比

许可与声明

24 KiB

Raw Permalink Blame History

分析文档（`docs/`）