To ensure that your submitted code identity is correctly recognized by Gitee, please execute the following command.

git config --global user.name userName git config --global user.email userEmail

When using the SSH protocol for the first time to clone or push code, follow the prompts below to complete the SSH configuration.

1 Generate RSA keys.

2 Obtain the content of the RSA public key and configure it in SSH Public Keys

To use SVN on Gitee, please visit the usage guide

When using the HTTPS protocol, the command line will prompt for account and password verification as follows. For security reasons, Gitee recommends configure and use personal access tokens instead of login passwords for cloning, pushing, and other operations.

Username for 'https://gitee.com': userName

Password for 'https://userName@gitee.com': # Private Token

New file Create Diagram file

.claude/sessions

.github

assets

docs

rust

src

tests

.claude.json

.claw.json

.gitignore

CLAUDE.md

Containerfile

PARITY.md

PHILOSOPHY.md

README.md

ROADMAP.md

USAGE.md

install.sh

prd.json

progress.txt

# Claw Code 中文 <p align="center"> <a href="https://github.com/ultraworkers/claw-code">ultraworkers/claw-code</a> · <a href="./USAGE.md">Usage</a> · <a href="./rust/README.md">Rust workspace</a> · <a href="./PARITY.md">Parity</a> · <a href="./ROADMAP.md">Roadmap</a> · <a href="https://discord.gg/5TUQKqFWd">UltraWorkers Discord</a> </p> <p align="center"> <a href="https://star-history.com/#ultraworkers/claw-code&Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date&theme=dark" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" /> <img alt="Star history for ultraworkers/claw-code" src="https://api.star-history.com/svg?repos=ultraworkers/claw-code&type=Date" width="600" /> </picture> </a> </p> <p align="center"> <img src="assets/claw-hero.jpeg" alt="Claw Code" width="300" /> </p> Claw Code is the public Rust implementation of the `claw` CLI agent harness. The canonical implementation lives in [`rust/`](./rust), and the current source of truth for this repository is **ultraworkers/claw-code**. > [!IMPORTANT] > Start with [`USAGE.md`](./USAGE.md) for build, auth, CLI, session, and parity-harness workflows. Make `claw doctor` your first health check after building, use [`rust/README.md`](./rust/README.md) for crate-level details, read [`PARITY.md`](./PARITY.md) for the current Rust-port checkpoint, and see [`docs/container.md`](./docs/container.md) for the container-first workflow. > > **ACP / Zed status:** `claw-code` does not ship an ACP/Zed daemon entrypoint yet. Run `claw acp` (or `claw --acp`) for the current status instead of guessing from source layout; `claw acp serve` is currently a discoverability alias only, and real ACP support remains tracked separately in `ROADMAP.md`. ## 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 > [!NOTE] > [!WARNING] > **`cargo install claw-code` installs the wrong thing.** The `claw-code` crate on crates.io is a deprecated stub that places `claw-code-deprecated.exe` — not `claw`. Running it only prints `"claw-code has been renamed to agent-code"`. **Do not use `cargo install claw-code`.** Either build from source (this repo) or install the upstream binary: > > ```bash > cargo install agent-code # upstream binary — installs 'agent.exe' (Windows) / 'agent' (Unix), NOT 'agent-code' > ``` > > This repo (`ultraworkers/claw-code`) is **build-from-source only** — follow the steps below. ```bash # 1. Clone and build git clone https://github.com/ultraworkers/claw-code cd claw-code/rust cargo build --workspace # 2. Set your API key (Anthropic API key — not a Claude subscription) export ANTHROPIC_API_KEY="sk-ant-..." # 3. Verify everything is wired correctly ./target/debug/claw doctor # 4. Run a prompt ./target/debug/claw prompt "say hello" ``` > [!NOTE] > **Windows (PowerShell):** the binary is `claw.exe`, not `claw`. Use `.\target\debug\claw.exe` or run `cargo run -- prompt "say hello"` to skip the path lookup. ### Windows setup **PowerShell is a supported Windows path.** Use whichever shell works for you. The common onboarding issues on Windows are: 1. **Install Rust first** — download from [https://rustup.rs/](https://rustup.rs/) and run the installer. Close and reopen your terminal when it finishes. 2. **Verify Rust is on PATH:** ```powershell cargo --version ``` If this fails, reopen your terminal or run the PATH setup from the Rust installer output, then retry. 3. **Clone and build** (works in PowerShell, Git Bash, or WSL): ```powershell git clone https://github.com/ultraworkers/claw-code cd claw-code/rust cargo build --workspace ``` 4. **Run** (PowerShell — note `.exe` and backslash): ```powershell $env:ANTHROPIC_API_KEY = "sk-ant-..." .\target\debug\claw.exe prompt "say hello" ``` **Git Bash / WSL** are optional alternatives, not requirements. If you prefer bash-style paths (`/c/Users/you/...` instead of `C:\Users\you\...`), Git Bash (ships with Git for Windows) works well. In Git Bash, the `MINGW64` prompt is expected and normal — not a broken install. > [!NOTE] > **Auth:** claw requires an **API key** (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, etc.) — Claude subscription login is not a supported auth path. Run the workspace test suite: ```bash cd rust cargo test --workspace ``` ## Documentation map - [`USAGE.md`](./USAGE.md) — quick commands, auth, sessions, config, parity harness - [`rust/README.md`](./rust/README.md) — crate map, CLI surface, features, workspace layout - [`PARITY.md`](./PARITY.md) — parity status for the Rust port - [`rust/MOCK_PARITY_HARNESS.md`](./rust/MOCK_PARITY_HARNESS.md) — deterministic mock-service harness details - [`ROADMAP.md`](./ROADMAP.md) — active roadmap and open cleanup work - [`PHILOSOPHY.md`](./PHILOSOPHY.md) — why the project exists and how it is operated ## Ecosystem Claw Code is built in the open alongside the broader UltraWorkers toolchain: - [clawhip](https://github.com/Yeachan-Heo/clawhip) - [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) - [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) - [oh-my-codex](https://github.com/Yeachan-Heo/oh-my-codex) - [UltraWorkers Discord](https://discord.gg/5TUQKqFWd) ## Ownership / affiliation disclaimer - This repository does **not** claim ownership of the original Claude Code source material. - This repository is **not affiliated with, endorsed by, or maintained by Anthropic**.

Report success

Type

Reason

取消

提交