자주 묻는 질문

Mac에서 돌아가는 Claude 세션을 폰·브라우저에서 실시간으로 보고, 그 자리에서 이어 대화하는 도구예요. Mac에 작은 브릿지(decku)를 띄우고, QR로 한 번 페어링하면 끝입니다.

대화는 종단간 암호화(E2EE)로 중계됩니다. 암호화 키는 QR 안에만 들어 있고 서버로는 전송되지 않아요. 중계 서버(Supabase)를 지나는 건 복호화 불가능한 암호문뿐이라, 운영자도 내용을 볼 수 없습니다.

계정 대신 페어링 namespace 자체가 자격증명입니다. QR을 가진 기기만 그 세션에 접근할 수 있어요. 로그인 단계가 없어 빠르지만, QR(특히 그 안의 키)은 본인 기기에서만 열어야 합니다.

아니요. Node만 있으면 설치 없이 npx @decku/cli 로 바로 됩니다 — 처음 실행하면 자동으로 페어링 QR이 떠요. 자주 쓴다면 npm i -g @decku/cli 로 전역 설치하면 decku 한 줄로 실행할 수 있어요.

decku 자체는 무료입니다. Claude 사용료는 별개로, 기존에 쓰던 Claude 구독/요금 그대로예요.

Mac에서 브릿지(decku)가 떠 있는지 먼저 확인하세요. 그리고 그 Mac에 claude CLI와 실제 Claude 세션이 있어야 목록에 나옵니다. 브릿지는 그 머신의 세션을 읽어 중계하는 구조라, 세션이 없으면 목록도 비어 있어요.

이전에 로컬 빌드로 설치한 흔적이 남아 충돌하는 경우예요. npm rm -g @decku/cli (또는 옛 이름 @decku/bridge) 후 rm -f /opt/homebrew/bin/decku 로 잔여 파일을 지우고 다시 설치하세요. 급하면 npm i -g @decku/cli --force 로 덮어써도 됩니다.

사내 방화벽이 registry.npmjs.org를 막은 경우가 많아요. 사내 프록시/미러를 IT에 확인하거나(npm config set registry <사내미러>), 개인 핫스팟 같은 다른 망에서 한 번 설치하면 이후엔 그 망 없이도 decku가 실행됩니다.

네. 웹 헤더의 📱 폰 추가 버튼으로 현재 페어링을 QR로 띄우고, 다른 기기 카메라로 찍으면 같은 세션을 함께 볼 수 있어요. 같은 namespace·같은 키를 공유하므로 본인 기기끼리만 하세요.

웹 헤더의 해제 버튼을 누르면 이 기기에 저장된 페어링 정보가 지워집니다. 새로 시작하려면 Mac에서 decku pair --new 로 새 페어링을 만드세요.