讓另一台電腦上的 Claude Code 和 Codex,出現在同一個 console 裡。
伺服器端不需要任何設定——同一組 token 就能用,session 之間不會互相干擾。 要做的事全在新機器上,大約五分鐘。
| Bun | curl -fsSL https://bun.sh/install | bashbridge 跑在它上面。裝完記得開一個新的 shell,讓 PATH 生效。 |
|---|---|
| Claude Code | 已經裝好而且能跑 claude。 |
| 網路 | 那台機器連得到這個 console 的網址。 |
約 75 KB。裡面是外掛、Codex 的 bridge、幾個工具腳本和安裝腳本,不含相依套件——那些由安裝腳本現場抓。
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>
在已經能用的那台機器上執行:
grep CONSOLE_TOKEN ~/.claude/channels/remote/.env
grep CONSOLE_UI_TOKEN ~/.claude/channels/remote/ui.env # 選用
第二個只有 examples/ 底下那些工具(orch.ts、watch-continue.ts)會用到,
純粹要讓 session 出現在 console 上的話不需要。
已經在跑的 session 不會自己載入外掛,要新開一個。
然後在裡面說點什麼——完全沒有對話內容的 session 不會登記到 console。 這是刻意的:Claude Code 會預先養一池待命行程,不擋掉的話側邊欄會冒出一堆空白的列。
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
/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/ 刪掉。 |