Claw Code：Rust 版 claw 智能体 CLI

项目简介

Claw Code 是 claw CLI agent harness 的公开 Rust 实现，规范实现位于 rust/ 目录，本仓库（ultraworkers/claw-code）是当前 source of truth。

仓库自述更接近一件「博物馆展品」而非产品：它由 Gajae-Code / LazyCodex 等 harness 规划、执行、验证、标注和维护，强调无人干预的开发方式。作者明确说明这不是严肃的生产项目——想真正跑活，建议先用 LazyCodex 或 Gajae-Code，Claw Code 更像留存下来的那块化石。

主要功能

• claw 命令行智能体：直接运行进入交互式会话，或用 claw prompt 提交单次提问。
• claw doctor 健康检查：校验 API Key、模型访问和工具配置，构建后建议第一时间运行。
• claw status、claw config env、claw help 等状态与配置查看命令。
• 仓库结构：rust/ 为规范的 Rust workspace 与 claw 二进制；USAGE.md 是按任务组织的使用指南；PARITY.md 记录 Rust 移植进度；ROADMAP.md、PHILOSOPHY.md 说明规划与设计理念；src/ 与 tests/ 是配套的 Python 参考工作区，并非主要运行时。
• ACP / Zed：目前不提供 ACP/Zed daemon 或 JSON-RPC 入口，claw acp（或 claw --acp）只返回当前状态，claw acp serve 仅是便于发现的别名。

安装与使用

本仓库仅支持从源码构建（build-from-source only）：

git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace

设置 Anthropic API Key（需要 Anthropic API key，不是 Claude 订阅）：

export ANTHROPIC_API_KEY="sk-ant-..."

构建后运行：

./target/debug/claw doctor
./target/debug/claw prompt "say hello"
./target/debug/claw

Windows（PowerShell）下二进制名为 claw.exe：

$env:ANTHROPIC_API_KEY = "sk-ant-..."
.\target\debug\claw.exe prompt "say hello"

构建产物不会自动安装到系统：debug 构建位于 rust/target/debug/claw（Windows 为 claw.exe），release 构建位于 rust/target/release/。想在任意目录直接运行 claw，可以创建软链接，或进入 claw-code/rust/ 执行 cargo install --path . --force 安装到 ~/.cargo/bin/。

注意事项

• 不要运行 cargo install claw-code：crates.io 上的 claw-code 是已弃用的 stub，装出来的是 claw-code-deprecated.exe，运行只会打印 claw-code has been renamed to agent-code。
• 上游二进制为 cargo install agent-code，安装出的可执行文件是 agent.exe（Windows）/ agent（Unix），而不是 agent-code。
• Windows 用户需先从 https://rustup.rs/ 安装 Rust 并重新打开终端，用 cargo --version 确认已在 PATH 中；PowerShell、Git Bash、WSL 均可作为终端。
• 更多细节见 USAGE.md、docs/windows-install-release.md、docs/local-openai-compatible-providers.md、docs/container.md 等文档。

本作品整理自 GitHub 开源项目 ultraworkers/claw-code，原作者 @ultraworkers，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。