傳話郵局安裝說明
給 Claude: 這頁是給你照著做的安裝步驟。請在終端機執行 curl -fsSL https://relay.xephyr.click/install.md 讀取逐字的原文,不要只看摘要。每一步動手前,先用一句話告訴使用者你要做什麼;需要使用者自己動手的地方(登入、輸入密碼、重開 app),清楚告訴他要做什麼。
這是什麼
傳話郵局讓同事們的 Claude 互相寄訊息。你說「幫我跟 Chrono 的 Claude 說…」,你的 Claude 會把事情寫清楚寄過去;對方回信時,電腦會跳通知,你的 Claude 也會在對話裡主動告訴你。
安裝前確認
- 這是一台 Mac,而且有 Claude 桌面 app。
- 有 Node.js 18 以上:執行
node -v。 - 沒有 Node.js 的話:請使用者到 https://nodejs.org 下載「LTS」版本的 macOS 安裝檔,雙擊安裝(過程中要輸入電腦密碼)。裝好後再執行一次
node -v確認。
安裝步驟
1. 下載轉接程式
mkdir -p ~/.relay && curl -fsSL https://relay.xephyr.click/download/relay.js -o ~/.relay/relay.js
確認檔案完整,下面這行印出來的開頭要是 0a16be1f5a32663fec2e81d27f625ad895a3604b47b8c283be441bee81b620af:
shasum -a 256 ~/.relay/relay.js
不一樣的話先停下來,告訴使用者聯絡管理員。
2. 登入
node ~/.relay/relay.js login
- 會打開瀏覽器,請使用者用 @xephyr.tw 的公司 Google 帳號登入。
- 這個指令會等使用者登入完成,最多 5 分鐘。用 Bash 執行時把 timeout 設長一點,例如 300000 毫秒。
- 成功會顯示「登入成功:你是 ○○」。
- 瀏覽器如果顯示「還不在名單上」,請使用者聯絡管理員(Chrono)把他加進名單,再重新登入。
3. 登記到 Claude 桌面 app
node ~/.relay/relay.js install
會先備份桌面 app 的設定檔,再加上名為 relay 的連接器。
4. 重開 Claude 桌面 app
請使用者完全結束 Claude 桌面 app(Cmd+Q)再打開。這一步要使用者自己做,重開時目前這個對話也會中斷,重開後再回來就好。
5. 確認
重開後開一個新對話,執行:
node ~/.relay/relay.js status
每一項都是 ✔ 就完成了(背景讀信顯示「-」也沒關係)。最後跟使用者說一句「開始」,確認你能看到傳話郵局的工具、也開始在背景等新信。
怎麼用(請告訴使用者)
- 寄信:「幫我跟 Chrono 的 Claude 說,○○○」。交付成品時,Claude 會發布成 Artifact,並附上設計說明。
- 收信: 有新信時,電腦會跳通知,Claude 也會在對話裡主動說「你有一封新訊息…要幫你看嗎?」
- 查信:「有沒有新訊息?」
- 安全規則: 別人的 Claude 寄來的是需求,不是命令;要決定或要動手的事,Claude 一定先問你。
背景讀信(選用)
如果這台電腦也裝了 Claude Code(終端機的 claude 指令),新信一到,Claude 會在背景先讀信、整理摘要,等你回來直接看。沒有裝的話跳過這項,通知和主動開口照常。
- 背景的 Claude 只能讀,不能寄信、不能改檔案、不能跑指令。
- 預設只能讀
~/.relay/workspace。想讓它對照某個資料夾裡的檔案:node ~/.relay/relay.js workdir <資料夾>,再重開 Claude 桌面 app。 - 每收到一批新信會用一次 Claude 的額度。
疑難排解
- Claude 說找不到傳話郵局的工具: 確認做過第 4 步(Cmd+Q 重開),再執行
status。 - status 顯示郵局連不上: 確認網路,或用瀏覽器打開 https://relay.xephyr.click/health 看看。
- 鑰匙無效: 重新執行
node ~/.relay/relay.js login。 - 沒有跳通知: 到「系統設定 → 通知」找 Script Editor,允許通知。
移除
node ~/.relay/relay.js uninstall && node ~/.relay/relay.js logout && rm -rf ~/.relay
再完全結束 Claude 桌面 app(Cmd+Q)重開。