Claude Code를 슬랙으로 원격 제어하고, 배포·커밋 결과를 자동으로 스레드와 대시보드에 기록하는 나만의 관제탑을 5분 안에 설치하세요.
클대리(claude-remote)는 맥에서 돌아가는 Claude Code를 슬랙으로 원격 제어하는 상주 브리지입니다. 프로젝트를 배포하면 자동으로 슬랙 알림이 오고, 그 알림 스레드에 답장만 하면 같은 프로젝트 폴더에서 곧바로 후속 작업이 실행됩니다. 별도 대시보드 웹페이지에서 모든 프로젝트의 최신 배포 현황도 한눈에 볼 수 있습니다. 이 킷은 각자의 맥에 각자의 계정으로 설치하도록 만들어졌습니다 — 자세한 이유는 아래 FAQ를 참고하세요.
| 기능 | 설명 |
|---|---|
| 자동 배포 알림 | wrangler pages deploy 성공 시 프로젝트별 슬랙 스레드로 자동 알림 |
| 스레드로 후속 지시 | 알림 스레드에 답장하면 같은 프로젝트 폴더에서 헤드리스 Claude 작업 실행 |
| DM/멘션 지시 | [프로젝트명] 지시문 형태로 언제든 새 작업 요청 가능 |
| 웹 대시보드 | Cloudflare Worker 기반, 전체 프로젝트 최신 배포 URL·브랜치·커밋 확인 |
| 안전장치 | 삭제 등 파괴적 지시는 30분 내 "승인" 답장 필요, 헤드리스 실행은 도구 화이트리스트만 허용 |
Cloudflare 계정이 없어도 슬랙 알림/원격 지시 기능은 그대로 동작합니다. 대시보드(웹으로
전체 현황 보기)만 못 쓸 뿐입니다. 나중에 계정을 만들고 ./setup.sh를 다시
실행해도 됩니다(멱등적이라 여러 번 실행해도 안전합니다).
터미널(Terminal) 앱을 열고 아래 한 줄을 붙여넣고 엔터를 누르세요.
curl -fsSL https://kdaeri-setup.pages.dev/install.sh | bash~/claude-remote에 파일을 배치하고, 의존성을 설치하고, Claude Code 훅과
launchd 서비스 등록까지 자동으로 끝냅니다. 이미 설치돼 있다면 기존 폴더를 안전하게
백업만 하고 안내 메시지를 띄운 뒤 종료합니다.
설치 스크립트가 끝나면 ~/claude-remote/SLACK_SETUP.md 문서를 열어
클릭 단위로 따라 하세요. 아래는 핵심 요약입니다(전체 클릭 가이드는 문서에 있습니다).
| 1 | api.slack.com/apps → Create New App → From scratch |
| 2 | App Name에 "클대리-이름"처럼 본인을 구분할 수 있는 이름 입력 권장 (예: 클대리-김철수) — 워크스페이스에 여러 명이 각자 설치하므로 앱 이름이 겹치면 헷갈립니다 |
| 3 | Socket Mode 켜기 → connections:write 스코프로 앱 토큰(xapp-) 발급 → .env의 SLACK_APP_TOKEN에 저장 |
| 4 | OAuth & Permissions에서 Bot Token Scope 11개 추가(문서에 전체 목록 있음) |
| 5 | Event Subscriptions 켜기 → app_mention, message.im, message.channels 추가 |
| 6 | Install to Workspace → Bot 토큰(xoxb-) 발급 → .env의 SLACK_BOT_TOKEN에 저장 |
| 7 | 본인 슬랙 프로필 → 멤버 ID 복사 → .env의 SLACK_ID에 저장 |
클로드-관제탑 채널입니다. 다른 이름을 쓰고 싶으면
~/claude-remote/setup.sh 파일을 열어 DESIRED_CHANNEL_NAME
변수 값을 원하는 이름으로 수정한 뒤 다음 단계를 진행하세요.
.env에 토큰 3개(SLACK_BOT_TOKEN, SLACK_APP_TOKEN, SLACK_ID)를 채웠다면
아래를 실행하세요.
cd ~/claude-remote && ./setup.sh토큰 검증, 알림 채널 생성, 대시보드 배포(Cloudflare 로그인이 되어 있다면), 브리지 서비스 기동까지 전부 자동으로 처리되고 단계마다 한국어로 진행 상황을 보여줍니다. 실패하면 원인과 다음 조치가 함께 출력됩니다.
| 입력 | 동작 | 권한 |
|---|---|---|
| 배포 알림 스레드에 답글 | 해당 프로젝트에서 즉시 수정 작업 실행 | 관리자·허용된 팀원 |
신규 이름 지시문 | ~/이름 폴더 생성 + 스레드 개설 + 개발 시작 | 관리자 |
현황 | 진행 중인 작업 목록 확인 | 모두 |
사용량 | Claude 사용량 5시간·주간 한도 확인 (본인 계정 기준) | 관리자 |
메뉴 / 기능 | 권한별 맞춤 사용법 안내 | 모두 |
예약 21:30 지시문 | 예약 작업 등록 (예약목록·예약취소 N으로 관리) | 관리자·팀원 |
권한 @멘션 프로젝트… | 팀원별 프로젝트 접근 권한 관리 | 관리자 |
스레드에 전체삭제 → 삭제확인 | 폴더를 휴지통으로 이동(복구 가능) + 장부 제거 | 관리자 |
배포하면 자동으로 알림이 오고, 그 스레드에 답장하면 바로 후속 작업이 실행됩니다 — 대부분의 경우 위 명령을 외울 필요 없이 그냥 배포하고 답장만 하면 됩니다.
클대리는 각자의 맥에서 각자의 Claude Code 로그인 세션으로 claude -p를
실행합니다. 즉 사용량 명령이 보여주는 5시간·주간 한도는 클대리를
설치한 본인 계정의 한도입니다. 다른 사람의 사용량에 영향을 주지 않고, 다른
사람도 내 사용량에 영향을 주지 않습니다.
슬랙 앱(봇 토큰)은 특정 맥의 특정 claude-remote 프로세스 하나에 연결되어
있습니다. 여러 사람이 같은 앱/토큰을 공유하면 지시가 어느 컴퓨터로 갈지 알 수 없고,
한 사람의 헤드리스 작업이 다른 사람의 Claude 사용량 한도를 갉아먹게 됩니다. 각자
설치·각자 슬랙 앱 생성이 원칙입니다 — 이 가이드의 2단계에서 앱 이름에 본인 이름을
넣도록 권장하는 이유도 이 때문입니다.
대시보드(웹에서 전체 프로젝트 배포 현황 보기)만 못 씁니다. 슬랙 알림, 스레드 답장으로 후속 작업 지시하기 등 핵심 기능은 Cloudflare 없이도 전부 동작합니다.
launchctl unload ~/Library/LaunchAgents/kr.onoffer.claude-bridge.plist로
서비스를 내린 뒤, ~/claude-remote 폴더를 삭제하면 됩니다. Claude Code
훅은 ~/.claude/settings.json의 hooks.PostToolUse 항목에서
deploy-hook.sh를 가리키는 항목을 지우면 됩니다(자세한 내용은
README.md의 "완전히 되돌리기" 섹션 참고).
이미 ~/claude-remote가 있으면 그 폴더를 통째로
claude-remote.bak.<시각>으로 안전하게 백업만 하고 설치를 중단합니다
(실수로 기존 설정을 덮어쓰지 않기 위함). 백업 폴더에서 .env 등 필요한
값을 새 설치 폴더로 옮긴 뒤 다시 ./setup.sh를 실행하면 됩니다.