Claw Code：用 Rust 重写的开源版 Claude Code，4 天 18 万 star——墨涩网

2026 年 3 月 31 日，GitHub 上出现了一个仓库：ultraworkers/claw-code。4 天后，它积累了 18 万 star、10 万 fork，成为 GitHub 历史上最快突破 10 万 star 的仓库。它是什么？一句话：用 Rust 重写的开源版 Claude Code。

Claw Code 是什么？

Claw Code 是 ultraworkers 团队开源的 AI Agent 开发框架，采用 Rust 语言从零实现，是 Claude Code CLI 的"干净室重写"版本。它不是破解版，不是逆向工程，而是基于 Claude Code 公开文档和行为规范，独立实现的一套完整 AI 编程助手运行环境。

核心定位：为开发者提供一个生产级的 Rust CLI 运行环境，用于构建、运行和调试多工具调用的 AI Agent。MIT 许可证，完全开源，不存在厂商锁定。

为什么用 Rust 重写？

• 启动速度快：原生二进制，没有 Node.js 的冷启动延迟
• 内存占用低：Rust 没有 GC，长期运行不会内存泄漏
• 跨平台：macOS、Linux、Windows 全平台支持，单二进制分发
• 无运行时依赖：不需要装 Node.js、Python，一个二进制文件就能跑
• 适合嵌入和服务端：可以嵌入到更大的系统中，也适合服务器长期运行

核心功能

• 多后端兼容：支持 Anthropic（Claude）、OpenAI 等 API，可切换
• 会话管理：保存和恢复多轮对话上下文
• 多工具调用：支持 AI Agent 在一次对话中调用多个工具（文件读写、命令执行、搜索等）
• MCP 协议：通过 Model Context Protocol 连接外部工具和数据源
• 容器化部署：提供 Docker 标准化部署方案
• 健康检查：内置 claw doctor 命令验证环境配置
• Mock 测试框架：内置确定性 Mock 服务，方便开发和测试

安装教程

环境要求

• Rust（通过 rustup.rs 安装）
• Anthropic API Key（从 Anthropic Console 申请）

从源码构建

# 克隆仓库
git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust

# 构建
cargo build --workspace

# 设置 API Key
export ANTHROPIC_API_KEY="sk-ant-..."

# 健康检查
./target/debug/claw doctor

# 运行第一个 Prompt
./target/debug/claw prompt "say hello"

安装到系统 PATH

构建完成后二进制不会自动到 PATH，两种方式：

# 方式一：软链接
ln -s $(pwd)/rust/target/debug/claw /usr/local/bin/claw

# 方式二：cargo install
cargo install --path . --force

Windows 注意事项

Windows 下二进制名为 claw.exe，推荐使用 PowerShell。验证 Rust 安装：cargo --version

⚠️ 重要提示

不要执行 cargo install claw-code！ crates.io 上的 claw-code 是一个早已废弃的空壳包，只会打印 "claw-code has been renamed to agent-code"。正确做法是从 GitHub 源码构建，或安装上游二进制 cargo install agent-code。

项目结构

claw-code/
├── rust/              # Rust workspace + claw CLI 二进制（主实现）
├── src/ + tests/      # Python 参考工作区（非主运行时）
├── USAGE.md           # 任务导向的使用指南（推荐优先阅读）
├── PARITY.md          # Rust 移植进度与迁移说明
├── ROADMAP.md         # 路线图与待办事项
├── PHILOSOPHY.md      # 项目定位与设计哲学
└── docs/container.md  # 容器优先工作流文档

文档地图

• USAGE.md：CLI 命令详解、认证、会话、配置（新手必读）
• rust/README.md：crate 层级结构、CLI surface、特性列表
• PARITY.md：Rust 移植的当前进度与已知差异
• ROADMAP.md：ACP/Zed 支持等活跃功能规划

常见问题

claw doctor 报告 API Key 无效

确认使用的是 Anthropic API Key（ANTHROPIC_API_KEY），不是 Claude 网页版的登录 Session。API Key 需要在 Anthropic Console 申请。

构建速度太慢

默认 Debug 模式编译较快。追求运行时性能可用 Release 模式（编译约 5-10 分钟）：cargo build --workspace --release

claw 命令找不到

二进制不在 PATH 中。用完整路径运行，或创建软链接。

适用场景

• 本地 AI Agent 原型开发：Rust 实现带来优秀的启动速度和低内存占用
• 私有化部署：不依赖第三方云服务，API Key 自持
• 跨平台 CLI 工具链：macOS、Linux、Windows 全平台支持
• 调试和测试 AI 工具调用：内置健康检查和 Mock 测试框架
• 不想被厂商锁定：MIT 许可，完全开源，可自由修改

与 Claude Code 的关系

Claw Code 是 Claude Code 的"干净室重写"——基于公开文档独立实现，不是逆向工程。功能上对标 Claude Code CLI，但用 Rust 实现，带来更好的性能和跨平台体验。如果你喜欢 Claude Code 的工作方式但想要开源和本地化部署，Claw Code 是最佳选择。

总结

Claw Code 代表了开源 AI Agent 工具链的重要方向——用 Rust 实现生产级 CLI 运行环境，兼顾性能和跨平台能力。GitHub 19 万+ star 说明了社区对这个方向的认可。

如果你是 AI 应用开发者，建议从 claw doctor 开始验证环境，再结合 USAGE.md 深入探索会话管理和 MCP 集成能力。

项目地址：https://github.com/ultraworkers/claw-code

Discord 社区：https://discord.gg/5TUQKqFWd