Claw Code 使用教程

📖 项目简介

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
            

🚀 如何使用

克隆仓库

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

查看移植摘要

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

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

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

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

运行验证测试

                        bash
                        python3 -m unittest discover -s tests -v
                    

查看命令/工具清单

                        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 模式进行持久执行循环和架构级验证。

⚠️

声明：该仓库不声称拥有原始 Claude Code 源材料的所有权，也不隶属于 Anthropic、不受其认可或维护。

❓ 常见问题

Q: 这个项目和 Claude Code 是什么关系？

Claw Code 是 Claude Code 泄露源码的 clean-room 重写，不包含任何原始泄露代码。它重现了 Claude Code 的架构模式（harness 系统、工具编排、任务管理），但所有代码都是独立编写的。

Q: Rust 版本什么时候完成？

Rust 移植正在 dev/rust 分支上积极进行中，目标是提供更快、内存安全的 harness 运行时。具体发布时间请关注仓库动态。

Q: 这个项目有法律风险吗？

作者采用了 clean-room 重写方式，不包含原始泄露的代码。这是一种常见的合法逆向工程方法。仓库中还包含一篇关于 AI 重新实现与版权法的法律分析文章。