README

Claw Code


  
    
  
  
    
  



  English ·
  中文



  
    
  
  
    
  


start with the real crab-powered harnesses


  github.com/code-yeongyu/lazycodex
  
  github.com/Yeachan-Heo/gajae-code



  
    
  
  
    
  



  
    
  
  
    
  



  加入 Discord：
  ultraworkers discord
  ·
  gajae-code discord


 [!IMPORTANT]
 Claw Code 在这里并不是一个严肃的生产级项目。
 这个代码库更像是一个博物馆的展品，而不是一个产品推介。它是一个由螃蟹（crab）驱动的工件，由带爪子的 gajae（小龙虾）维持生命，由智能体清扫和贴标签，并根据上述的工具（harnesses）自动维护。

 正如项目理念中所描述的，这并不旨在像普通产品代码库那样由人工操作。它是一个由智能体管理的展品 (agent-managed exhibit)：当螃蟹保持水箱运转时，工具会规划、执行、验证、标记并保存该工件。

 如果你想要实际运行工作任务，请从 LazyCodex 或 Gajae-Code 开始。如果你想研究 Claw Code 时刻这个奇怪的小化石，请继续往下看。

 有关这一理念背后更详细的公开解释，请参阅这里。


  ultraworkers/claw-code
  ·
  使用指南 (Usage)
  ·
  Rust 工作区 (Rust workspace)
  ·
  一致性 (Parity)
  ·
  路线图 (Roadmap)
  ·
  贡献指南 (Contributing)
  ·
  安全 (Security)
  ·
  UltraWorkers Discord



  
    
      
      
      
    
  



  


Claw Code 是 claw CLI 智能体工具的公开 Rust 实现。
规范的实现位于 rust/，此代码库当前的事实来源是 ultraworkers/claw-code。

 [!IMPORTANT]
 首先请阅读 USAGE.md 以了解构建、认证、CLI、会话和一致性工具（parity-harness）工作流。关于文件提交/导航问题，请参阅 导航和文件上下文 (Navigation and file context)。关于本地兼容 OpenAI 的模型和离线技能设置，请参阅 本地兼容 OpenAI 提供商及技能设置 (Local OpenAI-compatible providers and skills setup)。Windows 用户可以跳转至以 PowerShell 为主的 Windows 安装和发布快速入门 (Windows install and release quickstart)。构建完成后，请首先使用 claw doctor 进行健康检查，查看 rust/README.md 获取 crate 级别的详细信息，阅读 PARITY.md 了解当前的 Rust 移植检查点，并查阅 docs/container.md 了解优先使用容器的工作流。

 ACP / Zed 状态： claw-code 尚未发布 ACP/Zed 守护进程或 JSON-RPC 入口点。请运行 claw acp（或 claw --acp）查看当前状态，而不是从源代码布局中猜测；claw acp serve 目前仅作为可发现性的别名，返回状态并以退出码 0 结束，真正的 ACP 支持仍在 ROADMAP.md 中单独追踪。有关公开的 JSON 契约，请参阅 docs/g011-acp-json-rpc-status-contract.md。

 当前代码库结构

- rust/ — 规范的 Rust 工作区和 claw CLI 二进制文件
- USAGE.md — 针对当前产品表面的面向任务的使用指南
- PARITY.md — Rust 移植一致性状态和迁移说明
- ROADMAP.md — 活跃的路线图和清理待办事项
- PHILOSOPHY.md — 项目意图和系统设计框架
- src/ + tests/ — 配套的 Python/参考工作区和审计辅助工具；不是主要的运行时表面

 快速入门

 [!NOTE]
 [!WARNING]
 cargo install claw-code 会安装错误的东西。 crates.io 上的 claw-code crate 是一个已废弃的存根（stub），它会放置 claw-code-deprecated.exe — 而不是 claw。运行它只会打印 "claw-code has been renamed to agent-code"。请勿使用 cargo install claw-code。 请从源码构建（本代码库）或安装上游二进制文件：
 bash
 cargo install agent-code    上游二进制文件 — 安装为 'agent.exe' (Windows) / 'agent' (Unix)，而不是 'agent-code'
 
 本代码库 (ultraworkers/claw-code) 仅支持从源码构建 — 请遵循以下步骤。

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

 2. 设置您的 API 密钥（Anthropic API 密钥 — 不是 Claude 订阅）
export ANTHROPIC_API_KEY="sk-ant-..."

 3. 验证所有配置是否正确
./target/debug/claw doctor

 4. 运行提示词
./target/debug/claw prompt "say hello"

 5. 启动交互式会话
./target/debug/claw


 [!NOTE]
 Windows (PowerShell)： 二进制文件是 claw.exe，而不是 claw。使用 .\target\debug\claw.exe 或运行 cargo run -- prompt "say hello" 以跳过路径查找。

 Windows 设置

PowerShell 是一种支持的 Windows 路径。 您可以使用任何适合您的终端 shell。Windows 上常见的入门问题是：

1. 首先安装 Rust — 从  下载并运行安装程序。完成后关闭并重新打开终端。
2. 验证 Rust 是否在 PATH 中：
   powershell
   cargo --version
   
   如果失败，请重新打开终端或运行 Rust

Top issues

Latest release

See CHANGELOG.

The claw-macos-arm64 asset was built by release.yml run 42519229108 on macos-15 from commit 3885e733 (ci/release-macos-15, PR 3380). That commit is v0.1.12 plus only the runner change, because the tag run could not schedule the retired macos-14 runner.