AI エージェントを
どこへでも持ち歩こう

前提条件

• Node.js ≥ 22（tunnelbox アダプターが必要とします）
• 有料の Claude プラン（Pro / Max / Team）または Anthropic Console の API キー

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 アカウントでログインします。

インストール手順

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

実行とペアリング

tunnelbox-claude-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 キー）と、codex app-server サブコマンドに対応した Codex CLI

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 が利用可能か確認）。

インストール手順

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

実行とペアリング

tunnelbox-codex

任意設定とヒント

すべて任意です。よく使う例：

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 キー（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 キーを設定します（$DSH_HOME/.credentials.yaml に保存）。

インストール手順

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

実行とペアリング

dsh --profile tunnelbox

任意設定とヒント

すべて任意です。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 が実行されていれば準備完了です。

インストール手順

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

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

実行とペアリング

tunnelbox-openclaw

任意設定とヒント

すべて任意です。よく使う例：

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 キー（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" が応答すれば準備完了です。

インストール手順

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

実行とペアリング

tunnelbox-hermes

任意設定とヒント

すべて任意です。よく使う例：

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

注意：このヘッドレスアダプターはスマホ承認を提供しません。危険な操作は hermes 自身のセキュリティポリシーで制御されます（fail-closed）。セッションは実際の Hermes セッションで継続します（初回ターン後に id を自動検出）。対話セッションの承認 / 質問フローは Hermes 公式ネイティブプラグイン（native-plugin/）にあります。

前提条件

• Node.js ≥ 22
• Cursor アカウント（ヘッドレス利用は 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" が正常に出力すれば準備完了（ヘッドレス利用は Cursor の課金対象）。

インストール手順

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

実行とペアリング

tunnelbox-cursor

任意設定とヒント

すべて任意です。よく使う例（plan モード + ファイル編集を許可）：

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

スマホ承認は利用できません（Cursor の hooks は IDE / Cloud agent 専用で、ヘッドレスの 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 でバージョンが表示されれば準備完了。初回実行にはログインが必要です。

インストール手順

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

実行とペアリング

tunnelbox-codebuddy

任意設定とヒント

すべて任意です。よく使う例（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 が必要です。

インストール手順

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

実行とペアリング

tunnelbox-kimi

任意設定とヒント

すべて任意です。よく使う例（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 が成功すれば準備完了です。

インストール手順

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

実行とペアリング

tunnelbox-trae

任意設定とヒント

すべて任意です。よく使う例（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 でバージョンが表示され、ログイン済みなら準備完了です。

インストール手順

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

実行とペアリング

tunnelbox-qoder

任意設定とヒント

すべて任意です。よく使う例（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 を設定します。