---
type: entity
title: ultraworkers/claw-code
created: 2026-05-07
updated: 2026-05-07
tags: [claw-code, rust, ultraworkers, opencode, coding-agent, cli]
---

## 基本信息

- **类型**：AI Coding Agent Runtime / CLI 工具
- **源码**：https://github.com/ultraworkers/claw-code
- **语言**：Rust
- **里程碑**：史上最快突破 100K stars 的开源项目
- **Discord**：https://discord.gg/5TUQKqFWd

## 核心定位

claw-code 是 `claw` CLI agent harness 的公开 Rust 实现，为 AI Coding Agent 提供生产级运行环境。支持 Anthropic API（Claude）、OpenAI API 等多模型平台。

## 快速开始

```bash
# 1. 克隆并构建
git clone https://github.com/ultraworkers/claw-code
cd claw-code/rust
cargo build --workspace

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

# 3. 验证
./target/debug/claw doctor

# 4. 运行
./target/debug/claw prompt "say hello"
```

## 重要安装警告

**不要用 `cargo install claw-code`！** crates.io 上的 `claw-code` 包是废弃桩，装的是 `claw-code-deprecated.exe`，运行只打印 `"claw-code has been renamed to agent-code"`。

正确方式：
- 从源码构建（上方步骤）
- 或 `cargo install agent-code`（上游二进制，安装的是 `agent`/`agent.exe`）

## 文档结构

| 文件 | 用途 |
|------|------|
| `USAGE.md` | 任务导向用法、认证、会话、配置 |
| `rust/README.md` | Crate 地图、CLI 表面、功能、workspace 布局 |
| `PARITY.md` | Rust 迁移的 parity 状态 |
| `ROADMAP.md` | 路线图和待清理项 |
| `docs/container.md` | 容器优先工作流 |

## 相关概念

- [[wiki/concepts/claw-code|claw-code]]
- [[wiki/concepts/agent-skills|Agent Skills]]

## 参考来源

- [[wiki/library/ultraworkersclaw-code|ultraworkers/claw-code（library）]]