Claw Code 使用教程-cmzhiku

项目简介

Claw Code 是 Claude Code 泄露源码的 clean-room（干净室）Python 重写项目。2026年3月31日凌晨 Claude Code 源码被意外泄露后，韩国开发者 Sigrid Jin 在压力下从零开始将核心功能移植到 Python，并在日出前将其发布到 GitHub。该仓库在发布后仅 2小时内就突破了5万Star，成为 GitHub 历史上增长最快的开源仓库。

目前项目正在积极使用 Rust 进行重写，目标是打造一个更快、内存安全的 harness 运行时，最终成为真正可用的开源替代方案。

💡
GitHub 地址：
https://github.com/instructkr/claw-code

核心亮点

⚡ 2小时破5万Star

GitHub历史上增长最快的开源仓库

🐍 Python Clean-Room重写

不含任何原始泄露代码，完全独立重写

🦀 Rust重构进行中

更快、更安全的 harness 运行时

📰 华尔街日报报道

作者被 WSJ 专题报道的知名开发者

项目架构

当前 Python 工作区提供以下核心模块：

port_manifest.py — 汇总当前 Python 工作区结构
models.py — 子系统、模块和待办状态的数据类
commands.py — Python 侧命令移植元数据
tools.py — Python 侧工具移植元数据
query_engine.py — 从活跃工作区渲染移植摘要
main.py — 清单和摘要输出的 CLI 入口

目录结构


├── src/                    # Python 移植工作区
│   ├── __init__.py
│   ├── commands.py
│   ├── main.py
│   ├── models.py
│   ├── port_manifest.py
│   ├── query_engine.py
│   ├── task.py
│   └── tools.py
├── rust/                   # Rust 重写（开发中）
├── tests/                  # Python 验证测试
└── README.md

如何使用

步骤 1

克隆仓库

bash

git clone https://github.com/instructkr/claw-code.git
cd claw-code

步骤 2

查看移植摘要

使用 CLI 命令查看当前 Python 移植进度：

bash

# 渲染 Python 移植摘要
python3 -m src.main summary

# 打印当前 Python 工作区清单
python3 -m src.main manifest

# 列出当前 Python 模块
python3 -m src.main subsystems --limit 16

步骤 3

运行验证测试

bash

python3 -m unittest discover -s tests -v

步骤 4

查看命令/工具清单

bash

# 查看镜像的命令清单
python3 -m src.main commands --limit 10

# 查看镜像的工具清单
python3 -m src.main tools --limit 10

背景故事

2026年3月31日凌晨4点，Claude Code 的源代码被意外泄露，整个开发者社区炸开了锅。
作者 Sigrid Jin 在韩国女友担心他可能面临 Anthropic 法律诉讼的压力下，做了任何工程师都会做的事——
坐下来，从零开始用 Python 重写了整个核心，并在日出前将代码推送到 GitHub。

整个移植过程使用了 oh-my-codex (OmX) 工作流编排，利用 $team 模式进行并行代码审查，
以及 $ralph 模式进行持久执行循环和架构级验证。