UStackUStack
claude-share icon

claude-share

claude-share 是 macOS 和 Linux 上的轻量 CLI,通过配对链接与朋友共享 Claude Code 订阅,且不泄露访问令牌,可随时撤销。

claude-share

claude-share 是什么?

claude-share 是一个小型命令行界面 (CLI),让您通过配对链接与朋友共享 Claude Code 订阅访问权限。它设计为接收机器不会获取您的 Claude 访问令牌,且您可以立即撤销访问。

工作流程分为两部分:共享机器运行 claude-share 代理,朋友使用生成的配对链接通过 claude-connect 连接。

主要特性

  • 一键安装:使用 npm install -g @0xpv/claude-share 全局安装 CLI,适用于 macOS 和 Linux 的快速本地使用。
  • 配对链接共享:生成配对链接发送给朋友,在其端建立临时保存的连接。
  • 不向朋友泄露令牌:架构通过共享机器代理 Claude CLI 流量,并在服务器端注入 Claude API bearer token,因此接收机器不会收到访问令牌。
  • 停止共享即立即撤销:退出 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 即可撤销。
  • 远程开发环境的局域网共享:两台机器在同一本地网络时,claude-share 效果最佳。
  • 可信协作者的远程访问(实验性):如果朋友不在同一 LAN,可使用描述中的 bore.pub 实验性公网模式。
  • 受控访问会话:代理绑定共享机器的运行进程,可随时停止共享立即断开连接。

常见问题

  • 朋友会收到我的 Claude 访问令牌吗?
    不会。所述架构将流量代理到共享机器,并在服务器端注入 bearer token,而朋友的机器不会收到访问令牌。

  • 共享机器休眠或 CLI 停止会怎样?
    机器休眠或进程退出时,朋友会立即断开连接,因为 CLI 运行本地代理。

  • 能否无需重新配置即可撤销访问?
    可以。退出 CLI 会关闭代理并立即断开所有连接。

  • 支持互联网使用吗?
    在局域网 (LAN) 效果最佳,可通过 bore.pub 的实验性公网模式支持远程朋友。

  • 对任何人使用都安全吗?
    不安全。项目明确警告仅与完全信任的人共享,因为共享机器的代理按设计可拦截 Claude Code 聊天。

替代方案

  • 每用户使用独立订阅/账户:不代理共享访问,每个用户使用自己的订阅登录,避免令牌处理和信任问题。
  • 其他基于 CLI 的代理方法:对网络设置熟悉的开发者,可寻找本地转发或代理 API 流量的工具;这些通常在凭证处理和可观察流量部分有所不同。
  • 官方账户管理下的团队访问(如果可用):如有可用,使用官方共享或团队访问机制(而非自定义代理)可降低运行拦截聊天的本地代理带来的操作风险。