UStackUStack
claude-share icon

claude-share

claude-share è una CLI per macOS e Linux che condivide l’abbonamento a Claude Code con un link di pairing, senza rivelare il token e revoca subito l’accesso.

claude-share

Cos'è claude-share?

claude-share è una piccola interfaccia a riga di comando (CLI) che ti permette di condividere l'accesso all'abbonamento Claude Code con gli amici tramite un link di pairing. È progettata in modo che la macchina ricevente non ottenga il tuo token di accesso Claude, e tu possa revocare l'accesso istantaneamente.

Il flusso di lavoro è diviso in due parti: la macchina condividente esegue il proxy claude-share, e l'amico si connette usando claude-connect con il link di pairing generato.

Caratteristiche Principali

  • Installazione con un comando: Installa la CLI globalmente con npm install -g @0xpv/claude-share, per un uso rapido locale su macOS e Linux.
  • Condivisione via link di pairing: Genera un link di pairing da inviare a un amico, che stabilisce una connessione temporanea salvata sul suo lato.
  • Token non rivelato all'amico: L'architettura instrada il traffico CLI Claude attraverso la macchina condividente e inietta il token bearer API Claude lato server, così la macchina ricevente non riceve un token di accesso.
  • Revoca istantanea fermando il condividente: Chiudendo la CLI si spegne il proxy locale e si disconnette immediatamente chiunque.
  • Instradamento di rete via proxy/tunnel (con note sulla modalità): Di default funziona al meglio su LAN; menziona anche una modalità pubblica sperimentale usando bore.pub per amici remoti.

Come Usare claude-share

  1. Installa claude-share sulla macchina che condividerà l'accesso: npm install -g @0xpv/claude-share
  2. Esegui la CLI per generare un link di pairing e condividi quel link con il tuo amico.
  3. Fai connettere il tuo amico eseguendo claude-connect, quindi inserendo il link di pairing per stabilire la sessione.
  4. Mantieni la macchina condividente disponibile: devi tenere la macchina sveglia durante la condivisione perché la CLI esegue un proxy locale.

Casi d'Uso

  • Uso side-by-side di Claude Code su un progetto condiviso: Team o coppie possono usare lo stesso abbonamento Claude Code per sessioni di collaborazione brevi connettendo ogni amico tramite un link di pairing.
  • Concessione temporanea di accesso per onboarding: Puoi condividere l'accesso mentre un amico impara o valida un flusso di lavoro, poi revocarlo chiudendo la CLI.
  • Condivisione basata su LAN per setup dev remoti: Quando entrambe le macchine sono sulla stessa rete locale, claude-share funziona al meglio.
  • Accesso remoto per collaboratori fidati (sperimentale): Se il tuo amico non è sulla stessa LAN, puoi usare la modalità pubblica sperimentale via bore.pub come descritto.
  • Sessioni di accesso controllate: Poiché il proxy è legato al processo in esecuzione della macchina condividente, puoi fermare la condivisione in qualsiasi momento per disconnettere immediatamente.

FAQ

  • Il mio amico riceve il mio token di accesso Claude? No. L'architettura descritta instrada il traffico alla macchina condividente e inietta il token bearer lato server, mentre la macchina dell'amico non riceve un token di accesso.

  • Cosa succede se la macchina condividente va in sonno o la CLI si ferma? Gli amici vengono disconnessi immediatamente se la macchina va in sonno o il processo termina, poiché la CLI esegue un proxy locale.

  • Posso revocare l'accesso senza riconfigurare nulla? Sì. Chiudendo la CLI si spegne il proxy e si disconnette immediatamente chiunque.

  • Funziona su internet? Funziona al meglio su LAN, ed è disponibile una modalità pubblica sperimentale via bore.pub per amici remoti.

  • È sicuro usarlo con chiunque? No. Il progetto avverte esplicitamente di condividerlo solo con persone di cui ti fidi completamente, perché il proxy della macchina condividente può intercettare le chat di Claude Code per design.

Alternative

  • Usa abbonamenti/account separati per utente: Invece di instradare e condividere l'accesso, ogni utente accede con il proprio abbonamento per evitare problemi di gestione token e preoccupazioni di fiducia.
  • Altri approcci proxy basati su CLI: Per sviluppatori a proprio agio con setup di rete, potresti cercare tool che inoltrano o proxyfizzano il traffico API localmente; questi differiscono tipicamente per come gestiscono le credenziali e quale porzione di traffico possono osservare.
  • Accesso team via gestione account ufficiale (se disponibile): Dove disponibile, usare un meccanismo ufficiale di condivisione o accesso team (invece di un proxy custom) può ridurre il rischio operativo rispetto a eseguire un proxy locale che intercetta le chat.