把新機器接上 Remote Console

讓另一台電腦上的 Claude Code 和 Codex,出現在同一個 console 裡。

伺服器端不需要任何設定——同一組 token 就能用,session 之間不會互相干擾。 要做的事全在新機器上,大約五分鐘。

需要先有的東西

Buncurl -fsSL https://bun.sh/install | bash
bridge 跑在它上面。裝完記得開一個新的 shell,讓 PATH 生效。
Claude Code已經裝好而且能跑 claude。
網路那台機器連得到這個 console 的網址。

安裝

  1. 下載安裝包

    下載 remote-console-bridge.tgz

    約 75 KB。裡面是外掛、Codex 的 bridge、幾個工具腳本和安裝腳本,不含相依套件——那些由安裝腳本現場抓。

  2. 解開並執行

    tar xzf remote-console-bridge.tgz
    bash install.sh

    它會問你 console 網址和 bridge token,其餘自動處理:檢查環境、安裝相依、 註冊 marketplace、啟用外掛、寫入認證檔(權限 600)。

    想先看它會做什麼而不動到設定:

    bash install.sh --dry-run

    非互動式:

    bash install.sh --url https://你的console --token <bridge token>
  3. token 去哪裡拿

    在已經能用的那台機器上執行:

    grep CONSOLE_TOKEN    ~/.claude/channels/remote/.env
    grep CONSOLE_UI_TOKEN ~/.claude/channels/remote/ui.env   # 選用

    第二個只有 examples/ 底下那些工具(orch.ts、watch-continue.ts)會用到, 純粹要讓 session 出現在 console 上的話不需要。

    這一頁沒有放 token,也不會放。它是公開的——不需要登入就能讀, 所以任何秘密都不該出現在這裡。
  4. 開一個新的 session,然後講一句話

    已經在跑的 session 不會自己載入外掛,要新開一個。

    然後在裡面說點什麼——完全沒有對話內容的 session 不會登記到 console。 這是刻意的:Claude Code 會預先養一池待命行程,不擋掉的話側邊欄會冒出一堆空白的列。

Codex

Codex 不走外掛,走一個獨立的 bridge。在同一台機器上:

codex app-server --listen ws://127.0.0.1:8123 &
bun ~/remote-console-bridge/codex/bridge.ts &

之後 codex 要用 --remote 啟動,它的 thread 才會交給 app-server 管理、bridge 才看得見:

codex --remote ws://127.0.0.1:8123
Codex 的 session 在 console 上會另外分一區顯示,顏色也不同。 幾個行為跟 Claude Code 不一樣(例如 /exit 之後仍然顯示在線), 細節見安裝包裡的 codex/README.md。

裝完不動怎麼辦

session 沒出現 先確認你在裡面講過話了。還是沒有的話,直接問那個 session 「console 連上了嗎」——外掛會回報設定路徑、連線狀態和鏡像進度。
出現但一直離線 多半是網址或 token 錯了。檢查 ~/.claude/channels/remote/.env, CONSOLE_URL 結尾應該是 /ws/bridge。
claude plugin 說找不到 marketplace 手動跑一次 claude plugin marketplace add ~/remote-console-bridge, 那個目錄底下要有 .claude-plugin/marketplace.json。
想整個移除 claude plugin disable remote@remote-console,再把 ~/remote-console-bridge 和 ~/.claude/channels/remote/ 刪掉。