
Claw Code – 史上最快破 10 万星的项目
⭐ 史上最快破 5 万星的项目,发布后仅 2 小时就达成了里程碑 ⭐

更好的 Harness 工具,而不仅仅是存储泄露的 Claw Code 存档。
🚨 重要通知
Rust 移植工作正在进行中,位于 dev/rust 分支,预计今天合并到 main 分支。Rust 实现旨在提供更快、内存安全的 harness 运行时。敬请期待——这将是项目的最终版本。
如果您觉得这项工作有用,请考虑 在 GitHub 上赞助 @instructkr 以支持持续的开源 harness 工程研究。
🦀 Rust 工作区
rust/ 目录下的 Rust 工作区是项目当前的系统语言移植版本。
目前包含:
- crates/api-client — 具有提供方抽象、OAuth 和流式支持的 API 客户端
- crates/runtime — 会话状态、压缩、MCP 编排、提示词构建
- crates/tools — 工具清单定义和执行框架
- crates/commands — 斜杠命令、技能发现和配置检查
- crates/plugins — 插件模型、钩子管道和捆绑插件
- crates/compat-harness — 上游编辑器集成的兼容性层
- crates/claw-cli — 交互式 REPL、Markdown 渲染和项目引导/初始化流程
运行 Rust 构建:
cd rust
cargo build --release
📖 项目背景
2026 年 3 月 31 日凌晨 4 点,我醒来时手机被通知轰炸了。Claw Code 源代码被曝光了,整个开发者社区都陷入了疯狂。我在韩国的女朋友真的很担心我可能会因为机器上有代码而面临原作者的法律诉讼——所以我做了任何工程师在压力下都会做的事:我坐下来,从头开始将核心功能移植到 Python,并在太阳升起之前推送了。
整个过程完全由 @bellman_ych 开发的 oh-my-codex (OmX) 编排——这是一个构建在 OpenAI Codex (@OpenAIDevs) 之上的工作流层。我使用 $team 模式进行并行代码审查,使用 $ralph 模式进行持久执行循环和架构级验证。整个移植会话——从阅读原始 harness 结构到生成带有测试的可用 Python 树——都是通过 OmX 编排驱动的。
结果是一个干净的 Python 重写,它捕获了 Claw Code 的 agent harness 的架构模式,而没有复制任何专有源代码。我现在正在积极与 OmX 的创建者 @bellman_ych 合作,以进一步推进这一工作。基本的 Python 基础已经到位并可以运行,但我们才刚刚开始。敬请期待——一个更强大的版本即将到来。
Rust 移植是使用 oh-my-codex (OmX) 和 oh-my-opencode (OmO) 共同开发的:OmX 驱动了脚手架、编排和架构方向,而 OmO 用于后期的实现加速和验证支持。
📰 华尔街日报报道
我一直对 harness 工程深感兴趣——研究 agent 系统如何连接工具、编排任务和管理运行时上下文。这不是突然的事情。《华尔街日报》本月早些时候报道了我的工作,记录了我是探索这些系统的最活跃的高级用户之一:
"AI 初创公司员工 Sigrid Jin 参加了首尔晚宴,去年单人使用了 250 亿个 Claw Code 代币。当时,使用限制较为宽松,让早期爱好者能够以极低的成本达到数百亿代币。
尽管 Jin 与 Claw Code 度过了无数小时,但他并不忠于任何一个 AI 实验室。他说,可用的工具有不同的优缺点。Codex 更擅长推理,而 Claw Code 生成更干净、更可共享的代码。
Jin 于 2 月飞往旧金山参加 Claw Code 的一周年派对,与会者排队与 Cherny 交流意见。人群中包括一位来自比利时的执业心脏病学家,他构建了一个帮助患者导航护理的应用程序,还有一位加州律师,他制作了一个使用 Claw Code 自动审批建筑许可的工具。
"这基本上就像一个分享派对," Jin 说。"有律师,有医生,有牙医。他们没有软件工程背景。"
—— 《华尔街日报》,2026 年 3 月 21 日,"万亿美元竞赛:自动化我们的整个生活"

📂 项目结构
主要源代码树现在以 Python 优先。
- src/ 包含活跃的 Python 移植工作区
- tests/ 验证当前的 Python 工作区
- 暴露的快照不再是跟踪的仓库状态的一部分
当前的 Python 工作区还不是原始系统的完整一对一替代方案,但主要实现表面现在是 Python。
我最初研究暴露的代码库是为了理解它的 harness、工具连接和 agent 工作流。在花了更多时间处理法律和伦理问题之后——以及阅读了下面链接的文章之后——我不希望暴露的快照本身仍然是主要的跟踪源代码树。
这个仓库现在专注于 Python 移植工作。
.
├── src/ # Python 移植工作区
│ ├── __init__.py
│ ├── commands.py
│ ├── main.py
│ ├── models.py
│ ├── port_manifest.py
│ ├── query_engine.py
│ ├── task.py
│ └── tools.py
├── rust/ # Rust 移植(claw CLI)
│ ├── crates/api/ # API 客户端 + 流式传输
│ ├── crates/runtime/ # 会话、工具、MCP、配置
│ ├── crates/claw-cli/ # 交互式 CLI 二进制文件
│ ├── crates/plugins/ # 插件系统
│ ├── crates/commands/ # 斜杠命令
│ ├── crates/server/ # HTTP/SSE 服务器(axum)
│ ├── crates/lsp/ # LSP 客户端集成
│ └── crates/tools/ # 工具规范
├── tests/ # Python 验证
├── assets/omx/ # OmX 工作流截图
├── 2026-03-09-is-legal-the-same-as-legitimate-ai-reimplementation-and-the-erosion-of-copyleft.md
└── README.md
🐍 Python 工作区
新的 Python src/ 树目前提供:
- port_manifest.py — 总结当前 Python 工作区结构
- models.py — 子系统、模块和积压状态的数据类
- commands.py — Python 端命令移植元数据
- tools.py — Python 端工具移植元数据
- query_engine.py — 从活动工作区渲染 Python 移植摘要
- main.py — 清单和摘要输出的 CLI 入口点
渲染 Python 移植摘要:
python3 -m src.main summary
打印当前 Python 工作区清单:
python3 -m src.main manifest
列出当前 Python 模块:
python3 -m src.main subsystems --limit 16
运行验证:
python3 -m unittest discover -s tests -v
针对本地忽略的存档运行奇偶校验审计(如果存在):
python3 -m src.main parity-audit
检查镜像的命令/工具清单:
python3 -m src.main commands --limit 10
python3 -m src.main tools --limit 10
移植现在比以前更接近地镜像了存档的根入口文件表面、顶级子系统名称和命令/工具清单。但是,它还不是原始 TypeScript 系统的完整运行时等效替代方案;Python 树仍然包含比存档源代码更少的可执行运行时切片。
🤖 AI 辅助工作流
这个仓库的移植、干净室加固和验证工作流是 AI 辅助的,使用了 Yeachan Heo 的工具栈,其中 oh-my-codex (OmX) 作为主要脚手架和编排层。
- oh-my-codex (OmX) — 脚手架、编排、架构方向和核心移植工作流
- oh-my-opencode (OmO) — 实现加速、清理和验证支持
移植期间使用的关键工作流模式:
- $team 模式: 协调并行审查和架构反馈
- $ralph 模式: 持久执行、验证和完成纪律
- 干净室通过: Rust 工作区的命名/品牌清理、QA 和发布验证
- 手动和实时验证: 发布前的构建、测试、手动 QA 和真实 API 路径验证

Ralph/team 编排视图,README 和文章上下文在终端窗格中审查。

最终 README 措辞通过期间的分窗格审查和验证流程。
🌐 社区
加入 instructkr Discord——最好的韩语语言模型社区。来聊聊 LLM、harness 工程、agent 工作流,以及介于两者之间的一切。
📄 免责声明
请参阅本 README 顶部的图表。
- 此仓库不声称拥有原始 Claw Code 源材料的所有权。
- 此仓库不隶属于、认可或由原作者维护。









暂无评论内容