ultraworkers/claw-code

Claw Code – AI 에이전트를 위한 Rust 기반 CLI 하네스

소개 – claw-code는 claw 명령줄 에이전트 하네스의 공개 Rust 구현입니다. LLM 공급자(Anthropic, OpenAI, 로컬 Ollama 스타일 서버)와 통신하고 에이전트 스타일의 프롬프트, 세션 및 도구 호출 워크플로우를 실행할 수 있는 바이너리(claw)를 제공합니다. 저장소에는 Rust 워크스페이스(rust/), 소규모 Python 참조 레이어, 그리고 CLI 빌드, 구성 및 사용을 위한 광범위한 문서가 포함되어 있습니다.

주요 기능(README 설명 기준)

• 에이전트 관리형 CLI – 하네스가 자동으로 작업을 계획, 실행, 검증 및 라벨링합니다. 수동 조작이 아닌 다른 에이전트에 의해 실행되도록 설계되었습니다.
• 멀티 공급자 지원 – Anthropic, OpenAI 및 로컬 OpenAI 호환 서버(Ollama, vLLM 등)와 작동합니다.
• 대화형 및 일회성 모드 – 단일 요청에는 claw prompt "…"를, 대화형 REPL 스타일 세션에는 claw를 사용합니다.
• 상태 확인 명령 – claw doctor는 API 키, 모델 액세스 및 도구 구성을 검증합니다.
• 패리티 하네스 – 결정론적 테스트 및 마이그레이션 추적을 위한 모의 서비스(MOCK_PARITY_HARNESS.md).
• 컨테이너 우선 워크플로우 – 컨테이너 내에서 하네스를 실행하는 방법에 대한 문서가 포함되어 있습니다.
• 향후 ACP/Zed JSON-RPC – 로드맵에는 ACP 데몬 및 JSON-RPC 진입점 추가가 언급되어 있습니다.

시작하기

1. Rust 워크스페이스 복제 및 빌드:

   git clone https://github.com/ultraworkers/claw-code
   cd claw-code/rust
   cargo build --workspace   # 또는 `cargo build --release`
   

2. API 키 설정(예: Anthropic):

   export ANTHROPIC_API_KEY="sk-ant-..."
   

3. 상태 확인 실행:

   ./target/debug/claw doctor
   

4. 프롬프트 시도:

   ./target/debug/claw prompt "say hello"
   

5. 대화형 모드 진입:

   ./target/debug/claw
   

Windows 사용자는 PowerShell에서 동일한 단계를 따르고 claw.exe를 사용하십시오.

문서 맵 – 저장소에는 다음과 같은 markdown 파일 모음이 포함되어 있습니다:

• USAGE.md – 빠른 시작 명령, 인증, 세션, 패리티 하네스.
• rust/README.md – 크레이트 레이아웃 및 CLI 인터페이스.
• docs/ – 공급자 설정, 컨테이너 워크플로우, Windows 설치, 이벤트/보고서 계약 등.
• PARITY.md, ROADMAP.md, PHILOSOPHY.md – 프로젝트 상태, 향후 계획 및 설계 근거.

생태계 – claw는 clawhip, oh-my-openagent, gajae-code 등 다른 UltraWorkers 도구와 함께 제공되며, 커뮤니티는 두 개의 Discord 서버에서 활동합니다.

라이선스 – MIT.

결론 – LLM 기반 자율 에이전트를 실행하고, 세션을 관리하며, 멀티 공급자 설정을 실험하기 위한 Rust 네이티브 CLI가 필요하다면 claw-code가 그 하네스를 제공합니다. 이 프로젝트는 소스에서 직접 빌드해야 합니다. crates.io에 게시된 claw-code 크레이트는 더 이상 사용되지 않는 스텁이므로, 직접 바이너리를 컴파일하거나 업스트림 agent-code 패키지를 설치해야 합니다.