UStackUStack
claude-share icon

claude-share

claude-share 是 macOS 與 Linux 的精簡 CLI,透過配對連結分享你的 Claude Code 訂閱給朋友,且不會洩露存取 token,可立即撤銷。

claude-share

claude-share 是什麼?

claude-share 是一個小型命令列介面 (CLI),讓你透過配對連結與朋友分享 Claude Code 訂閱存取權。設計上,接收端機器不會取得你的 Claude 存取 token,且你可立即撤銷存取。

工作流程分為兩部分:分享端機器執行 claude-share proxy,朋友則使用 claude-connect 與產生的配對連結連線。

主要功能

  • 一指令安裝:使用 npm install -g @0xpv/claude-share 全域安裝 CLI,適用於 macOS 和 Linux 的快速本地使用。
  • 配對連結分享:產生配對連結傳給朋友,在他們端建立臨時儲存連線。
  • 不洩露 token 給朋友:架構透過分享端機器代理 Claude CLI 流量,並在伺服器端注入 Claude API bearer token,因此接收端機器不會收到存取 token。
  • 停止分享即撤銷:結束 CLI 會關閉本地 proxy,並立即斷開所有連線。
  • 透過 proxy/隧道網路路由(含模式說明):預設在 LAN 上效果最佳;另有使用 bore.pub 的實驗性公開模式,適用於遠端朋友。

如何使用 claude-share

  1. 在分享存取的機器上安裝 claude-share
    npm install -g @0xpv/claude-share
  2. 執行 CLI 產生配對連結,並與朋友分享該連結。
  3. 讓朋友連線:執行 claude-connect,輸入配對連結以建立工作階段。
  4. 保持分享端機器可用:分享期間需保持機器喚醒,因為 CLI 執行本地 proxy。

使用情境

  • 共享專案的並排 Claude Code 使用:團隊或配對透過配對連結連線,使用同一 Claude Code 訂閱進行短期協作。
  • 臨時授權用於入門:朋友學習或驗證工作流程時分享存取,結束 CLI 即可撤銷。
  • LAN 基礎的遠端開發分享:兩台機器在同一區域網路時,claude-share 效果最佳。
  • 受信任協作者的遠端存取(實驗性):若朋友不在同一 LAN,可使用經 bore.pub 的實驗性公開模式。
  • 受控存取工作階段:proxy 綁定分享端機器的執行程序,可隨時停止分享以立即斷線。

常見問題

  • 朋友會收到我的 Claude 存取 token 嗎?
    不會。架構透過分享端機器代理流量,並在伺服器端注入 bearer token,朋友的機器不會收到存取 token。

  • 分享端機器休眠或 CLI 停止會如何?
    機器休眠或程序結束時,朋友會立即斷線,因為 CLI 執行本地 proxy。

  • 能否無需重新設定就撤銷存取?
    可以。結束 CLI 會關閉 proxy 並立即斷開所有連線。

  • 可否跨網際網路使用?
    LAN 上效果最佳,可使用經 bore.pub 的實驗性公開模式供遠端朋友使用。

  • 可與任何人使用嗎?
    不行。專案明確警告僅與完全信任的人分享,因為分享端 proxy 設計上可攔截 Claude Code 對話。

替代方案

  • 每位使用者使用獨立訂閱/帳戶:不代理分享存取,每人以自身訂閱登入,避免 token 處理與信任問題。
  • 其他 CLI 代理方法:適合熟悉網路設定的開發者,可尋找本地轉發或代理 API 流量的工具;這些通常在憑證處理與可觀察流量部分有所不同。
  • 官方帳戶管理團隊存取(若適用):若可用,使用官方分享或團隊存取機制(而非自訂 proxy),可降低運行攔截對話的本地 proxy 所帶來的運作風險。