# claw-code **Repository Path**: kimi_3/claw-code ## Basic Information - **Project Name**: claw-code - **Description**: claw-code (Claude Code) - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 19 - **Created**: 2026-04-02 - **Last Updated**: 2026-04-02 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Claw Code 重写项目

⭐ 历史上最快突破 5 万星标的仓库，发布后仅 2 小时即达成里程碑 ⭐

Star History Chart

Claw

更好的工具驾驭系统，不仅仅是泄露代码的存档

GitHub 赞助

> [!IMPORTANT] > **Rust 移植版本正在进行中**，位于 [`dev/rust`](https://github.com/instructkr/claw-code/tree/dev/rust) 分支，预计今日合并到主分支。Rust 实现旨在提供更快、内存更安全的运行时。敬请期待 —— 这将是项目的最终版本。 > 如果你觉得这个作品有用，可以考虑 [在 GitHub 上赞助 @instructkr](https://github.com/sponsors/instructkr) 以支持持续的开源工具工程研究。 --- ## 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 构建： ```bash cd rust cargo build --release ``` ## 背景故事 2026 年 3 月 31 日凌晨 4 点，我被手机通知轰炸醒了。Claw Code 源码被曝光了，整个开发者社区都陷入了疯狂。我在韩国的女朋友真心担心我可能因为机器上有这份代码而面临原作者的法律诉讼 —— 所以我在压力下做了任何工程师都会做的事：我坐下来，从头将核心功能移植到 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` 模式进行具有架构师级验证的持久执行循环。整个移植会话 —— 从阅读原始工具结构到生成带有测试的可工作的 Python 代码树 —— 都是通过 OmX 编排驱动的。 结果是一个清洁室的 Python 重写版本，捕捉了 Claw Code 代理工具的架构模式，而没有复制任何专有源码。我现在正积极与 OmX 的创建者 [@bellman_ych](https://x.com/bellman_ych) 合作，进一步推进这项工作。基本的 Python 基础已经到位并且可以正常工作，但我们才刚刚开始。**敬请期待 —— 更强大的版本即将推出。** Rust 移植版本同时使用 [oh-my-codex (OmX)](https://github.com/Yeachan-Heo/oh-my-codex) 和 [oh-my-opencode (OmO)](https://github.com/code-yeongyu/oh-my-openagent) 开发：OmX 驱动脚手架、编排和架构方向，而 OmO 用于后期实现加速和验证支持。 https://github.com/instructkr/claw-code ![推文截图](assets/tweet-screenshot.png) ## 被《华尔街日报》报道的创作者 —— 献给热心的 Claw Code 粉丝 我一直对 **工具工程（harness engineering）** 深感兴趣 —— 研究代理系统如何连接工具、编排任务和管理运行时上下文。这不是一时兴起。《华尔街日报》本月早些时候报道了我的工作，记录了我一直是探索这些系统的最活跃用户之一： > AI 创业公司员工 Sigrid Jin 参加了首尔晚宴，去年仅他一人就使用了 250 亿个 Claw Code token。当时使用限制较为宽松，让早期爱好者能够以很低的成本达到数百亿 token。 > > 尽管 Jin 在 Claw Code 上花费了无数时间，但他并不忠于任何一家 AI 实验室。他说，可用的工具各有优缺点。Codex 更擅长推理，而 Claw Code 生成的代码更清晰、更易于分享。 > > Jin 在二月份飞往旧金山参加 Claw Code 的一周年派对，与会者排队等候与 Cherny 交流心得。人群中有来自比利利的执业心脏病专家，他开发了一个帮助患者就医的应用，还有一位加州律师，他制作了一个使用 Claw Code 自动化建筑许可审批的工具。 > > "这基本上就像一个分享派对，" Jin 说。"有律师、医生、牙医。他们没有软件工程背景。" > > — *《华尔街日报》*，2026 年 3 月 21 日，[*"万亿美元竞赛：让我们的生活完全自动化"*](https://lnkd.in/gs9td3qd) ![WSJ 报道](assets/wsj-feature.png) --- ## 移植状态 主源代码树现在以 Python 优先。 - `src/` 包含活动的 Python 移植工作区 - `tests/` 验证当前的 Python 工作区 - 暴露的存档快照不再是跟踪的仓库状态的一部分 当前的 Python 工作区尚未完全替代原始的 TypeScript 系统，但主要的实现表面现在是 Python。 ## 为什么存在这个重写版本 我最初研究暴露的代码库是为了理解其工具系统、工具连接和代理工作流。在花了更多时间思考法律和伦理问题后 —— 在阅读了下面链接的文章后 —— 我不希望暴露的存档快照本身仍然是主要的跟踪源代码树。 这个仓库现在专注于 Python 移植工作。 ## 仓库结构 ```text . ├── 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`** — 子系统、模块和待办状态的 dataclass - **`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 ``` ## 当前对 parity 检查点 移植版本现在比以前更接近地镜像了存档的根入口文件表面、顶级子系统名称以及命令/工具清单。然而，它**尚未**完全替代原始的 TypeScript 系统；Python 树仍然包含比存档源更少的可执行运行时片段。 ## 使用 `oh-my-codex` 和 `oh-my-opencode` 构建 这个仓库的移植、清洁室强化和验证工作流由 Yeachan Heo 的工具栈 AI 辅助完成，其中 **oh-my-codex (OmX)** 是主要的脚手架和编排层。 - [**oh-my-codex (OmX)**](https://github.com/Yeachan-Heo/oh-my-codex) — 脚手架、编排、架构方向和核心移植工作流 - [**oh-my-opencode (OmO)**](https://github.com/code-yeongyu/oh-my-openagent) — 实现加速、清理和验证支持 移植期间使用的关键工作流模式： - **`$team` 模式：** 协调并行审查和架构反馈 - **`$ralph` 模式：** 持久执行、验证和完成纪律 - **清洁室通过：** 跨 Rust 工作区的命名/品牌清理、QA 和发布验证 - **手动和实时验证：** 在发布前进行构建、测试、手动 QA 和真实 API 路径验证 ### OmX 工作流截图 ![OmX 工作流截图 1](assets/omx/omx-readme-review-1.png) *在终端窗格中审查 README 和文章上下文时的 Ralph/team 编排视图。* ![OmX 工作流截图 2](assets/omx/omx-readme-review-2.png) *最终 README 措辞通过期间的分离窗格审查和验证流程。* ## 社区

instructkr

加入 [**instructkr Discord**](https://instruct.kr/) —— 最好的韩语语言模型社区。来聊聊 LLM、工具工程、代理工作流以及介于两者之间的一切。 [![Discord](https://img.shields.io/badge/Join%20Discord-instruct.kr-5865F2?logo=discord&style=for-the-badge)](https://instruct.kr/) ## Star 历史 参见本 README 顶部的图表。 ## 所有权 / 隶属关系免责声明 - 本仓库**不**声明对原始 Claw Code 源材料的所有权。 - 本仓库**不隶属于**、**不受**原始作者认可或维护。