claw-code

claw-code – 开源的 Claude Code 源码重写项目

Claw-code 是一款备受瞩目的开源项目，它的诞生源于对 Claude Code 源码泄露的回应。该项目秉持“净室重写”（Clean-room Rewrite）的理念，旨在打造一个在法律上完全且功能强大的 Agent 开发框架。为了规避潜在的法律风险，项目作者巧妙地利用 OpenAI Codex 的 OmX 工作流进行编排，仅用数小时便成功将核心架构从 TypeScript 移植到了 Python。

Claw-code 的出现，为开发者提供了一个保留了原始 Agent 工作流和工具编排能力的开源替代方案。目前，该项目正积极推进向 Rust 的移植，以期实现更卓越的运行时效率。项目始终将“Better Harness Tools”（更优的工具链）作为核心追求，致力于构建一个真正实用、可扩展的开源 Agent 开发生态。

Claw-code 的核心功能亮点

Agent 工作流的精妙编排：项目精心设计了 Agent 系统的核心架构，负责无缝衔接工具、调度任务以及管理运行时上下文。
模块化的工具系统：提供了一个灵活的工具框架，能够管理工具的调用链，并清晰定义工具的端口元数据。
强大的命令管理体系：封装了各类开发操作，形成一套模块化的命令集，并支持对命令端口元数据进行管理。
高效的任务调度机制：构建了一个能够支持异步处理和执行循环的任务状态管理与调度系统。
智能的查询引擎：具备强大的代码理解、上下文检索和代码库分析能力，能够高效处理各类查询请求。
便捷的 CLI 交互接口：提供了一个命令行入口，方便用户查看移植摘要、工作区清单以及进行交互式操作。
持久化的运行时上下文管理：维护着对话历史和执行状态，实现可靠的上下文信息持久化管理。
自动化代码生成能力：借助人工智能技术，实现代码的理解、生成与重构，赋能自动化开发。

如何上手 Claw-code

环境准备工作：请确保您的本地已安装 Python 3 环境。将项目仓库克隆至本地后，进入项目根目录即可。
概览信息查看：执行主模块命令，您将能够清晰地了解当前 Python 移植工作的摘要信息，以及详尽的工作区结构清单。
模块探索与发现：通过相应的命令，您可以轻松列出系统中的子模块、可用的命令接口以及支持的工具列表。
运行测试以验证：执行测试发现命令，运行验证测试套件，确保移植后的代码功能正确无误。
对比审计确保一致性：如果您拥有原始代码存档，可以运行一致性审计检查，以评估移植版本与原始代码在功能上的对齐程度。

Claw-code 的关键信息与使用要求

项目性质界定：Claw-code 是在 Claude Code 源码泄露后，通过“净室重写”方式开发的开源项目，并非官方存档。
技术栈演进：目前主要以 Python 实现（位于 src/ 目录），Rust 版本（位于 dev/rust 分支）即将整合，旨在追求更高的内存安全性和运行性能。
核心定位聚焦：该项目定位于 Agent 开发框架，提供了一整套强大的 Harness 能力，包括工作流编排、工具系统、命令管理和任务调度等。
开发模式创新：整个开发过程均采用 oh-my-codex (OmX) AI 工作流进行编排，并辅以 team 模式的并行审查和 ralph 模式的持久验证。
当前项目状态：基础的 Python 框架已投入使用，但尚未完全实现与原始 TypeScript 系统在运行时上的等价。Rust 版本将是项目的最终形态。
环境部署需求：需要安装 Python 3 环境。克隆仓库后即可开始使用。

Claw-code 的突出优势

法律合规的安全性：项目采用“净室重写”的开发模式，从零开始构建，彻底消除了因使用泄露源码而可能引发的版权侵权及法律诉讼风险。
开源带来的度：作为一个完全开源的项目，它打破了商业软件的束缚，开发者可以地修改、扩展和深度定制 Agent 工作流及工具链。
技术栈的前瞻性：项目正积极向 Rust 语言迁移，相较于原始的 TypeScript 实现，将带来显著的内存安全、运行时性能和系统级稳定性提升。
AI 原生开发范式：全程采用 oh-my-codex AI 工作流编排开发，预示着未来 AI 辅助编程的工程模式和自动化构建能力的巨大潜力。
功能上的完整性保障：项目完整保留了 Claude Code 的核心 Harness 能力，包括 Agent 工作流编排、工具系统、命令管理和任务调度等关键功能。

Claw-code 的项目地址

GitHub 仓库：https://github.com/instructkr/claw-code

Claw-code 与同类竞品的对比分析

对比维度	Claw-code	Claude Code	Aider
核心定位	经过净室重写的 Claude Code 开源替代框架，提供完整的 Agent Harness 工作流编排能力	Anthropic 官方闭源 AI 编程 Agent，提供端到端的代码生成与任务执行	开源终端 AI 结对编程助手，专注于代码编辑与 Git 集成
开源协议	完全开源（GitHub 公开仓库），支持修改、二次开发与私有化部署	闭源商业软件，仅限官方客户端或 API 使用，无源码可定制	开源（GitHub 公开仓库），支持多模型配置与终端集成
法律合规性	采用净室重写（Clean-room）从零实现，彻底规避源码泄露导致的版权侵权与法律诉讼风险	源码曾发生泄露，使用泄露代码存在潜在法律风险与合规争议	开发的开源项目，无版权争议，合规安全
技术架构	当前 Python 实现，正移植至 Rust 追求内存安全与高性能，提供模块化 Harness 运行时	基于 TypeScript 构建的官方实现，架构封闭无法自主优化或本地深度部署	基于 Python 的终端工具，通过编辑器集成实现代码修改，缺乏系统性 Agent 运行时
工作流能力	提供完整的 Harness 工作流编排、工具系统、命令管理与任务调度，支持复杂多步骤自动化	提供端到端 Agent 能力，但仅限于官方预设功能，无法自定义工作流编排逻辑	支持对话式代码编辑与 Git 提交，但缺乏多工具链编排与复杂任务调度能力
上下文管理	支持持久化执行循环与长期上下文维护，适合处理跨会话的大型项目理解与重构	具备强大的上下文窗口管理，但受限于商业服务的会话与速率限制	基于当前会话的上下文，难以维护长期执行状态与复杂项目级记忆
工具链集成	模块化设计支持深度定制工具调用链，可集成任意第三方开发工具与内部系统	封闭生态，仅支持官方集成的工具，无法扩展企业私有工具链	主要集成 Git 与编辑器，工具链扩展性有限

Claw-code 的应用场景展望

AI 辅助编程的革新：作为 Claude Code 的开源替代品，它能够提供代码自动生成、补全、重构以及错误修复等智能编程助手功能。
代码库的深度智能分析：借助其强大的查询引擎，能够深入理解大型代码库的结构，实现跨文件的语义检索、架构分析及文档的自动化生成。
自动化工作流的精细编排：通过 Harness 系统，可以编排复杂的、多步骤的开发任务，例如自动化构建、部署流水线以及持续集成脚本的管理。
工具链的灵活集成与扩展：作为一个模块化的 Agent 框架，它能够集成各种开发工具（如 Git、测试框架、Linter），实现统一的命令调度和工具调用。
代码迁移与重构的利器：支持大规模代码库的自动化重构、语言移植（例如将 Python 代码转换为 Rust）以及架构的现代化改造。