UStackUStack
claude-share icon

claude-share

claude-share é um CLI pequeno para macOS e Linux que compartilha sua assinatura do Claude Code via link de pareamento, sem token, e revoga acesso.

claude-share

O que é claude-share?

claude-share é um pequeno CLI (interface de linha de comando) que permite compartilhar o acesso à sua assinatura do Claude Code com amigos por meio de um link de pareamento. Ele é projetado para que a máquina receptora não receba seu token de acesso do Claude, e você possa revogar o acesso instantaneamente.

O fluxo de trabalho é dividido em duas partes: a máquina compartilhadora executa o proxy claude-share, e o amigo se conecta usando claude-connect com o link de pareamento gerado.

Principais Recursos

  • Configuração com um comando: Instale o CLI globalmente com npm install -g @0xpv/claude-share, para uso rápido local no macOS e Linux.
  • Compartilhamento por link de pareamento: Gere um link de pareamento para enviar a um amigo, que estabelece uma conexão temporária salva no lado dele.
  • Token não revelado ao amigo: A arquitetura faz proxy do tráfego do Claude CLI pela máquina compartilhadora e injeta o token bearer da API do Claude no lado do servidor, para que a máquina receptora não receba um token de acesso.
  • Revogação instantânea ao parar o compartilhador: Fechar o CLI desliga o proxy local e desconecta todos imediatamente.
  • Roteamento de rede via proxy/túnel (com notas sobre o modo): Por padrão, funciona melhor em uma LAN; também menciona um modo público experimental usando bore.pub para amigos remotos.

Como Usar claude-share

  1. Instale claude-share na máquina que compartilhará o acesso: npm install -g @0xpv/claude-share
  2. Execute o CLI para gerar um link de pareamento e compartilhe esse link com seu amigo.
  3. Peça ao seu amigo para se conectar executando claude-connect e inserindo o link de pareamento para estabelecer a sessão.
  4. Mantenha a máquina compartilhadora disponível: você precisa manter a máquina acordada durante o compartilhamento, pois o CLI executa um proxy local.

Casos de Uso

  • Uso lado a lado do Claude Code em um projeto compartilhado: Equipes ou pares podem usar a mesma assinatura do Claude Code para sessões curtas de colaboração, conectando cada amigo por um link de pareamento.
  • Concessão temporária de acesso para onboarding: Você pode compartilhar acesso enquanto um amigo aprende ou valida um fluxo de trabalho, depois revogá-lo fechando o CLI.
  • Compartilhamento baseado em LAN para setups de dev remotos: Quando ambas as máquinas estão na mesma rede local, claude-share funciona melhor.
  • Acesso remoto para colaboradores confiáveis (experimental): Se seu amigo não estiver na mesma LAN, você pode usar o modo público experimental via bore.pub, como descrito.
  • Sessões de acesso controladas: Como o proxy está vinculado ao processo em execução da máquina compartilhadora, você pode parar o compartilhamento a qualquer momento para desconectar imediatamente.

FAQ

  • Meu amigo recebe meu token de acesso do Claude? Não. A arquitetura descrita faz proxy do tráfego para a máquina compartilhadora e injeta o token bearer no lado do servidor, enquanto a máquina do amigo não recebe um token de acesso.

  • O que acontece se a máquina compartilhadora hibernar ou o CLI parar? Os amigos são desconectados imediatamente se a máquina hibernar ou o processo sair, pois o CLI executa um proxy local.

  • Posso revogar o acesso sem reconfigurar nada? Sim. Fechar o CLI desliga o proxy e desconecta todos instantaneamente.

  • Funciona pela internet? Funciona melhor em uma LAN, e um modo público experimental está disponível via bore.pub para amigos remotos.

  • É seguro usar com qualquer pessoa? Não. O projeto alerta explicitamente para compartilhar apenas com pessoas em quem você confia totalmente, pois o proxy da máquina compartilhadora pode interceptar chats do Claude Code por design.

Alternativas

  • Usar assinaturas/contas separadas por usuário: Em vez de proxy e compartilhamento de acesso, cada usuário faz login com sua própria assinatura para evitar preocupações com manipulação de tokens e confiança.
  • Outras abordagens de proxy baseadas em CLI: Para desenvolvedores confortáveis com setups de rede, você pode procurar ferramentas que encaminhem ou façam proxy de tráfego de API localmente; elas geralmente diferem pela forma como lidam com credenciais e que porção de tráfego podem observar.
  • Acesso de equipe via gerenciamento oficial de contas (se disponível): Onde disponível, usar um mecanismo oficial de compartilhamento ou acesso de equipe (em vez de um proxy personalizado) pode reduzir riscos operacionais em comparação a executar um proxy local que intercepta chats.