Claude code泄露码源到底说了啥?
Source: http://x.com/i/article/2038949665606111232
摘要
今天下午最大的新闻莫过于claude code码源泄露这件事了。 https://github.com/instructkr/claude-code 那么很简单,我们一起来看一下这里面都有什么东西。
首先,Claude Code 的公开产品到底是什么样的?
Anthropic 官方将其定义为一套agentic coding tool,核心能力包括读取代码库、编辑文件、执行命令,并与开发工具集成;使用入口覆盖终端、IDE、桌面应用和浏览器。与此同时,Anthropic 又公开了 Claude Agent SDK,并明确说明该 SDK 复用了与 Claude Code 相同的 tools、agent loop 和 context management。这两组公开信息共同说明,Claude Code 的核心并不止于一个命令行界面,它已经形成一套完整的代理执行框架。
基于这份泄露源码快照的模块命名与 Anthropic 官方文档的能力描述,可以将 Claude Code 概括为一套由启动层、命令层、代理循环层、工具层、会话与记忆层、权限层、扩展层、多代理层、多端接入层共同组成的工程系统。
GitHub 上公开流传的`instructkr/claude-code` 仓库将自己描述为 2026 年 3 月 31 日经由 npm 发布包中的 source map 暴露出来的源码归档。这个公开仓库具备较高的研究价值,但从公开页面能看到的内容来看,它呈现的是源码快照和说明材料,尚不能直接等同于 Anthropic 内部完整开发仓。
一、项目定位
从官方产品定义看,Claude Code 已经被组织为面向软件工程任务的通用执行环境。官方文档列出的基础能力包括理解整个代码库、跨多个文件工作、执行开发命令以及与本地或外部开发工具协作。这个产品定位决定了 Claude Code 的内部结构需要处理代码上下文、命令执行、权限控制、会话持久化和扩展接入等多个问题,单一聊天式界面无法覆盖这些要求。1
从公开流传的源码快照定位看,当前这份仓库更适合被描述为高可信源码归档。GitHub 页面明确写明仓库来源于一次通过 `.map` 文件暴露源码的事件,并展示了以 `src/` 为主体的公开内容。这个性质说明它适合用于架构研究、模块识别和能力对照,不适合直接被当作官方发布仓或完整可复现工程来引用。2
二、总体架构
根据官方文档和这份源码快照的模块组织,Claude Code 可以拆分为九个主要部分:启动与入口、命令系统、代理循环、工具执行、上下文与会话、记忆、权限控制、扩展生态、多端接入。
Anthropic 对外公开的Agent SDK 进一步说明了这一拆分方式具有较强可信度,因为 SDK 直接复用了 Claude Code 的 tools、agent loop 和 context management。这意味着 Claude Code 的内部边界已经被产品化,并且具备可编程的复用价值。[3]
在这套结构中,`QueryEngine` 一类模块承担执行循环的中枢职责,`tools.ts` 和 `Tool.ts` 一类模块承担动作能力的注册与协议定义,`commands.ts` 一类模块承担用户入口和控制平面,`main.tsx` 一类模块承担进程启动、UI 装配和运行时初始化。这样的分层方式与官方公开的命令、工具、权限、会话、插件、子代理、远程控制等文档高度一致。(Claude)
三、启动与入口层
在源码快照中识别出的 `main.tsx`,在系统里承担应用入口的角色。公开流传的仓库说明中提到,入口文件负责 CLI 解析与 React/Ink 渲染初始化,并且在启动时并行预取 MDM、keychain 等资源以优化冷启动体验。官方文档也说明 Claude Code 同时存在终端、IDE、桌面和浏览器等多个入口表面。
由此可以判断,入口层的职责包括运行环境识别、命令行参数解析、UI 渲染容器装配、会话初始化和后续代理循环的接线。1
入口层还负责把不同表面的输入统一接入 Claude Code 的核心执行框架。官方 VS Code 文档写明扩展提供图形化界面,并且内含 CLI;桌面应用文档写明桌面版提供图形界面、可视化 diff、实时预览、并行会话和远程任务能力。这说明入口层面对的并不是单一路径,而是一组共享底层能力的前端表面。5
四、命令系统
`commands.ts` 所代表的是Claude Code 的控制平面。
官方内置命令文档说明,用户可以通过 `/` 查看全部可用命令,并根据平台、套餐和环境看到不同的命令集合。这说明命令系统不是简单的文本替换层,而是一套与权限、平台和功能开关联动的命令注册与分发系统。4
命令系统的作用主要体现在三个方面。第一,它提供显式的工作流入口,允许用户直接操作配置、会话、权限和界面行为。第二,它把高频操作变成独立的产品能力,而不是要求用户每次都通过自由文本去描述。第三,它把不同表面的交互方式收敛到同一套内部动作模型上。官方文档显示,命令可见性会受到平台和计划限制,这进一步说明命令层与运行时状态是紧密耦合的。4
对架构分析而言,命令系统的重要性在于它表明 Claude Code 已经将会话管理、配置管理、权限管理、扩展管理和任务管理提升为一等能力。这类设计通常只会出现在已经进入产品化阶段的代理系统中。4
五、代理循环与查询引擎
`QueryEngine.ts` 你可以理解为 agent loop orchestrator,这个判断与官方公开资料高度一致。Anthropic 的 Agent SDK 文档写明,SDK 复用了与 Claude Code 相同的 tools、agent loop 和 context management;关于 agent loop 的公开说明则指出,循环过程包括 Claude 评估提示、调用工具采取动作、接收结果并反复执行,直到任务完成。[3]
这意味着 `QueryEngine` 一类模块在系统中的含义非常明确。它负责接收用户输入和当前上下文,将其组织成模型请求;解析模型返回的工具调用或后续动作;把动作交给工具层执行;接收工具结果并继续推进下一轮推理;在满足终止条件后输出最终结果。Claude Code 的核心执行逻辑可以据此概括为一条持续迭代的控制链,而非单轮请求—响应结构。[6]
这一层同时还需要处理权限回调、成本限制、上下文压缩、会话恢复和输出流控制。官方agent loop 文档明确提到,SDK 暴露了对tools、permissions、cost limits 和 output 的程序化控制;Claude Code 的会话文档又说明会话支持 rewinding、resuming 和 forking。相关能力都需要与代理循环层发生直接连接。[6]
六、工具系统
`tools.ts` 和`Tool.ts` 所对应的是 Claude Code 的执行层。官方 Tools reference 明确写到,Claude Code 拥有一组帮助其理解和修改代码库的工具,并且这些工具名称会直接出现在 permission rules、subagent tool lists 和 hook matchers 中。这说明工具在 Claude Code 中具有标准化标识、统一权限接口和可组合调用关系。7
从公开能力看,工具系统至少覆盖文件操作、命令执行、网页检索、外部系统接入、代码智能分析和多代理协调等方向。Agent SDK 官方文档也写明,SDK 自带读取文件、运行命令、编辑代码等内建工具,因此 Claude Code 的执行能力并不依赖用户自行实现底层工具调用。[3]
如果将你观察到的工具模块与官方公开资料对应,可以看到比较稳定的映射关系。文件读写、编辑、Glob、Grep 等模块对应本地代码库访问;Bash 对应命令执行;WebSearch 与 WebFetch 对应网络信息检索;LSP 相关模块对应语言服务器集成;MCP 相关模块对应外部系统连接;AgentTool、Task、Plan Mode、Worktree 等模块对应更高层级的任务编排和运行模式控制。官方插件、远程控制、团队代理、频道与工具参考文档都表明这些能力已经进入公开产品范围。7
工具系统在 Claude Code 中承担两层含义。第一层是具体动作能力,例如读文件、改文件、执行命令。第二层是协议能力,包括输入输出结构、权限要求、可见性范围和生命周期事件。官方文档中工具名称与权限规则直接关联这一点,说明工具系统已经具备稳定协议边界。7
七、会话、上下文与回放
Claude Code 的会话机制已经在官方文档中明确公开。
How Claude Code works 页面说明,Claude Code 会在本地保存工作过程中的会话内容,每条消息、每次工具使用和每个结果都会被记录,这使 rewinding、resuming 和 forking 成为可能;在代码修改发生之前,系统还会对受影响文件建立快照,以支持后续回滚。8
这些信息说明 Claude Code 的上下文管理并不依赖单次会话窗口,而是以本地持久化记录作为执行历史的承载层。对于架构分析来说,这意味着代理循环层每一轮所看到的上下文,并非只来自当前用户输入,还会融合会话历史、工具结果、文件状态和系统控制信息。8
会话是 Claude Code 多项高级功能的基础。恢复会话、分叉会话、回退会话、审查工具行为、追踪任务过程,都依赖于会话层的结构化记录。如果没有这一层,权限控制、远程控制、多代理协作和桌面界面的可视化能力都难以稳定落地。8
八、记忆系统
官方 Memory 文档将Claude Code 的持久记忆明确拆成两类:`CLAUDE.md` 与 Auto memory。文档给出的对照关系显示,`CLAUDE.md` 由用户或组织编写,承载项目规则、工作流和架构说明;Auto memory 由 Claude 自动积累,记录学习到的模式、调试经验和偏好。两类记忆都会在会话中被加载,作用域分别覆盖项目、用户、组织和具体 working tree。9
这个设计说明 Claude Code 已经把长期上下文分成了“主动写入的规格或工作流要求”和“自动记下来的经验和偏好”。`CLAUDE.md` 对应明确的工程约束与团队规范,Auto memory 对应在实际使用过程中逐步形成的经验数据。官方文档还指出,子代理也可以拥有自己的 auto memory,这意味着记忆系统已经与代理隔离机制结合。9
对源码快照的解读中,`memdir/` 之类目录可以据此理解为持久记忆或记忆管理相关模块。它在系统里的作用不是简单保存聊天内容,而是为后续会话持续提供可加载的工作模式、项目习惯和调试经验。 9
九、权限系统与安全控制
Claude Code 官方公开了独立的 permissions 文档。文档说明用户可以通过 `/permissions` 管理工具权限,并且规则分为 Allow、Ask、Deny 三类;这些规则会标明来源于哪个 `settings.json`。这表明权限体系以工具为最小控制单位,并且已经与设置系统打通。10
这一设计说明权限系统在 Claude Code 中具有明确结构。工具调用不是无条件执行,而是要经过规则匹配、询问确认或直接拒绝。权限控制点因此直接嵌入代理循环和工具系统之间。对架构分析来说,这一层的意义在于它把模型生成的动作转化为可审计、可约束、可配置的执行请求。 7
官方还公开了 server-managed settings,允许组织在管理后台下发统一配置,并支持限制权限绕过。这说明 Claude Code 的权限体系已经具备企业治理能力,适用于团队或组织环境中的统一约束。 [11]
十、Hooks 与生命周期控制
Hooks reference 提供了Claude Code 生命周期的公开接口。文档说明 agent hooks 触发后,Claude Code 会启动一个子代理,传入提示和 JSON 输入,让该子代理使用 Read、Grep、Glob 等工具进行检查,并在最多 50 轮内返回结构化判断结果。这说明 hooks 系统已经不仅是命令前后的脚本触发器,还具备利用代理能力执行规则检查的能力。12
这一层的工程含义很明确。Claude Code 将关键生命周期节点开放给外部逻辑处理,使自动校验、策略检查、审计流程和组织规则能够嵌入核心执行流程。由于 hooks 能调用子代理和工具,它们并不是被动通知,而是主动验证模块。 12
从架构角度看,hooks 使Claude Code 拥有可编排的事件总线。插件系统、权限系统、工具系统和团队自动化都可以通过这条机制进行连接,因此它在 Claude Code 的整体可扩展性中占据核心位置。 12
十一、技能系统
官方 Skills 文档说明,Claude Code 可以通过 `SKILL.md` 文件引入技能,Claude 会在相关场景自动使用它们,也支持通过 `/skill-name` 显式调用。文档同时写明,skills 用于扩展 Claude 的能力,并包含 custom commands 与 bundled skills。 13
这意味着源码快照中与 `skills/` 相关的代码,代表的是一类轻量级能力封装机制。它们通常不需要修改底层代理循环,也不要求重建工具协议,而是在现有系统之上注入任务说明、使用规则和附加资源。对外部使用者来说,skills 提供的是低门槛扩展路径;对系统内部来说,skills 是标准化的能力包。13
Skills 系统的重要性还在于它已经与命令系统打通。通过 `/skill-name` 直接触发的设计说明,skills 不是边缘扩展,而是被纳入正式交互入口管理的组件。 13
十二、插件系统
官方 Plugins 文档和Plugins reference 明确写到,插件是自包含目录,用于扩展 Claude Code 的 skills、agents、hooks、MCP servers 和 LSP servers,并且能够在项目和团队之间共享。官方 Settings 文档进一步说明,Claude Code 支持插件系统,插件可通过 marketplace 分发,并在用户级和仓库级配置。14
这说明插件系统在 Claude Code 中承担的是更高层级的打包和分发职责。相比单个 skill 或单个 hook,插件面向的是一组功能组件的整体交付,包括技能、代理、语言服务和外部连接器配置。源码快照中的 `plugins/` 目录由此可以理解为平台扩展的核心落地点。 14
官方还提供了插件市场相关文档,说明 marketplace 支持集中式发现、版本追踪、自动更新和多种来源类型。这个公开能力表明 Claude Code 的扩展机制已经从本地配置阶段进入分发与生态阶段。 [15]
十三、外部系统接入:MCP、LSP 与 Channels
Claude Code 的外部接入能力已经在多个官方文档中得到公开说明。Overview 页面写明 Claude Code 可以与开发工具集成;插件文档列出 MCP servers 和 LSP servers 是插件组件;Discover plugins 页面说明 code intelligence plugins 会启用内建 LSP 工具,使 Claude Code 获得跳转到定义、查找引用和查看类型错误的能力。1
这说明源码快照中的 `bridge/`、LSP 相关工具和 MCP 相关模块,分别对应代码智能、外部系统连接和跨表面通信能力。LSP 接入负责语言级语义信息,MCP 接入负责企业系统、知识源或其他工具链的接入,二者共同扩展了 Claude Code 的执行边界。[16]
官方 Channels 文档则公开了一条新的接入通道:MCP server 可以向正在运行的 Claude Code 会话推送消息、告警和 webhook,使 Claude 在用户离开时依然能够接收 CI 结果、聊天消息或监控事件。这表明 Claude Code 的会话已从纯交互式输入,扩展到事件驱动输入。 17
十四、子代理与多代理协作
官方 Sub-agents 文档说明,Claude Code 支持专用子代理,并强调子代理用于 task-specific workflows 和 improved context management。这个定义直接说明子代理拥有明确的任务边界和上下文边界。18
官方 Agent Teams 文档进一步给出更强的协作模型。文档写明 agent teams 允许多个 Claude Code 实例协同工作,由一个 lead session 负责协调任务、分配工作和综合结果;teammates 各自在自己的 context window 中独立运行,并且可以彼此直接通信。文档还明确指出,agent teams 与 subagents 的关键区别在于独立性和通信模式。19
这些公开信息说明,源码快照中的 `coordinator/`、任务相关工具、消息工具和团队管理逻辑并非偶发设计,而是 Claude Code 已经对外公开的一条演进方向。系统当前不仅支持单代理执行,也支持在多个会话和多个上下文之间进行任务拆分、协同与结果汇总。19
十五、多端接入与运行表面
官方概览和快速开始文档说明,Claude Code 可在终端、IDE、桌面应用、浏览器、Slack 和CI/CD 中使用。这个公开范围说明 Claude Code 的产品边界已经超出传统 CLI。1
VS Code 文档写明扩展提供原生图形界面、inline diffs、@-mentions、plan review 和快捷键,并且扩展内含 CLI。桌面应用文档写明桌面版支持 visual diff review、live app preview、PR monitoring、parallel sessions with Git worktree isolation、scheduled tasks 和远程运行任务。由此可见,不同表面共享底层执行能力,同时在界面形态和任务管理上有所区分。 5
Remote Control 文档说明,Remote Control 会话运行在本地机器上,网页和移动端只是这一会话的窗口;与之相对,Claude Code on the web 运行在 Anthropic 管理的云基础设施上。文档还说明 Remote Control 采用本机向外发起 HTTPS 请求并通过 Anthropic API 中转消息,不需要在本机开放入站端口。这些公开细节说明,多端接入层同时支持本地执行和云端执行两种运行模式。20
十六、桌面应用与图形界面层
桌面应用在 Claude Code 架构中的意义已经由官方文档明确给出。Desktop quickstart 指出,桌面版提供图形化界面、可视 diff、实时应用预览、GitHub PR 监控、并行会话和远程任务能力;桌面版完整文档又说明插件可以直接在桌面应用中安装和管理。21
这说明桌面层不只是简单包装终端 CLI,而是一个完整的图形化操作环境。它负责把权限模式选择、模型选择、目录选择、插件管理、会话观察和任务控制提升到 UI 层。源码快照中如果出现桌面相关目录或界面逻辑,其对应含义应理解为图形交互表面的独立实现,而不是核心执行逻辑的重复实现。21
十七、构建与发布判断
围绕这份源码快照,最需要谨慎处理的问题是工程完整性。GitHub 仓库当前公开页将自己说明为经由 source map 泄露出来的源码归档,并展示以 `src/` 为主的内容结构。公开页面未呈现一个典型 Bun/TypeScript 产品仓通常应具备的完整构建元数据、依赖声明和打包配置。基于公开可见内容,这个仓库更适合作为源码研究样本来使用。2
官方文档已经公开表明 Claude Code 是持续发布、持续扩展的产品,支持插件、桌面应用、远程控制、频道、团队代理、托管设置和多种运行表面。具有这种能力范围的产品,在实际构建链中通常会依赖依赖清单、构建脚本、配置注入、版本管理、环境变量和多表面打包流程。公开快照目前无法完整展示这些部分。[22]
因此,对这份代码的正式描述可以写成:当前公开仓库为 Claude Code 高可信源码快照,足以用于模块分析、架构对照与能力研究;当前公开材料不足以支持将其视为 Anthropic 官方完整开发仓或直接复现工程。这个表述更符合目前能被公开证据支撑的范围。2
十八、综合结论
Claude Code 的核心架构已经可以通过官方资料和源码快照得到较完整的重建。系统的骨架由入口层、命令层、代理循环层和工具层组成;会话、记忆和权限系统为执行过程提供持久化和控制能力;skills、plugins、hooks、MCP、LSP 构成扩展面;subagents、agent teams、channels 和 remote control 将其推进到多代理、多事件和多端协作的产品形态。 1
从工程视角看,Claude Code 已经具备平台化特征。Anthropic 公开发布的 Agent SDK 表明,这套系统的核心能力已经抽象到可以被库化复用的程度;官方多表面文档又说明同一执行内核正在服务终端、IDE、桌面和远程场景。源码快照中各模块的组织方式,与这些公开能力高度一致。[3]
如果把这份报告用于对外分享,最稳妥的总体结论是:Claude Code 当前呈现为一套成熟的代理执行平台,公开流传的代码材料具有很高的架构研究价值;在工程完整性、构建链和发布链层面,公开快照仍不足以替代官方内部完整工程。2
所有还没有来得及git clone的小伙伴快去啊!
别到时候被下了又抓不到这个第一手信源啦!
[3]:
https://docs.anthropic.com/en/docs/claude-code/sdk?utm_source=chatgpt.com
"Agent SDK overview - Claude API Docs"
[6]:
https://platform.claude.com/docs/en/agent-sdk/agent-loop?utm_source=chatgpt.com
"How the agent loop works - Claude API Docs"
[11]:
https://code.claude.com/docs/en/server-managed-settings?utm_source=chatgpt.com
"Configure server-managed settings (public beta)"
[15]:
https://code.claude.com/docs/en/plugin-marketplaces?utm_source=chatgpt.com
"Create and distribute a plugin marketplace - Claude Code Docs"
[16]:
https://code.claude.com/docs/en/discover-plugins?utm_source=chatgpt.com
"Discover and install prebuilt plugins through marketplaces"
[22]:
https://code.claude.com/docs/en/settings?utm_source=chatgpt.com
"Claude Code settings - Claude Code Docs"