efa24edf21
Filed from live #claw-code dogfood on 2026-04-08 where two real users hit adjacent auth confusion within minutes: - varleg set OPENAI_API_KEY for OpenRouter but prefix routing didn't win because the model name wasn't prefixed with openai/; unsetting ANTHROPIC_API_KEY then hit MissingApiKey with no hint that the OpenAI path was already configured - stanley078852 put an sk-ant-* key in ANTHROPIC_AUTH_TOKEN instead of ANTHROPIC_API_KEY, causing claw to send it as Authorization: Bearer sk-ant-..., which Anthropic rejects at the edge with 401 Invalid bearer token Both fixes delivered live in #claw-code as direct replies, but the pattern is structural: the error surface doesn't bridge HTTP-layer symptoms back to env-var choice. Action block spells out a single main-side PR with three improvements: (a) MissingCredentials hint when an adjacent provider's env var is already set, (b) 401-on-Anthropic hint when bearer token starts with sk-ant-, (c) 'which env var goes where' paragraph in both README matrices mapping sk-ant-* -> x-api-key and OAuth access token -> Authorization: Bearer. All three improvements are unit-testable against ApiError::fmt output with no HTTP calls required.
Claw Code
ultraworkers/claw-code · Usage · Rust workspace · Parity · Roadmap · UltraWorkers Discord
Claw Code is the public Rust implementation of the claw CLI agent harness.
The canonical implementation lives in rust/, and the current source of truth for this repository is ultraworkers/claw-code.
Important
Start with
USAGE.mdfor build, auth, CLI, session, and parity-harness workflows. Makeclaw doctoryour first health check after building, userust/README.mdfor crate-level details, readPARITY.mdfor the current Rust-port checkpoint, and seedocs/container.mdfor the container-first workflow.
Current repository shape
rust/— canonical Rust workspace and theclawCLI binaryUSAGE.md— task-oriented usage guide for the current product surfacePARITY.md— Rust-port parity status and migration notesROADMAP.md— active roadmap and cleanup backlogPHILOSOPHY.md— project intent and system-design framingsrc/+tests/— companion Python/reference workspace and audit helpers; not the primary runtime surface
Quick start
cd rust
cargo build --workspace
./target/debug/claw --help
./target/debug/claw prompt "summarize this repository"
Authenticate with either an API key or the built-in OAuth flow:
export ANTHROPIC_API_KEY="sk-ant-..."
# or
cd rust
./target/debug/claw login
Run the workspace test suite:
cd rust
cargo test --workspace
Documentation map
USAGE.md— quick commands, auth, sessions, config, parity harnessrust/README.md— crate map, CLI surface, features, workspace layoutPARITY.md— parity status for the Rust portrust/MOCK_PARITY_HARNESS.md— deterministic mock-service harness detailsROADMAP.md— active roadmap and open cleanup workPHILOSOPHY.md— why the project exists and how it is operated
Ecosystem
Claw Code is built in the open alongside the broader UltraWorkers toolchain:
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.