用途
claw-code 是 claw CLI 智能体框架的公开 Rust 实现，也是 Anthropic Claude Code 智能体框架（agent harness）的 Rust 重实现。项目现已更名为 agent-code。根据官方说明，该仓库由智能体自主开发与维护，没有人工干预，定位更接近“博物馆展品”而非严肃的生产项目；如果要在实际工作中运行任务，维护者建议使用 LazyCodex 或 Gajae-Code。
主要能力
- 提供 claw CLI 智能体框架的 Rust 实现，规范实现位于 rust/ 目录。
- 支持构建、认证、CLI、会话以及 parity-harness 工作流（见 USAGE.md）。
- 提供 claw doctor 健康检查，用于验证 API 密钥、模型访问和工具配置。
- 支持本地 OpenAI 兼容模型（如 Ollama、llama.cpp、vLLM）以及离线技能安装。
- 提供容器优先工作流（docs/container.md）。
- 提供 Windows 优先的 PowerShell 安装与发布快速入门。
- 关于 ACP / Zed 状态：claw-code 目前尚未提供 ACP/Zed 守护进程或 JSON-RPC 入口点；claw acp serve 目前仅为可发现性别名，返回状态并退出码为 0，真正的 ACP 支持仍在 ROADMAP.md 中单独跟踪。
使用方式
本仓库仅支持从源码构建。
Windows（PowerShell）安装步骤：
- 先安装 Rust：从 https://rustup.rs/ 下载并运行安装程序，完成后关闭并重新打开终端。
- 验证 Rust 已在 PATH 中：cargo --version。若失败，重新打开终端或按安装程序输出设置 PATH 后重试。
- 克隆并构建（PowerShell、Git Bash 或 WSL 均可）： git clone https://github.com/ultraworkers/claw-code cd claw-code/rust cargo build --workspace
- 运行（PowerShell，注意 .exe 和反斜杠）： $env:ANTHROPIC_API_KEY="sk-ant-..." .\target\debug\claw.exe prompt "say hello"
构建后二进制位置：
- 调试构建（默认，编译更快）：macOS/Linux 为 rust/target/debug/claw，Windows 为 rust/target/debug/claw.exe。
- 发布构建（优化，编译更慢）：macOS/Linux 为 rust/target/release/claw，Windows 为 rust/target/release/claw.exe。
可选：将 claw 加入 PATH，方式包括符号链接（macOS/Linux）、使用 cargo install（所有平台，安装到 ~/.cargo/bin/）或更新 shell 配置文件（bash/zsh）。
认证：claw 需要 API 密钥（ANTHROPIC_API_KEY、OPENAI_API_KEY 等），不支持 Claude 订阅登录作为认证路径。
适用场景
- 希望研究或检视 Claude Code 智能体框架 Rust 重实现的技术人员。
- 需要本地 OpenAI 兼容模型或离线技能安装的开发者。
- 对智能体自主维护项目形态感兴趣的观察者。
限制与注意事项
- 该项目由智能体自主维护，定位为展品而非生产产品，维护者建议生产使用 LazyCodex 或 Gajae-Code。
- cargo install claw-code 会安装错误内容：crates.io 上的 claw-code crate 是已弃用的存根，会放置 claw-code-deprecated.exe 而非 claw，运行只会打印“claw-code has been renamed to agent-code”。不要使用 cargo install claw-code。
- 本仓库仅支持从源码构建。
- Windows 上二进制名为 claw.exe 而非 claw。
- 不支持 Claude 订阅登录认证。
- 目前不提供 ACP/Zed 守护进程或 JSON-RPC 入口点。
- 本仓库不声称拥有原始 Claude Code 源代码材料的所有权，与 Anthropic 无关联、未获其背书或维护。
- 许可证为 MIT。
