Mã móng vuốt

bắt đầu với dây nịt chạy bằng cua thực sự

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

Tham gia vào sự bất hòa: sự bất hòa giữa các công nhân siêu nhân · sự bất hòa về mã gajae

[! QUAN TRỌNG] Claw Code không phải là dự án sản xuất nghiêm túc ở đây. Kho lưu trữ này gần với một cuộc triển lãm trong bảo tàng hơn là nơi giới thiệu sản phẩm, một hiện vật do loài giáp xác điều hành được duy trì sự sống nhờ các gajae có móng vuốt, được các đặc vụ quét và dán nhãn, đồng thời được bảo trì tự động theo các quy định trên.

Như đã được mô tả trong triết lý dự án, điều này không có nghĩa là phải vận hành bằng tay như một kho lưu trữ sản phẩm thông thường. Nó là một triển lãm do đại lý quản lý: người khai thác lập kế hoạch, thực hiện, xác minh, dán nhãn và bảo quản hiện vật trong khi cua tiếp tục vận hành bể chứa.

Nếu bạn thực sự muốn chạy công việc, hãy bắt đầu với LazyCodex hoặc Mã Gajae. Nếu bạn muốn xem hóa thạch nhỏ kỳ lạ của khoảnh khắc Mã Vuốt, hãy tiếp tục bên dưới.

Để có lời giải thích công khai dài hơn đằng sau triết lý này, hãy xem ở đây.

ultraworkers/claw-code · Cách sử dụng · Rust không gian làm việc · Tính chẵn lẻ · Lộ trình · Đóng góp · Bảo mật · Sự bất hòa của UltraWorkers

Mã móng vuốt là cách triển khai Rust công khai của claw Dây đai đặc vụ CLI. Việc triển khai kinh điển tồn tại trong rust/và nguồn sự thật hiện tại cho kho lưu trữ này là ultraworkers/claw-code.

[!QUAN TRỌNG] Bắt đầu với USAGE.md dành cho các quy trình xây dựng, xác thực, CLI, phiên và khai thác chẵn lẻ. Đối với các câu hỏi về gửi/điều hướng tệp, hãy xem Điều hướng và ngữ cảnh tập tin. Để biết các kiểu máy tương thích với OpenAI cục bộ và cài đặt kỹ năng ngoại tuyến, hãy xem Thiết lập kỹ năng và nhà cung cấp tương thích với OpenAI tại địa phương. Người dùng Windows có thể chuyển sang PowerShell-first Cài đặt và phát hành Windows khởi động nhanh. làm claw doctor lần kiểm tra sức khỏe đầu tiên của bạn sau khi xây dựng, hãy sử dụng rust/README.md để biết chi tiết về cấp độ thùng, hãy đọc PARITY.md để biết điểm kiểm tra cổng Rust hiện tại và xem docs/container.md cho quy trình làm việc đầu tiên của vùng chứa.

Trạng thái ACP/Zed: claw-code chưa gửi daemon ACP/Zed hoặc điểm vào JSON-RPC. Chạy claw acp (hoặc claw --acp) để biết trạng thái hiện tại thay vì đoán từ bố cục nguồn; claw acp serve hiện chỉ là bí danh có thể khám phá, trả về trạng thái có mã thoát 0 và hỗ trợ ACP thực vẫn được theo dõi riêng trong ROADMAP.md. Đối với hợp đồng JSON công khai, xem docs/g011-acp-json-rpc-status-contract.md.

Hình dạng kho lưu trữ hiện tại

• rust/ — không gian làm việc chuẩn Rust và claw CLI nhị phân
• USAGE.md — hướng dẫn sử dụng theo định hướng nhiệm vụ cho bề mặt sản phẩm hiện tại
• PARITY.md — Trạng thái chẵn lẻ của cổng Rust và ghi chú di chuyển
• ROADMAP.md - lộ trình hoạt động và dọn dẹp tồn đọng
• PHILOSOPHY.md - mục đích của dự án và khung thiết kế hệ thống
• src/ + tests/ — người đồng hành Python/không gian làm việc tham khảo và người trợ giúp kiểm tra; không phải là bề mặt thời gian chạy chính

Bắt đầu nhanh

[!LƯU Ý] [!CẢNH BÁO] cargo install claw-code cài đặt sai thứ. các claw-code thùng trên thùng.io là một sơ khai không được dùng nữa đặt claw-code-deprecated.exe - không claw. Chạy nó chỉ in "claw-code has been renamed to agent-code". không sử dụng cargo install claw-code. Xây dựng từ nguồn (repo này) hoặc cài đặt nhị phân ngược dòng:

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

Kho lưu trữ này (ultraworkers/claw-code) là chỉ xây dựng từ nguồn — hãy làm theo các bước dưới đây.

# 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"

# 5. Start an interactive session
./target/debug/claw

[!LƯU Ý] Windows (PowerShell): nhị phân là claw.exe, không claw. sử dụng .\target\debug\claw.exe hoặc chạy cargo run -- prompt "say hello" để bỏ qua việc tra cứu đường dẫn.

thiết lập Windows

PowerShell là đường dẫn Windows được hỗ trợ. Sử dụng bất kỳ shell nào phù hợp với bạn. Các vấn đề phổ biến khi cài đặt trên Windows là:

1. Trước tiên hãy cài đặt Rust - tải xuống từ https://rustup.rs/ và chạy trình cài đặt. Đóng và mở lại thiết bị đầu cuối của bạn khi nó kết thúc.
2. Xác minh Rust có trên PATH:

   cargo --version
   

   Nếu điều này không thành công, hãy mở lại thiết bị đầu cuối của bạn hoặc chạy thiết lập PATH từ đầu ra của trình cài đặt Rust, sau đó thử lại.
3. Sao chép và xây dựng (hoạt động trong PowerShell, Git Bash hoặc WSL):

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

4. Chạy (PowerShell - lưu ý .exe và dấu gạch chéo ngược):

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

Để biết các ZIP phát hành, thiết lập PATH, chuyển đổi nhà cung cấp và kiểm tra khói thông báo, hãy xem docs/windows-install-release.md.

Git Bash / WSL là những lựa chọn thay thế tùy chọn, không phải là yêu cầu. Nếu bạn thích đường dẫn kiểu bash (/c/Users/you/... thay vì C:\Users\you\...), Git Bash (đi kèm với Git cho Windows) hoạt động tốt. Trong Git Bash, MINGW64 lời nhắc được mong đợi và bình thường — không phải là cài đặt bị hỏng.

Sau khi xây dựng: xác định vị trí nhị phân và xác minh

Sau khi chạy cargo build --workspace, cái claw nhị phân được xây dựng nhưng không tự động được cài đặt vào hệ thống của bạn. Đây là nơi để tìm thấy nó và cách xác minh quá trình xây dựng đã thành công.

Vị trí nhị phân

Sau cargo build --workspace trong claw-code/rust/:

Bản dựng gỡ lỗi (mặc định, biên dịch nhanh hơn):

• macOS/Linux: rust/target/debug/claw
• Windows: rust/target/debug/claw.exe

Bản phát hành (được tối ưu hóa, biên dịch chậm hơn):

• macOS/Linux: rust/target/release/claw
• Windows: rust/target/release/claw.exe

Nếu bạn chạy cargo build không có --release, hệ nhị phân nằm trong debug/ thư mục.

Xác minh quá trình xây dựng thành công

Kiểm tra nhị phân trực tiếp bằng đường dẫn của nó:

# macOS/Linux (debug build)
./rust/target/debug/claw --help
./rust/target/debug/claw doctor

# Windows PowerShell (debug build)
.\rust\target\debug\claw.exe --help
.\rust\target\debug\claw.exe doctor

Lệnh khói PowerShell không yêu cầu thông tin xác thực trực tiếp:

$env:CLAW_CONFIG_HOME = Join-Path $env:TEMP "claw config home"
New-Item -ItemType Directory -Force -Path $env:CLAW_CONFIG_HOME | Out-Null
Remove-Item Env:\ANTHROPIC_API_KEY, Env:\ANTHROPIC_AUTH_TOKEN, Env:\OPENAI_API_KEY -ErrorAction SilentlyContinue
.\rust\target\debug\claw.exe help
.\rust\target\debug\claw.exe status
.\rust\target\debug\claw.exe config env
.\rust\target\debug\claw.exe doctor

Nếu các lệnh này thành công thì quá trình xây dựng đang hoạt động. claw doctor là lần kiểm tra tình trạng đầu tiên của bạn — nó xác thực khóa API, quyền truy cập mô hình và cấu hình công cụ của bạn.

Tùy chọn: Thêm vào PATH

Nếu bạn muốn chạy claw từ bất kỳ thư mục nào không có đường dẫn đầy đủ, hãy chọn một trong các cách tiếp cận sau:

Tùy chọn 1: Liên kết tượng trưng (macOS/Linux)

ln -s $(pwd)/rust/target/debug/claw /usr/local/bin/claw

Sau đó tải lại shell của bạn và kiểm tra:

claw --help

Cách 2: Sử dụng cargo install (tất cả các nền tảng)

Build và cài đặt vào vị trí mặc định của Cargo (~/.cargo/bin/, thường nằm trên PATH):

# From the claw-code/rust/ directory
cargo install --path . --force

# Then from anywhere
claw --help

Tùy chọn 3: Cập nhật hồ sơ shell (bash/zsh)

Thêm dòng này vào ~/.bashrc hoặc ~/.zshrc:

export PATH="$(pwd)/rust/target/debug:$PATH"

Tải lại shell của bạn:

source ~/.bashrc  # or source ~/.zshrc
claw --help

Khắc phục sự cố

• "không tìm thấy lệnh: vuốt" — Hệ nhị phân nằm trong rust/target/debug/claw, nhưng nó không có trên ĐƯỜNG của bạn. Sử dụng đường dẫn đầy đủ ./rust/target/debug/claw hoặc liên kết tượng trưng/cài đặt như trên.
• "sự cho phép bị từ chối" — Trên macOS/Linux, bạn có thể cần chmod +x rust/target/debug/claw nếu bit thực thi không được đặt (hiếm).
• Gỡ lỗi so với phát hành — Nếu quá trình xây dựng chậm thì bạn đang ở chế độ gỡ lỗi (mặc định). Thêm --release để cargo build để có thời gian chạy nhanh hơn nhưng quá trình xây dựng sẽ mất 5–10 phút.

[!LƯU Ý] Xác thực: móng vuốt yêu cầu một Phím API (ANTHROPIC_API_KEY, OPENAI_API_KEY, v.v.) — Đăng nhập đăng ký Claude không phải là đường dẫn xác thực được hỗ trợ.

Chạy bộ kiểm tra không gian làm việc sau khi xác minh tệp nhị phân hoạt động:

cd rust
cargo test --workspace

Bản đồ tài liệu

• USAGE.md — lệnh nhanh, xác thực, phiên, cấu hình, khai thác chẵn lẻ
• docs/navigation-file-context.md - điều hướng thiết bị đầu cuối, cuộn lại, @path ngữ cảnh tệp, tệp đính kèm và hướng dẫn an toàn bí mật
• docs/local-openai-compatible-providers.md — Thiết lập Ollama/Llama.cpp/vLLM, định vị nhiều nhà cung cấp Claw và kiểm tra cài đặt kỹ năng cục bộ
• docs/windows-install-release.md — Cài đặt PowerShell đầu tiên, phát hành tạo phẩm, chuyển đổi nhà cung cấp và đường dẫn khói thông báo Windows/WSL
• rust/README.md — bản đồ thùng, bề mặt CLI, tính năng, bố cục không gian làm việc
• PARITY.md — trạng thái chẵn lẻ cho cổng Rust
• rust/MOCK_PARITY_HARNESS.md - chi tiết khai thác dịch vụ mô phỏng xác định
• ROADMAP.md — lộ trình tích cực và công việc dọn dẹp mở
• docs/g004-events-reports-contract.md — Hướng dẫn hợp đồng báo cáo/sự kiện luồng 2 làn cho người tiêu dùng
• PHILOSOPHY.md - tại sao dự án tồn tại và nó được vận hành như thế nào
• CONTRIBUTING.md, SECURITY.md, SUPPORT.mdvà CODE_OF_CONDUCT.md — đóng góp, báo cáo lỗ hổng, hỗ trợ và chính sách cộng đồng
• LICENSE - Giấy phép MIT cho kho lưu trữ này

Hệ sinh thái

Claw Code được xây dựng mở cùng với chuỗi công cụ UltraWorkers rộng hơn:

• móng vuốt
• ôi-của-tôi-mở
• ôi-claudecode
• ôi-codex của tôi
• mã gajae
• Sự bất hòa của UltraWorkers

Tuyên bố từ chối trách nhiệm về quyền sở hữu / liên kết

• Kho lưu trữ này làm không yêu cầu quyền sở hữu tài liệu nguồn Claude Code ban đầu.
• Kho lưu trữ này là không được liên kết với, xác nhận hoặc duy trì bởi Anthropic.