接続経路は、公式に確認できるだけでも SSH と開発用トンネルの2系統です。Agent Hostの公式アーキテクチャに沿って、Agent HostをコードリポジトリとXcodeツールチェーンに近い独立したクラウドMacへ置き、隔離したGit worktreeで実行してください。これが、VS Code Agent HostのクラウドMacデプロイで最初に採るべき構成です。
セッションをエディターのウィンドウから切り離して継続できても、実行環境の安全性まで自動的に確保されるわけではありません。接続を切る前に、権限、作業ディレクトリ、秘密情報、回退手順を検証できないなら、本番コードを任せず、ローカルまたは限定された検証用リポジトリへ戻してください。
この記事は、XcodeプロジェクトでGitHub Copilot、Claude、Codexに長時間の作業をさせたいiOS・macOS開発者向けです。複数のAgentセッション、worktree、認証情報を管理するプラットフォーム担当者と、クラウドMacの共有運用か専有運用かを判断するAI Codingチーム責任者にも向いています。
最終更新：2026年9月3日。機能状態と接続方法は、VS CodeのAgent Hostアーキテクチャ、セッション管理、AI設定、リモートセッション、SSH・開発用トンネルの公式資料を確認しています。
VS Code Agent HostのクラウドMacデプロイで最初に決める境界
Agent Hostは、セッションの状態を保持し、Agent harnessを起動し、指定されたワークスペースでファイル変更やコマンド実行を仲介する常駐側のプロセスです。モデルそのものを提供するサービスでも、権限を自動的に封じ込めるサンドボックスでもありません。モデル提供元、GitHub Copilotなどのharness、VS Codeクライアントの拡張機能、macOSの実行環境を分けて設計します。
クラウドMacが必要なのは、Xcode、Simulator、macOS専用のビルド、署名、実機に近いテストなどを遠隔環境で実行したい場合です。単なるテキスト編集や一般的なサーバー処理だけなら、Macを常時確保する構成は、費用と管理対象を増やすだけになる可能性があります。
最初に次の境界を1枚の運用記録へ書きます。
- Agentが直接変更できるリポジトリとworktree
- 実行を許可するコマンド、禁止するコマンド、人工承認が必要な操作
- モデルやharnessへ渡す認証情報の範囲
- Xcodeの署名情報、キーチェーン、MCP接続先の扱い
- セッション終了時に削除するworktree、ログ、トークン
注意：Agent Hostのセッション保存と、Mac上のファイル・資格情報の隔離は別の管理項目です。前者だけを確認して「安全な長時間実行」と判定しないでください。
SSHと開発用トンネルを比較して最初の接続を決める
SSHは、接続元、鍵、踏み台、ファイアウォール、監査ログをチームの既存運用へ組み込みやすい方式です。一方、開発用トンネルは受信ポートを直接公開せずに接続しやすい反面、組織アカウント、トンネルの所有者、利用可能なクライアント、停止手順を継続的に管理する必要があります。詳細な安全上の前提は、Remote Tunnelsの公式セキュリティ文書で確認してください。
| 接続方式 | 認証と入口 | 向いている運用 | 先に確認する停止条件 | 判断用評価 |
|---|---|---|---|---|
| SSH | SSH鍵、接続元、ネットワーク経路を自分たちで管理 | 固定チーム、監査可能な社内経路、定型化された運用 | 鍵の失効、接続元制限、Mac再起動後の再接続が未確認 | 管理性 5 / 導入容易性 3 |
| 開発用トンネル | VS Codeのアカウントとトンネルの公開範囲を管理 | 受信ポートを公開したくない短期検証や柔軟な接続 | 所有者不在、アカウント失効、トンネル停止後の復旧が未確認 | 管理性 3 / 導入容易性 4 |
評価は公式の優劣ではなく、運用設計上の比較です。固定されたプラットフォーム運用ならSSH、ネットワーク入口を用意しにくい試験環境なら開発用トンネルを選び、両方を同時に本番経路へ残さないでください。
リモートAgentセッションの公式手順で対象機能の提供状態を確認したら、遠隔Mac上でAgent Hostを独立した起動単位として立ち上げます。保存する証跡は、VS Codeと関連機能の状態、Agent Hostのバージョン、起動方法、接続主体、最初に接続できた日時です。接続できただけで本番入口にせず、運用担当以外が停止・再接続できるかを確認します。
最初の1時間は小さなworktreeだけで接続を検収する
GitHub Copilot、Claude、Codexの差を先に記録する
harnessを選ぶときは、アカウント認証、モデルの入口、ツール呼び出し、実験的な設定を個別に確認します。GitHub Copilot、Claude、Codexが同じAgent Host上で動くとしても、利用可能なモデル、承認フロー、組み込みツール、保存される状態まで同一とは限りません。AI設定の公式リファレンスにある設定と、実際のチーム契約で使える機能を照合してください。
変更を独立させ、失敗しても捨てられる作業にする
リポジトリを直接編集せず、セッションごとに専用のGit worktreeを作ります。作業名、担当者、開始時のコミット、使用したharness、終了状態を記録し、最初の課題はテスト追加や小さな修正など、差分をレビューしやすく元へ戻しやすいものに限定します。
次の順番で実行すると、最小の検収になります。
- 基準ブランチの状態を保存し、対象worktreeが空の変更から始まることを確認します。
- Agent Hostへ接続し、harness、モデル入口、リポジトリのパス、許可ツールを記録します。
- 小さな修正を依頼し、Agent Hostが直接編集した場所とworktree内の変更を照合します。
- テストを実行し、差分、標準出力、確認要求、失敗理由を保存します。
- 変更をコミットする場合と破棄する場合の両方を試し、基準状態へ戻せることを確認します。
- 合格しない場合は、対象worktreeを削除してローカル開発へ戻し、権限や接続設定を見直します。
切断後の継続と複数ウィンドウの同期を分けて検証する
ローカルPCを閉じても処理は続くのか
Agent Hostが独立した遠隔プロセスとして動作し、セッションがそのHost側に保持されていれば、1つのVS Codeウィンドウを閉じても処理を継続できる構成です。セッション管理の公式文書が示す対応状態を確認し、まず短い代表タスクで実測してください。
検証では、クライアントを閉じる操作、ネットワークを切る操作、遠隔Macを再起動する操作、Agent Hostプロセスを終了する操作を分けます。前者だけ成功しても、Hostの異常終了やMac再起動から復旧できる証拠にはなりません。
複数のVS Codeウィンドウは同じセッションを扱えるのか
公式アーキテクチャでは、複数のクライアントが同じセッションへ接続できる構成が確認されています。ただし、2つの画面から同時に承認やファイル操作を行うと、誰が判断したか追跡しにくくなります。2つ目のウィンドウ、または対応するブラウザー入口から再接続し、セッション状態、端末出力、変更差分、確認要求が一致することを確認してください。
合格条件は「画面が開いた」ではなく、切断中もタスクが進み、再接続後に同じ状態を読み取れ、変更をレビューしてコミットまたは破棄できることです。進捗が消えた場合は、遠隔Hostのログとセッション保存状態を確認し、長時間タスクを停止します。
XcodeとMCPを接続して納品物まで確認する
Agent HostからXcodeやMCPを直接呼び出せるかは、Agent Host本体、クライアント拡張機能、harness、MCP設定、macOS上の権限に分けて確認します。MCPの定義だけが見えても、クライアント切断後にツールが動くとは限らないため、MCP設定の公式リファレンスに沿って転送先、認証、対話入力、承認操作を点検します。
実プロジェクトでの検収は次の順にします。
- 依存関係を復元し、固定された作業ディレクトリから同じ操作を再実行します。
- Xcodeのビルド対象、署名設定、生成される制品の保存先を確認します。
- Xcodeのコマンドラインツール公式リファレンスに対応する手順でビルドを実行します。
- 単にコードが生成されたかではなく、テスト実行と結果解釈の公式資料に沿ってテスト結果を保存します。
- MCP経由のブラウザー操作や外部書き込みは人工承認を必須にし、秘密情報を含むログを回収します。
経験上、ビルド成功は納品成功ではありません。署名、テスト結果、成果物の場所、再現手順の4点が保存できない場合は、コード生成の検収に戻してください。
1週目に共有運用か専有運用かを決める
最初の週は、セッションごとに実行時間、ツール呼び出し、失敗と再試行、人工接管、Macの占有状況を保存します。これは性能ランキングを作るためではなく、作業が同時に走ったときに、共有Macで待ち時間や権限衝突が発生するかを判断するためです。
次の状態なら、まだ拡大せず限定試験に戻します。
- 切断後にセッションの進捗を再現できない
- worktreeと直接編集の区別がつかない
- MCPやXcodeの承認が誰の操作か残らない
- Mac異常停止後にスナップショット、再作成、資格情報の失効ができない
- 終了したセッションのworktreeやログを清掃できない
逆に、セッションを再接続でき、差分をレビューでき、環境を再構築できるなら、長時間タスクの対象を段階的に増やせます。容量判断では、複数人のリモートMac開発に必要な容量を考える記事を参照し、長時間タスク、並行worktree数、Xcodeビルドのピークを実測値で見積もってください。
現在の手元Macだけで運用すると、ローカルPCを閉じた時点で処理が止まりやすく、複数担当者とのセッション共有、環境の再作成、署名やMCPの権限分離も難しくなります。一般的なLinuxやWindowsのクラウド環境へ移す方法もありますが、Xcode、Simulator、macOS専用テストを同じ場所で完結できず、別のMacへ成果物を戻す工程が増えます。
そのため、長時間のAI Codingを一時的に動かし、Xcodeを含む実環境で接続と復旧を検証したい段階では、MacPullのクラウドMacレンタルが現実的な選択肢になります。共有池かタスク単位の専有環境かを決める前に、クラウドMacの利用案内と容量の考え方を確認し、まず最小worktreeで切断、再接続、Xcode検収まで通してから運用範囲を広げてください。