# ultraworkers/claw-code

## 📖 项目介绍

# Claw Code

### start with the real crab-powered harnesses

[**github.com/code-yeongyu/lazycodex**](https://github.com/code-yeongyu/lazycodex)
[**github.com/Yeachan-Heo/gajae-code**](https://github.com/Yeachan-Heo/gajae-code)

Join the Discords:

[**ultraworkers discord**](https://discord.gg/GtjhvgjnV)

> Claw Code is not the serious production project here.
> This repository is closer to a museum exhibit than a product pitch, a crustacean-run artifact kept alive by clawed gajaes.

If you want to actually run work, start with **[LazyCodex](https://github.com/code-yeongyu/lazycodex)** or  **[Gajae-Code](https://github.com/Yeachan-Heo/gajae-code)**.

## Current repository shape

- **`rust/`** — canonical Rust workspace and the `claw` CLI binary
- **`USAGE.md`** — task-oriented usage guide for the current product surface
- **`PARITY.md`** — Rust-port parity status and migration notes
- **`ROADMAP.md`** — active roadmap and cleanup backlog
- **`PHILOSOPHY.md`** — project intent and system-design framing
- **`src/` + `tests/`** — companion Python/reference workspace and audit helpers; not the primary runtime surface

## Quick start

> **`cargo install claw-code` installs the wrong thing.**

```bash
> cargo install agent-code   # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code'
```

### Windows setup

1. **Install Rust first** — download from the official Rust site and run the installer.
2. **Verify Rust is on PATH:**

```powershell
   cargo --version
```

3. **Clone and build:**

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

4. **Run:**

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

## Post-build: locate the binary and verify

After `cargo build --workspace`, the `claw` binary is built but **not** automatically installed to your system. 
### Binary location

**Debug build:**
- **macOS/Linux:** `rust/target/debug/claw`
- **Windows:** `rust/target/debug/claw.exe`

### Verify the build succeeded

Test the binary directly:

```bash
macOS/Linux (debug build)
./rust/target/debug/claw --help
```

### Troubleshooting
- **"command not found: claw"** — The binary is in `rust/target/debug/claw`, but it's not on your PATH. Use the full path `./rust/target/debug/claw`.

---

## Documentation map

- [`USAGE.md`](/content/projects/USAGE.md) — quick commands, auth, sessions, config, parity harness
- [`docs/navigation-file-context.md`](/content/projects/docs/navigation-file-context.md) — terminal navigation and scrollback guidance
- [`rust/README.md`](/content/projects/rust/README.md) — crate map, CLI surface, features, workspace layout
- [`PARITY.md`](/content/projects/PARITY.md) — parity status for the Rust port
- [`ROADMAP.md`](/content/projects/ROADMAP.md) — active roadmap and open cleanup work
- [`LICENSE`](/content/projects/LICENSE/index.html) — MIT license for this repository

## Ecosystem

Claw Code is built in the open alongside the broader UltraWorkers toolchain:
- [clawhip](https://github.com/Yeachan-Heo/clawhip)

### 🔗 项目信息

**创建时间:** 2026/3/31  
**最后更新:** 2026/6/15  
**开源协议:** MIT License  
**项目大小:** 24.1k KB

### 📊 项目统计

⭐ 星标: 193.8k  
🍴 分支: 110.0k  
👀 关注者: 193.8k  
📝 议题: 8

[🌟 访问GitHub仓库](https://github.com/ultraworkers/claw-code)