설치 가이드 — DureClaw

→

빠른 시작

Claude Code 플러그인

필수 · 로컬 실행 가능

여기까지만 해도 바로 사용 가능.
Claude Code가 오케스트레이터로 로컬 태스크를 실행한다.

Phoenix 서버 설치

멀티머신 확장 시 · Docker/바이너리

Elixir 불필요.
사전빌드 바이너리 → Docker 자동 선택.
대시보드: http://서버IP:4000/

워커 에이전트 설치

각 원격 머신 · /setup-team 자동 안내

또는 Claude Code에게 말하세요:
"워커 추가해줘" / "팀 설정해줘"
→ 서버 IP 자동 감지 + 복붙 명령어 출력

→

지원 환경

🍎

macOS — Apple Silicon

M1 / M2 / M3 / M4 · arm64

서버 ✓ 워커 ✓ 사전빌드

$ bash <(curl -fsSL https://dureclaw.baryon.ai/server)

✅ darwin-arm64 바이너리 다운로드 완료

✅ Tailscale 연결됨: 100.x.x.x

→ 서버 시작 · ws://100.x.x.x:4000

완전 지원 · 권장 환경

💻

macOS — Intel

Core i5/i7/i9 · x86_64

서버 ✓ 워커 ✓ 사전빌드

$ bash <(curl -fsSL https://dureclaw.baryon.ai/server)

✅ darwin-x86_64 바이너리 다운로드 완료

→ 서버 시작 · ws://192.168.x.x:4000

완전 지원

🐧

Linux — x86_64

Ubuntu / Debian / CentOS · amd64

서버 ✓ 워커 ✓ 사전빌드 Docker

$ ROLE=builder bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

✅ linux-x86_64 에이전트 설치 완료

✅ claude-cli 감지됨

→ builder@gpu-server 연결 완료

완전 지원 · GPU 서버 권장

🫐

Raspberry Pi 4 / 5

Linux arm64 · aarch64

서버 ✓ 워커 ✓ 사전빌드

$ ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

✅ linux-arm64 에이전트 설치 완료

✅ pi 감지됨

→ executor@raspberrypi 연결 완료

완전 지원 · executor 역할 최적

📡

Raspberry Pi Zero W/2W

WiFi 내장 · armv6 / arm64 · 512MB RAM

워커 ✓ JS 번들

$ ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

✅ JS 번들 모드 (armv6)

⚠ aider 경량 모드 사용

→ executor@zero-w 연결 완료 (WiFi)

IoT 센서 · 경량 executor · WiFi로 연결

🪟

Windows 10 / 11

설치 프로그램 · x86_64

워커 ✓ 설치형 exe Docker

⬇ DureClaw-Agent-Setup.exe

① Setup.exe 실행 (관리자 권한 불필요)

② 서버 주소 — 비우면 oah.local · Tailscale 자동 탐색

✅ 트레이 상주 · 로그인 시 자동 연결

→ builder@DESKTOP-WIN 연결 완료

터미널 선호 시: irm https://dureclaw.baryon.ai/agent.ps1 | iex

워커 지원 · 설치 프로그램 / PowerShell

🐳

Docker

모든 플랫폼 · ghcr.io/dureclaw/dureclaw

서버 ✓ 컨테이너

$ docker compose up

✅ ghcr.io/dureclaw/dureclaw:latest

Elixir 불필요 · /data 볼륨 마운트

→ 서버 준비 완료 · :4000

Elixir 없이 즉시 실행

→

AI 팀원 추가하기

새 머신에서 아래 명령어를 실행하면 설치·설정·연결이 자동 처리된다. 서버IP는 Tailscale IP(100.x.x.x) 또는 LAN IP로 교체하거나, "워커 추가해줘"라고 Claude에게 말하면 자동으로 채워준다.

builder
코드 작성

PHOENIX=ws://서버IP:4000 ROLE=builder bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

tester
테스트 실행

PHOENIX=ws://서버IP:4000 ROLE=tester bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

analyst
코드 분석

PHOENIX=ws://서버IP:4000 ROLE=analyst bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

executor
명령 실행

PHOENIX=ws://서버IP:4000 ROLE=executor bash <(curl -fsSL https://dureclaw.baryon.ai/agent)

🪟 Windows는 명령어 없이 — 설치 프로그램을 받아 실행하고 서버 주소·역할만 입력하면 된다.
여러 PC 일괄 배포: DureClaw-Agent-Setup.exe /VERYSILENT /SERVER=ws://서버IP:4000 /ROLE=builder

⬇ Windows용 다운로드

Work Key 생략 시 서버에서 자동 감지 · 에이전트 이름 미지정 시 역할@머신이름으로 자동 설정 · Windows는 설치 프로그램(트레이) 또는 PowerShell 스크립트

→

활용 예시 — fix-agent

3개의 에이전트가 협력해 레포지토리 버그를 자동 분석·수정·PR 생성하는 파이프라인.

시작

Claude Code가 버그 리포트 수신 → 에이전트 배분

analyzer→버그 탐지·분석

분석 완료

분석 결과 → fixer에게 전달

analyzer✓root cause 특정

fixer→코드 수정

수정 완료

수정 코드 → tester 검증 + PR 생성

fixer✓패치 완료

tester→테스트 실행 + PR 생성

PR 자동 생성 · 테스트 통과 확인 · 리뷰 요청까지 자동화