claw-code是什么
claw-code 是Claude Code 源码泄露后推出的Clean-room Rewrite项目。作者为避免法律风险,使用 OpenAI Codex 的 OmX 工作流编排,仅用数小时将核心架构从 TypeScript 移植为 Python 实现。项目保留原始 Agent 工作流、工具编排能力的开源替代方案,目前正进一步移植至 Rust 提供更高效的运行时。项目强调”Better Harness Tools”,打造真正可用的开源 Agent 开发框架。

claw-code的主要功能
Agent 工作流编排:负责工具连接、任务编排与运行时上下文管理的 Agent 系统核心架构。
工具系统:提供工具调用链管理与工具端口元数据定义的模块化工具框架。
命令管理:封装各类开发操作的模块化命令体系与端口元数据管理。
任务调度:支持异步处理与执行循环的任务状态管理与调度系统。
查询引擎:支持代码理解、上下文检索与代码库分析的查询处理引擎。
CLI 交互接口:提供查看移植摘要、清单及交互式操作的命令行入口。
运行时上下文管理:维护对话历史与执行状态的持久化上下文管理系统。
代码自动化生成:基于 AI 实现代码理解、生成与重构的自动化开发能力。
如何使用claw-code
- 环境准备:需要确保本地已安装 Python 3 环境,将项目仓库克隆到本地后进入根目录。
- 查看概览:通过执行主模块命令可以查看当前 Python 移植工作的摘要信息以及完整的工作区结构清单。
- 探索模块:用相应命令可以列出系统子模块、可用的命令接口及支持的工具清单。
- 运行测试:执行测试发现命令运行验证测试套件,确保移植代码的正确性。
- 对比审计:当本地存在原始存档时,可运行一致性审计检查移植版本与原始代码的功能对齐程度。
claw-code的关键信息和使用要求
项目性质:Claude Code 源码泄露后的净室重写(Clean-room Rewrite),非官方存档。
技术栈:当前为 Python 实现(
src/目录),Rust 版本(dev/rust分支)即将合并,追求内存安全与高性能。核心定位:Agent 开发框架,提供工具编排、命令管理、任务调度、查询引擎等 Harness 能力。
开发方式:全程使用 oh-my-codex (OmX) AI 工作流编排, 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)与架构现代化改造。
