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）与架构现代化改造。