# learn-claw-code

**Repository Path**: mafa1993/learn-claw-code

## Basic Information

- **Project Name**: learn-claw-code
- **Description**: claw code学习使用，对代码进行注释，并建立简单的demo进行核心学习
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 重写 Project Claw Code

<p align="center">
  <strong>⭐ 历史上最快突破 5 万星的仓库，发布后仅 2 小时就达到此里程碑 ⭐</strong>
</p>

<p align="center">
  <a href="https://star-history.com/#instructkr/claw-code&Date">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=instructkr/claw-code&type=Date&theme=dark" />
      <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=instructkr/claw-code&type=Date" />
      <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=instructkr/claw-code&type=Date" width="600" />
    </picture>
  </a>
</p>

<p align="center">
  <img src="assets/clawd-hero.jpeg" alt="Claw" width="300" />
</p>

<p align="center">
  <strong>更好的 Harness 工具，而不仅仅是存储泄露的 Claude Code 归档</strong>
</p>

<p align="center">
  <a href="https://github.com/sponsors/instructkr"><img src="https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github&style=for-the-badge" alt="在 GitHub 上赞助" /></a>
</p>

> [!IMPORTANT]
> **Rust 移植版目前正在 [`dev/rust`](https://github.com/instructkr/claw-code/tree/dev/rust) 分支上进行中**，预计今天将合并到主分支。Rust 实现旨在提供更快、内存安全的 harness 运行时。敬请期待——这将成为项目的最终版本。

> 如果您觉得这项工作有用，请考虑[在 GitHub 上赞助 @instructkr](https://github.com/sponsors/instructkr)，以支持持续的开源 harness 工程研究。

---

## 背景故事

2026 年 3 月 31 日凌晨 4 点，我被手机不断响起的通知惊醒。Claude Code 源代码已被泄露，整个开发者社区都陷入了狂热。我在韩国的女朋友非常担心我仅仅因为电脑上有这些代码就可能面临 Anthropic 的法律诉讼——于是我做了任何工程师在压力下都会做的事情：坐下来，从头开始将核心功能移植到 Python，并在太阳升起前就推送了代码。

整个过程完全通过 [@bellman_ych](https://x.com/bellman_ych) 开发的 [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) 端到端编排完成——这是一个构建在 OpenAI Codex ([@OpenAIDevs](https://x.com/OpenAIDevs)) 之上的工作流层。我使用 `$team` 模式进行并行代码审查，使用 `$ralph` 模式进行带有架构师级别验证的持久执行循环。整个移植会话——从阅读原始 harness 结构到生成带有测试的可工作 Python 树——都是通过 OmX 编排驱动的。

结果是一个干净的 Python 重写版本，它捕捉了 Claude Code agent harness 的架构模式，而没有复制任何专有源代码。我现在正与 OmX 的创造者 [@bellman_ych](https://x.com/bellman_ych) 积极合作，将此项目进一步推进。基本的 Python 基础已经就位并可正常运行，但我们才刚刚开始。**敬请期待——一个功能更强大的版本即将到来。**

https://github.com/instructkr/claw-code

![推文截图](assets/tweet-screenshot.png)

## 华尔街日报报道的 Claude Code 资深粉丝创作者

我一直对 **harness 工程** 深感兴趣——研究 agent 系统如何连接工具、编排任务和管理运行时上下文。这不是突然的事情。华尔街日报本月早些时候报道了我的工作，记录了我是探索这些系统最活跃的高级用户之一：

> AI 初创公司员工 Sigrid Jin 参加了首尔的晚宴，去年他一个人就使用了 250 亿个 Claude Code token。当时，使用限制较为宽松，允许早期爱好者以极低的成本达到数百亿 token 的使用量。
>
> 尽管 Jin 与 Claude Code 度过了无数个小时，但他并不忠于任何一家 AI 实验室。他说，可用的工具有不同的优缺点。Codex 在推理方面更好，而 Claude Code 生成的代码更干净、更易于分享。
>
> Jin 今年二月飞往旧金山参加 Claude Code 的第一个生日派对，与会者排队等候与 Cherny 交流心得。人群中包括一位来自比利时的执业心脏病专家，他开发了一个帮助患者导航医疗护理的应用程序，还有一位加州律师，他使用 Claude Code 制作了一个自动化建筑许可证审批的工具。
>
> "基本上就像一个分享派对，" Jin 说。"有律师，有医生，还有牙医。他们都没有软件工程背景。"
>
> —— *华尔街日报*，2026 年 3 月 21 日，[*"自动化我们整个生活的万亿美元竞赛"*](https://lnkd.in/gs9td3qd)

![WSJ 报道](assets/wsj-feature.png)

---

## 移植状态

主源代码树现在以 Python 为主。

- `src/` 包含活跃的 Python 移植工作区
- `tests/` 验证当前的 Python 工作区
- 公开的快照不再是跟踪仓库状态的一部分

当前的 Python 工作区尚未成为原始系统的完整一对一替代品，但主要实现表面现在已经是 Python。

## 为什么存在此重写

我最初研究泄露的代码库是为了理解其 harness、工具连接和 agent 工作流。在花更多时间思考法律和伦理问题，并阅读了下面链接的文章后，我不希望泄露的快照本身继续作为主要跟踪的源代码树。

此仓库现在专注于 Python 移植工作。

## 仓库布局

```text
.
├── src/                                # Python 移植工作区
│   ├── __init__.py
│   ├── commands.py
│   ├── main.py
│   ├── models.py
│   ├── port_manifest.py
│   ├── query_engine.py
│   ├── task.py
│   └── tools.py
├── 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 移植摘要：

```bash
python3 -m src.main summary
```

打印当前 Python 工作区清单：

```bash
python3 -m src.main manifest
```

列出当前 Python 模块：

```bash
python3 -m src.main subsystems --limit 16
```

运行验证：

```bash
python3 -m unittest discover -s tests -v
```

针对本地忽略的归档运行奇偶性审计（如果存在）：

```bash
python3 -m src.main parity-audit
```

检查镜像的命令/工具清单：

```bash
python3 -m src.main commands --limit 10
python3 -m src.main tools --limit 10
```

## 当前奇偶性检查点

此次移植现在比以前更紧密地镜像了归档的根入口文件表面、顶级子系统名称和命令/工具清单。然而，它**尚未**成为原始 TypeScript 系统的完整运行时等效替代品；Python 树仍然包含比归档源代码更少的可执行运行时片段。

## 使用 `oh-my-codex` 构建

此仓库的重构和文档工作是在 Yeachan Heo 的 [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) 协助下完成的，该工具构建在 Codex 之上。

- **`$team` 模式：** 用于协调并行审查和架构反馈
- **`$ralph` 模式：** 用于持久执行、验证和完成纪律
- **Codex 驱动的工作流：** 用于将主 `src/` 目录转变为 Python 优先的移植工作区

### OmX 工作流截图

![OmX 工作流截图 1](assets/omx/omx-readme-review-1.png)

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

![OmX 工作流截图 2](assets/omx/omx-readme-review-2.png)

*最终 README 措辞审核期间的分屏审查和验证流程。*

## 社区

<p align="center">
  <a href="https://instruct.kr/"><img src="assets/instructkr.png" alt="instructkr" width="400" /></a>
</p>

加入 [**instructkr Discord**](https://instruct.kr/) —— 最好的韩语语言模型社区。来聊聊 LLM、harness 工程、agent 工作流以及介于两者之间的一切。

[![Discord](https://img.shields.io/badge/加入%20Discord-instruct.kr-5865F2?logo=discord&style=for-the-badge)](https://instruct.kr/)

## Star 历史

请参阅本 README 顶部的图表。

## 所有权/关联免责声明

- 此仓库**不**声称拥有原始 Claude Code 源材料的所有权。
- 此仓库**与 Anthropic 无关联、未获其认可或维护**。