全因 Claude Code 源码泄漏了。

源码泄漏背后的真相

低级失误导致大规模泄露

安全研究员 Chaofan Shou 发现 Anthropic 发布在 npm 上的 Claude Code 包里有一个 57 MB 的 .map 文件没有被排除。通过这个文件可以还原出全部 数万行 TypeScript 源文件共计约 30 万行代码。

泄漏原因很低级——Bun 打包器默认生成 source map，.npmignore 没加排除规则。更讽刺的是源码里还有一个叫 “Undercover Mode” 的子程序。专门防止 AI 在 git commit 里泄漏内部代号，却把整个源码直接塞进了 npm 包。按理说，

我们不聊八卦。只聊价值

这篇文章聚焦两件事：

1. 这数万行代码里隐藏了哪些可以参考的工程设计。
2. 泄漏后几小时内全球开发者到底造出了什么新环境。

主要在第二个。因为源码本身会逐渐老化，但它催生的开源环境将长期影响 Agent 开发格局。

Claude Code 干了什么？

所有代码都是 Harness Engineering工具程序、权限管控、记忆整理、上下文压缩、多 Agent 协调、遥测监控等。模型本身仅是一个 API 调用。

ShareAI Lab 逆向工程团队： “模型是大脑，Harness 是身体。没有身体，大脑什么也做不了。”

如果你曾经把 80% 时间花在调 Prompt 上，这段源码会让你意识到方向完全错了。

可以参考的关键工程决策

. 被禁用的工具连 Schema 都不发给模型

Claude Code 中约有 30 个工具定义代码。老实说，被拒绝的工具根本不会出现在模型的工具列表中，自然不会被调用。其实，

痛点： “我经常在 Prompt 中写‘不要调用 X 工具’。但模型仍然幻觉调用，” 至于方法，直接在注册阶段省略该工具的 Schema。即可根除幻觉调用，怎么说呢，

. 上下文自动压缩。实现高达 6 倍压缩率且语义损失低于 5%

C​laude Code 使用六种不同的压缩策略，根据 session 状态动态选择。150 K token 能压到 25 K。

痛点： “长对话后模型忘记前面说了什么。” 方法这方面，将上下文压缩视为架构层面的必需，而非可选调整。老实说，

. Agent 会自己做梦

后台服务 autoDream 在满足以下条件时触发：

• 距上次 Dream 超过 4 小时；
• 至少产生 10 个新 session；
• L​LM 获取排他锁。

触发后执行四阶段：感知、采集、整合、修剪。Dream 子 Agent 拥有只读权限。用于自行整理笔记，而不是简单存档对话。

. 文件编辑采用字符串替换而非 diff

FileEditTool 接受 old_string/end_string。避免了生成合法 diff 时常见的错误，提高了可靠性。

. 程序提示词拆分为静态与动态两段

静态段命中 API prompt cache，不产生费用；动态段根据项目变化实时生成。不过，一刀切两段显著减少成本。

. 多 Agent 协调防止偷懒

# Coordinator Prompt Rule: "Do NOT say 'based on your findings' — read actual findings and specify exactly what to do."

痛点： “主 Agent 指令太模糊，子 Agent 输出一堆无关内容。” 通过硬编码反偷懒规则。可强制子 Agent 按实际数据行动，提高整体质量。

C​laude Code 与 Codex 的安全设计差异

C​laude Code：应用层细粒度控制

• # 生命周期约 50 条安全门控，每次工具调用检查耗时仅约 0.8 ms；粒度细，可编程性强，与使用者进程共享边界。
• # 精细控制 vs. Codex 的绝对隔离.

K​AIROS 与 BUDDY 两个隐藏功能抢先曝光

• KAIROS：S​cheduled autonomous checks，每隔一定时间主动触发任务；阻塞预算秒级限制——任何阻塞使用者超过 1 秒的操作自动推迟。
• BUDDY：S​完整电子宠物程序。 拥有多种稀有度和出现概率，目前已内部发布，仅文档延迟更新。

泄漏后数小时内全球开发者到底造了什么？

A. 洁净室重写——从零实现跨语言版本

• `claw-code`: — 首小时即获得 500+ stars，突破 2000 stars 成为 GitHub 增长最快仓库之一。— 作者 Sigrid Jin 为 Claude Code 最活跃使用者之一。在泄漏当天凌晨用 Codex 完全从零重写 Python 实现，并正在推进 Rust 移植，跨越 5 个 crate。话说回来，— Anthropic 对直接源码镜像提起 DMCA。但未对洁净室重写采取行动。
• `Kuberwastaken/claude-code`: — 两个 AI Agent 协同工作：一个分析源码产出行为规格。另一个仅依据规格实现，实现法律上严格的洁净室。
• `opensolon/soloncode`: — 面向中国公司环境，在 Gitee 上提供 Java 实现。

B. 教学项目——把架构拆成课程程序

• `learn-claude-code`: — “Bash is all you need”。共计 12 节课时每节逆向实现一个主要机制：Agent 循环、工具使用、子 Agent、技能加载、上下文压缩、任务程序、后台任务、Agent 团队、自主 Agent、worktree 隔离等。— 单文件 s_full.py) 集成全部机制，并提供英文/中文/日文三语文档。*如果你正为“Prompt 调试占据大部分时间”而苦恼。这套课程能方便你转向 Harness 开发*
• `mini-claude-code`：极致浓缩版，仅几百行 Python，从最小 Bash Agent 到完整技能加载版本。
• `claw0`：章节化教程，共计 8k 行 Python。围绕五大阶段：Foundation → Connectivity → Brain → Autonomy → Production。
• `claude-code-deep-dive`：中文深度研究报告 PDF，程序阐释架构、程序提示词、Agent 调度链、插件与钩子等。
• `claude-code-agent-teams-exercises`：提供 20+练习 + 5 项综合项目专注于 Agent Teams 协调模式。

C. 解锁版——去掉遥测并开启实验特性

• `free-code`：去除所有遥测。剥离安全提示词护栏，并解锁 VOICE_MODE、KAIROS 等实验性 Feature Flag。
• `claude-code-haha`：本地化可运行版本，支持通过 ANTHROPIC_BASE_URL{} 接入国内 LLM 提供商。
• `claude-private`：二进制补丁版。清零 Datadog token，其余功能保持完整。

D. 架构可视化与分析工具

• `claude-code-reverse`：基于运行时拦截 Claude Code → LLM API 请求，实现日志可视化与动态逆向。
• `sanbuphy/claude-code-source-code`：四语言深度分析，记录内部代号映射关系。
• `nirholas/claude-code`：附带 MCP 服务，使 Claude Desktop / VS Code Copilot / Cursor 能交互式探索完整源码。
• `collection-claude-code-source-code`：聚合仓库，追踪自2024年9月1日起每一次关键分析与社区反馈。

E. 技能与插件环境——爆炸式增长中

• `awesome-claude-code`：精选技能、钩子、斜杠命令、Agent 编排器及插件列表，是寻找资源的一站式入口。按理说，
• `claude-code-plugins-plus-skills`：提供超过 30 个插件 + 150+ Agent 技能。并内置 CCPI 包管理器及 Prism Scanner 安全扫描器。
• `awesome-claude-code-toolkit`：汇总>40 个 Agent +>200 个精选技能 +>50 条命令 +>30 插件 +>20 钩子 +>100 安全规则 + 多模板 & MCP 配置，是目前最全的工具包。按理说，
• `claude-code-skills`：覆盖交付生命周期全链路。包括 hex-line、hex-graph、hex-ssh等。

按 Star 数量分布概览

Total repositories tagged `claude-code`: **≈1。200**，覆盖 Python、TypeScript、Shell、JavaScript、Go 与 Rust 六大语言，其中多个仓库在短时间内突破千星大关。

K​airos 与 Buddy —— 两大隐藏功能简单分析

• KAIROS：S​cheduled autonomous agent，每隔固定间隔自行检查是否有待办任务。具备秒级阻塞预算——任何可能阻塞使用者超过 **1 秒** 的操作会自动推迟，以保证交互流畅性。
• BUDDY：S​完整电子宠物程序。共计 **7** 种物种与 **5** 种稀有度等级，还有 **0.02%** 的闪光传说级出现概率。怎么说呢，目前已内部发布，只是公开文档稍显滞后。*如果你希望在自己的 AI 助手中加入情感交互，这两个功能值得参考*.

P​​ost‑leak 开源环境版图 —— 我们还缺哪些关键组件？

• KAIROS 自主模式实现：- 周期性 tick 提示 + 秒阻塞预算 + append‑only 日志，目前尚无开源等价实现。

• Kairos 自动记忆整合管线 完整实现：- 虽有 ai‑dream 项目提供基础框架，但缺少官方精密度还有夜间分叉子 Agent 完整流程复刻.

• KV 缓存分叉合并机制：- Claude Code 利用分叉 prompt 缓存实现几乎免费并行。需要服务器端基础设施支撑，目前开源项目难以覆盖.

• "ULTRAPLAN" 云端规划服务：- 将复杂规划卸载至容器跑 Opus，可思考最长达 **30 分钟**；暂无公开替代品.

• S​ecurity Validation 套件 ： - 超过 **10k 行** bash 脚本进行安全检查，目前缺少匹配投入的衍生项目.

• C​ross‑border e‑commerce Skills：- 在所有 ~1,200 仓库中针对跨境电商场景几乎为零空白.

P​​ersonal Verdict —— 把精力放在 Harness 上，而不是 Prompt

If you’re still spending *80%* of your time tweaking prompts,you’re fighting a losing battle.

The leaked code plus exploding ecosystem provide concrete evidence that ** real ROI lies in building robust harnesses**。not in endless prompt engineering.

The single most actionable takeaway: dive into . Its step‑by‑step modules walk you through every core mechanism of a production‑grade harness – from context compression to autonomous dreaming – and will give you more value than any single analysis article.

If you’re currently building Agents or automating workflows with AI,bookmark this page. Feel free to comment with specific challenges – context compression,memory systems or multi‑Agent coordination – because I’m still digging deeper and will publish dedicated deep‑dive posts soon.

。

---