명령어 문서
Mac에 작은 브릿지를 띄워 Claude 세션을 웹앱에 연결합니다. 명령은 딱 하나 — decku (설치 없이 npx @decku/cli) 만 실행하면 처음엔 자동으로 페어링하고 바로 중계를 시작합니다.
빠른 시작
# 설치 없이 바로 (필요 시 자동 페어링 → QR 출력 → watch)
npx @decku/cli
# 또는 전역 설치 후 decku 한 줄
npm i -g @decku/cli
deckuNode 20+ 필요. 처음 실행하면 QR이 뜨고, 폰·브라우저로 한 번 스캔하면 연결됩니다. 이후엔 페어링이 저장돼 decku 만으로 재연결돼요.
decku (= decku run)
기본 명령입니다. 페어링이 없으면 자동으로 페어링(QR 출력)한 뒤, Claude 세션을 감시(watch)하고 목록·대화를 E2EE로 암호화해 실시간 중계합니다.
decku # 페어링(필요 시) + watch + 중계
decku run <sessionId> # 특정 세션만
decku --from-start # 처음부터 전체 기록 백필 (-a 와 동일)
decku --console # 중계 없이 로컬 콘솔에서 목록·tail만<sessionId> | 특정 세션 ID만 대상으로. 생략 시 모든 세션. |
--from-start, -a | 세션 시작부터 전체 transcript를 백필. 기본은 최근 위주. |
--console | 중계·페어링 없이 로컬에서만 목록·실시간 tail 확인 (디버그용). |
목록이 비어 있으면 그 Mac에 claude CLI와 실제 Claude 세션이 있는지 확인하세요.
decku pair
첫 페어링은 decku 실행 시 자동으로 되므로 보통 직접 칠 일은 없습니다. 재페어링하거나 QR을 다시 보고 싶을 때 사용해요.
decku pair # 저장된 페어링 재사용 + QR 다시 출력
decku pair --new # 기존 페어링 버리고 새 namespace 발급
decku pair --new --expire-days 7 # 7일 후 만료되는 페어링
decku pair --url <webUrl> # 다른 웹 주소로 페어링--new | 저장된 페어링을 무시하고 새 namespace·키를 발급. 기존 기기 연결은 끊깁니다. |
--expire-days <N> | N일 후 만료되는 페어링(--new와 함께). 만료되면 재연결 불가 → 다시 페어링. 기본은 무제한(상시 실행이 끊기지 않도록). |
--url <webUrl> | 연결할 웹앱 주소. 생략 시 https://decku.app (환경변수 DECKU_URL 로도 지정 가능). |
decku install / uninstall
macOS launchd에 등록해 로그인할 때 브릿지가 자동 실행되게 합니다. 매번 터미널을 열 필요가 없어요.
decku install # 로그인 시 자동 시작 등록 (먼저 pair 필요)
decku uninstall # 자동 시작 해제전역 설치(npm i -g @decku/cli) 후 사용하길 권장합니다. install 전에 decku pair 로 페어링이 되어 있어야 합니다.
환경변수
DECKU_URL | pair 기본 웹 주소를 덮어씁니다. --url 플래그가 우선. |
막히는 부분은 FAQ 를 확인하세요.