claude-share

claude-share란?

claude-share는 페어링 링크를 통해 친구와 Claude Code 구독 액세스를 공유할 수 있는 작은 명령줄 인터페이스(CLI)입니다. 수신 측 머신에 Claude 액세스 토큰이 전달되지 않도록 설계되었으며, 액세스를 즉시 취소할 수 있습니다.

워크플로는 두 부분으로 나뉩니다: 공유 머신에서 claude-share 프록시를 실행하고, 친구가 생성된 페어링 링크로 claude-connect를 사용해 연결합니다.

주요 기능

• 한 명령 설치: macOS와 Linux에서 빠른 로컬 사용을 위해 npm install -g @0xpv/claude-share로 CLI를 전역 설치.
• 페어링 링크 공유: 친구에게 보낼 페어링 링크를 생성해 상대방 측에 임시 저장 연결을 설정.
• 친구에게 토큰 노출 안 함: 아키텍처가 공유 머신을 통해 Claude CLI 트래픽을 프록시하고 서버 측에서 Claude API bearer 토큰을 주입하므로, 수신 머신은 액세스 토큰을 받지 않음.
• 공유자 중지로 즉시 취소: CLI 종료 시 로컬 프록시가 꺼지고 모든 연결이 즉시 끊어짐.
• 프록시/터널 네트워크 라우팅(모드 노트 포함): 기본적으로 LAN에서 최적 작동; 원격 친구를 위한 bore.pub 실험적 공개 모드 언급.

claude-share 사용법

1. 액세스 공유 머신에 claude-share 설치: npm install -g @0xpv/claude-share
2. CLI 실행으로 페어링 링크 생성하고 친구와 공유.
3. 친구가 claude-connect 실행 후 페어링 링크 입력으로 세션 연결.
4. 공유 머신 유지: CLI가 로컬 프록시를 실행하므로 공유 중 머신을 깨워둠.

사용 사례

• 공유 프로젝트에서 병렬 Claude Code 사용: 팀이나 페어가 페어링 링크로 각 친구 연결해 짧은 협업 세션에서 동일 Claude Code 구독 사용.
• 온보딩을 위한 임시 액세스 부여: 친구가 워크플로 학습/검증 중 액세스 공유 후 CLI 종료로 취소.
• 원격 개발 설정을 위한 LAN 기반 공유: 동일 로컬 네트워크 머신 간 claude-share가 최적 작동.
• 신뢰 협력자를 위한 원격 액세스(실험적): 동일 LAN이 아닌 경우 bore.pub를 통한 실험적 공개 모드 사용.
• 제어된 액세스 세션: 프록시가 공유 머신 프로세스에 묶여 언제든 중지로 즉시 연결 끊기.

자주 묻는 질문

• 친구가 내 Claude 액세스 토큰을 받나요? 아니요. 아키텍처가 트래픽을 공유 머신으로 프록시하고 서버 측에서 bearer 토큰 주입하므로 친구 머신은 액세스 토큰을 받지 않음.

• 공유 머신이 절전되거나 CLI가 중지되면? 머신 절전이나 프로세스 종료 시 친구 연결이 즉시 끊어지며, CLI가 로컬 프록시 실행 때문.

• 재설정 없이 액세스 취소 가능? 네. CLI 종료로 프록시 중지하고 모든 연결 즉시 끊음.

• 인터넷으로 작동하나요? LAN에서 최적이며, 원격 친구를 위한 bore.pub 실험적 공개 모드 사용 가능.

• 누구와나 안전하게 사용하나요? 아니요. 프로젝트가 설계상 공유 머신 프록시가 Claude Code 채팅 가로챌 수 있으므로 완전히 신뢰하는 사람과만 공유하라는 경고 명시.

대안

• 사용자별 개별 구독/계정 사용: 프록시와 공유 대신 각 사용자 고유 구독으로 로그인해 토큰 처리 및 신뢰 문제 회피.
• 기타 CLI 기반 프록시 접근: 네트워킹에 익숙한 개발자를 위해 로컬 API 트래픽 포워딩/프록시 도구 탐색; 자격 증명 처리와 관찰 트래픽 범위로 차이.
• 공식 계정 관리로 팀 액세스(사용 가능 시): 로컬 프록시 실행 대신 공식 공유/팀 액세스 메커니즘 사용으로 채팅 가로채기 운영 위험 감소.