核心功能

一個遙控器，指揮你所有代理

在 CLI / headless 代理生態之上，加上一層統一的遠端閘道——工作階段、串流、權限與命令全部正規化為單一協定。

svg-connect

反向連線，不需公網 IP

電腦上的轉接器只會主動對外連線——不需公網 IP、連接埠對應或通道。任何防火牆或公司網路都能運作。

svg-agents

多個代理，一台電腦

同時執行 opencode、Claude Code、Codex 等多個代理。各自獨立配對與連線；在手機上隨時切換，甚至能讓不同代理比較同一項任務。

svg-approve

在手機上審批高風險操作

在執行 bash 或編輯檔案前，權限請求會即時推送到手機上的卡片——允許 / 拒絕 / 永遠允許，一鍵完成。任何危險操作都不會自動放行。

svg-scan

掃描 QR Code 即可配對

終端機會印出 QR Code 與配對碼。在 tunnelbox App 中選擇「掃描配對」即可立即連線；配對碼為一次性，10 分鐘後失效。

svg-layers

單一協定，後端完全透明

工作階段清單 / 串流輸出 / 權限審批 / 斜線命令全部正規化為單一協定——手機端完全不必知道背後是哪個代理。

svg-lock

隱私優先

中繼只做無狀態轉送，不儲存任何對話內容。傳輸全程 TLS。重視隱私的使用者可自行架設中繼，完全掌握資料。

支援的代理

主流 CLI 代理全數涵蓋

每個代理都對應一個轉接器，將其工作階段 / 串流 / 權限正規化為統一的遠端協定——中繼與手機端完全無感。

代理	轉接器	類型	狀態
O opencode	行程內外掛（@tunnelbox/opencode）	A	✅ MVP · 已實作
DS DeepSeek Harness (dsh)	原生 Cordis 外掛（@tunnelbox/dsh-tunnelbox）	B	✅ 已實作
CC Claude Code	claude-agent-sdk 橋接（獨立行程）	B	✅ 已實作
CX Codex	codex app-server 橋接（獨立行程）	B	✅ 已實作
OW OpenClaw	官方 Gateway operator WS · 閘道 ≥ 2026.6.11	B	✅ 已實作 · 已測試（6.35 / 9.4）
HM Hermes	hermes chat -Q -q oneshot 橋接（含原生外掛）	B	✅ 已實作
CS Cursor	Cursor CLI agent acp（獨立行程）	B	✅ 已實作
CB CodeBuddy	CodeBuddy CLI codebuddy --acp（獨立行程）	B	✅ 已實作
K Kimi Code	Kimi Code CLI kimi acp（獨立行程）	B	✅ 已實作
T TraeCode	TraeCode CLI traecli acp serve（獨立行程）	B	✅ 已實作 · 實驗性 · 待端對端測試
Q Qoder	Qoder CLI qoder --acp（獨立行程）	B	✅ 已實作

A 行程內外掛 · 在代理伺服器行程內執行；B CLI / headless 橋接 · 由獨立連接器行程驅動非互動模式。支援同類型多個執行個體（opencode1 / opencode2…）。

運作原理

反向連線 + 無狀態中繼

為代理生態打造的統一遠端閘道：手機連上中繼，電腦上的轉接器反向連回——訊息雙向流通。

svg-phone

你的手機

Android · iOS App

透過 WSS 連線中繼
瀏覽工作階段與串流輸出
派發任務 / 審批權限

svg-relay

中繼 relay（Go）

雲端伺服器 · 可自行架設

配對 / 驗證 / 轉送
無狀態——不儲存對話
NATS 多節點水平擴充

svg-pc

你的電腦

代理轉接器

主動對外連線（對外 WS）
opencode：行程內外掛
其他：CLI / SDK 橋接

轉接器主動對外連線

反向連線可自然穿透 NAT 與防火牆——公司網路與宿舍環境都能順利運作，不需公網 IP 或通道服務。

中繼只負責轉送

成本低且易於擴充。節點為無狀態、斷線會自動重連；工作階段資料永遠只存在你電腦上的代理本機儲存空間。

配對一次，長期使用

首次掃描後會取得工作階段權杖，之後自動重連。設定 MySQL 後，中繼重新啟動也不需重新配對。

下載

現在就開始

從官方網站下載 tunnelbox App（Android 與 iOS 皆已提供）。掃描 QR Code 或點選下方按鈕。

掃描下載 App

Android · iOS

tunnelbox App

原生行動 App：掃描配對、遠端工作階段、串流輸出、高風險操作審批與推播通知。

下載 Android 版下載 iOS 版

教學

三個步驟配對，立即起飛

所有代理都走同一條路：在電腦安裝轉接器 → 用手機掃描 → 開始。下方安裝手冊提供每個代理的逐步命令——一鍵即可複製。

1

步驟 1 · 在電腦上執行你的代理轉接器

安裝並執行對應代理的轉接器（命令見下方「安裝手冊」）。啟動後，終端機會印出 QR Code + 配對碼。

2

步驟 2 · 在手機安裝並開啟 tunnelbox App

從官方網站下載並安裝 tunnelbox App（Android 與 iOS），然後登入。

3

步驟 3 · 掃描配對

點選「掃描配對」並對準終端機的 QR Code 即可自動連線——也可手動輸入配對碼。配對完成後，代理會出現在首頁清單中。

4

步驟 4 · 開始遠端操作

開啟代理聊天頁面：以分頁切換 / 建立工作階段、傳送提示詞、即時觀看串流輸出、在卡片上審批高風險操作，並可隨時按下「停止」。

各代理安裝手冊

在下方選擇你的代理，逐步照著做——每道命令都有一鍵複製按鈕。

前置條件

建議環境：macOS / Linux / Windows（WSL）
不需另外安裝 Node——opencode 內建 Bun 執行環境，外掛直接在其中執行

安裝 opencode（官方）

先安裝 opencode 本體（macOS / Linux 官方一行指令；Windows 請用 WSL，或 Chocolatey / Scoop）：

# macOS / Linux (official one-line installer)
curl -fsSL https://opencode.ai/install | bash

# Windows (PowerShell): Chocolatey / Scoop / WSL
choco install opencode

安裝後，執行 opencode --version 應會顯示版本號。

安裝步驟

1在 opencode.json 的 plugin 陣列加入 npm 套件（首次啟動時自動安裝）

// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@tunnelbox/opencode"]
}

執行與配對

2重新啟動 opencode（建議加上 --print-logs）；外掛會連上中繼並印出 QR Code 與配對碼。在 opencode 內也可以要求「顯示手機配對碼」，或隨時輸入 /pair，直接在聊天中取得配對碼與可掃描的 QR Code。

opencode serve --print-logs

✅ 當終端機顯示 [tunnelbox] QR Code 時即完成——用手機掃描即可配對。

選用設定與提示

使用官方中繼不需任何設定。若要使用自己的中繼，可設定 TUNNELBOX_RELAY_URL 環境變數，或在 opencode.json 以物件形式傳入 options.relayUrl：

// opencode.json (custom relay)
{
  "plugin": [{ "package": "@tunnelbox/opencode", "options": { "relayUrl": "wss://relay.tunnelbox.top" } }]
}

狀態儲存在 ~/.tunnelbox/remote-state.json（僅有你的代理 ID 與語言）。同一台電腦可執行多個轉接器——各自獨立配對，手機上點一下即可切換。

前置條件

Node.js ≥ 22（tunnelbox 轉接器需要）
付費 Claude 方案（Pro / Max / Team）或 Anthropic Console API key

安裝 Claude Code（官方）

先安裝 Claude Code 本體（官方原生安裝程式——自動更新，不需額外執行環境）：

# macOS / Linux / WSL (official native installer)
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

安裝後，claude --version 應可正常執行；首次啟動請以付費 Claude 帳號登入。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/claude-code

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。手機端不需安裝任何 Claude SDK。

tunnelbox-claude-code

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_CWD=D:/workspace/project \
TUNNELBOX_CLAUDE_MODE=plan \
tunnelbox-claude-code

工具審批預設會推送到你的手機（允許 / 拒絕 / 永遠允許）。斷線或超過 120 秒逾時會自動拒絕（fail-closed）——不會自動放行任何操作。模式：default / plan / acceptEdits / bypassPermissions。

前置條件

Node.js ≥ 22
OpenAI 帳號（ChatGPT Plus / Pro，或平台 API key），且 Codex CLI 需支援 codex app-server 子命令

安裝 Codex CLI（官方）

先安裝 Codex CLI 本體（官方安裝程式或 npm）：

# macOS / Linux (official installer)
curl -fsSL https://chatgpt.com/codex/install.sh | sh

# Windows PowerShell
irm https://chatgpt.com/codex/install.ps1 | iex

# or Node: npm install -g @openai/codex
npm install -g @openai/codex

以 codex --version 確認，接著執行 codex login 登入。轉接器自我檢查：tunnelbox-codex --check（確認 codex app-server 可用）。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/codex

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-codex

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_CODEX_SANDBOX=workspace-write \
tunnelbox-codex

# optional: TUNNELBOX_CODEX_APPSERVER_ARGS="--stdio"

審批與選項為原生功能：codex 會直接把工具審批請求與選擇題送到你的手機（允許 / 拒絕、挑選選項），其推理過程會即時串流。斷線 / 逾時會自動拒絕（fail-closed）。可放行的範圍仍由 TUNNELBOX_CODEX_SANDBOX 決定（read-only / workspace-write / danger-full-access）。

前置條件

Node.js ^22.19 或 >=24
DeepSeek API key（dsh 憑證位於 $DSH_HOME/.credentials.yaml，預設為 ~/.dsh）

安裝 DeepSeek Harness（官方）

先安裝 dsh 本體（DeepSeek 官方 npm 套件；需要 Node.js ^22.19 或 >=24）：

# Install dsh globally (official package)
npm install -g @deepseek-ai/dsh

# or try instantly: npx @deepseek-ai/dsh web

安裝後，dsh --version 應可正常執行；首次使用時請設定 DeepSeek API key（儲存於 $DSH_HOME/.credentials.yaml）。

安裝步驟

1從 npm 安裝至 dsh 的 profile（一次性，不需複製儲存庫）

dsh plugin --profile tunnelbox add @tunnelbox/dsh-tunnelbox
dsh --profile tunnelbox --dump-config   # verify the tunnelbox-dsh layer

執行與配對

2啟動 harness 與外掛；終端機會印出 QR Code 與配對碼：

dsh --profile tunnelbox

✅ 出現 QR Code 即完成。模型 / 工作目錄可在 profile 的 cordis.yml 中設定。

選用設定與提示

全部為選用。profile 設定範例（cordis.patch.yml）：

- id: tunnelbox-dsh
  config:
    relayUrl: 'wss://relay.tunnelbox.top'
    model: 'deepseek-v4-flash'
    cwd: 'D:/workspace/project'

審批遵循 dsh 的 approval / sandbox-policy（預設 workspace-write + ask）——高風險操作會推送到你的手機。可用不同的 DSH_HOME 執行多個執行個體。

前置條件

Node.js ≥ 22.19
本機需可執行 OpenClaw Gateway ≥ 2026.6.11（protocol v4）——舊版線（< 2026.9.1）與新版線（≥ 2026.9.1）皆支援（執行時偵測能力）

安裝 OpenClaw（官方）

先安裝 OpenClaw（官方安裝程式）並完成 onboard 精靈：

# macOS / Linux (official installer)
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

# finish the setup wizard after install
openclaw onboard

當 openclaw 可執行且 Gateway 正在運作時即完成。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/openclaw

2Gateway 驗證（通常會自動完成）

轉接器會自動從 ~/.openclaw/openclaw.json 讀取你的 Gateway 權杖（或 TUNNELBOX_OPENCLAW_TOKEN）。若你的 Gateway 改為要求裝置審批，請審批一次：

openclaw devices list              # note the requestId
openclaw devices approve <requestId>

執行與配對

3啟動轉接器（連線至你的本機 Gateway）；裝置通過審批後，終端機會印出 tunnelbox QR Code：

tunnelbox-openclaw

✅ 裝置審批通過後會出現 QR Code——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_OPENCLAW_GATEWAY_URL=ws://127.0.0.1:18789 \
tunnelbox-openclaw

工作階段刪除會透過 Gateway 硬刪除（sessions.delete，需要 operator.admin）。轉接器會自動探索 gateway.auth.token / password（設定、環境變數、執行中的 Gateway 行程，或 2026.9.1 之後的憑證檔案）；可設定 TUNNELBOX_OPENCLAW_TOKEN 覆寫、執行 --check-gateway-auth 檢查、--save-token 保存，或以 TUNNELBOX_OPENCLAW_AUTOSTART=start|install 自動啟動 Gateway。審批（exec/plugin）與工具卡（含命令參數）會推送到你的手機；互動式選擇 / 提問卡需要 Gateway ≥ 2026.7（question.*），較舊的 Gateway 則會將這類提示呈現為審批或純文字。

前置條件

Node.js ≥ 22
Hermes 帳號 / 模型 API key（於 hermes setup 時設定）

安裝 Hermes Agent（官方）

先安裝 Hermes Agent（官方安裝程式）並完成設定：

# official installer
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# finish setup after install
hermes setup

當 hermes chat -Q -q "hi" 有回應時即完成。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/hermes

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-hermes

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_HERMES_MODEL="anthropic/claude-sonnet-4" \
tunnelbox-hermes

注意：此 headless 轉接器不提供手機審批；危險操作由 hermes 本身的安全策略控管（fail-closed）。工作階段會延續真實的 Hermes 工作階段（第一輪後會自動探索 id）。互動式工作階段的審批 / 提問流程位於 Hermes 官方原生外掛（native-plugin/）。

前置條件

Node.js ≥ 22
Cursor 帳號（headless 使用會計入你的 Cursor 方案）

安裝 Cursor CLI（官方）

先安裝 Cursor CLI 本體（官方安裝程式）：

# macOS / Linux (official installer)
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

當 agent -p "hello" 正常輸出時即完成（headless 使用由 Cursor 計費）。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/cursor

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。headless 使用由 Cursor 計費——請確認已包含在你的方案中。

tunnelbox-cursor

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例（plan 模式 + 允許編輯檔案）：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_CURSOR_MODE=plan \
TUNNELBOX_CURSOR_FORCE=1 \
tunnelbox-cursor

無法進行手機審批（Cursor hooks 僅支援 IDE / Cloud agent；headless agent -p 沒有外部審批中繼），且 print 模式會抑制思考過程（沒有推理卡）。實際可執行的內容由 permissions allow/deny + --force/--yolo + --sandbox 決定。預設為唯讀（不加 --force 時，代理只提出建議、不會編輯）。設定 TUNNELBOX_CURSOR_FORCE=1 才會實際編輯檔案。還沒有 CLI？macOS / Linux：curl https://cursor.com/install -fsS | bash；Windows：irm 'https://cursor.com/install?win32=true' | iex。

前置條件

Node.js ≥ 22
已安裝並登入 CodeBuddy CLI（npm i -g @tencent-ai/codebuddy-code；先執行一次 codebuddy 登入，或設定 CODEBUDDY_API_KEY）

安裝 CodeBuddy CLI（官方）

先安裝 CodeBuddy CLI 本體（npm 全域安裝）：

# install the CodeBuddy CLI
npm install -g @tencent-ai/codebuddy-code

# first login (or use CODEBUDDY_API_KEY)
codebuddy

當 codebuddy --version 顯示版本時即完成；首次執行需要登入。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/codebuddy

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-codebuddy

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例（plan 模式）：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_CODEBUDDY_MODE=plan \
tunnelbox-codebuddy

驅動 codebuddy --acp（ACP）。工具審批會送到手機（允許 / 拒絕 / 永遠允許）；離線或 120 秒逾時會自動拒絕（fail-closed）。選擇 / 計畫 / 提問為原生 ACP（AskUserQuestion / ExitPlanMode / elicitation）。若尚未登入，請執行一次 codebuddy 登入（或設定 CODEBUDDY_API_KEY）。

前置條件

Node.js ≥ 22
已安裝並登入 Kimi Code CLI（先執行一次 kimi 並傳送 /login）

安裝 Kimi Code CLI（官方）

先安裝 Kimi Code CLI 本體（官方指令碼或 npm），接著執行一次並傳送 /login：

# macOS / Linux (official installer)
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows PowerShell
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# first login
kimi   # then send /login

當 kimi --version 顯示版本時即完成；首次執行需要 /login。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/kimi

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-kimi

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例（plan 模式）：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_KIMI_MODE=plan \
tunnelbox-kimi

驅動 kimi acp（ACP）。官方能力矩陣包含原生 session/list|resume|delete；工具審批與提問共用 session/request_permission 並送到手機；離線或 120 秒逾時會自動拒絕（fail-closed）。若尚未登入，請執行一次 kimi 並傳送 /login。

前置條件

Node.js ≥ 22
已安裝並登入 TraeCode CLI（traecli login）。注意：TraeCode CLI 需要 TRAE 企業版旗艦方案

安裝 TraeCode CLI（官方）

先依官方文件安裝 TraeCode CLI 本體，然後登入：

# see https://docs.trae.cn/cli_what-is-trae-cli
traecli login

當 traecli --version 可執行且 traecli login 成功時即完成。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/trae

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-trae

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例（auto 權限模式）：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_TRAE_PERMISSION_MODE=auto \
tunnelbox-trae

驅動 traecli acp serve（ACP）。官方文件僅說明支援 ACP、未公布能力矩陣，因此此轉接器屬實驗性——請以實際 CLI 驗證串流 / 審批 / 選擇 / 中止（npm run probe）。審批預設為 fail-closed。TraeCode CLI 需要 TRAE 企業版旗艦方案，且預設為 Max 模式（請注意額度）。

前置條件

Node.js ≥ 22
已安裝並登入 Qoder CLI（qoder login，或設定 QODER_PERSONAL_ACCESS_TOKEN）

安裝 Qoder CLI（官方）

先安裝 Qoder CLI 本體（npm），然後登入：

# install Qoder CLI
npm install -g @qoder-ai/qodercli

# log in (or set QODER_PERSONAL_ACCESS_TOKEN)
qoder login

當 qoder --version 顯示版本且已登入時即完成。

安裝步驟

1透過 npm 全域安裝轉接器（不需複製儲存庫）

# no repo clone needed
npm install -g @tunnelbox/qoder

執行與配對

2啟動轉接器（會常駐於你的電腦）；終端機會印出 QR Code 與配對碼。

tunnelbox-qoder

✅ 出現 QR Code 即完成——用手機掃描即可配對。

選用設定與提示

全部為選用。常見範例（auto 權限模式）：

TUNNELBOX_RELAY_URL=wss://relay.tunnelbox.top \
TUNNELBOX_QODER_PERMISSION_MODE=auto \
tunnelbox-qoder

驅動 qoder --acp（ACP）。工具審批會送到手機（允許 / 拒絕 / 永遠允許）；離線或 120 秒逾時會自動拒絕（fail-closed）。選擇 / 計畫 / 提問會經由 ACP 權限通道。若尚未登入，請執行 qoder login 或設定 QODER_PERSONAL_ACCESS_TOKEN。

進階：更多代理與自行架設

各轉接器 README：除了上述手冊，更深入的架構 / 協定細節位於儲存庫中 plugin/ 下各轉接器的 README。
自行架設中繼：docker compose up -d 一行指令即可部署中繼（可選用 MySQL 持久化）。nginx.conf 範本提供反向代理 HTTPS；設定 NATS_URL 即可擴充至多節點。

GitHub 儲存庫 → 需求文件與轉接器規格 →

常見問題

我的電腦沒有公網 IP——在公司 / 宿舍網路能用嗎？

可以。你電腦上的轉接器只會發出對外 WebSocket 連線（反向連線）。不需公網 IP、連接埠轉送或通道；它能穿透 NAT 與防火牆，因此公司網路也能正常運作。

我的訊息會經過中繼——這樣安全嗎？

中繼只做無狀態轉送，且不儲存任何對話內容。傳輸全程 TLS；配對碼為一次性且 10 分鐘後失效；工作階段權杖以 SHA-256 雜湊儲存。重視隱私的使用者可自行架設中繼，讓資料留在自己的伺服器上。

我的對話紀錄儲存在哪裡？

只存在你電腦上代理的本機儲存空間。當你開啟工作階段時，App 會即時向你的電腦取得紀錄；電腦關機或外掛離線時便無法取得。中繼不進行雲端同步或備份——這是刻意採取的隱私優先、低成本取捨。

支援哪些代理？可以同時執行多個嗎？

支援 opencode、Claude Code、Codex、DeepSeek Harness、OpenClaw、Hermes 與 Cursor，且同類型允許多個執行個體（例如 opencode1 / opencode2）。各自獨立配對與連線——可從手機清單切換，或讓不同代理執行同一項任務以並排比較。

危險操作一定需要我審批嗎？

是的。當呼叫 bash 或編輯檔案等工具時，請求會依各代理原生的 ask / 審批模型推送到你的手機——只有在你允許或拒絕後才會執行。你也可以為某個工具選擇「永遠允許」（僅限本次工作階段）。

免費嗎？可以自行架設 / 部署嗎？

免費且開源（請見儲存庫中的 LICENSE）。中繼可自行架設：Docker / docker compose 一行指令即可部署，透過 nginx 反向代理提供 HTTPS，支援 MySQL 持久化與 NATS 多節點擴充。Android / iOS App 可於官方網站取得。

這和 AionUi 這類產品有何不同？

tunnelbox 以手機遠端控制為核心：中繼反向連線加上原生 Android / iOS App，讓你隨時隨地遙控電腦上的多個 CLI 代理。統一的協定、無狀態中繼與易於自行架設的特性，讓你在單一機器上輕鬆執行與管理多個代理。

把AI 代理隨身帶著走

一個遙控器，指揮你所有代理

反向連線，不需公網 IP

多個代理，一台電腦

在手機上審批高風險操作

掃描 QR Code 即可配對

單一協定，後端完全透明

隱私優先

主流 CLI 代理全數涵蓋

反向連線 + 無狀態中繼

你的手機

中繼 relay（Go）

你的電腦

現在就開始

tunnelbox App

三個步驟配對，立即起飛

步驟 1 · 在電腦上執行你的代理轉接器

步驟 2 · 在手機安裝並開啟 tunnelbox App

步驟 3 · 掃描配對

步驟 4 · 開始遠端操作

各代理安裝手冊

前置條件

安裝 opencode（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Claude Code（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Codex CLI（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 DeepSeek Harness（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 OpenClaw（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Hermes Agent（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Cursor CLI（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 CodeBuddy CLI（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Kimi Code CLI（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 TraeCode CLI（官方）

安裝步驟

執行與配對

選用設定與提示

前置條件

安裝 Qoder CLI（官方）

安裝步驟

執行與配對

選用設定與提示

進階：更多代理與自行架設

常見問題

把 AI 裝進口袋——現在就出發

把AI 代理
隨身帶著走