Claw Code Harness 是对 Claude Code 智能体框架(agent harness)的净室重写项目,主体采用 Python 实现,Rust 移植版本仍在开发中。它提供一套命令行工具与可导入的 Python 模块,用于检查移植清单、枚举子系统、对照归档源码进行一致性审计,以及查询工具与命令清单。
用途 该项目面向需要了解或跟踪 Claude Code 框架移植进度的开发者与 AI 智能体工作流。它把移植状态(哪些子系统、模块、工具、命令已完成移植)以结构化数据的形式暴露出来,便于程序化查询、生成摘要产物或与历史检查点做差异对比。
主要能力
- 命令行入口:通过 python3 -m src.main <command> 调用,支持 summary(渲染完整移植摘要)、manifest(打印当前 Python 工作区清单,含文件面与子系统名称)、subsystems(列出已知子系统,可加 --limit)、commands(查看镜像命令清单,可加 --limit)、tools(查看镜像工具清单,可加 --limit)、parity-audit(对照本地存在的归档快照运行一致性审计,该快照被 gitignore,需位于预期路径)。
- 可导入模块:src/models.py 提供 Subsystem、Module、BacklogState 等数据类;src/tools.py 提供 get_tools、ToolMeta;src/commands.py 提供 get_commands、CommandMeta;src/query_engine.py 提供 render_summary;src/port_manifest.py 提供 get_manifest、ManifestEntry。
- 常见用法模式:统计已移植工具数量、查找未移植子系统、构建程序化摘要流水线、贡献前运行测试、作为 OmX/智能体工作流的一部分生成摘要产物并做差异对比。
使用方式 安装:克隆仓库 git clone https://github.com/instructkr/claw-code.git,进入目录 cd claw-code,按需安装依赖 pip install -r requirements.txt(若存在;核心仅用标准库,无外部依赖)。验证工作区:python3 -m unittest discover -s tests -v。目前没有 PyPI 包,需从源码直接使用。 Rust 移植:位于 dev/rust 分支,切换方式为 git fetch origin dev/rust 与 git checkout dev/rust,构建需 Rust 工具链(https://rustup.rs),使用 cargo build 构建、cargo run -- summary 运行。该移植尚未合并到主分支,在此之前所有生产工作流应使用 Python 实现。
适用场景
- 跟踪 Claude Code 框架的 Python 移植进度与一致性。
- 在智能体工作流中生成移植摘要产物,供其他工具消费或与历史检查点做 diff。
- 在沙箱环境中运行(核心模块无外部运行时依赖)。
限制
- 尚无 PyPI 包,只能从源码使用。
- parity-audit 需要本地存在归档快照(不在 git 跟踪范围内),否则会以“archive not found”退出。
- Rust 移植仍在进行中,未合并到主分支,暂不适用于生产工作流。
- 项目与 Anthropic 无关联,不包含 Claude Code 专有源码。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。