低遅延開発ガイド：SSH でクラウド Mac をローカル体験にマッピングする

一言で言うと：Cloud Mac を借りたのに「リモートはいつも半拍遅い」と感じる人の多くは、ネットが悪いのではなく、Mac 全体をリモートデスクトップとしてピクセル転送している。 本文は 4 層に分けて解説：SSH 基線の調整、エディタの Remote 接続、ポートとファイルの同期、長時間タスクの不断線——読み終えれば VNC を開くべきか SSH だけで足りるか判断でき、日常開発を「ノートの後ろに Mac mini が繋がっている」感覚に近づけられる。

関連記事：5 分で Cloud Mac に CodeGraph をデプロイ · Linux/Windows からリモート Xcode テスト · Cloud Mac vs ローカル Mac AI ワークステーション

Cloud Mac を借りたのに、なぜ「リモートはいつも半拍遅い」のか？

初めてクラウド Macに接続すると、多くの人は VNC や画面共有を開き、リモートデスクトップで Xcode を起動——そして遅延を嘆く。問題は M4 の算力ではなく、「開発」を「リモート画面を見ること」と同一視している点にある。

現代のリモート開発は 2 種類のトラフィックに分けられる：

• ピクセル流（VNC / RDP / 画面共有）：GUI の各フレームをエンコード・転送・デコード。太平洋横断では、マウス移動やスクロールが「追従遅れ」する。
• コマンドと差分編集流（SSH / Remote SSH）：ターミナル出力、ファイル diff、LSP メッセージのみ転送。同じ 150ms RTT でも、コマンド入力と保存の体感は通常 1 桁良い。

「ローカル体験にマッピング」とは、机の上に Mac があると思い込むことではなく、ノートは表示と入力だけ、コンパイル・テスト・索引・Agent ループはすべてクラウドで実行し、往復データを最小化すること。以下 4 層はこの原則で積み上げたもの。

コントロール面と実行面：境界を先に描く

リモート Xcode テストと同じ考え方：

• コントロール面（ローカル Windows / Linux / 薄型ノート）：SSH クライアント、Cursor / VS Code、ブラウザプレビュー、git push で CI 起動。
• 実行面（Cloud Mac）：xcodebuild、シミュレータ、pnpm test、Ollama、Claude Code、GitHub Actions self-hosted runner。

境界が明確になると、「ローカル体験」の定義も具体化する：入力はローカル、計算はクラウド、フィードバックはターミナルとエディタ中心、GUI は補助。Windows 開発者も Mac を所有しなくて、Cloud Mac で Mac mini 相当のツールチェーンを得られる——詳しくは クラウド Mac で Windows の iOS ビルド課題を解決。

4 層マッピングモデル：「接続できる」から「ローカルらしい」へ

第 1 層：SSH 基線チューニング（コピペ可）

ZavCloud コンソールからインスタンス IP、ポート、ユーザー名をコピー後、以下をローカルの ~/.ssh/config に記述（Windows：%USERPROFILE%\.ssh\config）：

# グローバル：接続再利用 + キープアライブ（全 Host に適用）
Host *
  ControlMaster auto
  ControlPath ~/.ssh/cm-%r@%h:%p
  ControlPersist 10m
  ServerAliveInterval 30
  ServerAliveCountMax 4
  IdentityFile ~/.ssh/id_ed25519

# Cloud Mac インスタンス（例）
Host cloud-mac
  HostName 203.0.113.10    # コンソールの公開 IP
  User root                  # またはパネル提供のユーザー名
  Port 22
  IdentitiesOnly yes

ControlMaster は 2 本目の ssh cloud-mac が既存 TCP+暗号化チャネルを再利用。Remote SSH で複数ウィンドウを開くとき特に効く。ServerAliveInterval は会社 Wi‑Fi/NAT のサイレント切断を防ぐ。鍵は Ed25519、権限 chmod 600。

検証：

ssh cloud-mac   # 初回：フィンガープリント yes
uname -a        # リモート macOS が表示されるはず
exit
time ssh cloud-mac true  # 2 回目は明らかに速い（再利用）

第 2 層：Cursor / VS Code Remote SSH

「ローカル体験にマッピング」の核心：Language Server、ターミナル、デバッガーは Cloud Mac 上で動き、ローカルは UI 描画のみ。VNC でリモート Xcode ウィンドウをドラッグするより、1 ファイル編集の往復は通常数 KB。

1. ローカルに Remote - SSH 拡張をインストール（Cursor 内蔵または Open VSX）。
2. Cmd/Ctrl+Shift+P → Remote-SSH: Connect to Host → cloud-mac を選択。
3. 初回接続でリモートに VS Code Server をダウンロード（outbound ネットワーク必要）。完了後 Open Folder でリポジトリルート、例 /root/projects/my-app。
4. 統合ターミナルの各コマンドは Cloud Mac 上で実行——brew、xcodebuild、claude はローカル Mac と同様。

よくある落とし穴：ローカルでリポジトリを開き SSH でコマンドだけ実行——「二重ファイル」と同期遅延の原因。正しくはワークスペースはリモート、ローカルに 2 つ目の working copy を置かない（読み取り専用バックアップのみ可）。

第 3 層：ポート転送——ブラウザプレビューをローカルらしく

リモートで npm run dev が 3000 を listen しているとき、ファイアウォールで公開ポートを開く必要はない。2 つの書き方：

方式 A：ssh config 静的転送

LocalForward 3000 localhost:3000
LocalForward 5173 localhost:5173   # Vite デフォルト

接続後、ローカルで http://localhost:3000 にアクセスすればリモートサービスへ到達。

方式 B：VS Code / Cursor Ports パネル——Remote 接続後に listen ポートを自動検出し、ワンクリックで localhost に Forward。一時ポート向け。

iOS シミュレータ内 WebView デバッグ、Next.js HMR もこの経路で可能。転送するのは TCP であり HTTP 認証ではない——未認可の管理パネルを共有ネットワークに転送しないこと。

第 4 層：コードと状態の同期

原則：同期層は少ないほど良い。クラウド Mac のディスクがローカル NVMe 同等なら、「唯一の真実」はクラウドに置き、ローカルは SSH クライアントのみ——競合面が最小。

tmux：長時間タスクと「蓋を閉じても不断線」

xcodebuild test、codegraph init -i、Claude Code Agent ループは数十分以上かかることも。tmux で包めば SSH 切断は detach のみ、再接続後 tmux attach で出力を復元。

brew install tmux   # 未インストールの場合
tmux new -s build
xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16'
# Ctrl+B の後 D でデタッチ；断線後：
tmux attach -t build

これは Cloud Mac AI ワークステーションの「重い処理はリモート、ノートはターミナル」と一致：ローカル 16GB メモリで IDE + 索引 + テストを同時に抱えない。

VNC と SSH：使い分け

リージョン選択と遅延の概測

注文時にチームの主要オフィスネットワークから RTT が最も低いデータセンターを選択。概測方法：

• ping <インスタンスIP> で平均 RTT（ICMP 参考のみ、SSH 全体を代表しない）。
• mtr -rwzc 50 <IP> でパケットロスと最終ホップのジッター。
• 実際の開発は Remote SSH でファイル保存 + ターミナル応答 の体感を基準に。

経験則（国際オフィス網、専用線なし）：RTT < 80ms で Remote 編集はローカルに近い；> 150ms でも SSH/tmux は使えるが LSP ジャンプに待ちを感じる；> 250ms はより近いリージョンへ、または同一 VPN 出口に集約を検討。

3 つの典型ワークフロー

A. Windows 独立開発者 · iOS + フロントエンド

• Cloud Mac：git clone、Xcode、シミュレータ、署名。
• ローカル：Cursor Remote SSH + ポート転送で Web 管理画面をプレビュー。
• CI：同一インスタンスに GitHub Actions self-hosted runner を登録（Runner ワークスペース設定参照）。

B. ローカル MacBook + クラウド算力オフロード

• 軽量編集はローカル可；codegraph init、大リポジトリテスト、Ollama 14B は Cloud Mac へ。
• SSH でスクリプト起動、結果 artifact を返送；ノートのファンはあまり回らない。

C. ターミナル派 · Claude Code 長時間実行

• SSH + tmux + claude のみ、GUI 不要。
• MCP Server（GitHub、CodeGraph）はクラウドにインストール、実行環境と同機。

トラブルシューティング

よくある質問

mosh は SSH より向いている？

mosh は高パケットロス、IP 頻繁変更のモバイルネットワーク向けだが、リモートに mosh-server が必要で、SSH ポート転送は非対応。デスクトップオフィス + Remote SSH + LocalForward なら OpenSSH 最適化で十分；地下鉄で頻繁に断線する場合のみ mosh を対話 shell 専用で検討。

Cloud Mac で Docker は使える？

Apple Silicon で Linux コンテナは Docker Desktop または Colima で可能だが、iOS/macOS ネイティブツールチェーンは macOS に直接インストール推奨。SSH ワークフローと Docker 使用は直交——多くの iOS/Flutter チームはネイティブ brew + Xcode が主体。

複数人で 1 台の Cloud Mac を共有？

専有インスタンスは単一ユーザーまたは単一チーム占有が前提。複数人は独立アカウント + SSH 鍵、または各人独立インスタンス——同一ワークスペースへの同時 Remote はファイルロック競合を招く。協業は Git、共有デスクトップではない。

セキュリティ上の注意は？

パスワードログイン無効、鍵のみ；~/.ssh/authorized_keys を定期ローテーション；本番鍵と .env をリポジトリに入れない；ポート転送で未認証サービスをカフェ LAN に晒さない。詳細はコンソール SSH 説明と ヘルプセンター。