raullenchai/claw

CLaude AnyWhere — 어디서나 Claude Code를 제어하세요

📱 전화기 · 💻 노트북 · 📟 태블릿 · ⌚ 워치 — 브라우저가 있다면, 당신이 제어할 수 있습니다

긴 Claude Code 세션(session)을 실행 중인가요? 자리에서 잠시 비워야 하나요? Claw를 사용하면 브라우저가 있는 모든 기기에서 Claude Code를 모니터링하고 제어할 수 있습니다.

• 👀 Claude가 무엇을 하고 있는지 어떤 화면에서든 실시간으로 확인하세요
• ⚡ 한 번의 탭으로 빠른 응답(yes/no/continue)을 보내세요
• 🛑 상황이 잘못될 때는 Ctrl+C로 중단하세요
• 🖥️ 세션(sessions), 윈도우(windows), 팬(panes), git 상태(git status), 시스템 통계(system stats) 등 모든 것을 모니터링하세요

python3 claw.py --share

전화기에서 URL을 여세요. 그것으로 끝입니다.

Python 3 표준 라이브러리 외에 다른 의존성(dependencies)은 없습니다.

기능	설명
라이브 터미널 (Live Terminal)	자동 스크롤 기능이 포함된 실시간 tmux 팬 (pane) 콘텐츠
빠른 작업 (Quick Actions)	원탭 버튼: yes no continue /compact Ctrl+C
세션 전환 (Session Switching)	tmux 세션, 윈도우, 팬 사이를 전환
Git 상태 (Git Status)	현재 브랜치(branch), 변경된 파일, 최근 커밋
시스템 통계 (System Stats)	CPU, 메모리(memory), 부하 평균(load averages)
프로세스 모니터 (Process Monitor)	CPU/메모리 사용량을 포함한 Claude 관련 프로세스
모바일 우선 (Mobile-First)	당겨서 새로고침(pull-to-refresh) 기능이 있는 전화기용 설계
자동 새로고침 (Auto-Refresh)	설정 가능한 새로고침 간격 (기본값: 5초)

pipx install claw-cli
claw --share

pip install claw-cli
claw --share

curl -O https://raw.githubusercontent.com/raullenchai/claw/main/claw.py
python3 claw.py --share

git clone https://github.com/raullenchai/claw.git
cd claw
python3 claw.py --share

usage: claw.py [-h] [-p PORT] [-b BIND] [-r REFRESH] [-d DIR] [-s]
Claw - Claude Code 세션을 위한 원격 제어
options:
...

# 기본값 (localhost 전용, 포트 8080, 5초 새로고침)
claw
# 🌐 어디서나 접속 가능 (집을 떠나 있을 때 전화기로!)
...

상황에 맞는 방법을 선택하세요:

전화기와 컴퓨터가 동일한 WiFi에 연결되어 있는 경우:

claw -b 0.0.0.0

그 다음 전화기에서 http://<your-computer-ip>:8080을 여세요.

컴퓨터의 IP를 찾으세요:

# macOS
ipconfig getifaddr en0
# Linux
...

예시: http://192.168.1.42:8080

또는 http://10.0.0.15:8080

커피숍, 자동차, 또는 집 밖 어디에서든 Claude를 확인하기에 완벽합니다:

claw --share

╱╱╱ Claw - CLaude AnyWhere
✓ Tunnel ready!
→ Public: https://random-words.trycloudflare.com ← 이걸 사용하세요!
...

• ✅ 모든 방화벽/NAT를 통해 작동
• ✅ 회원가입 불필요
• ✅ 완전 무료
• ✅ 비밀번호 보호 (자동 생성됨)
  ⚠️ URL과 비밀번호는 재시작할 때마다 변경됩니다.

첫 실행 시 cloudflared (~25MB)가 자동으로 다운로드됩니다.

매번 동일한 URL을 사용하고 싶으신가요? 무료 Cloudflare 계정을 설정하세요:

일회성 설정:

# 1. cloudflared 설치 (자동 설치되지 않은 경우)
brew install cloudflared # macOS
# 또는 https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/ 에서 다운로드
...

매일 사용하기:

# Claw 시작
claw &
# 터널 시작 (다른 터미널에서 실행하거나 시작 프로그램에 추가)
...

이제 https://claw.yourdomain.com이

항상 작동합니다!

요구 사항:

• 무료 Cloudflare 계정 (가입 필요)
• 도메인 이름 (연간 약 $10, 또는 이미 보유한 도메인 사용)

Tailscale을 사용하는 경우, 다음을 실행하기만 하면 됩니다:

claw -b 0.0.0.0

Tailscale IP를 통해 접속하세요: http://100.x.x.x:8080

방법	설정	URL	용도
동일한 WiFi	없음	192.168.x.x:8080	가정 내 사용
--share	없음	랜덤 URL	빠른 원격 접속
Cloudflare	5분	claw.yourdomain.com	매일 사용하는 원격 접속
Tailscale	앱 설치	100.x.x.x:8080	팀/여러 기기

엔드포인트 (Endpoint)	설명
/	메인 대시보드 (HTML)
/api/data	모든 대시보드 데이터 (JSON)
/api/pane?session=NAME&window=IDX&pane=IDX	Tmux pane 내용
/api/git?dir=NAME	디렉토리에 대한 Git 정보

Endpoint	Body	Description
/api/send	{"session": "name", "window": "1", "pane": "0", "text": "yes", "enter": true}	Pane에 텍스트 전송
/api/control	{"session": "name", "window": "1", "pane": "0", "key": "C-c"}	Control key 전송

기본적으로 안전함 (Safe by default):

• localhost에만 바인딩됨 — 오직 당신의 컴퓨터만 접속 가능
• --share 사용 시 비밀번호 인증이 필요함 (자동 생성됨)
• --share는 HTTPS를 사용함 (Cloudflare를 통해 암호화됨)
• 입력값 검증 (Input validation)을 통해 커맨드 인젝션 (Command injection)을 방지함
• Control key는 화이트리스트 (Whitelist)로 관리됨
• 콘텐츠 보안 정책 (Content Security Policy, CSP) 헤더를 통해 XSS를 방지함

--share 사용 시:

• 시작 시 무작위 비밀번호가 생성되어 표시됨
• 휴대폰에서 접속할 때 이 비밀번호를 입력해야 함
• Claw를 재시작할 때마다 비밀번호가 변경됨

-b 0.0.0.0 사용 시 (로컬 네트워크 접속):

• 인증이 필요하지 않음 (신뢰할 수 있는 네트워크)
• 동일한 WiFi에 있는 누구나 Claw에 접속할 수 있음
• 홈 네트워크에서는 괜찮지만, 공용 WiFi에서는 주의할 것

로컬 네트워크에서 추가 보안을 강화하려면:

# SSH 터널 (서버가 있는 경우)
ssh -L 8080:localhost:8080 your-server
# 그 다음 SSH 앱을 통해 휴대폰에서 http://localhost:8080으로 접속

Python 3.8+ (표준 라이브러리만 사용, pip install 불필요)
tmux (세션 관리를 위함)
git (선택 사항, 리포지토리 정보를 위함)

Platform	Basic Usage	--share	System Stats
macOS (Intel/Apple Silicon)	✅	✅	✅
Linux (x64/ARM)	✅	✅	✅
Windows (x64/x86)	✅	✅	✅
WSL	✅	✅	✅

참고: Windows는 WSL 등을 통한 tmux가 필요합니다. 네이티브 Windows 터미널 모니터링은 지원되지 않습니다.

포트가 이미 사용 중인 경우 (Port already in use)

# 포트를 사용 중인 프로세스 찾기
lsof -i :8080
# 다른 포트 사용
...

tmux 세션이 표시되지 않는 경우 (No tmux sessions showing)

# tmux가 실행 중인지 확인
tmux list-sessions
# 새 세션 시작
...

휴대폰에서 접속할 수 없는 경우 (Can't access from phone)

• 방화벽 설정을 확인하세요
• 두 장치가 동일한 네트워크에 있는지 확인하세요
• 컴퓨터의 IP를 직접 사용해 보세요 (localhost가 아님)
• VPN이 간섭하고 있는지 확인하세요

┌─────────────────────────────────────────────────────────┐
│ 모바일 브라우저 (Mobile Browser) │
│ ┌─────────────────────────────────────────────────┐ │
...

기여(Contributions)는 언제나 환영합니다! 우리의 기여 가이드(Contributing Guide)와 행동 강령(Code of Conduct)을 읽어주세요.

# 저장소(repo)를 포크(Fork)한 후, 다음을 실행하세요:
git clone https://github.com/YOUR_USERNAME/claw.git
cd claw
...

MIT License - 자세한 내용은 LICENSE를 참조하세요.

Anthropic의 Claude Code와 함께 사용하도록 제작되었습니다.

책상까지 다시 걸어가는 것에 지친 개발자들이 🦞를 사용하여 만들었습니다.