CLI Claw-Code 用Rust构建的开源AI编程智能体

很多开发者想要一个完全属于自己的编程 agent：开源、能本地跑、可以自选模型，并且清楚它到底改了什么文件、跑了哪些命令。闭源方案往往把这些藏起来。claw-code 就是 claw CLI 智能体 harness 的公开 Rust 实现，核心目标是让这个 agent 能被你在本机读源码、审逻辑、自己构建运行。

项目基本信息

一、项目介绍

ultraworkers/claw-code 是 claw CLI 智能体 harness 的公开 Rust 实现，核心代码在 rust/ 工作区，二进制名为 claw。它支持 Anthropic API（注意不是 Claude 订阅），提供 doctor 健康检查、prompt 单次调用与交互式 session；Windows 下二进制是 claw.exe。README 明确提示：不要使用 cargo install claw-code（那是已废弃、重命名为 agent-code 的桩），本仓库只能从源码构建。项目以 MIT 协议开源。

二、核心优势

1. 完全开源：Rust 工作区源码可读可审计，二进制 claw 由你本机构建。
2. 本地优先：API Key 在你机器上，会话与文件不出本机。
3. 健康检查：claw doctor 一键校验环境、Key 与 provider 配置。
4. 双模式：claw prompt 跑单条任务，claw 进入交互会话。
5. 跨平台：Windows（PowerShell）/ macOS / Linux 一致体验，Rust 单二进制。

三、适用场景

• 想用开源、可审计的终端编程 agent 替代闭源方案。
• 希望在本地用 Anthropic API 驱动 agent，数据不出机。
• 需要事后排查 agent 环境（Key/provider）配置的开发者。
• 研究 Rust 实现的 agent harness 架构。

四、安装教程

macOS / Linux 从源码构建：

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

设置密钥并自检：

export ANTHROPIC_API_KEY="sk-ant-..."
./target/debug/claw doctor

Windows（PowerShell，注意 .exe）：

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

常见报错：务必用 cargo build --workspace 从本仓库构建，不要 cargo install claw-code（那是已重命名废弃桩，只会打印提示）；Windows 上直接用 claw.exe 而非 claw。

五、使用示例

跑单条任务：

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

进入交互会话：

./target/debug/claw

真实效果：doctor 通过后会列出环境状态；prompt 把任务交给 claw，它会调用工具读写文件、跑命令，直到完成或请你确认——全程在本地 Rust 进程内运行。

六、常见问题

Q：cargo install claw-code 能用吗？
A：不能。那是已废弃的桩，应改为从本仓库源码 cargo build --workspace，或安装上游 agent-code。
Q：必须用 Anthropic 订阅吗？
A：不需要订阅，配置 Anthropic API Key（sk-ant-...）即可，也支持本地 OpenAI 兼容模型。
Q：Windows 上为什么命令报错？
A：Windows 二进制是 claw.exe，需写 .\target\debug\claw.exe；PowerShell 下记得用 $env: 设置 Key。

七、总结

claw-code 把“终端编程 agent”以 Rust 源码形式完全开放，让你能在本地构建、审计并运行。它明确拒绝用错的 crate、强调从源码构建，适合想要开源、可掌控编程 agent 的开发者；MIT 协议，跨平台。